@flighthq/movieclip 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './movieClip';
+export * from './spritesheetTimelineSource';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './movieClip';
+export * from './spritesheetTimelineSource';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,6BAA6B,CAAC"}

package/dist/movieClip.d.ts

@@ -0,0 +1,24 @@
+import type { FrameScript, MovieClip, MovieClipData, MovieClipRuntime, MovieClipSignals, PartialNode, TimelineLabel, TimelineSource } from '@flighthq/types';
+export declare function addMovieClipFrameScript(clip: MovieClip, frame: number | string, script: FrameScript): void;
+export declare function createMovieClip(obj?: Readonly<PartialNode<MovieClip>>): MovieClip;
+export declare function createMovieClipData(data?: Readonly<Partial<MovieClipData>>): MovieClipData;
+export declare function createMovieClipRuntime(): MovieClipRuntime;
+export declare function disposeMovieClipSignals(clip: MovieClip): void;
+export declare function enableMovieClipSignals(clip: MovieClip): MovieClipSignals;
+export declare function getMovieClipCurrentFrame(clip: MovieClip): number;
+export declare function getMovieClipCurrentLabel(clip: MovieClip): TimelineLabel | null;
+export declare function getMovieClipFrameScript(clip: MovieClip, frame: number | string): FrameScript | null;
+export declare function getMovieClipRuntime(source: Readonly<MovieClip>): Readonly<MovieClipRuntime>;
+export declare function getMovieClipSignals(clip: MovieClip): MovieClipSignals | null;
+export declare function getMovieClipTotalFrames(clip: MovieClip): number;
+export declare function gotoAndPlayMovieClip(clip: MovieClip, frame: number | string): void;
+export declare function gotoAndStopMovieClip(clip: MovieClip, frame: number | string): void;
+export declare function isMovieClipPlaying(clip: MovieClip): boolean;
+export declare function nextFrameMovieClip(clip: MovieClip): void;
+export declare function playMovieClip(clip: MovieClip): void;
+export declare function prevFrameMovieClip(clip: MovieClip): void;
+export declare function removeMovieClipFrameScript(clip: MovieClip, frame: number | string): void;
+export declare function setMovieClipSource(clip: MovieClip, source: TimelineSource): void;
+export declare function stopMovieClip(clip: MovieClip): void;
+export declare function updateMovieClip(clip: MovieClip, deltaTime: number): void;
+//# sourceMappingURL=movieClip.d.ts.map

package/dist/movieClip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"movieClip.d.ts","sourceRoot":"","sources":["../src/movieClip.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,cAAc,EACf,MAAM,iBAAiB,CAAC;AAKzB,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAG1G;AAED,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,GAAG,SAAS,CAEjF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,aAAa,CAI1F;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CAIzD;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAI7D;AAKD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,gBAAgB,CAQxE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAEhE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,GAAG,IAAI,CAG9E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,IAAI,CAGnG;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAE3F;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAG5E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAE/D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAE3D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAGxD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAGnD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAGxD;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGxF;AAKD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAShF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAGnD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAGxE"}

package/dist/movieClip.js

@@ -0,0 +1,123 @@
+import { createDisplayObjectGeneric, createDisplayObjectRuntime, getDisplayObjectRuntime, } from '@flighthq/displayobject';
+import { addTimelineFrameScript, createTimeline, disposeTimelineSignals, enableTimelineSignals, getTimelineCurrentLabel, getTimelineFrameScript, gotoAndPlayTimeline, gotoAndStopTimeline, nextFrameTimeline, playTimeline, prevFrameTimeline, removeTimelineFrameScript, stopTimeline, updateTimeline, } from '@flighthq/timeline';
+import { EntityRuntimeKey, MovieClipKind } from '@flighthq/types';
+// The MovieClip display node lives here, with its playback engine — a MovieClip is a DisplayObject whose
+// content is driven by a timeline, so the node and the engine that constructs its frames are one feature.
+export function addMovieClipFrameScript(clip, frame, script) {
+    if (clip.data.timeline === null)
+        return;
+    addTimelineFrameScript(clip.data.timeline, frame, script);
+}
+export function createMovieClip(obj) {
+    return createDisplayObjectGeneric(MovieClipKind, obj, createMovieClipData, createMovieClipRuntime);
+}
+export function createMovieClipData(data) {
+    return {
+        timeline: data?.timeline ?? null,
+    };
+}
+export function createMovieClipRuntime() {
+    const out = createDisplayObjectRuntime();
+    out.movieClipSignals = null;
+    return out;
+}
+export function disposeMovieClipSignals(clip) {
+    const runtime = clip[EntityRuntimeKey];
+    if (clip.data.timeline !== null)
+        disposeTimelineSignals(clip.data.timeline);
+    runtime.movieClipSignals = null;
+}
+// Allocates a MovieClipSignals group on the clip and arms per-frame signal emission. Idempotent —
+// returns the same group on subsequent calls. Also enables the underlying timeline signals so the
+// clip's signals fire when the timeline advances.
+export function enableMovieClipSignals(clip) {
+    const runtime = clip[EntityRuntimeKey];
+    if (runtime.movieClipSignals !== null)
+        return runtime.movieClipSignals;
+    // Ensure the timeline exists so signals can be armed even before setMovieClipSource is called.
+    if (clip.data.timeline === null)
+        clip.data.timeline = createTimeline();
+    const signals = enableTimelineSignals(clip.data.timeline);
+    runtime.movieClipSignals = signals;
+    return signals;
+}
+export function getMovieClipCurrentFrame(clip) {
+    return clip.data.timeline?.currentFrame ?? 1;
+}
+export function getMovieClipCurrentLabel(clip) {
+    if (clip.data.timeline === null)
+        return null;
+    return getTimelineCurrentLabel(clip.data.timeline);
+}
+export function getMovieClipFrameScript(clip, frame) {
+    if (clip.data.timeline === null)
+        return null;
+    return getTimelineFrameScript(clip.data.timeline, frame);
+}
+export function getMovieClipRuntime(source) {
+    return getDisplayObjectRuntime(source);
+}
+export function getMovieClipSignals(clip) {
+    const runtime = clip[EntityRuntimeKey];
+    return runtime.movieClipSignals;
+}
+export function getMovieClipTotalFrames(clip) {
+    return clip.data.timeline?.source?.totalFrames ?? 1;
+}
+export function gotoAndPlayMovieClip(clip, frame) {
+    if (clip.data.timeline === null)
+        return;
+    gotoAndPlayTimeline(clip.data.timeline, frame);
+}
+export function gotoAndStopMovieClip(clip, frame) {
+    if (clip.data.timeline === null)
+        return;
+    gotoAndStopTimeline(clip.data.timeline, frame);
+}
+export function isMovieClipPlaying(clip) {
+    return clip.data.timeline?.isPlaying ?? false;
+}
+export function nextFrameMovieClip(clip) {
+    if (clip.data.timeline === null)
+        return;
+    nextFrameTimeline(clip.data.timeline);
+}
+export function playMovieClip(clip) {
+    if (clip.data.timeline === null)
+        return;
+    playTimeline(clip.data.timeline);
+}
+export function prevFrameMovieClip(clip) {
+    if (clip.data.timeline === null)
+        return;
+    prevFrameTimeline(clip.data.timeline);
+}
+export function removeMovieClipFrameScript(clip, frame) {
+    if (clip.data.timeline === null)
+        return;
+    removeTimelineFrameScript(clip.data.timeline, frame);
+}
+// Binds a TimelineSource to `clip`: gives it a timeline (reusing an existing one) pointed at the clip as
+// its construct target, and realizes the initial frame so the clip isn't blank before play. The source
+// comes from a format — createTimelineSource (hand-authored), createSpritesheetTimelineSource, etc.
+export function setMovieClipSource(clip, source) {
+    // Reuse the clip's existing timeline if it has one: enableMovieClipSignals may have already created and
+    // armed it (storing the same group in runtime.movieClipSignals), so pointing a source at the same object
+    // keeps those signals live with no re-wire needed — the runtime slot and timeline.signals are one group.
+    const timeline = clip.data.timeline ?? createTimeline();
+    timeline.source = source;
+    timeline.target = clip;
+    clip.data.timeline = timeline;
+    gotoAndStopTimeline(timeline, timeline.currentFrame);
+}
+export function stopMovieClip(clip) {
+    if (clip.data.timeline === null)
+        return;
+    stopTimeline(clip.data.timeline);
+}
+export function updateMovieClip(clip, deltaTime) {
+    if (clip.data.timeline === null)
+        return;
+    updateTimeline(clip.data.timeline, deltaTime);
+}
+//# sourceMappingURL=movieClip.js.map

package/dist/movieClip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"movieClip.js","sourceRoot":"","sources":["../src/movieClip.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,yBAAyB,EACzB,YAAY,EACZ,cAAc,GACf,MAAM,oBAAoB,CAAC;AAW5B,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAElE,yGAAyG;AACzG,0GAA0G;AAC1G,MAAM,UAAU,uBAAuB,CAAC,IAAe,EAAE,KAAsB,EAAE,MAAmB;IAClG,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO;IACxC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAsC;IACpE,OAAO,0BAA0B,CAAC,aAAa,EAAE,GAAG,EAAE,mBAAmB,EAAE,sBAAsB,CAAc,CAAC;AAClH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAuC;IACzE,OAAO;QACL,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,IAAI;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,MAAM,GAAG,GAAG,0BAA0B,EAAsB,CAAC;IAC7D,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAC5B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAe;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAqB,CAAC;IAC3D,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI;QAAE,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5E,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;AAClC,CAAC;AAED,kGAAkG;AAClG,kGAAkG;AAClG,kDAAkD;AAClD,MAAM,UAAU,sBAAsB,CAAC,IAAe;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAqB,CAAC;IAC3D,IAAI,OAAO,CAAC,gBAAgB,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC,gBAAgB,CAAC;IACvE,+FAA+F;IAC/F,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,cAAc,EAAE,CAAC;IACvE,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1D,OAAO,CAAC,gBAAgB,GAAG,OAAO,CAAC;IACnC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAe;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAe;IACtD,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAe,EAAE,KAAsB;IAC7E,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAA2B;IAC7D,OAAO,uBAAuB,CAAC,MAAM,CAAqB,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAe;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAqB,CAAC;IAC3D,OAAO,OAAO,CAAC,gBAAgB,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAe;IACrD,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAe,EAAE,KAAsB;IAC1E,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO;IACxC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAe,EAAE,KAAsB;IAC1E,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO;IACxC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAe;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,IAAI,KAAK,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAe;IAChD,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO;IACxC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAe;IAC3C,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO;IACxC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAe;IAChD,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO;IACxC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAe,EAAE,KAAsB;IAChF,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO;IACxC,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC;AAED,yGAAyG;AACzG,uGAAuG;AACvG,oGAAoG;AACpG,MAAM,UAAU,kBAAkB,CAAC,IAAe,EAAE,MAAsB;IACxE,wGAAwG;IACxG,yGAAyG;IACzG,yGAAyG;IACzG,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,cAAc,EAAE,CAAC;IACxD,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC9B,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAe;IAC3C,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO;IACxC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAe,EAAE,SAAiB;IAChE,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO;IACxC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAChD,CAAC"}

package/dist/spritesheetTimelineSource.d.ts

@@ -0,0 +1,3 @@
+import type { Spritesheet, SpritesheetAnimation, TimelineSource } from '@flighthq/types';
+export declare function createSpritesheetTimelineSource(spritesheet: Readonly<Spritesheet>, animation: Readonly<SpritesheetAnimation>): TimelineSource;
+//# sourceMappingURL=spritesheetTimelineSource.d.ts.map

package/dist/spritesheetTimelineSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spritesheetTimelineSource.d.ts","sourceRoot":"","sources":["../src/spritesheetTimelineSource.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAyB,WAAW,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAUhH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,EAClC,SAAS,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GACxC,cAAc,CA0BhB"}

package/dist/spritesheetTimelineSource.js

@@ -0,0 +1,38 @@
+import { createBitmap } from '@flighthq/displayobject';
+import { addNodeChild, invalidateNodeLocalTransform } from '@flighthq/node';
+// Exposes a spritesheet animation as a TimelineSource so a MovieClip can play it (the spritesheet side of
+// the timeline frame-source contract — `@flighthq/timeline` consumes `TimelineSource`, this produces one,
+// and neither depends on the other beyond the shared interface in `@flighthq/types`). Each frame swaps
+// the displayed atlas region and offset on a bitmap the source lazily creates as a child of the target
+// the first time it constructs onto that target; tracking the bitmap per target keeps the source
+// shareable across many MovieClips.
+//
+// Bind it with `setMovieClipSource(clip, createSpritesheetTimelineSource(sheet, anim))`, then `playMovieClip`.
+export function createSpritesheetTimelineSource(spritesheet, animation) {
+    const bitmaps = new WeakMap();
+    return {
+        totalFrames: animation.frames.length,
+        labels: [],
+        frameRate: 1000 / animation.frameDuration,
+        constructFrame(target, frame) {
+            const atlas = spritesheet.atlas;
+            if (atlas === null)
+                return;
+            let bitmap = bitmaps.get(target);
+            if (bitmap === undefined) {
+                bitmap = createBitmap();
+                bitmap.data.image = atlas.image;
+                addNodeChild(target, bitmap);
+                bitmaps.set(target, bitmap);
+            }
+            const sheetFrame = spritesheet.frames[animation.frames[frame - 1]];
+            if (sheetFrame === undefined)
+                return;
+            bitmap.data.sourceRectangle = atlas.regions[sheetFrame.id];
+            bitmap.x = sheetFrame.offsetX - animation.originX;
+            bitmap.y = sheetFrame.offsetY - animation.originY;
+            invalidateNodeLocalTransform(bitmap);
+        },
+    };
+}
+//# sourceMappingURL=spritesheetTimelineSource.js.map

package/dist/spritesheetTimelineSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spritesheetTimelineSource.js","sourceRoot":"","sources":["../src/spritesheetTimelineSource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAG5E,0GAA0G;AAC1G,0GAA0G;AAC1G,uGAAuG;AACvG,uGAAuG;AACvG,iGAAiG;AACjG,oCAAoC;AACpC,EAAE;AACF,+GAA+G;AAC/G,MAAM,UAAU,+BAA+B,CAC7C,WAAkC,EAClC,SAAyC;IAEzC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAyB,CAAC;IACrD,OAAO;QACL,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM;QACpC,MAAM,EAAE,EAAE;QACV,SAAS,EAAE,IAAI,GAAG,SAAS,CAAC,aAAa;QACzC,cAAc,CAAC,MAAqB,EAAE,KAAa;YACjD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC;YAChC,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO;YAE3B,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACjC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,GAAG,YAAY,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;gBAChC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC9B,CAAC;YAED,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YACnE,IAAI,UAAU,KAAK,SAAS;gBAAE,OAAO;YACrC,MAAM,CAAC,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAC3D,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;YAClD,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;YAClD,4BAA4B,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@flighthq/movieclip",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/displayobject": "0.1.0",
+    "@flighthq/node": "0.1.0",
+    "@flighthq/timeline": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "@flighthq/image": "*",
+    "@flighthq/spritesheet": "*",
+    "@flighthq/textureatlas": "*",
+    "typescript": "^5.3.0"
+  },
+  "description": "MovieClip display-object composition layer over @flighthq/timeline",
+  "sideEffects": false
+}

package/src/movieClip.test.ts

@@ -0,0 +1,430 @@
+import { createTimeline, createTimelineSource, playTimeline } from '@flighthq/timeline';
+import type { MovieClip, Timeline } from '@flighthq/types';
+import { MovieClipKind } from '@flighthq/types';
+
+import {
+  addMovieClipFrameScript,
+  createMovieClip,
+  createMovieClipData,
+  createMovieClipRuntime,
+  disposeMovieClipSignals,
+  enableMovieClipSignals,
+  getMovieClipCurrentFrame,
+  getMovieClipCurrentLabel,
+  getMovieClipFrameScript,
+  getMovieClipRuntime,
+  getMovieClipSignals,
+  getMovieClipTotalFrames,
+  gotoAndPlayMovieClip,
+  gotoAndStopMovieClip,
+  isMovieClipPlaying,
+  nextFrameMovieClip,
+  playMovieClip,
+  prevFrameMovieClip,
+  removeMovieClipFrameScript,
+  setMovieClipSource,
+  stopMovieClip,
+  updateMovieClip,
+} from './movieClip';
+
+describe('addMovieClipFrameScript', () => {
+  it('does nothing when timeline is null', () => {
+    const clip = createMovieClip();
+    expect(() => addMovieClipFrameScript(clip, 1, () => {})).not.toThrow();
+  });
+
+  it('attaches a script that fires on frame entry', () => {
+    const fired: number[] = [];
+    const clip = createMovieClip();
+    clip.data.timeline = createTimeline({
+      source: createTimelineSource({ totalFrames: 3, frameRate: null }),
+      target: clip,
+    });
+    addMovieClipFrameScript(clip, 2, (_t, f) => fired.push(f));
+    playMovieClip(clip);
+    updateMovieClip(clip, 0); // frame 1
+    updateMovieClip(clip, 0); // frame 2 — script fires
+    expect(fired).toEqual([2]);
+  });
+});
+
+describe('createMovieClip', () => {
+  let movieClip: MovieClip;
+
+  beforeEach(() => {
+    movieClip = createMovieClip();
+  });
+
+  it('initializes default values', () => {
+    expect(movieClip.data.timeline).toBeNull();
+    expect(movieClip.kind).toStrictEqual(MovieClipKind);
+  });
+
+  it('allows pre-defined values', () => {
+    const base = { data: { timeline: {} as Timeline } };
+    const obj = createMovieClip(base);
+    expect(obj.data.timeline).toStrictEqual(base.data.timeline);
+  });
+
+  it('returns a new object for better hidden-class performance', () => {
+    const base = {};
+    const obj = createMovieClip(base);
+    expect(obj).not.toStrictEqual(base);
+  });
+});
+
+describe('createMovieClipData', () => {
+  it('returns default values', () => {
+    expect(createMovieClipData().timeline).toBeNull();
+  });
+
+  it('allows pre-defined values', () => {
+    const timeline = {} as Timeline;
+    expect(createMovieClipData({ timeline }).timeline).toBe(timeline);
+  });
+});
+
+describe('createMovieClipRuntime', () => {
+  it('returns a non-null runtime with movieClipSignals null', () => {
+    const runtime = createMovieClipRuntime();
+    expect(runtime).not.toBeNull();
+    expect(runtime.movieClipSignals).toBeNull();
+  });
+});
+
+describe('disposeMovieClipSignals', () => {
+  it('clears movieClipSignals to null on the runtime', () => {
+    const clip = createMovieClip();
+    setMovieClipSource(clip, createTimelineSource({ totalFrames: 3 }));
+    enableMovieClipSignals(clip);
+    expect(getMovieClipSignals(clip)).not.toBeNull();
+    disposeMovieClipSignals(clip);
+    expect(getMovieClipSignals(clip)).toBeNull();
+  });
+
+  it('clears the underlying timeline signals', () => {
+    const clip = createMovieClip();
+    setMovieClipSource(clip, createTimelineSource({ totalFrames: 3 }));
+    enableMovieClipSignals(clip);
+    expect(clip.data.timeline!.signals).not.toBeNull();
+    disposeMovieClipSignals(clip);
+    expect(clip.data.timeline!.signals).toBeNull();
+  });
+
+  it('is idempotent — no-op when signals are already null', () => {
+    const clip = createMovieClip();
+    expect(() => disposeMovieClipSignals(clip)).not.toThrow();
+  });
+
+  it('allows enableMovieClipSignals to re-arm after dispose', () => {
+    const clip = createMovieClip();
+    setMovieClipSource(clip, createTimelineSource({ totalFrames: 3 }));
+    const first = enableMovieClipSignals(clip);
+    disposeMovieClipSignals(clip);
+    const second = enableMovieClipSignals(clip);
+    expect(second).not.toBe(first);
+    expect(getMovieClipSignals(clip)).toBe(second);
+  });
+});
+
+describe('enableMovieClipSignals', () => {
+  it('returns a signals group with all lifecycle signals defined', () => {
+    const clip = createMovieClip();
+    setMovieClipSource(clip, createTimelineSource({ totalFrames: 3 }));
+    const signals = enableMovieClipSignals(clip);
+    expect(signals.onEnterFrame).toBeDefined();
+    expect(signals.onExitFrame).toBeDefined();
+    expect(signals.onFrameConstructed).toBeDefined();
+    expect(signals.onComplete).toBeDefined();
+    expect(signals.onLoop).toBeDefined();
+  });
+
+  it('is idempotent — returns the same object on subsequent calls', () => {
+    const clip = createMovieClip();
+    setMovieClipSource(clip, createTimelineSource({ totalFrames: 3 }));
+    expect(enableMovieClipSignals(clip)).toBe(enableMovieClipSignals(clip));
+  });
+
+  it('works before setMovieClipSource is called', () => {
+    const clip = createMovieClip();
+    expect(() => enableMovieClipSignals(clip)).not.toThrow();
+    expect(enableMovieClipSignals(clip)).not.toBeNull();
+  });
+
+  it('emits onEnterFrame when the frame changes', () => {
+    const frames: number[] = [];
+    const clip = createMovieClip();
+    setMovieClipSource(clip, createTimelineSource({ totalFrames: 3, frameRate: null }));
+    const signals = enableMovieClipSignals(clip);
+    signals.onEnterFrame.emit = (event) => frames.push(event.frame);
+    playMovieClip(clip);
+    updateMovieClip(clip, 0); // frame 1
+    updateMovieClip(clip, 0); // frame 2
+    expect(frames).toContain(2);
+  });
+});
+
+describe('getMovieClipCurrentFrame', () => {
+  it('returns 1 when timeline is null', () => {
+    const clip = createMovieClip();
+    expect(getMovieClipCurrentFrame(clip)).toBe(1);
+  });
+
+  it('returns the timeline currentFrame', () => {
+    const clip = createMovieClip();
+    clip.data.timeline = createTimeline({ source: createTimelineSource({ totalFrames: 5 }), currentFrame: 3 });
+    expect(getMovieClipCurrentFrame(clip)).toBe(3);
+  });
+});
+
+describe('getMovieClipCurrentLabel', () => {
+  it('returns null when timeline is null', () => {
+    const clip = createMovieClip();
+    expect(getMovieClipCurrentLabel(clip)).toBeNull();
+  });
+
+  it('returns the label at the current frame', () => {
+    const clip = createMovieClip();
+    setMovieClipSource(
+      clip,
+      createTimelineSource({
+        totalFrames: 5,
+        labels: [
+          { name: 'idle', frame: 1 },
+          { name: 'run', frame: 3 },
+        ],
+      }),
+    );
+    gotoAndStopMovieClip(clip, 3);
+    expect(getMovieClipCurrentLabel(clip)?.name).toBe('run');
+  });
+});
+
+describe('getMovieClipFrameScript', () => {
+  it('returns null when timeline is null', () => {
+    const clip = createMovieClip();
+    expect(getMovieClipFrameScript(clip, 1)).toBeNull();
+  });
+
+  it('returns null when no script is attached', () => {
+    const clip = createMovieClip();
+    clip.data.timeline = createTimeline({ source: createTimelineSource({ totalFrames: 3 }) });
+    expect(getMovieClipFrameScript(clip, 1)).toBeNull();
+  });
+
+  it('returns the script after addMovieClipFrameScript', () => {
+    const clip = createMovieClip();
+    clip.data.timeline = createTimeline({ source: createTimelineSource({ totalFrames: 3 }) });
+    const fn = () => {};
+    addMovieClipFrameScript(clip, 2, fn);
+    expect(getMovieClipFrameScript(clip, 2)).toBe(fn);
+  });
+});
+
+describe('getMovieClipRuntime', () => {
+  it('returns the runtime for a MovieClip', () => {
+    expect(getMovieClipRuntime(createMovieClip())).not.toBeNull();
+  });
+});
+
+describe('getMovieClipSignals', () => {
+  it('returns null before enableMovieClipSignals is called', () => {
+    const clip = createMovieClip();
+    expect(getMovieClipSignals(clip)).toBeNull();
+  });
+
+  it('returns the signals group after enableMovieClipSignals', () => {
+    const clip = createMovieClip();
+    setMovieClipSource(clip, createTimelineSource({ totalFrames: 3 }));
+    const signals = enableMovieClipSignals(clip);
+    expect(getMovieClipSignals(clip)).toBe(signals);
+  });
+});
+
+describe('getMovieClipTotalFrames', () => {
+  it('returns 1 when timeline is null', () => {
+    const clip = createMovieClip();
+    expect(getMovieClipTotalFrames(clip)).toBe(1);
+  });
+
+  it('returns the timeline totalFrames', () => {
+    const clip = createMovieClip();
+    clip.data.timeline = createTimeline({ source: createTimelineSource({ totalFrames: 10 }) });
+    expect(getMovieClipTotalFrames(clip)).toBe(10);
+  });
+});
+
+describe('gotoAndPlayMovieClip', () => {
+  it('does nothing when timeline is null', () => {
+    const clip = createMovieClip();
+    expect(() => gotoAndPlayMovieClip(clip, 2)).not.toThrow();
+  });
+
+  it('seeks to the given frame and starts playing', () => {
+    const clip = createMovieClip();
+    clip.data.timeline = createTimeline({ source: createTimelineSource({ totalFrames: 5 }) });
+    gotoAndPlayMovieClip(clip, 3);
+    expect(clip.data.timeline.currentFrame).toBe(3);
+    expect(clip.data.timeline.isPlaying).toBe(true);
+  });
+});
+
+describe('gotoAndStopMovieClip', () => {
+  it('does nothing when timeline is null', () => {
+    const clip = createMovieClip();
+    expect(() => gotoAndStopMovieClip(clip, 2)).not.toThrow();
+  });
+
+  it('seeks to the given frame and stops', () => {
+    const clip = createMovieClip();
+    clip.data.timeline = createTimeline({ source: createTimelineSource({ totalFrames: 5 }) });
+    playMovieClip(clip);
+    gotoAndStopMovieClip(clip, 2);
+    expect(clip.data.timeline.currentFrame).toBe(2);
+    expect(clip.data.timeline.isPlaying).toBe(false);
+  });
+});
+
+describe('isMovieClipPlaying', () => {
+  it('returns false when timeline is null', () => {
+    const clip = createMovieClip();
+    expect(isMovieClipPlaying(clip)).toBe(false);
+  });
+
+  it('returns true when the timeline is playing', () => {
+    const clip = createMovieClip();
+    clip.data.timeline = createTimeline({ source: createTimelineSource({ totalFrames: 3 }) });
+    playTimeline(clip.data.timeline);
+    expect(isMovieClipPlaying(clip)).toBe(true);
+  });
+});
+
+describe('nextFrameMovieClip', () => {
+  it('does nothing when timeline is null', () => {
+    const clip = createMovieClip();
+    expect(() => nextFrameMovieClip(clip)).not.toThrow();
+  });
+
+  it('advances currentFrame by one', () => {
+    const clip = createMovieClip();
+    clip.data.timeline = createTimeline({ source: createTimelineSource({ totalFrames: 5 }), currentFrame: 2 });
+    nextFrameMovieClip(clip);
+    expect(clip.data.timeline.currentFrame).toBe(3);
+  });
+});
+
+describe('playMovieClip', () => {
+  it('does nothing when timeline is null', () => {
+    const clip = createMovieClip();
+    expect(() => playMovieClip(clip)).not.toThrow();
+  });
+
+  it('starts the timeline playing', () => {
+    const clip = createMovieClip();
+    clip.data.timeline = createTimeline({ source: createTimelineSource({ totalFrames: 3 }) });
+    playMovieClip(clip);
+    expect(clip.data.timeline.isPlaying).toBe(true);
+  });
+});
+
+describe('prevFrameMovieClip', () => {
+  it('does nothing when timeline is null', () => {
+    const clip = createMovieClip();
+    expect(() => prevFrameMovieClip(clip)).not.toThrow();
+  });
+
+  it('moves currentFrame back by one', () => {
+    const clip = createMovieClip();
+    clip.data.timeline = createTimeline({ source: createTimelineSource({ totalFrames: 5 }), currentFrame: 3 });
+    prevFrameMovieClip(clip);
+    expect(clip.data.timeline.currentFrame).toBe(2);
+  });
+});
+
+describe('removeMovieClipFrameScript', () => {
+  it('does nothing when timeline is null', () => {
+    const clip = createMovieClip();
+    expect(() => removeMovieClipFrameScript(clip, 1)).not.toThrow();
+  });
+
+  it('removes the script so it no longer fires', () => {
+    const fired: number[] = [];
+    const clip = createMovieClip();
+    clip.data.timeline = createTimeline({
+      source: createTimelineSource({ totalFrames: 3, frameRate: null }),
+      target: clip,
+    });
+    addMovieClipFrameScript(clip, 2, (_t, f) => fired.push(f));
+    removeMovieClipFrameScript(clip, 2);
+    playMovieClip(clip);
+    updateMovieClip(clip, 0); // frame 1
+    updateMovieClip(clip, 0); // frame 2 — script should not fire
+    expect(fired).toEqual([]);
+  });
+});
+
+describe('setMovieClipSource', () => {
+  it('binds a source, targets the clip, and realizes the initial frame', () => {
+    const frames: number[] = [];
+    const clip = createMovieClip();
+    setMovieClipSource(clip, createTimelineSource({ totalFrames: 4, constructFrame: (_t, f) => frames.push(f) }));
+    expect(getMovieClipTotalFrames(clip)).toBe(4);
+    expect(clip.data.timeline?.target).toBe(clip);
+    expect(frames).toEqual([1]);
+  });
+
+  it('reuses an existing timeline on the clip', () => {
+    const clip = createMovieClip();
+    clip.data.timeline = createTimeline({ currentFrame: 2 });
+    const existing = clip.data.timeline;
+    setMovieClipSource(clip, createTimelineSource({ totalFrames: 5 }));
+    expect(clip.data.timeline).toBe(existing);
+    expect(clip.data.timeline?.source?.totalFrames).toBe(5);
+  });
+});
+
+describe('stopMovieClip', () => {
+  it('does nothing when timeline is null', () => {
+    const clip = createMovieClip();
+    expect(() => stopMovieClip(clip)).not.toThrow();
+  });
+
+  it('stops a playing timeline', () => {
+    const clip = createMovieClip();
+    clip.data.timeline = createTimeline({ source: createTimelineSource({ totalFrames: 3 }) });
+    playMovieClip(clip);
+    stopMovieClip(clip);
+    expect(clip.data.timeline.isPlaying).toBe(false);
+  });
+});
+
+describe('updateMovieClip', () => {
+  it('does nothing when timeline is null', () => {
+    const clip = createMovieClip();
+    expect(() => updateMovieClip(clip, 16)).not.toThrow();
+  });
+
+  it('advances the timeline when playing', () => {
+    const frames: number[] = [];
+    const clip = createMovieClip();
+    clip.data.timeline = createTimeline({
+      source: createTimelineSource({ totalFrames: 3, frameRate: null, constructFrame: (_t, f) => frames.push(f) }),
+      target: clip,
+    });
+    playTimeline(clip.data.timeline);
+    updateMovieClip(clip, 16);
+    updateMovieClip(clip, 16);
+    expect(frames).toEqual([1, 2]);
+  });
+
+  it('fires constructFrame for frame 1 on first update even when stopped', () => {
+    const frames: number[] = [];
+    const clip = createMovieClip();
+    clip.data.timeline = createTimeline({
+      source: createTimelineSource({ totalFrames: 3, constructFrame: (_t, f) => frames.push(f) }),
+      target: clip,
+    });
+    updateMovieClip(clip, 0);
+    expect(frames).toEqual([1]);
+  });
+});

package/src/spritesheetTimelineSource.test.ts

@@ -0,0 +1,58 @@
+import { createDisplayContainer, getDisplayObjectRuntime } from '@flighthq/displayobject';
+import { createImageResource } from '@flighthq/image';
+import { createSpritesheet, createSpritesheetAnimation, createSpritesheetFrame } from '@flighthq/spritesheet';
+import { addTextureAtlasRegion, createTextureAtlas } from '@flighthq/textureatlas';
+import type { DisplayObject } from '@flighthq/types';
+
+import { createSpritesheetTimelineSource } from './spritesheetTimelineSource';
+
+function makeSheet(frameCount: number) {
+  const img = document.createElement('img') as HTMLImageElement;
+  const source = createImageResource(img);
+  source.width = 128;
+  source.height = 32;
+  const atlas = createTextureAtlas({ image: source });
+  const frames = [];
+  for (let i = 0; i < frameCount; i++) {
+    addTextureAtlasRegion(atlas, i * 32, 0, 32, 32);
+    frames.push(createSpritesheetFrame({ id: i }));
+  }
+  const sheet = createSpritesheet({ atlas });
+  sheet.frames = frames;
+  return sheet;
+}
+
+describe('createSpritesheetTimelineSource', () => {
+  it('reports totalFrames from the animation and frameRate from frameDuration', () => {
+    const sheet = makeSheet(3);
+    const anim = createSpritesheetAnimation({ frameDuration: 200, frames: [0, 1, 2] });
+
+    const source = createSpritesheetTimelineSource(sheet, anim);
+
+    expect(source.totalFrames).toBe(3);
+    expect(source.frameRate).toBeCloseTo(1000 / 200);
+  });
+
+  it('lazily creates one bitmap child on the target and shows the frame region', () => {
+    const sheet = makeSheet(2);
+    const anim = createSpritesheetAnimation({ frameDuration: 100, frames: [0, 1] });
+    const source = createSpritesheetTimelineSource(sheet, anim);
+    const target = createDisplayContainer();
+
+    source.constructFrame(target as DisplayObject, 1);
+    source.constructFrame(target as DisplayObject, 2);
+
+    const children = getDisplayObjectRuntime(target).children;
+    expect(children).not.toBeNull();
+    expect(children!.length).toBe(1); // reused across frames, not one-per-frame
+  });
+
+  it('does not throw when the spritesheet has no atlas', () => {
+    const sheet = createSpritesheet({ atlas: null });
+    sheet.frames = [];
+    const anim = createSpritesheetAnimation({ frameDuration: 100, frames: [0] });
+    const source = createSpritesheetTimelineSource(sheet, anim);
+
+    expect(() => source.constructFrame(createDisplayContainer() as DisplayObject, 1)).not.toThrow();
+  });
+});