@flighthq/timeline 0.1.0 → 0.2.0

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

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

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,11 @@
 {
   "name": "@flighthq/timeline",
-  "version": "0.1.0",
+  "version": "0.2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/timeline"
+  },
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -27,9 +32,8 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/displayobject": "0.1.0",
-    "@flighthq/signals": "0.1.0",
-    "@flighthq/types": "0.1.0"
+    "@flighthq/signals": "0.2.0",
+    "@flighthq/types": "0.2.0"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/dist/movieClip.d.ts

@@ -1,24 +0,0 @@
-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

@@ -1 +0,0 @@
-{"version":3,"file":"movieClip.d.ts","sourceRoot":"","sources":["../src/movieClip.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,cAAc,EACf,MAAM,iBAAiB,CAAC;AAsBzB,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

@@ -1,123 +0,0 @@
-import { createDisplayObjectGeneric, createDisplayObjectRuntime, getDisplayObjectRuntime, } from '@flighthq/displayobject';
-import { EntityRuntimeKey, MovieClipKind } from '@flighthq/types';
-import { addTimelineFrameScript, createTimeline, disposeTimelineSignals, enableTimelineSignals, getTimelineCurrentLabel, getTimelineFrameScript, gotoAndPlayTimeline, gotoAndStopTimeline, nextFrameTimeline, playTimeline, prevFrameTimeline, removeTimelineFrameScript, stopTimeline, updateTimeline, } from './timeline';
-// 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

@@ -1 +0,0 @@
-{"version":3,"file":"movieClip.js","sourceRoot":"","sources":["../src/movieClip.ts"],"names":[],"mappings":"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"}

package/src/movieClip.test.ts

@@ -1,430 +0,0 @@
-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';
-import { createTimeline, createTimelineSource, playTimeline } from './timeline';
-
-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]);
-  });
-});