@aura3d/engine 1.0.3 → 1.0.5

package/README.md

@@ -15,7 +15,30 @@ Use Aura3D when you are building browser 3D apps, prompt-authored scenes, produc
 
 ## Current release
 
-`@aura3d/engine@1.0.3` removes Three.js from the root engine runtime and npm dependency graph. The default Aura3D install now uses Aura-owned browser runtime code; Three.js migration support lives in the separately installed `@aura3d/three-compat` package.
+`@aura3d/engine@1.0.5` is the current release candidate for browser-native game routes, visible GLB animation runtime evidence, prompt-cartoon playback, AuraVoice timing packages, typed assets, diagnostics, screenshots, and readiness evidence. The root engine runtime remains free of Three.js imports; Three.js migration support lives in the separately installed `@aura3d/three-compat` package.
+
+Registry status before publish: npm `latest` still points at `@aura3d/engine@1.0.3`, and `@aura3d/cli` / `create-aura3d` must be published before the `npx ...@latest` commands below work for external users. Do not claim the 1.0.5 release is live until registry verification passes.
+
+## Aura3D 1.0.5 asset catalog
+
+Aura3D 1.0.5 includes the catalog-first asset workflow for AI coding agents. When a prompt names a real object, agents should search the hosted Aura3D catalog before writing scene code:
+
+```bash
+npx @aura3d/cli@latest assets search "battle-worn knight helmet"
+npx @aura3d/cli@latest assets resolve "battle-worn knight helmet" --name helmet
+```
+
+The resolver pulls only verified auto-pullable candidates into the existing typed asset pipeline, then scene code uses `model(assets.helmet)`. Unverified or marketplace candidates stay as deep-links until the user approves and supplies the asset.
+## Aura3D 1.0.5 runtime launch track
+
+Aura3D 1.0.5 is the active runtime and animation evidence foundation for the next public showcase wave:
+
+- `game runtime`: mutable runtime nodes, app-owned frame loops, input, kinematic bodies, hitboxes, combat events, camera direction, effects, and evidence for browser-native game routes.
+- `fighting-game template`: `npx create-aura3d@latest my-fighter --template fighting-game` scaffolds a public-API playable starter using typed assets, `app.input(...)`, `app.onFrame(...)`, `game.kinematicBody(...)`, `game.combatWorld(...)`, and `app.evidence(...)`.
+- `prompt animation`: `npx create-aura3d@latest my-episode --template prompt-cartoon-channel` scaffolds structured episode plans, storyboards, shot timelines, captions, visemes, render queues, and evidence for prompt-authored cartoon/video workflows. The shorter `cartoon-channel` template name remains supported.
+- `AuraVoice bridge`: AuraVoice owns script/audio/caption/viseme timing; Aura3D owns typed scene generation, character performance, camera choreography, rendering, screenshots, and visual evidence.
+
+Aura Clash requires Aura3D 1.0.5 runtime and animation evidence before it should be marketed as a polished public game showcase. Until the runtime, screenshot, route, GLB, package-smoke, and visual approval gates pass, Aura Clash remains a development showcase proving the direction of the public API.
 
 ## Install
 
@@ -58,20 +81,18 @@ import { createAuraApp, sceneKits } from "@aura3d/engine";
 
 ## Flagship game showcase
 
-World War X is Aura3D's production game proof: an original satirical 1v1 browser arena fighter built with `@aura3d/engine`.
+AuraClash is the active Aura3D game-runtime proof target: an original 1v1 browser arena fighter built with `@aura3d/engine` public APIs.
 
 The showcase includes:
 
-- a 10-fighter G7+India+Russia+China roster;
-- generated fighter GLB assets;
+- typed or validated stylized fighter assets;
 - typed asset members from `src/aura-assets.ts`;
 - `model(assets.x)` runtime usage;
 - arena primitives, lighting, effects, camera composition, and material polish;
-- arcade movement, hitboxes, projectiles, guard state, meter, AI pressure, and results;
-- Summit Remix prompt presets;
+- arcade movement, hitboxes, guard state, meter, AI pressure, and results;
 - evidence routes, accessibility settings, poster capture, Playwright contracts, sitemap and robots integration, and marketing homepage placement.
 
-Open the route at `apps/world-war-x-showcase/`.
+Open the source route at `apps/aura-clash-showcase/`.
 
 ## 30-second product viewer
 
@@ -89,6 +110,269 @@ createAuraApp("#app", {
 
 The safe API uses generated refs such as `assets.robot`. Do not write `model("robot")`, hand-written GLB URLs, or invented asset ids.
 
+## Aura3D 1.0.5 game runtime example
+
+Add typed assets before writing model code:
+
+```bash
+npx @aura3d/cli@latest assets add ./assets/fighter.glb --name fighter
+npx @aura3d/cli@latest assets add ./assets/opponent.glb --name opponent
+```
+
+Then use the public game facade and stage builders:
+
+```ts
+import {
+  AnimationController,
+  createAuraApp,
+  game,
+  games,
+  lights,
+  model,
+  scene
+} from "@aura3d/engine";
+import { assets } from "./aura-assets";
+
+const stage = games.fighting.stagePreset("neon-dojo");
+const stageIssues = games.fighting.validateStage(stage);
+
+const fighting = game.fighting({
+  playerId: "player",
+  opponentId: "opponent",
+  stage: { width: stage.combatBounds.maxX - stage.combatBounds.minX },
+  autoListen: true
+});
+
+const app = createAuraApp("#app", {
+  scene: stage.nodes
+    .reduce((builder, node) => builder.add(node), scene())
+    .add(model(assets.fighter).runtime(game.runtimeNode("player", { tags: ["fighter", "local"] })))
+    .add(model(assets.opponent).runtime(game.runtimeNode("opponent", { tags: ["fighter", "ai"] })))
+    .add(lights.studio())
+});
+
+const player = app.nodes.require("player");
+const opponent = app.nodes.require("opponent");
+const animation = new AnimationController({
+  clipRegistry: assets.fighter,
+  requiredClips: ["Idle", "Walk", "LightPunch"],
+  suppressRootMotion: true
+});
+
+const touchLayout = game.touchControls({
+  width: window.innerWidth,
+  height: window.innerHeight,
+  buttons: [
+    { action: "jump", label: "Jump", binding: "TouchJump" },
+    { action: "light", label: "Light", binding: "TouchLight" }
+  ]
+});
+
+const jumpAssist = game.jumpAssist({ coyoteMs: 100, bufferMs: 120 });
+const hud = game.hud.bindings([
+  game.hud.health({ actorId: "player", label: "Player health" }),
+  game.hud.health({ actorId: "opponent", label: "Opponent health" }),
+  game.hud.timer({ valuePath: "round.timeRemaining" }),
+  game.hud.debugToggle({ action: "debug", statePath: "debug.visible" })
+]);
+const accessibility = [
+  game.accessibility.label({ targetId: "player-health", label: "Player health", live: true }),
+  game.accessibility.pauseControls({ actions: ["pause", "Escape"], resumeActions: ["pause", "Enter"], menuId: "pause-menu" })
+];
+
+app.onFrame(({ dt }) => {
+  const snapshot = fighting.update(dt);
+  animation.update(dt);
+
+  jumpAssist.update(dt, {
+    grounded: fighting.bodies.player.grounded,
+    jumpPressed: fighting.input.pressed("jump")
+  });
+  if (jumpAssist.consume()) fighting.bodies.player.jump();
+
+  if (fighting.input.pressed("light")) {
+    animation.crossFade("LightPunch", 0.08, { restart: true });
+  }
+
+  player.setPosition(snapshot.player.position[0], snapshot.player.position[1], snapshot.player.position[2]);
+  opponent.setPosition(snapshot.opponent.position[0], snapshot.opponent.position[1], snapshot.opponent.position[2]);
+});
+
+const replayPlan = game.inputReplay(fighting.input.recorded(), { fps: 60, label: "round-1" });
+const replayInput = game.input({
+  actions: fighting.controls.actions,
+  axes: fighting.controls.axes,
+  autoListen: false
+});
+const replayDriver = game.inputReplayDriver(replayInput, replayPlan);
+
+const colliders = [
+  game.collider.capsule({ id: "player-body", center: fighting.bodies.player.position, radius: 0.34, height: 1.7 }),
+  game.collider.capsule({ id: "opponent-body", center: fighting.bodies.opponent.position, radius: 0.34, height: 1.7 })
+];
+const overlay = game.debug.overlay({
+  runtime: app.runtime,
+  input: fighting.input,
+  bodies: [fighting.bodies.player, fighting.bodies.opponent],
+  combat: fighting.combat,
+  effects: fighting.effects,
+  camera: fighting.camera,
+  colliders,
+  warnings: stageIssues.map((issue) => issue.message)
+});
+
+const evidence = app.evidence({
+  input: fighting.input,
+  bodies: [fighting.bodies.player, fighting.bodies.opponent],
+  combat: fighting.combat,
+  effects: fighting.effects,
+  camera: fighting.camera,
+  hud,
+  accessibility,
+  stage: { id: stage.id, safeZones: true, bounds: stage.combatBounds, warnings: stageIssues.map((issue) => issue.message) }
+});
+
+console.log(touchLayout.controls.length, replayDriver.snapshot(), overlay.sections, evidence.systems);
+```
+
+## Aura3D 1.0.5 prompt-cartoon and AuraVoice example
+
+Prompt-cartoon routes use typed assets, contract artifacts, shot playback, captions, visemes, and AuraVoice timing packages.
+
+```ts
+import {
+  collectPromptAnimationEvidence,
+  compilePromptEpisodePlan,
+  createAudioStemManifest,
+  createAuraApp,
+  createAuraVoiceBridgePackage,
+  createAuraVoiceVisemeTrack,
+  createCartoonRenderOutputPackageMetadata,
+  createGlbBlendshapeVisemeCue,
+  createPrimitiveMouthVisemeCues,
+  createShotPlaybackPlan,
+  evaluatePromptAnimationPublishReadiness,
+  game,
+  installShotPlayback,
+  lights,
+  model,
+  scene,
+  sampleAuraVoiceBridgeAtTime,
+  validateAuraVoiceBridgePackage
+} from "@aura3d/engine";
+import { assets } from "./aura-assets";
+
+const plan = compilePromptEpisodePlan({
+  episodeId: "moon-garden",
+  title: "Moon Garden Helpers",
+  prompt: "Two robots clean a glowing moon garden.",
+  language: "en",
+  runtime: { duration: 30, frameRate: 30, resolution: { width: 1280, height: 720 }, maxTimingDriftFrames: 1 },
+  characters: [
+    { id: "miko", name: "Miko", role: "hero", asset: assets.miko },
+    { id: "luma", name: "Luma", role: "sidekick", asset: assets.luma }
+  ],
+  locations: [{ id: "moon-garden", name: "Moon Garden", mood: "soft neon bedtime" }],
+  beats: [
+    {
+      id: "beat-001",
+      locationId: "moon-garden",
+      summary: "Miko and Luma clean the glowing weeds.",
+      visualIntent: "Two readable typed characters, safe captions, and gentle light.",
+      duration: 8,
+      characters: ["miko", "luma"],
+      dialogue: [{ speakerId: "miko", text: "The moon garden is glowing again.", emotion: "curious" }]
+    }
+  ],
+  route: "/episodes/moon-garden"
+});
+
+const visemes = createAuraVoiceVisemeTrack({
+  episodeId: plan.episodePlan.episodeId,
+  language: plan.episodePlan.language,
+  frameRate: plan.shotTimeline.frameRate,
+  cues: plan.dialogueTrack.lines.flatMap((line) =>
+    createPrimitiveMouthVisemeCues({
+      characterId: line.speakerId,
+      speakerId: line.speakerId,
+      lineId: line.lineId,
+      startTime: line.startTime,
+      endTime: line.endTime
+    }).map((cue) => createGlbBlendshapeVisemeCue(cue))
+  )
+});
+
+const audioStems = createAudioStemManifest({
+  episodeId: plan.episodePlan.episodeId,
+  duration: plan.dialogueTrack.duration,
+  stems: plan.dialogueTrack.lines.map((line) => ({
+    id: `audio:${line.lineId}`,
+    role: "dialogue",
+    path: line.audioFile ?? `assets/audio/${line.language}/${line.lineId}.wav`,
+    startTime: line.startTime,
+    duration: line.endTime - line.startTime,
+    language: line.language
+  }))
+});
+
+const renderOutputPackage = createCartoonRenderOutputPackageMetadata({
+  episodePlan: plan.episodePlan,
+  shotTimeline: plan.shotTimeline,
+  renderQueue: plan.renderQueue
+});
+
+const bridge = createAuraVoiceBridgePackage({
+  episodePlan: plan.episodePlan,
+  storyboard: plan.storyboard,
+  shotTimeline: plan.shotTimeline,
+  dialogueTrack: plan.dialogueTrack,
+  captionTrack: plan.captionTrack,
+  visemes,
+  audioStems,
+  renderQueue: plan.renderQueue,
+  renderOutputPackage
+});
+const bridgeIssues = validateAuraVoiceBridgePackage(bridge);
+
+const playback = createShotPlaybackPlan({
+  timeline: plan.shotTimeline,
+  performance: plan.performance,
+  captions: plan.captionTrack,
+  visemes,
+  runtimeNodeByCharacterId: { miko: "miko", luma: "luma" },
+  loop: true
+});
+
+const app = createAuraApp("#app", {
+  scene: scene()
+    .add(model(assets.miko).runtime(game.runtimeNode("miko", { tags: ["character"] })))
+    .add(model(assets.luma).runtime(game.runtimeNode("luma", { tags: ["character"] })))
+    .add(lights.studio())
+});
+installShotPlayback(app, playback);
+
+const sample = sampleAuraVoiceBridgeAtTime(bridge, 3);
+const evidence = collectPromptAnimationEvidence({
+  bridgePackage: bridge,
+  screenshots: [
+    {
+      id: "shot-001",
+      time: sample.time,
+      path: "artifacts/screenshots/shot-001.png",
+      hash: "sha256:replace-with-rendered-screenshot-hash",
+      width: 1280,
+      height: 720
+    }
+  ],
+  routeHealth: { status: "pass" }
+});
+const readiness = evaluatePromptAnimationPublishReadiness(evidence);
+
+console.log(bridgeIssues, evidence.publishReady, readiness.ready);
+```
+
+Do not publish placeholder screenshot hashes. Deterministic render output must replace the placeholder before a prompt-cartoon or AuraVoice route is called publish-ready.
+
 ## Prompt-to-3D scene kits
 
 Use scene kits when an AI prompt asks for generated 3D systems rather than a supplied model.
@@ -143,6 +427,24 @@ pnpm run check:release
 
 Use release checks to confirm package integrity, generated assets, examples, and static deployment output before shipping.
 
+Aura3D 1.0.5 route-specific readiness commands:
+
+```bash
+npx @aura3d/cli@latest assets validate-game
+npx @aura3d/cli@latest assets validate-cartoon
+npx @aura3d/cli@latest check-deploy --dist dist
+pnpm game-runtime:docs
+pnpm game-runtime:template
+pnpm game-runtime:package
+pnpm game-runtime:release
+pnpm prompt-animation:docs
+pnpm prompt-animation:template
+pnpm prompt-animation:package
+pnpm prompt-animation:release
+```
+
+Do not mark a game, prompt-cartoon, or AuraVoice route launch-ready from source evidence alone. Asset readiness, package smoke, browser route health, deterministic screenshots, visual review, accessibility proof, and deployment checks must also pass.
+
 ## Contributing
 
 Star the repo if you want AI-native browser 3D tooling for TypeScript, WebGL, WebGPU, GLB/glTF assets, product viewers, prompt-to-3D scenes, and deployable 3D websites. Open issues with the prompt, package version, asset source or license, commands run, route-health output, screenshots, and deploy context.

package/dist/animation/AnimationClipEvents.d.ts

@@ -0,0 +1,57 @@
+export type AnimationPlaybackDirection = 1 | -1;
+export type AnimationClipEventType = "marker" | "hitbox" | "hurtbox" | "footstep" | "sfx" | "vfx" | "camera" | "state" | "custom" | (string & {});
+export interface AnimationClipEvent<TName extends string = string, TPayload = unknown> {
+    readonly id?: string;
+    readonly name: TName;
+    readonly type?: AnimationClipEventType;
+    readonly time: number;
+    readonly duration?: number;
+    readonly payload?: TPayload;
+    readonly once?: boolean;
+    readonly tags?: readonly string[];
+}
+export interface AnimationClipEventSource<TEvent extends AnimationClipEvent = AnimationClipEvent> {
+    readonly id: string;
+    readonly duration: number;
+    readonly events?: readonly TEvent[];
+}
+export interface AnimationClipEventSamplingOptions {
+    readonly from: number;
+    readonly to: number;
+    readonly duration?: number;
+    readonly loop?: boolean;
+    readonly direction?: AnimationPlaybackDirection;
+    readonly includeStart?: boolean;
+    readonly includeEnd?: boolean;
+    readonly loopCount?: number;
+    readonly playbackTime?: number;
+}
+export interface AnimationClipEventInvocation<TEvent extends AnimationClipEvent = AnimationClipEvent, TClipId extends string = string> {
+    readonly clipId: TClipId;
+    readonly event: TEvent;
+    readonly time: number;
+    readonly previousTime: number;
+    readonly localTime: number;
+    readonly normalizedTime: number;
+    readonly loopCount: number;
+    readonly direction: AnimationPlaybackDirection;
+    readonly playbackTime?: number;
+}
+export type AnimationClipEventListener<TPayload> = (payload: TPayload) => void;
+export type AnimationClipEventUnsubscribe = () => void;
+export declare class AnimationEventDispatcher<TEventMap = Record<string, unknown>> {
+    private readonly listeners;
+    on<K extends Extract<keyof TEventMap, string>>(type: K, listener: AnimationClipEventListener<TEventMap[K]>): AnimationClipEventUnsubscribe;
+    once<K extends Extract<keyof TEventMap, string>>(type: K, listener: AnimationClipEventListener<TEventMap[K]>): AnimationClipEventUnsubscribe;
+    off<K extends Extract<keyof TEventMap, string>>(type: K, listener: AnimationClipEventListener<TEventMap[K]>): void;
+    emit<K extends Extract<keyof TEventMap, string>>(type: K, payload: TEventMap[K]): void;
+    clear(type?: Extract<keyof TEventMap, string>): void;
+    listenerCount(type?: Extract<keyof TEventMap, string>): number;
+}
+export declare function createAnimationClipEvent<TName extends string, TPayload = unknown>(name: TName, time: number, options?: Omit<AnimationClipEvent<TName, TPayload>, "name" | "time">): AnimationClipEvent<TName, TPayload>;
+export declare function normalizeClipEvents<TEvent extends AnimationClipEvent>(events?: readonly TEvent[]): readonly TEvent[];
+export declare function animationClipEventKey(clipId: string, event: AnimationClipEvent): string;
+export declare function sampleClipEvents<TEvent extends AnimationClipEvent, TClipId extends string = string>(source: AnimationClipEventSource<TEvent> & {
+    readonly id: TClipId;
+}, options: AnimationClipEventSamplingOptions): AnimationClipEventInvocation<TEvent, TClipId>[];
+//# sourceMappingURL=AnimationClipEvents.d.ts.map

package/dist/animation/AnimationClipEvents.d.ts.map

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

package/dist/animation/AnimationClipEvents.js

@@ -0,0 +1,171 @@
+export class AnimationEventDispatcher {
+    listeners = new Map();
+    on(type, listener) {
+        const listeners = this.listeners.get(type) ?? new Set();
+        listeners.add(listener);
+        this.listeners.set(type, listeners);
+        return () => {
+            this.off(type, listener);
+        };
+    }
+    once(type, listener) {
+        const unsubscribe = this.on(type, (payload) => {
+            unsubscribe();
+            listener(payload);
+        });
+        return unsubscribe;
+    }
+    off(type, listener) {
+        const listeners = this.listeners.get(type);
+        if (!listeners)
+            return;
+        listeners.delete(listener);
+        if (listeners.size === 0) {
+            this.listeners.delete(type);
+        }
+    }
+    emit(type, payload) {
+        const listeners = this.listeners.get(type);
+        if (!listeners)
+            return;
+        for (const listener of [...listeners]) {
+            listener(payload);
+        }
+    }
+    clear(type) {
+        if (type) {
+            this.listeners.delete(type);
+            return;
+        }
+        this.listeners.clear();
+    }
+    listenerCount(type) {
+        if (type) {
+            return this.listeners.get(type)?.size ?? 0;
+        }
+        let count = 0;
+        for (const listeners of this.listeners.values()) {
+            count += listeners.size;
+        }
+        return count;
+    }
+}
+export function createAnimationClipEvent(name, time, options = {}) {
+    return {
+        ...options,
+        name,
+        time
+    };
+}
+export function normalizeClipEvents(events = []) {
+    return [...events].sort((a, b) => {
+        if (a.time !== b.time)
+            return a.time - b.time;
+        return a.name.localeCompare(b.name);
+    });
+}
+export function animationClipEventKey(clipId, event) {
+    return `${clipId}:${event.id ?? event.name}:${event.type ?? "marker"}:${event.time}`;
+}
+export function sampleClipEvents(source, options) {
+    const events = normalizeClipEvents(source.events);
+    if (events.length === 0)
+        return [];
+    const duration = sanitizeDuration(options.duration ?? source.duration);
+    const direction = options.direction ?? (options.to >= options.from ? 1 : -1);
+    const includeStart = options.includeStart ?? false;
+    const includeEnd = options.includeEnd ?? true;
+    const loopCount = options.loopCount ?? 0;
+    const playbackTime = options.playbackTime;
+    if (duration === 0) {
+        return events
+            .filter((event) => event.time === 0 && includesBoundary(includeStart, includeEnd))
+            .map((event) => createInvocation(source.id, event, options.from, 0, duration, loopCount, direction, playbackTime));
+    }
+    const from = normalizeLocalTime(options.from, duration, options.loop ?? false);
+    const to = normalizeLocalTime(options.to, duration, options.loop ?? false);
+    const segments = createSamplingSegments(from, to, duration, options.loop ?? false, direction);
+    const invocations = [];
+    for (let segmentIndex = 0; segmentIndex < segments.length; segmentIndex += 1) {
+        const segment = segments[segmentIndex];
+        const segmentIncludeStart = segmentIndex === 0 ? includeStart : true;
+        const segmentIncludeEnd = segmentIndex === segments.length - 1 ? includeEnd : true;
+        const matching = events.filter((event) => eventInSegment(event.time, segment.start, segment.end, segmentIncludeStart, segmentIncludeEnd));
+        if (direction === -1) {
+            matching.reverse();
+        }
+        for (const event of matching) {
+            invocations.push(createInvocation(source.id, event, options.from, event.time, duration, loopCount + segment.loopOffset, direction, playbackTime));
+        }
+    }
+    return invocations;
+}
+function createSamplingSegments(from, to, duration, loop, direction) {
+    if (!loop) {
+        return [
+            {
+                start: Math.min(from, to),
+                end: Math.max(from, to),
+                loopOffset: 0
+            }
+        ];
+    }
+    if (direction === 1) {
+        if (to >= from) {
+            return [{ start: from, end: to, loopOffset: 0 }];
+        }
+        return [
+            { start: from, end: duration, loopOffset: 0 },
+            { start: 0, end: to, loopOffset: 1 }
+        ];
+    }
+    if (to <= from) {
+        return [{ start: to, end: from, loopOffset: 0 }];
+    }
+    return [
+        { start: 0, end: from, loopOffset: 0 },
+        { start: to, end: duration, loopOffset: 1 }
+    ];
+}
+function createInvocation(clipId, event, previousTime, localTime, duration, loopCount, direction, playbackTime) {
+    return {
+        clipId,
+        event,
+        time: event.time,
+        previousTime,
+        localTime,
+        normalizedTime: duration > 0 ? event.time / duration : 0,
+        loopCount,
+        direction,
+        playbackTime
+    };
+}
+function eventInSegment(time, start, end, includeStart, includeEnd) {
+    const startsAfter = includeStart ? time >= start : time > start;
+    const endsBefore = includeEnd ? time <= end : time < end;
+    return startsAfter && endsBefore;
+}
+function includesBoundary(includeStart, includeEnd) {
+    return includeStart || includeEnd;
+}
+function normalizeLocalTime(time, duration, loop) {
+    if (!Number.isFinite(time))
+        return 0;
+    if (!loop)
+        return clamp(time, 0, duration);
+    return positiveModulo(time, duration);
+}
+function sanitizeDuration(duration) {
+    if (!Number.isFinite(duration) || duration <= 0)
+        return 0;
+    return duration;
+}
+function positiveModulo(value, divisor) {
+    if (divisor <= 0)
+        return 0;
+    return ((value % divisor) + divisor) % divisor;
+}
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+//# sourceMappingURL=AnimationClipEvents.js.map

package/dist/animation/AnimationClipEvents.js.map

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