@aura3d/engine 1.1.0 → 1.3.1

package/dist/engine/animation-studio/episode-document.js

@@ -0,0 +1,143 @@
+/**
+ * episode-document.ts — the Episode Document schema + deterministic sampling.
+ *
+ * This is the data-driven contract that makes the animation renderer GENERIC: every
+ * scene-specific decision that used to be a constant in `render-live-route.ts`
+ * (blocking marks, camera framing, the clip per shot, prop layout, the dim→sparkle
+ * world-state, even the primitive set + lights) is now DATA in an EpisodeDocument.
+ * The generic player (`scene-player.ts`) reads this document and renders it; it
+ * contains no scene-specific constants. A Director GENERATES documents
+ * from a prompt; the same player plays them.
+ *
+ * Placement note: this lives in the template for fast iteration (no engine dist
+ * rebuild). The design doc promotes these contracts into
+ * `packages/engine/src/animation-studio/*` once stable.
+ */
+// ---------------------------------------------------------------------------
+// Deterministic sampling — the generic player calls only these.
+// ---------------------------------------------------------------------------
+function clamp01(x) {
+    return x < 0 ? 0 : x > 1 ? 1 : x;
+}
+/** Smoothstep eased 0..1 (matches the original setGardenGlow curve). */
+function smoothstep(x) {
+    const t = clamp01(x);
+    return t * t * (3 - 2 * t);
+}
+/** The shot on screen at episode time `t`. */
+export function shotAtTime(doc, t) {
+    let chosen = doc.shots[0];
+    for (const shot of doc.shots) {
+        if (t >= shot.startTime)
+            chosen = shot;
+    }
+    return chosen;
+}
+/**
+ * Sample a character's blocking at episode time `t`: find the active shot's blocking,
+ * then lerp position/yaw across its waypoints by time. Single-waypoint beats hold a
+ * static mark (the original staging behaviour); multi-waypoint beats traverse.
+ */
+export function sampleBlocking(doc, characterId, t, fallback) {
+    const shot = shotAtTime(doc, t);
+    const charBlocking = doc.blocking.find((b) => b.characterId === characterId);
+    const beat = charBlocking?.shots.find((s) => s.shotId === shot.shotId);
+    if (!beat || beat.waypoints.length === 0) {
+        return { position: fallback.position, yaw: fallback.yaw, clip: fallback.clip, sweeping: false, moving: false };
+    }
+    const wps = beat.waypoints;
+    if (wps.length === 1) {
+        return { position: wps[0].position, yaw: wps[0].yaw, clip: beat.clip, sweeping: Boolean(beat.sweeping), moving: false };
+    }
+    // Find the waypoint segment containing t.
+    let a = wps[0];
+    let b = wps[wps.length - 1];
+    for (let i = 0; i < wps.length - 1; i += 1) {
+        if (t >= wps[i].time && t <= wps[i + 1].time) {
+            a = wps[i];
+            b = wps[i + 1];
+            break;
+        }
+    }
+    const span = Math.max(1e-3, b.time - a.time);
+    const f = clamp01((t - a.time) / span);
+    const lerp = (x, y) => x + (y - x) * f;
+    const moved = Math.hypot(b.position[0] - a.position[0], b.position[2] - a.position[2]) > 0.02 && f > 0 && f < 1;
+    return {
+        position: [lerp(a.position[0], b.position[0]), lerp(a.position[1], b.position[1]), lerp(a.position[2], b.position[2])],
+        yaw: lerp(a.yaw, b.yaw),
+        clip: beat.clip,
+        sweeping: Boolean(beat.sweeping),
+        moving: moved
+    };
+}
+/** Eased dim→sparkle world-state at episode time `t` (0 = dim, 1 = full twinkle). */
+export function sampleWorldStateGlow(doc, t) {
+    return smoothstep(t / Math.max(1e-3, doc.worldState.glowSpanSeconds));
+}
+/** The active caption at episode time `t`, from the document's dialogue. */
+export function sampleCaption(doc, t) {
+    const line = doc.dialogue?.lines.find((l) => t >= l.startTime && t < l.endTime);
+    return line ? { text: line.text, speakerId: line.speakerId, lineId: line.lineId } : { text: "", speakerId: "", lineId: "" };
+}
+/**
+ * Lip-sync mouth-openness for `speakerId` at `t`, derived deterministically from the
+ * document's dialogue (a speaking mouth pulse). Drives the GLB mouth morph for rigs that
+ * have one; 0 when the speaker isn't talking. (The full per-phoneme viseme track is
+ * AuraVoice's; this is the engine-side fallback driver.)
+ */
+export function sampleVisemeOpenness(doc, t, speakerId) {
+    const line = doc.dialogue?.lines.find((l) => l.speakerId === speakerId && t >= l.startTime && t < l.endTime);
+    if (!line)
+        return { mouthOpenness: 0, visemeId: "sil" };
+    const open = Math.max(0, 0.5 + 0.32 * Math.sin((t - line.startTime) * 9));
+    return { mouthOpenness: open, visemeId: open > 0.4 ? "ah" : "m" };
+}
+export function validateEpisodeDocumentShape(doc) {
+    const errors = [];
+    if (doc.duration <= 0)
+        errors.push("duration must be > 0");
+    if (doc.shots.length === 0)
+        errors.push("at least one shot is required");
+    if (doc.assets.characters.length === 0)
+        errors.push("at least one character is required");
+    // Shots cover the timeline contiguously from 0.
+    const sorted = [...doc.shots].sort((x, y) => x.startTime - y.startTime);
+    if (sorted[0] && sorted[0].startTime !== 0)
+        errors.push("shots must start at t=0");
+    for (let i = 0; i < sorted.length - 1; i += 1) {
+        if (Math.abs(sorted[i].endTime - sorted[i + 1].startTime) > 1e-6) {
+            errors.push(`shot gap/overlap between ${sorted[i].shotId} and ${sorted[i + 1].shotId}`);
+        }
+    }
+    // Blocking references real characters/shots.
+    const charIds = new Set(doc.assets.characters.map((c) => c.id));
+    const shotIds = new Set(doc.shots.map((s) => s.shotId));
+    for (const b of doc.blocking) {
+        if (!charIds.has(b.characterId))
+            errors.push(`blocking references unknown character ${b.characterId}`);
+        for (const s of b.shots)
+            if (!shotIds.has(s.shotId))
+                errors.push(`blocking references unknown shot ${s.shotId}`);
+    }
+    // Set dressing references real props.
+    const propIds = new Set(doc.assets.props.map((p) => p.id));
+    for (const d of doc.setDressing) {
+        if (!propIds.has(d.propId))
+            errors.push(`set dressing references unknown prop ${d.propId}`);
+    }
+    return { ok: errors.length === 0, errors };
+}
+/** One-line-per-fact summary of a document (for CLI output / agent grounding). */
+export function summarizeDocument(doc) {
+    return [
+        `id=${doc.id} duration=${doc.duration}s`,
+        `cast: ${doc.assets.characters.map((c) => c.id).join(", ")}`,
+        `shots: ${doc.shots.map((s) => `${s.shotId}[${s.startTime}-${s.endTime}] ${s.presetId}`).join(", ")}`,
+        `props placed: ${doc.setDressing.length}`,
+        doc.walkableBounds
+            ? `walkable: x[${doc.walkableBounds.min[0]}..${doc.walkableBounds.max[0]}] z[${doc.walkableBounds.min[2]}..${doc.walkableBounds.max[2]}]`
+            : "walkable: (unbounded)"
+    ].join("\n");
+}
+//# sourceMappingURL=episode-document.js.map

package/dist/engine/animation-studio/episode-document.js.map

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

package/dist/engine/animation-studio/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @aura3d/engine/animation-studio — the PROMOTED canonical home of the Animation Studio
+ * generative core (#10). The schema (EpisodeDocument), the deterministic Director
+ * heuristics, the coherence Validator, and the pure Scene-Tool transforms now ship as a
+ * first-class engine module so any consumer — not just the template — can generate, edit,
+ * and validate episode documents programmatically.
+ *
+ * The animation-studio TEMPLATE keeps local mirrors of these files because its render path
+ * (scene-player.ts in the browser) resolves them through Vite's dist alias; the engine
+ * module is the library API. Both share identical logic.
+ *
+ * Note: this module is PURE (schema + heuristics + validation + transforms). It does NOT
+ * include the browser renderer (scene-player) or the headless capture scripts — those
+ * stay in the template/run surface.
+ */
+export * from "./episode-document";
+export * from "./animation-episode-validator";
+export * from "./director-heuristics";
+export * from "./scene-tools";
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/animation-studio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/animation-studio/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC"}

package/dist/engine/animation-studio/index.js

@@ -0,0 +1,20 @@
+/**
+ * @aura3d/engine/animation-studio — the PROMOTED canonical home of the Animation Studio
+ * generative core (#10). The schema (EpisodeDocument), the deterministic Director
+ * heuristics, the coherence Validator, and the pure Scene-Tool transforms now ship as a
+ * first-class engine module so any consumer — not just the template — can generate, edit,
+ * and validate episode documents programmatically.
+ *
+ * The animation-studio TEMPLATE keeps local mirrors of these files because its render path
+ * (scene-player.ts in the browser) resolves them through Vite's dist alias; the engine
+ * module is the library API. Both share identical logic.
+ *
+ * Note: this module is PURE (schema + heuristics + validation + transforms). It does NOT
+ * include the browser renderer (scene-player) or the headless capture scripts — those
+ * stay in the template/run surface.
+ */
+export * from "./episode-document.js";
+export * from "./animation-episode-validator.js";
+export * from "./director-heuristics.js";
+export * from "./scene-tools.js";
+//# sourceMappingURL=index.js.map

package/dist/engine/animation-studio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/engine/src/animation-studio/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC"}

package/dist/engine/animation-studio/scene-tools.d.ts

@@ -0,0 +1,34 @@
+/**
+ * scene-tools.ts — pure EpisodeDocument transforms.
+ *
+ * Each function returns a NEW document; the store validates + commits (or rejects). The
+ * agent never edits raw code — only these typed, validated edits.
+ */
+import type { CameraPresetId } from "../agent-api/CameraPresetLibrary";
+import type { BlockingWaypoint, DialogueLine, EpisodeDocument, PropPlacement, Vec3 } from "./episode-document";
+/** Append a shot (given a duration); the timeline re-contiguizes. */
+export declare function addShot(doc: EpisodeDocument, shotId: string, presetId: CameraPresetId, duration: number, cameraSubject: Vec3): EpisodeDocument;
+/** Remove a shot; the timeline closes up. */
+export declare function removeShot(doc: EpisodeDocument, shotId: string): EpisodeDocument;
+/** Change a shot's duration; following shots shift to stay contiguous. */
+export declare function retimeShot(doc: EpisodeDocument, shotId: string, duration: number): EpisodeDocument;
+/** Set a character's blocking waypoints (and optionally clip) for a shot. */
+export declare function setBlocking(doc: EpisodeDocument, characterId: string, shotId: string, waypoints: readonly BlockingWaypoint[], clip?: string): EpisodeDocument;
+/** Schedule a clip/gesture for a character in a shot (keeps the existing waypoints). */
+export declare function setGesture(doc: EpisodeDocument, characterId: string, shotId: string, clip: string): EpisodeDocument;
+/** Set a shot's camera framing (preset and/or subject). */
+export declare function setCamera(doc: EpisodeDocument, shotId: string, opts: {
+    preset?: CameraPresetId;
+    subject?: Vec3;
+}): EpisodeDocument;
+/** Add a prop instance to the set dressing. */
+export declare function placeProp(doc: EpisodeDocument, placement: PropPlacement): EpisodeDocument;
+/** Clear set dressing (all, or just one prop type). */
+export declare function clearProps(doc: EpisodeDocument, propId?: string): EpisodeDocument;
+/** Set a character's uniform scale (sizing a resolved GLB to read at the right height). */
+export declare function setCharacterScale(doc: EpisodeDocument, characterId: string, scale: number): EpisodeDocument;
+/** Add or update a dialogue line (the scene's caption + lip-sync source / AuraVoice contract). */
+export declare function setDialogueLine(doc: EpisodeDocument, line: DialogueLine): EpisodeDocument;
+/** Remove a dialogue line. */
+export declare function removeDialogueLine(doc: EpisodeDocument, lineId: string): EpisodeDocument;
+//# sourceMappingURL=scene-tools.d.ts.map

package/dist/engine/animation-studio/scene-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-tools.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/animation-studio/scene-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAqB,YAAY,EAAE,eAAe,EAAE,aAAa,EAA0B,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAiB1J,qEAAqE;AACrE,wBAAgB,OAAO,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,GAAG,eAAe,CAE9I;AAED,6CAA6C;AAC7C,wBAAgB,UAAU,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAEhF;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAElG;AAyBD,6EAA6E;AAC7E,wBAAgB,WAAW,CACzB,GAAG,EAAE,eAAe,EACpB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,gBAAgB,EAAE,EACtC,IAAI,CAAC,EAAE,MAAM,GACZ,eAAe,CAOjB;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAGnH;AAED,2DAA2D;AAC3D,wBAAgB,SAAS,CACvB,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,cAAc,CAAC;IAAC,OAAO,CAAC,EAAE,IAAI,CAAA;CAAE,GAChD,eAAe,CAOjB;AAED,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,GAAG,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,GAAG,eAAe,CAEzF;AAED,uDAAuD;AACvD,wBAAgB,UAAU,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAEjF;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAE3G;AAED,kGAAkG;AAClG,wBAAgB,eAAe,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,YAAY,GAAG,eAAe,CAMzF;AAED,8BAA8B;AAC9B,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAGxF"}

package/dist/engine/animation-studio/scene-tools.js

@@ -0,0 +1,95 @@
+/**
+ * scene-tools.ts — pure EpisodeDocument transforms.
+ *
+ * Each function returns a NEW document; the store validates + commits (or rejects). The
+ * agent never edits raw code — only these typed, validated edits.
+ */
+/** Re-lay shots contiguously from t=0 (preserving each shot's duration); update the
+ * document duration + world-state span to match. Shots must cover the timeline with no
+ * gaps, so every shot edit re-contiguizes. */
+function withShots(doc, shots) {
+    let t = 0;
+    const rec = shots.map((s) => {
+        const dur = Math.max(0.1, s.endTime - s.startTime);
+        const out = { ...s, startTime: t, endTime: t + dur };
+        t += dur;
+        return out;
+    });
+    const duration = rec.length ? rec[rec.length - 1].endTime : doc.duration;
+    return { ...doc, shots: rec, duration, worldState: { glowSpanSeconds: duration } };
+}
+/** Append a shot (given a duration); the timeline re-contiguizes. */
+export function addShot(doc, shotId, presetId, duration, cameraSubject) {
+    return withShots(doc, [...doc.shots, { shotId, presetId, startTime: 0, endTime: duration, cameraSubject }]);
+}
+/** Remove a shot; the timeline closes up. */
+export function removeShot(doc, shotId) {
+    return withShots(doc, doc.shots.filter((s) => s.shotId !== shotId));
+}
+/** Change a shot's duration; following shots shift to stay contiguous. */
+export function retimeShot(doc, shotId, duration) {
+    return withShots(doc, doc.shots.map((s) => (s.shotId === shotId ? { ...s, endTime: s.startTime + Math.max(0.1, duration) } : s)));
+}
+function upsertCharacterShot(blocking, characterId, shotId, update) {
+    const defaultBeat = { shotId, clip: "idle", waypoints: [] };
+    const existing = blocking.find((b) => b.characterId === characterId);
+    if (!existing) {
+        return [...blocking, { characterId, shots: [update(defaultBeat)] }];
+    }
+    return blocking.map((b) => b.characterId !== characterId
+        ? b
+        : {
+            ...b,
+            shots: b.shots.some((s) => s.shotId === shotId)
+                ? b.shots.map((s) => (s.shotId !== shotId ? s : update(s)))
+                : [...b.shots, update(defaultBeat)]
+        });
+}
+/** Set a character's blocking waypoints (and optionally clip) for a shot. */
+export function setBlocking(doc, characterId, shotId, waypoints, clip) {
+    const blocking = upsertCharacterShot(doc.blocking, characterId, shotId, (beat) => ({
+        ...beat,
+        clip: clip ?? beat.clip,
+        waypoints: [...waypoints]
+    }));
+    return { ...doc, blocking };
+}
+/** Schedule a clip/gesture for a character in a shot (keeps the existing waypoints). */
+export function setGesture(doc, characterId, shotId, clip) {
+    const blocking = upsertCharacterShot(doc.blocking, characterId, shotId, (beat) => ({ ...beat, clip }));
+    return { ...doc, blocking };
+}
+/** Set a shot's camera framing (preset and/or subject). */
+export function setCamera(doc, shotId, opts) {
+    return {
+        ...doc,
+        shots: doc.shots.map((s) => s.shotId !== shotId ? s : { ...s, presetId: opts.preset ?? s.presetId, cameraSubject: opts.subject ?? s.cameraSubject })
+    };
+}
+/** Add a prop instance to the set dressing. */
+export function placeProp(doc, placement) {
+    return { ...doc, setDressing: [...doc.setDressing, placement] };
+}
+/** Clear set dressing (all, or just one prop type). */
+export function clearProps(doc, propId) {
+    return { ...doc, setDressing: propId ? doc.setDressing.filter((d) => d.propId !== propId) : [] };
+}
+/** Set a character's uniform scale (sizing a resolved GLB to read at the right height). */
+export function setCharacterScale(doc, characterId, scale) {
+    return { ...doc, assets: { ...doc.assets, characters: doc.assets.characters.map((c) => (c.id === characterId ? { ...c, scale } : c)) } };
+}
+/** Add or update a dialogue line (the scene's caption + lip-sync source / AuraVoice contract). */
+export function setDialogueLine(doc, line) {
+    const existing = doc.dialogue ?? { language: "en", lines: [] };
+    const lines = existing.lines.some((l) => l.lineId === line.lineId)
+        ? existing.lines.map((l) => (l.lineId === line.lineId ? line : l))
+        : [...existing.lines, line];
+    return { ...doc, dialogue: { language: existing.language, lines: [...lines].sort((a, b) => a.startTime - b.startTime) } };
+}
+/** Remove a dialogue line. */
+export function removeDialogueLine(doc, lineId) {
+    if (!doc.dialogue)
+        return doc;
+    return { ...doc, dialogue: { ...doc.dialogue, lines: doc.dialogue.lines.filter((l) => l.lineId !== lineId) } };
+}
+//# sourceMappingURL=scene-tools.js.map

package/dist/engine/animation-studio/scene-tools.js.map

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

package/dist/engine/index.d.ts

@@ -1,8 +1,8 @@
 export { A3D_APP_WORKFLOW_PRESETS, createA3DApp, resolveA3DAppQualityPreset } from "@aura3d/apps";
 export type { A3DApp, A3DAppDiagnostics, A3DAppOptions, A3DAppQualityPreset, A3DAppQualitySettings, A3DAppWorkflowPreset } from "@aura3d/apps";
 export { Engine } from "@aura3d/core";
-export { Renderer, analyzeRgbaFrameMotionRegions, createCartoonMaterialStyle, createCartoonRenderPreset, createCartoonVisualQualityReport, createExternalParityEnvironmentPipeline, listExternalParityEnvironmentTargets } from "@aura3d/rendering";
-export type { CartoonFrameVisualInput, CartoonFrameVisualQuality, CartoonMaterialStyle, CartoonMaterialStyleOptions, FrameMotionRegion, FrameMotionRegionMetrics, CartoonRenderPresetEvidence, CartoonRenderPresetOptions, CartoonVisualQualityOptions, CartoonVisualQualityReport } from "@aura3d/rendering";
+export { Renderer, analyzeRgbaFrameMotionRegions, createAnimationMaterialStyle, createAnimationRenderPreset, createAnimationVisualQualityReport, createExternalParityEnvironmentPipeline, listExternalParityEnvironmentTargets } from "@aura3d/rendering";
+export type { AnimationFrameVisualInput, AnimationFrameVisualQuality, AnimationMaterialStyle, AnimationMaterialStyleOptions, FrameMotionRegion, FrameMotionRegionMetrics, AnimationRenderPresetEvidence, AnimationRenderPresetOptions, AnimationVisualQualityOptions, AnimationVisualQualityReport } from "@aura3d/rendering";
 export { GLTFLoader, createAssetCompatibilityReport, inspectGLTFAsset, loadRenderableAsset, summarizeExternalParityGLTFCorpus } from "@aura3d/assets";
 export { loadProductAsset } from "@aura3d/product-studio";
 export { createAnimationLabWorkflow, createAssetViewerWorkflow, createComparisonWorkflow, createInteractiveSceneWorkflow, createMaterialStudioWorkflow, createProductConfiguratorWorkflow, createSceneShowcaseWorkflow } from "@aura3d/workflows";

package/dist/engine/index.d.ts.map

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

package/dist/engine/index.js

@@ -1,6 +1,6 @@
 export { A3D_APP_WORKFLOW_PRESETS, createA3DApp, resolveA3DAppQualityPreset } from "../apps/index.js";
 export { Engine } from "../core/index.js";
-export { Renderer, analyzeRgbaFrameMotionRegions, createCartoonMaterialStyle, createCartoonRenderPreset, createCartoonVisualQualityReport, createExternalParityEnvironmentPipeline, listExternalParityEnvironmentTargets } from "../rendering/index.js";
+export { Renderer, analyzeRgbaFrameMotionRegions, createAnimationMaterialStyle, createAnimationRenderPreset, createAnimationVisualQualityReport, createExternalParityEnvironmentPipeline, listExternalParityEnvironmentTargets } from "../rendering/index.js";
 export { GLTFLoader, createAssetCompatibilityReport, inspectGLTFAsset, loadRenderableAsset, summarizeExternalParityGLTFCorpus } from "../assets/index.js";
 export { loadProductAsset } from "../product-studio/index.js";
 export { createAnimationLabWorkflow, createAssetViewerWorkflow, createComparisonWorkflow, createInteractiveSceneWorkflow, createMaterialStudioWorkflow, createProductConfiguratorWorkflow, createSceneShowcaseWorkflow } from "../workflows/index.js";

package/dist/engine/index.js.map

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

package/dist/engine/production-runtime/TypedGLBActor.d.ts

@@ -1,4 +1,4 @@
-import { type GLTFSceneAnimationApplyResult, type GLTFSceneAnimationRuntime, type GLTFSceneAnimationRuntimeSnapshot, type ProductionGLTFRenderPipeline } from "@aura3d/assets/browser";
+import { type GLTFSceneAnimationApplyResult, type GLTFSceneAnimationRuntime, type GLTFSceneAnimationRuntimeSnapshot, type GLTFScenePose, type ProductionGLTFRenderPipeline } from "@aura3d/assets/browser";
 import { type RenderItem } from "@aura3d/rendering";
 import type { Mat4 } from "@aura3d/scene";
 export interface TypedGLBActorAsset {
@@ -53,6 +53,18 @@ export interface TypedGLBActor {
     readonly animation: GLTFSceneAnimationRuntime;
     readonly evidence: TypedGLBActorEvidence;
     playClip(name: string, time: number): GLTFSceneAnimationApplyResult;
+    /**
+     * Drive the GLB from an externally-computed retargeted pose (e.g. the output of
+     * `@aura3d/animation`'s `retargetHumanoidPose`, whose `bones` keys are the target rig's GLB node
+     * names). This is the Phase 2.3 pose→runtime bridge: instead of sampling an embedded clip, the
+     * caller hands in a per-frame pose and the runtime writes it onto the matching scene nodes.
+     */
+    applyRetargetedPose(pose: GLTFScenePose, time?: number): GLTFSceneAnimationApplyResult;
+    /**
+     * Convenience alias for {@link applyRetargetedPose} with a clip-style label, mirroring `playClip`
+     * for callers that drive the actor frame-by-frame from a retargeted clip pose.
+     */
+    playRetargetedClip(pose: GLTFScenePose, time?: number): GLTFSceneAnimationApplyResult;
     collectRenderItems(options?: TypedGLBActorTransformOptions): RenderItem[];
     snapshot(): GLTFSceneAnimationRuntimeSnapshot;
     setTint(options: TypedGLBActorTintOptions): void;

package/dist/engine/production-runtime/TypedGLBActor.d.ts.map

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

package/dist/engine/production-runtime/TypedGLBActor.js

@@ -32,6 +32,14 @@ export async function createTypedGLBActor(options) {
             lastApply = animation.applyClipByName(name, time);
             return lastApply;
         },
+        applyRetargetedPose(pose, time = 0) {
+            lastApply = animation.applyPose(pose, "retargeted-pose", time);
+            return lastApply;
+        },
+        playRetargetedClip(pose, time = 0) {
+            lastApply = animation.applyPose(pose, "retargeted-clip", time);
+            return lastApply;
+        },
         collectRenderItems(transformOptions = {}) {
             return collectTypedGLBActorRenderItems(actor, transformOptions);
         },

package/dist/engine/production-runtime/TypedGLBActor.js.map

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

package/dist/physics/Raycast.d.ts

@@ -18,6 +18,23 @@ export type SphereCastHit = RaycastHit & {
     readonly castCenter: Vec3;
     readonly castRadius: number;
 };
+/** Ground query result consumed by the animation foot-IK rig (matches its `GroundSample` shape). */
+export type GroundHeightSample = {
+    readonly point: Vec3;
+    readonly normal: Vec3;
+    readonly distance: number;
+};
+/** Structural downward-ground query the `@aura3d/animation` foot-IK rig accepts. */
+export type GroundHeightRaycaster = {
+    raycastDown(origin: Vec3, maxDistance: number): GroundHeightSample | undefined;
+};
+/**
+ * Adapt any downward raycast into the ground query the foot-IK rig needs. `cast` should perform a
+ * straight-down ray (typically a `PhysicsWorld.raycast` bound to a ground layer mask) and return
+ * the first hit. This is a thin adapter, not a new solver — it just casts `[0,-1,0]` from the
+ * given origin and reports the hit point/normal/distance.
+ */
+export declare function groundHeightRaycaster(cast: (origin: Vec3, direction: Vec3, maxDistance: number) => RaycastHit | undefined): GroundHeightRaycaster;
 export declare function raycastCollider(origin: Vec3, direction: Vec3, collider: Collider, body: RigidBody, options?: RaycastOptions): RaycastHit | undefined;
 export declare function sphereCastCollider(origin: Vec3, radius: number, direction: Vec3, collider: Collider, body: RigidBody, options?: RaycastOptions): SphereCastHit | undefined;
 //# sourceMappingURL=Raycast.d.ts.map

package/dist/physics/Raycast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Raycast.d.ts","sourceRoot":"","sources":["../../../../packages/physics/src/Raycast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG;IACvC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,cAAmB,GAAG,UAAU,GAAG,SAAS,CAmBxJ;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa,GAAG,SAAS,CA+B9K"}
+{"version":3,"file":"Raycast.d.ts","sourceRoot":"","sources":["../../../../packages/physics/src/Raycast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG;IACvC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,oGAAoG;AACpG,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;CAChF,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,KAAK,UAAU,GAAG,SAAS,GACnF,qBAAqB,CAQvB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,cAAmB,GAAG,UAAU,GAAG,SAAS,CAmBxJ;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa,GAAG,SAAS,CA+B9K"}

package/dist/physics/Raycast.js

@@ -1,4 +1,20 @@
 import { addVec3, dotVec3, scaleVec3, subVec3 } from "./Shape.js";
+/**
+ * Adapt any downward raycast into the ground query the foot-IK rig needs. `cast` should perform a
+ * straight-down ray (typically a `PhysicsWorld.raycast` bound to a ground layer mask) and return
+ * the first hit. This is a thin adapter, not a new solver — it just casts `[0,-1,0]` from the
+ * given origin and reports the hit point/normal/distance.
+ */
+export function groundHeightRaycaster(cast) {
+    return {
+        raycastDown(origin, maxDistance) {
+            const hit = cast(origin, [0, -1, 0], maxDistance);
+            if (!hit)
+                return undefined;
+            return { point: hit.point, normal: hit.normal, distance: hit.distance };
+        }
+    };
+}
 export function raycastCollider(origin, direction, collider, body, options = {}) {
     const maxDistance = options.maxDistance ?? Number.POSITIVE_INFINITY;
     if (collider.sensor && options.includeSensors !== true) {