@aura3d/engine 3.0.0 → 4.0.0

package/dist/engine/agent-api/nodes/sky.js

@@ -0,0 +1,121 @@
+// PR 0b-1 carve-out (CONTRACTS.md §3.2) — moved from agent-api/index.ts.
+// PRD-07 P3-T4 (§6.5): adds the real `sky` node builders (preetham/gradient/
+// hdri) and rewrites `sky.dayNight` to additionally emit one `sky` node
+// (spec from `createDayNightSky`), while the legacy sphere primitives are
+// emitted unchanged — each tagged `runtime.id = "prd07.legacySky.<n>"` so the
+// effect system can hide them via their runtime handles when A3D_QR_VFX_SKY
+// is on. Flag-off frames are byte-identical (the `sky` node draws nothing
+// without the flag, and the primitives render exactly as before).
+// `AuraSkyNode` isn't yet in the `AuraSceneNode` union (prd15-owned
+// index.ts — CCR-07-2); builders cast like the §6.2.9–11 effect builders.
+import { AuraNodeBuilder } from "./builder.js";
+import { primitives } from "./primitives.js";
+import { createDayNightSky } from "../../../rendering/index.js";
+import { lights } from "./lights.js";
+import { material } from "./material.js";
+function deg(rad) {
+    return (rad * 180) / Math.PI;
+}
+function sunSpec(disc) {
+    return {
+        elevationDeg: deg(disc.elevationRadians),
+        azimuthDeg: deg(disc.azimuthRadians),
+        intensity: disc.intensity,
+        color: disc.color,
+        discSize: disc.angularRadius * 2 // radians ≈ angular diameter
+    };
+}
+function skyNode(name, spec, options) {
+    const node = {
+        kind: "sky",
+        name,
+        spec,
+        captureEnvironment: options.captureEnvironment ?? true,
+        affectsFog: options.affectsFog ?? true
+    };
+    return new AuraNodeBuilder(node);
+}
+function skyPreetham(options) {
+    const { name, captureEnvironment, affectsFog, ...spec } = options;
+    return skyNode(name ?? "sky", { ...spec, model: "preetham" }, { captureEnvironment, affectsFog });
+}
+function skyGradient(options) {
+    const { name, captureEnvironment, affectsFog, ...spec } = options;
+    return skyNode(name ?? "sky", { ...spec, model: "gradient" }, { captureEnvironment, affectsFog });
+}
+function skyHdri(options) {
+    const { name, captureEnvironment, affectsFog, ...spec } = options;
+    return skyNode(name ?? "sky", { ...spec, model: "hdri" }, { captureEnvironment, affectsFog });
+}
+export const sky = {
+    preetham: skyPreetham,
+    gradient: skyGradient,
+    hdri: skyHdri,
+    /**
+     * Time-of-day sky: with `A3D_QR_VFX_SKY` off, emits exactly the legacy
+     * sphere sun/moon/stars/clouds + background colour (bit-identical); with
+     * the flag on those same primitives are runtime-tagged `prd07.legacySky.*`
+     * and hidden by the effect system, and the extra `sky` node draws the real
+     * sky (model = `options.model`, default "preetham"; sun/moon directions
+     * from `createDayNightSky` — the E31 keyframes keep only colour
+     * temperature). Return shape preserved, plus `sky`.
+     */
+    dayNight: (options = {}) => {
+        const state = createDayNightSky(options);
+        const nodes = [];
+        const sunUp = state.sun.elevationRadians > -0.05;
+        const moonUp = state.moon.elevationRadians > -0.05;
+        let legacyIndex = 0;
+        const tag = (builder) => builder.runtime({ id: `prd07.legacySky.${legacyIndex++}`, tags: ["prd07.legacySky"] }).toJSON();
+        if (sunUp) {
+            nodes.push(tag(primitives.sphere({ name: "d3 sun disc", material: material.emissive({ color: state.sun.color, emissive: state.sun.color, emissiveIntensity: 2.2, roughness: 0.8 }) })
+                .position(-6 * Math.cos(state.sun.azimuthRadians), 1 + 5 * Math.sin(state.sun.azimuthRadians), -7).scale(0.85)));
+        }
+        if (moonUp) {
+            nodes.push(tag(primitives.sphere({ name: "d3 moon disc", material: material.emissive({ color: state.moon.color, emissive: state.moon.color, emissiveIntensity: 1.4, roughness: 0.8 }) })
+                .position(-6 * Math.cos(state.moon.azimuthRadians), 1 + 5 * Math.sin(state.moon.azimuthRadians), -7).scale(0.6)));
+        }
+        const starLimit = Math.max(0, Math.min(120, options.starLimit ?? 48));
+        const visibleStars = state.stars.filter((star) => star.brightness > 0.05 && star.y > 0).slice(0, starLimit);
+        for (const [index, star] of visibleStars.entries()) {
+            nodes.push(tag(primitives.sphere({ name: `d3 night star ${index}`, material: material.emissive({ color: "#dbeafe", emissive: "#bfdbfe", emissiveIntensity: 1.8, roughness: 0.9 }) })
+                .position(star.x * 7, star.y * 4 + 0.6, -6.5).scale(0.028 + star.size * 2)));
+        }
+        const cloudLimit = Math.max(0, Math.min(48, options.cloudLimit ?? 12));
+        const cloudTint = state.dayFactor > 0.5 ? "#f1f5f9" : state.dayFactor > 0.2 ? "#b6a6a6" : "#1e293b";
+        for (const [index, cell] of state.clouds.slice(0, cloudLimit).entries()) {
+            nodes.push(tag(primitives.sphere({ name: `d3 noise cloud ${index}`, material: material.pbr({ color: cloudTint, roughness: 1, metallic: 0 }) })
+                .position(cell.x * 6, cell.y * 3 + 1.4, -5.5).scale([cell.radius * 1.7, cell.radius * 0.5, cell.radius * 0.8])));
+        }
+        // The real sky node: model defaults to preetham; sun/moon directions come
+        // straight from the day-night state; `groundColor` carries the horizon
+        // colour as the fog "sky" hint.
+        const skySpec = options.model === "gradient"
+            ? {
+                model: "gradient",
+                zenith: state.zenithColor,
+                horizon: state.horizonColor,
+                ground: "#2a2d33",
+                sun: sunSpec(state.sun),
+                stars: { density: Math.min(1, visibleStars.length / 240), intensity: 1 },
+                moon: { elevationDeg: deg(state.moon.elevationRadians), azimuthDeg: deg(state.moon.azimuthRadians), phase: state.moon.phase, color: state.moon.color, intensity: state.moon.intensity }
+            }
+            : {
+                model: "preetham",
+                sun: sunSpec(state.sun),
+                groundColor: state.horizonColor,
+                stars: { density: Math.min(1, visibleStars.length / 240), intensity: 1 },
+                clouds: { coverage: state.averageCloudCoverage },
+                moon: { elevationDeg: deg(state.moon.elevationRadians), azimuthDeg: deg(state.moon.azimuthRadians), phase: state.moon.phase, color: state.moon.color, intensity: state.moon.intensity }
+            };
+        nodes.push(skyNode("sky", skySpec, { captureEnvironment: true, affectsFog: true }).toJSON());
+        nodes.push(lights.directional({
+            name: sunUp ? "d3 sun key light" : "d3 moon key light",
+            position: sunUp ? [-4, 5, 2] : [3, 4, -1],
+            color: sunUp ? state.sun.color : state.moon.color,
+            intensity: sunUp ? 0.6 + state.dayFactor * 1.2 : 0.35
+        }).toJSON());
+        return { nodes, background: state.dayFactor > 0.5 ? state.horizonColor : state.nightFactor > 0.6 ? "#020617" : state.horizonColor, dayFactor: state.dayFactor, visibleStarCount: visibleStars.length, sky: skySpec };
+    }
+};
+//# sourceMappingURL=sky.js.map

package/dist/engine/agent-api/nodes/sky.js.map

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

package/dist/engine/agent-api/nodes/solar.d.ts

@@ -0,0 +1,17 @@
+import type { AuraMaterialSpec, AuraSceneNode, AuraCameraSpec, AuraSolarSystemPrefabOptions, AuraSolarPlanetMaterialPreset } from "./types.js";
+import { AuraSceneBuilder } from "./scene.js";
+import { validateSolarVisualQA } from "../looks/structuralQA.js";
+export declare function solarPlanetMaterial(preset: AuraSolarPlanetMaterialPreset): AuraMaterialSpec;
+declare function solarCameraPreset(): AuraCameraSpec;
+declare function solarScene(options?: AuraSolarSystemPrefabOptions): AuraSceneBuilder;
+export declare function solarMaterialPresetsInNodes(nodes: readonly AuraSceneNode[]): readonly AuraSolarPlanetMaterialPreset[];
+export declare const solar: {
+    readonly system: (options?: AuraSolarSystemPrefabOptions) => readonly AuraSceneNode[];
+    readonly scene: typeof solarScene;
+    readonly cameraPreset: typeof solarCameraPreset;
+    readonly materialPresets: () => readonly AuraSolarPlanetMaterialPreset[];
+    readonly planetMaterial: typeof solarPlanetMaterial;
+    readonly visualQA: typeof validateSolarVisualQA;
+};
+export {};
+//# sourceMappingURL=solar.d.ts.map

package/dist/engine/agent-api/nodes/solar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solar.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/solar.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAC/I,OAAO,EAAE,gBAAgB,EAAS,MAAM,YAAY,CAAC;AAQrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAMjE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,6BAA6B,GAAG,gBAAgB,CAO3F;AAED,iBAAS,iBAAiB,IAAI,cAAc,CAE3C;AAED,iBAAS,UAAU,CAAC,OAAO,GAAE,4BAAiC,GAAG,gBAAgB,CAOhF;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,6BAA6B,EAAE,CAWrH;AAED,eAAO,MAAM,KAAK;gCACE,4BAA4B,KAAQ,SAAS,aAAa,EAAE;;;oCAGzD,SAAS,6BAA6B,EAAE;;;CAGnD,CAAC"}

package/dist/engine/agent-api/nodes/solar.js

@@ -0,0 +1,64 @@
+// PRD-15 Phase 3 carve-out (CONTRACTS.md §3.2) — verbatim move from agent-api/index.ts; 0 changed logic lines.
+import { AuraSceneBuilder, scene } from "./scene.js";
+import { camera } from "./camera.js";
+import { groups } from "./groups.js";
+import { interactions } from "./interactions.js";
+import { labels } from "./labels.js";
+import { material } from "./material.js";
+import { prefabs } from "./prefabs/index.js";
+import { timeline } from "./timeline.js";
+import { validateSolarVisualQA } from "../looks/structuralQA.js";
+import { cameraPreset } from "../CameraPresetLibrary.js";
+import { distance } from "../SpatialAnchoring.js";
+import { lazyNamespace } from "../lazyNamespace.js";
+export function solarPlanetMaterial(preset) {
+    if (preset === "gas-giant")
+        return material.clearcoat({ color: "#f5d0a9", roughness: 0.2, clearcoat: 0.8, envMapIntensity: 0.88 });
+    if (preset === "ice")
+        return material.clearcoat({ color: "#93c5fd", roughness: 0.24, clearcoat: 1, envMapIntensity: 1.05 });
+    if (preset === "moon")
+        return material.pbr({ color: "#cbd5e1", roughness: 0.84, metallic: 0.01 });
+    if (preset === "ringed")
+        return material.emissive({ color: "#fde68a", emissive: "#fde68a", opacity: 0.82 });
+    if (preset === "lava-venus")
+        return material.emissive({ color: "#f59e0b", emissive: "#f97316", emissiveIntensity: 1.35 });
+    return material.pbr({ color: "#a8a29e", roughness: 0.76, metallic: 0.04 });
+}
+function solarCameraPreset() {
+    return camera.orbit({ target: [0, 0.18, 0], distance: 7.4, fov: 45 });
+}
+function solarScene(options = {}) {
+    return scene()
+        .background("#020617")
+        .addMany(prefabs.solarSystem({ labels: "attached", orbitSegments: 24, starCount: 42, dustCount: 18, ...options }))
+        .add(interactions.orbit())
+        .camera(solarCameraPreset())
+        .timeline(timeline.loop({ seconds: 18 }));
+}
+export function solarMaterialPresetsInNodes(nodes) {
+    const names = groups.flatten(nodes).map((node) => "name" in node ? node.name ?? "" : "");
+    const found = new Set();
+    if (names.some((name) => name.includes("rocky material")))
+        found.add("rocky");
+    if (names.some((name) => name.includes("gas-giant material")))
+        found.add("gas-giant");
+    if (names.some((name) => name.includes("ice material")))
+        found.add("ice");
+    if (names.some((name) => name.includes("moon material")))
+        found.add("moon");
+    if (names.some((name) => name.includes("ringed material") || name.includes("ringed planet")))
+        found.add("ringed");
+    if (names.some((name) => name.includes("lava-venus material")))
+        found.add("lava-venus");
+    const presets = ["rocky", "gas-giant", "ice", "moon", "ringed", "lava-venus"];
+    return presets.filter((preset) => found.has(preset));
+}
+export const solar = lazyNamespace(() => ({
+    system: (options = {}) => prefabs.solarSystem(options),
+    scene: solarScene,
+    cameraPreset: solarCameraPreset,
+    materialPresets: () => ["rocky", "gas-giant", "ice", "moon", "ringed", "lava-venus"],
+    planetMaterial: solarPlanetMaterial,
+    visualQA: validateSolarVisualQA
+}));
+//# sourceMappingURL=solar.js.map

package/dist/engine/agent-api/nodes/solar.js.map

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

package/dist/engine/agent-api/nodes/text3d.d.ts

@@ -0,0 +1,11 @@
+import type { AuraPrimitiveOptions, AuraPrimitiveNode } from "./types.js";
+import type { AuraText3DOptions } from "../RootGeometry.js";
+import type { SdfFontAtlas, SdfTextOcclusionPolicy, SdfTextStyle } from "../../../rendering/index.js";
+import { AuraNodeBuilder } from "./builder.js";
+export declare function rootSdfFontAtlas(): SdfFontAtlas;
+export declare function text3D(text: string, options?: AuraText3DOptions & Omit<AuraPrimitiveOptions, "geometry" | "text3D"> & {
+    readonly backend?: "extruded-mesh" | "sdf";
+    readonly sdfStyle?: SdfTextStyle;
+    readonly sdfOcclusion?: SdfTextOcclusionPolicy;
+}): AuraNodeBuilder<AuraPrimitiveNode>;
+//# sourceMappingURL=text3d.d.ts.map

package/dist/engine/agent-api/nodes/text3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text3d.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/text3d.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAQ/C,wBAAgB,gBAAgB,IAAI,YAAY,CAI/C;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAiB,GAAG,IAAI,CAAC,oBAAoB,EAAE,UAAU,GAAG,QAAQ,CAAC,GAAG;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,KAAK,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,sBAAsB,CAAA;CAAO,GAAG,eAAe,CAAC,iBAAiB,CAAC,CA4B/R"}

package/dist/engine/agent-api/nodes/text3d.js

@@ -0,0 +1,42 @@
+// PRD-15 Phase 3 carve-out (CONTRACTS.md §3.2) — verbatim move from agent-api/index.ts; 0 changed logic lines.
+import { AuraNodeBuilder } from "./builder.js";
+import { createAuraText3DGeometry } from "../RootGeometry.js";
+import { createSdfFontAtlas, layoutSdfText } from "../../../rendering/index.js";
+import { geometry } from "./geometry.js";
+import { primitive } from "./primitives.js";
+let cachedSdfFontAtlas;
+export function rootSdfFontAtlas() {
+    // Baked once per session (~500ms default res); the caller never bakes per frame.
+    cachedSdfFontAtlas ??= createSdfFontAtlas();
+    return cachedSdfFontAtlas;
+}
+export function text3D(text, options = {}) {
+    const built = createAuraText3DGeometry(text, options);
+    if ((options.backend ?? "extruded-mesh") === "extruded-mesh") {
+        return primitive("custom", { ...options, geometry: built.geometry, text3D: { text: built.text, glyphCount: built.glyphCount, unsupportedCharacters: built.unsupportedCharacters, method: built.method } });
+    }
+    // G1 SDF backend (muse3jsparity-PRD): the layout validates fail-loud and is
+    // recorded on the descriptor with the full author intent (size, spacing,
+    // style, occlusion policy) so the production bridge can replay the sampler
+    // at mount. The extruded mesh stays as the diagnosed fallback geometry.
+    const layout = layoutSdfText(text, rootSdfFontAtlas(), { size: options.size ?? 1, letterSpacing: options.letterSpacing, style: options.sdfStyle });
+    return primitive("custom", {
+        ...options,
+        geometry: built.geometry,
+        text3D: {
+            text: built.text,
+            glyphCount: built.glyphCount,
+            unsupportedCharacters: [...new Set([...built.unsupportedCharacters, ...layout.unsupportedCharacters])],
+            method: "sdf-atlas-quad",
+            backend: "sdf",
+            sdfQuadCount: layout.quads.length,
+            sdfWidthWorld: layout.widthWorld,
+            sdfHeightWorld: layout.heightWorld,
+            sdfSize: options.size ?? 1,
+            ...(options.letterSpacing === undefined ? {} : { sdfLetterSpacing: options.letterSpacing }),
+            ...(options.sdfStyle === undefined ? {} : { sdfStyle: options.sdfStyle }),
+            sdfOcclusion: options.sdfOcclusion ?? "dim"
+        }
+    });
+}
+//# sourceMappingURL=text3d.js.map

package/dist/engine/agent-api/nodes/text3d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text3d.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/text3d.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAK/G,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,IAAI,kBAA4C,CAAC;AAEjD,MAAM,UAAU,gBAAgB;IAC9B,iFAAiF;IACjF,kBAAkB,KAAK,kBAAkB,EAAE,CAAC;IAC5C,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,UAAoN,EAAE;IACzP,MAAM,KAAK,GAAG,wBAAwB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtD,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC,KAAK,eAAe,EAAE,CAAC;QAC7D,OAAO,SAAS,CAAC,QAAQ,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,qBAAqB,EAAE,KAAK,CAAC,qBAAqB,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7M,CAAC;IACD,4EAA4E;IAC5E,yEAAyE;IACzE,2EAA2E;IAC3E,wEAAwE;IACxE,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnJ,OAAO,SAAS,CAAC,QAAQ,EAAE;QACzB,GAAG,OAAO;QACV,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE;YACN,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,qBAAqB,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,qBAAqB,EAAE,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC;YACtG,MAAM,EAAE,gBAAgB;YACxB,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;YACjC,aAAa,EAAE,MAAM,CAAC,UAAU;YAChC,cAAc,EAAE,MAAM,CAAC,WAAW;YAClC,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC;YAC1B,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;YAC3F,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;YACzE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,KAAK;SAC5C;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/engine/agent-api/nodes/timeline.d.ts

@@ -0,0 +1,6 @@
+import type { AuraTimelineSpec } from "./types.js";
+export declare const timeline: {
+    readonly loop: (options?: Omit<AuraTimelineSpec, "mode">) => AuraTimelineSpec;
+    readonly once: (options?: Omit<AuraTimelineSpec, "mode">) => AuraTimelineSpec;
+};
+//# sourceMappingURL=timeline.d.ts.map

package/dist/engine/agent-api/nodes/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/timeline.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAO,MAAM,QAAQ;8BACH,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,KAAQ,gBAAgB;8BAStD,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,KAAQ,gBAAgB;CAS9D,CAAC"}

package/dist/engine/agent-api/nodes/timeline.js

@@ -0,0 +1,22 @@
+// PRD-15 Phase 3 carve-out (CONTRACTS.md §3.2) — verbatim move from agent-api/index.ts; 0 changed logic lines.
+export const timeline = {
+    loop: (options = {}) => ({
+        mode: "loop",
+        seconds: options.seconds ?? options.duration ?? 8,
+        startTime: options.startTime ?? 0,
+        duration: options.duration ?? options.seconds ?? 8,
+        loop: true,
+        easing: options.easing ?? "easeInOut",
+        captureTime: options.captureTime
+    }),
+    once: (options = {}) => ({
+        mode: "once",
+        seconds: options.seconds ?? options.duration ?? 4,
+        startTime: options.startTime ?? 0,
+        duration: options.duration ?? options.seconds ?? 4,
+        loop: false,
+        easing: options.easing ?? "easeInOut",
+        captureTime: options.captureTime
+    })
+};
+//# sourceMappingURL=timeline.js.map

package/dist/engine/agent-api/nodes/timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/timeline.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAI/G,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,CAAC,UAA0C,EAAE,EAAoB,EAAE,CAAC,CAAC;QACzE,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,IAAI,CAAC;QACjD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;QACjC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC;QAClD,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,WAAW;QACrC,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC;IACF,IAAI,EAAE,CAAC,UAA0C,EAAE,EAAoB,EAAE,CAAC,CAAC;QACzE,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,IAAI,CAAC;QACjD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;QACjC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC;QAClD,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,WAAW;QACrC,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC;CACM,CAAC"}