@aura3d/engine 1.5.2 → 2.0.0

package/dist/rendering/ProductTurntable.js

@@ -0,0 +1,639 @@
+import { Geometry } from "./Geometry.js";
+import { PBRMaterial } from "./PBRMaterial.js";
+import { createProceduralTexture } from "./ProceduralTexture.js";
+import { Sampler } from "./Sampler.js";
+import { TexturedPBRMaterial } from "./TexturedPBRMaterial.js";
+import { TexturedUnlitMaterial } from "./TexturedUnlitMaterial.js";
+import { UnlitMaterial } from "./UnlitMaterial.js";
+import { createExternalParityEnvironmentLighting } from "./ExternalParityRenderPreset.js";
+import { DirectionalLight } from "../scene/index.js";
+const sourceFiles = [
+    "master:src/ecommerce/turntable/TurntableController.ts",
+    "master:src/ecommerce/turntable/HotspotManager.ts",
+    "master:src/ecommerce/turntable/LightingPresetManager.ts",
+    "master:src/ecommerce/turntable/CaptureManager.ts",
+    "master:src/ecommerce/turntable/BatchProcessor.ts",
+    "master:src/ecommerce/turntable/ARExporter.ts"
+];
+const lightingPresets = {
+    studio: {
+        activeLightCount: 4,
+        ambientIntensity: 0.2,
+        keyIntensity: 1.5,
+        fillIntensity: 0.5,
+        rimIntensity: 0.8,
+        environmentIntensity: 1,
+        shadowEnabled: true,
+        shadowSoftness: 0.5
+    },
+    soft: {
+        activeLightCount: 4,
+        ambientIntensity: 0.5,
+        keyIntensity: 0.8,
+        fillIntensity: 0.8,
+        rimIntensity: 0.4,
+        environmentIntensity: 0.85,
+        shadowEnabled: false,
+        shadowSoftness: 1
+    },
+    inspection: {
+        activeLightCount: 3,
+        ambientIntensity: 0.32,
+        keyIntensity: 1.15,
+        fillIntensity: 0.65,
+        rimIntensity: 0.35,
+        environmentIntensity: 1.05,
+        shadowEnabled: true,
+        shadowSoftness: 0.35
+    },
+    dramatic: {
+        activeLightCount: 3,
+        ambientIntensity: 0.05,
+        keyIntensity: 2.5,
+        fillIntensity: 0.12,
+        rimIntensity: 1.2,
+        environmentIntensity: 0.7,
+        shadowEnabled: true,
+        shadowSoftness: 0.1
+    },
+    neutral: {
+        activeLightCount: 4,
+        ambientIntensity: 0.3,
+        keyIntensity: 1,
+        fillIntensity: 0.6,
+        rimIntensity: 0.3,
+        environmentIntensity: 1,
+        shadowEnabled: true,
+        shadowSoftness: 0.5
+    }
+};
+export function createProductTurntableFixture(options = {}) {
+    const elapsedSeconds = finiteOrDefault(options.elapsedSeconds, 0, "elapsedSeconds");
+    const interactionCount = integerOrDefault(options.interactionCount, 0, "interactionCount");
+    const interactionAgeMs = finiteOrDefault(options.interactionAgeMs, Number.POSITIVE_INFINITY, "interactionAgeMs");
+    const canvasWidth = Math.max(320, integerOrDefault(options.canvasWidth, 960, "canvasWidth"));
+    const canvasHeight = Math.max(240, integerOrDefault(options.canvasHeight, 540, "canvasHeight"));
+    const lightingPreset = options.lightingPreset ?? "studio";
+    const speedRadiansPerSecond = Math.PI / 8;
+    const resumeDelayMs = 2_000;
+    const transitionDurationSeconds = 0.5;
+    const pausedByInteraction = interactionCount > 0 && interactionAgeMs < resumeDelayMs;
+    const resumeBlend = pausedByInteraction ? 0 : Math.min(1, Math.max(0, (interactionAgeMs - resumeDelayMs) / (transitionDurationSeconds * 1000)));
+    const currentSpeedRadiansPerSecond = Number((speedRadiansPerSecond * resumeBlend).toFixed(4));
+    const rotationRadians = Number(((elapsedSeconds * speedRadiansPerSecond) % (Math.PI * 2)).toFixed(4));
+    const hotspots = createHotspots(rotationRadians, canvasWidth, canvasHeight);
+    const visibleHotspotCount = hotspots.filter((hotspot) => hotspot.screen.visible).length;
+    const capture = createCapturePlan(Boolean(options.captureRequested), Math.max(0, integerOrDefault(options.exportedBytes, 0, "exportedBytes")));
+    const lighting = createLighting(lightingPreset);
+    const hash = hashProductTurntable([
+        rotationRadians,
+        currentSpeedRadiansPerSecond,
+        visibleHotspotCount,
+        lighting.activeLightCount,
+        lighting.environmentIntensity,
+        capture.completedBatchTasks,
+        capture.exportedBytes
+    ]);
+    return {
+        id: "external-product-turntable-fixture",
+        source: "origin-master-ecommerce-turntable-adapted",
+        sourceFiles,
+        autoRotate: true,
+        speedRadiansPerSecond,
+        direction: "cw",
+        pauseOnInteraction: true,
+        resumeDelayMs,
+        smoothTransition: true,
+        transitionDurationSeconds,
+        currentSpeedRadiansPerSecond,
+        rotationRadians,
+        pausedByInteraction,
+        interactionCount,
+        hotspots,
+        visibleHotspotCount,
+        lighting,
+        capture,
+        manifestHash: hash,
+        claimBoundary: "This fixture adapts old ecommerce turntable concepts into deterministic external product evidence. It does not claim a complete ecommerce pipeline, native USDZ export, video capture, PIM integration, or AR platform parity."
+    };
+}
+export function createProductTurntableRenderKit(options = {}) {
+    const fixture = createProductTurntableFixture(options);
+    const environment = createExternalParityEnvironmentLighting(productTurntableEnvironmentPreset(fixture.lighting.activePreset));
+    const sampler = new Sampler({ minFilter: "linear-mipmap-linear", magFilter: "linear", addressU: "repeat", addressV: "repeat" });
+    const detailSampler = new Sampler({ minFilter: "linear", magFilter: "linear", addressU: "repeat", addressV: "repeat" });
+    const textures = [
+        createProceduralTexture("metallic-paint", { width: 128, height: 128 }),
+        createProceduralTexture("carbon-fiber", { width: 128, height: 128 }),
+        createProceduralTexture("metallic-roughness-map", { width: 128, height: 128 }),
+        createProceduralTexture("normal-from-height", { width: 128, height: 128 }),
+        createProceduralTexture("sci-fi-panel", { width: 128, height: 128 }),
+        createProceduralTexture("concrete-asphalt", { width: 128, height: 128 }),
+        createProceduralTexture("racing-stripes", { width: 128, height: 128 })
+    ];
+    const [paint, carbon, metallicRoughness, normal, panel, concrete, accentStripes] = textures;
+    const geometryLibrary = new Map([
+        ["ear-shell", Geometry.capsule({ radius: 0.34, height: 0.9, segments: 64, rings: 16, textured: true })],
+        ["ear-pad", Geometry.uvSphere(0.42, 64, 32, { textured: true })],
+        ["headband", Geometry.texturedCube(1)],
+        ["control", Geometry.texturedCube(1)],
+        ["accent", Geometry.uvSphere(0.18, 48, 24, { textured: true })],
+        ["stage", Geometry.texturedCube(1)]
+    ]);
+    const materialLibrary = new Map([
+        ["painted-shell", new TexturedPBRMaterial({
+                name: "turntable-painted-metal-shell",
+                baseColor: [0.48, 0.5, 0.52, 1],
+                metallic: 0.62,
+                roughness: 0.32,
+                metallicRoughnessTexture: metallicRoughness,
+                metallicRoughnessSampler: sampler,
+                normalTexture: normal,
+                normalSampler: detailSampler,
+                normalScale: 0.12,
+                clearcoatFactor: 0.34,
+                clearcoatRoughnessFactor: 0.22
+            })],
+        ["carbon-pad", new TexturedPBRMaterial({
+                name: "turntable-carbon-cushion",
+                baseColor: [0.08, 0.09, 0.11, 1],
+                metallic: 0.08,
+                roughness: 0.64,
+                baseColorTexture: carbon,
+                baseColorSampler: sampler,
+                normalTexture: normal,
+                normalSampler: detailSampler,
+                normalScale: 0.22
+            })],
+        ["brushed-trim", new PBRMaterial({
+                name: "turntable-brushed-trim",
+                baseColor: [0.86, 0.82, 0.72, 1],
+                metallic: 1,
+                roughness: 0.19,
+                specularFactor: 1
+            })],
+        ["control-panel", new TexturedPBRMaterial({
+                name: "turntable-control-panel",
+                baseColor: [0.16, 0.42, 0.58, 1],
+                metallic: 0.18,
+                roughness: 0.38,
+                baseColorTexture: panel,
+                baseColorSampler: sampler,
+                normalTexture: normal,
+                normalSampler: detailSampler,
+                normalScale: 0.16,
+                emissiveColor: [0.01, 0.12, 0.16],
+                emissiveStrength: 0.18
+            })],
+        ["status-light", new PBRMaterial({
+                name: "turntable-status-light",
+                baseColor: [0.18, 0.92, 1, 1],
+                metallic: 0,
+                roughness: 0.18,
+                emissiveColor: [0.06, 0.72, 1],
+                emissiveStrength: 1.4
+            })],
+        ["amber-status-light", new PBRMaterial({
+                name: "turntable-amber-status-light",
+                baseColor: [1, 0.62, 0.12, 1],
+                metallic: 0,
+                roughness: 0.2,
+                emissiveColor: [1, 0.36, 0.06],
+                emissiveStrength: 0.9
+            })],
+        ["magenta-status-light", new PBRMaterial({
+                name: "turntable-magenta-status-light",
+                baseColor: [0.94, 0.16, 0.86, 1],
+                metallic: 0,
+                roughness: 0.2,
+                emissiveColor: [0.56, 0.04, 0.5],
+                emissiveStrength: 0.82
+            })],
+        ["studio-stage", new TexturedUnlitMaterial({
+                name: "turntable-studio-stage",
+                texture: concrete,
+                sampler,
+                textureTransform: { scale: [7.5, 3.75] },
+                color: [0.18, 0.2, 0.22, 1]
+            })],
+        ["studio-backdrop", new UnlitMaterial({
+                name: "turntable-studio-backdrop",
+                color: [0.018, 0.023, 0.03, 1]
+            })],
+        ["studio-accent-stripe", new TexturedUnlitMaterial({
+                name: "turntable-studio-accent-stripe",
+                texture: accentStripes,
+                sampler,
+                textureTransform: { scale: [2.8, 0.8] },
+                color: [0.72, 0.62, 0.42, 1]
+            })],
+        ["paint-finish-reference", new TexturedUnlitMaterial({
+                name: "turntable-metallic-paint-finish-reference",
+                texture: paint,
+                sampler,
+                textureTransform: { scale: [2.4, 0.8] },
+                color: [0.2, 0.12, 0.1, 1]
+            })],
+        ["studio-softbox", new UnlitMaterial({
+                name: "turntable-studio-softbox-panel",
+                color: [0.1, 0.12, 0.14, 1]
+            })],
+        ["dark-detail-line", new UnlitMaterial({
+                name: "turntable-dark-detail-line",
+                color: [0.018, 0.022, 0.026, 1]
+            })],
+        ["cyan-detail-line", new UnlitMaterial({
+                name: "turntable-cyan-detail-line",
+                color: [0.08, 0.34, 0.38, 1]
+            })],
+        ["warm-detail-line", new UnlitMaterial({
+                name: "turntable-warm-detail-line",
+                color: [0.52, 0.31, 0.18, 1]
+            })]
+    ]);
+    const angle = fixture.rotationRadians;
+    const includeStage = options.includeStage !== false;
+    const collectedLights = createProductTurntableCollectedLights(fixture.lighting);
+    const renderItems = [
+        item(geometryLibrary, materialLibrary, "left-ear-shell", "ear-shell", "painted-shell", -0.56, 0.1, 0, 0.82, 1.08, 0.64, angle),
+        item(geometryLibrary, materialLibrary, "right-ear-shell", "ear-shell", "painted-shell", 0.56, 0.1, 0, 0.82, 1.08, 0.64, angle),
+        item(geometryLibrary, materialLibrary, "left-ear-pad", "ear-pad", "carbon-pad", -0.56, -0.02, 0.08, 0.56, 0.72, 0.26, angle),
+        item(geometryLibrary, materialLibrary, "right-ear-pad", "ear-pad", "carbon-pad", 0.56, -0.02, 0.08, 0.56, 0.72, 0.26, angle),
+        item(geometryLibrary, materialLibrary, "outer-headband", "headband", "brushed-trim", 0, 0.75, -0.05, 1.52, 0.14, 0.22, angle),
+        item(geometryLibrary, materialLibrary, "inner-headband", "headband", "carbon-pad", 0, 0.56, 0.02, 1.16, 0.1, 0.18, angle),
+        item(geometryLibrary, materialLibrary, "left-yoke", "headband", "brushed-trim", -0.54, 0.45, 0, 0.16, 0.64, 0.16, angle),
+        item(geometryLibrary, materialLibrary, "right-yoke", "headband", "brushed-trim", 0.54, 0.45, 0, 0.16, 0.64, 0.16, angle),
+        item(geometryLibrary, materialLibrary, "control-module", "control", "control-panel", 0.82, 0.04, 0.16, 0.18, 0.34, 0.12, angle),
+        item(geometryLibrary, materialLibrary, "status-light", "accent", "status-light", 0.91, 0.08, 0.28, 0.16, 0.16, 0.16, angle),
+        item(geometryLibrary, materialLibrary, "left-amber-accent", "accent", "amber-status-light", -0.96, 0.16, 0.24, 0.1, 0.1, 0.1, angle),
+        item(geometryLibrary, materialLibrary, "right-magenta-accent", "accent", "magenta-status-light", 0.36, -0.34, 0.3, 0.1, 0.1, 0.1, angle)
+    ];
+    for (const side of [-1, 1]) {
+        for (let index = 0; index < 5; index += 1) {
+            renderItems.push(item(geometryLibrary, materialLibrary, `ear-pad-stitch-${side}-${index}`, "headband", index % 2 === 0 ? "dark-detail-line" : "cyan-detail-line", side * 0.56, -0.24 + index * 0.085, -0.22, 0.46, 0.014, 0.012, angle));
+        }
+        for (let index = 0; index < 7; index += 1) {
+            renderItems.push(item(geometryLibrary, materialLibrary, `ear-pad-vertical-stitch-${side}-${index}`, "headband", index % 2 === 0 ? "dark-detail-line" : "cyan-detail-line", side * (0.34 + index * 0.075), -0.04, -0.235, 0.012, 0.43, 0.012, angle));
+        }
+        for (let index = 0; index < 4; index += 1) {
+            renderItems.push(item(geometryLibrary, materialLibrary, `shell-highlight-strake-${side}-${index}`, "headband", index % 2 === 0 ? "warm-detail-line" : "dark-detail-line", side * (0.56 + index * 0.035), 0.22 + index * 0.078, -0.24, 0.34 - index * 0.035, 0.012, 0.012, angle));
+        }
+        for (let index = 0; index < 7; index += 1) {
+            renderItems.push(item(geometryLibrary, materialLibrary, `shell-machined-vertical-${side}-${index}`, "headband", index % 2 === 0 ? "warm-detail-line" : "dark-detail-line", side * (0.31 + index * 0.07), 0.25, -0.245, 0.012, 0.58, 0.012, angle));
+        }
+    }
+    for (let index = 0; index < 7; index += 1) {
+        renderItems.push(item(geometryLibrary, materialLibrary, `headband-machined-groove-${index}`, "headband", index % 2 === 0 ? "dark-detail-line" : "cyan-detail-line", -0.58 + index * 0.19, 0.78, -0.24, 0.08, 0.016, 0.012, angle));
+    }
+    for (let index = 0; index < 6; index += 1) {
+        renderItems.push(item(geometryLibrary, materialLibrary, `control-module-ridge-${index}`, "headband", index % 2 === 0 ? "cyan-detail-line" : "dark-detail-line", 0.78, -0.08 + index * 0.052, -0.26, 0.16, 0.01, 0.01, angle));
+    }
+    for (let index = 0; index < 6; index += 1) {
+        renderItems.push(item(geometryLibrary, materialLibrary, `control-module-vertical-grille-${index}`, "headband", index % 2 === 0 ? "cyan-detail-line" : "dark-detail-line", 0.72 + index * 0.035, 0.06, -0.275, 0.01, 0.34, 0.01, angle));
+    }
+    if (includeStage) {
+        renderItems.push(item(geometryLibrary, materialLibrary, "full-studio-backdrop", "stage", "studio-backdrop", 0, 0.18, -1.48, 7.8, 4.35, 0.05, 0), item(geometryLibrary, materialLibrary, "studio-stage", "stage", "studio-stage", 0, -0.62, -0.42, 4.4, 0.08, 0.16, 0), item(geometryLibrary, materialLibrary, "backdrop", "stage", "studio-backdrop", 0, 0.18, -1.12, 4.4, 2.25, 0.05, 0), item(geometryLibrary, materialLibrary, "stage-accent-stripe-left", "stage", "studio-accent-stripe", -1.04, -0.51, -0.34, 1.18, 0.035, 0.035, 0), item(geometryLibrary, materialLibrary, "stage-accent-stripe-right", "stage", "studio-accent-stripe", 1.04, -0.51, -0.34, 1.18, 0.035, 0.035, 0), item(geometryLibrary, materialLibrary, "left-softbox-panel", "stage", "studio-softbox", -1.78, 0.22, -0.94, 0.12, 1.16, 0.04, 0), item(geometryLibrary, materialLibrary, "right-softbox-panel", "stage", "studio-softbox", 1.78, 0.22, -0.94, 0.12, 1.16, 0.04, 0), item(geometryLibrary, materialLibrary, "top-softbox-panel", "stage", "studio-softbox", 0, 1.08, -0.94, 1.52, 0.07, 0.04, 0));
+        appendTurntableStageDetails(renderItems, geometryLibrary, materialLibrary);
+    }
+    const postprocess = {
+        targetFormat: "rgba16f",
+        toneMapping: {
+            operator: "filmic",
+            exposure: fixture.lighting.activePreset === "dramatic" ? 1.32 : 1.12,
+            gamma: 2.2,
+            inputColorSpace: "linear",
+            outputColorSpace: "srgb"
+        },
+        colorGrade: {
+            contrast: 1.1,
+            saturation: 1.08,
+            vibrance: 0.16,
+            vignette: 0.12,
+            sharpening: 0.28
+        },
+        bloom: { threshold: 0.78, intensity: 0.12, radius: 1 },
+        fxaa: true
+    };
+    const source = {
+        renderItems,
+        cameraPolicy: "auto-frame",
+        cameraFrameBounds: { min: [-1.35, -0.52, -0.38], max: [1.35, 1, 0.42] },
+        collectedLights,
+        // `ambientIntensity` and `environmentIntensity` are preset properties, so they must reach
+        // the frame the renderer actually samples. In this renderer the ambient term *is*
+        // `environmentLighting.intensity`, so the preset's ambient drives that directly rather
+        // than being approximated by an extra directional light. The bundle returned by
+        // `createExternalParityEnvironmentLighting` is cached and shared across callers, so both
+        // values are applied to a copy rather than mutated in place.
+        environmentLighting: applyPresetEnvironmentLighting(environment.lighting, fixture.lighting.ambientIntensity, fixture.lighting.environmentIntensity),
+        shadow: {
+            // `shadowEnabled`/`shadowSoftness` are preset properties, so a preset that declares
+            // shadows off (soft) must actually render without them, and a hard-shadow preset
+            // (dramatic, softness 0.1) must not use the same PCF radius as a diffuse one.
+            enabled: fixture.lighting.shadowEnabled,
+            light: collectedLights[0]?.source,
+            size: 768,
+            strength: 0.42,
+            bias: 0.0025,
+            slopeBias: 1.2,
+            filter: "pcf",
+            pcfRadius: Number((0.6 + fixture.lighting.shadowSoftness * 1.3).toFixed(4)),
+            pcfSamples: 9
+        },
+        postprocess,
+        frustumCulling: false
+    };
+    return {
+        fixture,
+        source,
+        renderItems,
+        geometryLibrary,
+        materialLibrary,
+        bounds: { min: [-2.2, -0.7, -1.18], max: [2.2, 1.13, 0.44] },
+        postprocess,
+        dispose: () => {
+            for (const geometry of geometryLibrary.values())
+                geometry.dispose();
+            for (const texture of textures)
+                texture.dispose();
+        }
+    };
+}
+function appendTurntableStageDetails(renderItems, geometryLibrary, materialLibrary) {
+    for (let index = 0; index < 5; index += 1) {
+        renderItems.push(item(geometryLibrary, materialLibrary, `studio-floor-perspective-line-${index}`, "stage", "dark-detail-line", -1.2 + index * 0.6, -0.62, -0.305, 0.006, 0.58, 0.009, 0));
+    }
+    for (let index = 0; index < 3; index += 1) {
+        renderItems.push(item(geometryLibrary, materialLibrary, `studio-floor-cross-reference-${index}`, "stage", "dark-detail-line", 0, -0.74 + index * 0.14, -0.295, 1.42, 0.007, 0.009, 0));
+    }
+}
+/**
+ * Builds the turntable's three-point rig from the *active lighting preset*.
+ *
+ * These intensities used to be hardcoded, so `lightingPreset` changed only the reported
+ * `fixture.lighting` metadata while every preset rendered an identical frame. That made the
+ * preset a self-reported claim rather than a rendering input, and it left the studio preset
+ * measurably underlit: the kit reported `keyIntensity: 1.5` and `environmentIntensity: 1`
+ * while the rig actually submitted a fixed 2.35 key with no ambient term at all, and the
+ * root quality gate's `salientRatio` sat at 0.096 against its 0.105 floor.
+ *
+ * The preset's `keyIntensity`/`fillIntensity`/`rimIntensity` are relative weights, scaled by
+ * a shared gain so the default studio preset keeps its previously-tuned absolute key value.
+ * `ambientIntensity` is handled separately by `applyPresetEnvironmentLighting`, because in this
+ * renderer the ambient term is `environmentLighting.intensity` rather than a fourth
+ * directional light. Submitting it in both places would double-count it.
+ */
+/**
+ * Applies the active preset's ambient and environment intensities to an environment bundle.
+ *
+ * `ambientIntensity` sets the ambient colour term directly; `environmentIntensity` scales the
+ * sampled environment map and its specular contribution. Textures and samplers are shared by
+ * reference because they are immutable GPU resources, so only scalars differ per preset.
+ */
+function applyPresetEnvironmentLighting(lighting, ambientIntensity, environmentIntensity) {
+    for (const [name, value] of [["ambientIntensity", ambientIntensity], ["environmentIntensity", environmentIntensity]]) {
+        if (!Number.isFinite(value) || value < 0) {
+            throw new RangeError(`Product turntable ${name} must be finite and non-negative`);
+        }
+    }
+    const scaled = (value) => typeof value === "number" ? Number((value * environmentIntensity).toFixed(4)) : value;
+    return {
+        ...lighting,
+        intensity: Number(ambientIntensity.toFixed(4)),
+        ...(typeof lighting.environmentMapIntensity === "number"
+            ? { environmentMapIntensity: scaled(lighting.environmentMapIntensity) }
+            : {}),
+        ...(typeof lighting.environmentMapSpecularIntensity === "number"
+            ? { environmentMapSpecularIntensity: scaled(lighting.environmentMapSpecularIntensity) }
+            : {}),
+        ...(lighting.proceduralMap
+            ? {
+                proceduralMap: {
+                    ...lighting.proceduralMap,
+                    ...(typeof lighting.proceduralMap.intensity === "number"
+                        ? { intensity: scaled(lighting.proceduralMap.intensity) }
+                        : {}),
+                    ...(typeof lighting.proceduralMap.specularIntensity === "number"
+                        ? { specularIntensity: scaled(lighting.proceduralMap.specularIntensity) }
+                        : {})
+                }
+            }
+            : {})
+    };
+}
+function createProductTurntableCollectedLights(lighting) {
+    // Chosen so studio (keyIntensity 1.5) reproduces the previously hardcoded 2.35 key.
+    const gain = 2.35 / 1.5;
+    const keyIntensity = Number((lighting.keyIntensity * gain).toFixed(4));
+    const fillIntensity = Number((lighting.fillIntensity * gain).toFixed(4));
+    const rimIntensity = Number((lighting.rimIntensity * gain).toFixed(4));
+    const key = new DirectionalLight("turntable-key-shadow");
+    const fill = new DirectionalLight("turntable-fill");
+    const rim = new DirectionalLight("turntable-rim");
+    key.castsShadow = lighting.shadowEnabled;
+    key.color = [1, 0.92, 0.78];
+    key.intensity = keyIntensity;
+    fill.color = [0.5, 0.64, 0.95];
+    fill.intensity = fillIntensity;
+    rim.color = [0.85, 0.92, 1];
+    rim.intensity = rimIntensity;
+    return [
+        {
+            kind: "directional",
+            color: [1, 0.92, 0.78],
+            intensity: keyIntensity,
+            position: [0, 0, 0],
+            direction: [0.42, -0.64, -0.64],
+            right: [1, 0, 0],
+            up: [0, 1, 0],
+            range: 0,
+            width: 0,
+            height: 0,
+            spotAngle: 0,
+            penumbra: 0,
+            castsShadow: lighting.shadowEnabled,
+            layerMask: 0xffffffff,
+            source: key
+        },
+        {
+            kind: "directional",
+            color: [0.5, 0.64, 0.95],
+            intensity: fillIntensity,
+            position: [0, 0, 0],
+            direction: [-0.5, -0.3, -0.82],
+            right: [1, 0, 0],
+            up: [0, 1, 0],
+            range: 0,
+            width: 0,
+            height: 0,
+            spotAngle: 0,
+            penumbra: 0,
+            castsShadow: false,
+            layerMask: 0xffffffff,
+            source: fill
+        },
+        {
+            kind: "directional",
+            color: [0.85, 0.92, 1],
+            intensity: rimIntensity,
+            position: [0, 0, 0],
+            direction: [-0.15, -0.12, 0.98],
+            right: [1, 0, 0],
+            up: [0, 1, 0],
+            range: 0,
+            width: 0,
+            height: 0,
+            spotAngle: 0,
+            penumbra: 0,
+            castsShadow: false,
+            layerMask: 0xffffffff,
+            source: rim
+        }
+    ];
+}
+function createHotspots(rotationRadians, canvasWidth, canvasHeight) {
+    const anchors = [
+        {
+            id: "material-finish",
+            group: "material",
+            label: "Metallic shell",
+            content: "Product finish, carbon accent, and procedural roughness maps are bound through the current renderer.",
+            position: [-0.3, 0.24, 0.18],
+            threshold: -0.15
+        },
+        {
+            id: "comfort-band",
+            group: "comfort",
+            label: "Comfort band",
+            content: "Generated multi-part glTF geometry keeps headband and cushion slots independently selectable.",
+            position: [0, 0.52, 0.1],
+            threshold: -0.05
+        },
+        {
+            id: "control-module",
+            group: "controls",
+            label: "Control module",
+            content: "The selected controls part is exposed in runtime state for ecommerce hotspot evidence.",
+            position: [0.38, 0.06, 0.2],
+            threshold: -0.1
+        }
+    ];
+    return anchors.map((anchor, index) => {
+        const projected = projectHotspot(anchor.position, rotationRadians, canvasWidth, canvasHeight, index);
+        return {
+            id: anchor.id,
+            group: anchor.group,
+            label: anchor.label,
+            content: anchor.content,
+            position: anchor.position,
+            screen: projected,
+            visibilityThreshold: anchor.threshold
+        };
+    });
+}
+function productTurntableEnvironmentPreset(preset) {
+    if (preset === "soft" || preset === "neutral")
+        return "softbox";
+    if (preset === "inspection")
+        return "inspection";
+    if (preset === "dramatic")
+        return "exhibit";
+    return "studio";
+}
+function item(geometryLibrary, materialLibrary, label, geometryId, materialId, tx, ty, tz, sx, sy, sz, yawRadians) {
+    const geometry = geometryLibrary.get(geometryId);
+    const material = materialLibrary.get(materialId);
+    if (!geometry)
+        throw new Error(`Missing product turntable geometry: ${geometryId}`);
+    if (!material)
+        throw new Error(`Missing product turntable material: ${materialId}`);
+    return {
+        geometry,
+        material,
+        label,
+        modelMatrix: modelMatrix(tx, ty, tz, sx, sy, sz, yawRadians)
+    };
+}
+function modelMatrix(tx, ty, tz, sx, sy, sz, yawRadians) {
+    const cos = Math.cos(yawRadians);
+    const sin = Math.sin(yawRadians);
+    return new Float32Array([
+        cos * sx, 0, -sin * sx, 0,
+        0, sy, 0, 0,
+        sin * sz, 0, cos * sz, 0,
+        tx, ty, tz, 1
+    ]);
+}
+function projectHotspot(position, rotationRadians, canvasWidth, canvasHeight, index) {
+    const cos = Math.cos(rotationRadians);
+    const sin = Math.sin(rotationRadians);
+    const x = position[0] * cos - position[2] * sin;
+    const z = position[0] * sin + position[2] * cos;
+    const screenX = Math.round(canvasWidth * (0.5 + x * 0.36));
+    const screenY = Math.round(canvasHeight * (0.5 - position[1] * 0.42 + index * 0.018));
+    return {
+        x: screenX,
+        y: screenY,
+        visible: z > -0.38 && screenX >= 0 && screenX <= canvasWidth && screenY >= 0 && screenY <= canvasHeight,
+        occluded: false
+    };
+}
+function createLighting(activePreset) {
+    const descriptor = lightingPresets[activePreset];
+    return {
+        source: "origin-master-ecommerce-lighting-preset-manager-adapted",
+        presets: ["studio", "soft", "inspection", "dramatic", "neutral"],
+        activePreset,
+        transitionSupported: true,
+        ...descriptor
+    };
+}
+function createCapturePlan(captureRequested, exportedBytes) {
+    const completedBatchTasks = captureRequested && exportedBytes > 0 ? 3 : 2;
+    return {
+        source: "origin-master-ecommerce-capture-batch-export-adapted",
+        screenshotFormats: ["png", "jpeg", "webp"],
+        screenshotViews: ["hero", "front", "detail", "exploded"],
+        spinFrameCount: 72,
+        spinDurationSeconds: 4,
+        batchTasks: ["thumbnail", "screenshot", "360-spin", "ar-export"],
+        completedBatchTasks,
+        captureRequested,
+        exportedBytes,
+        arExportFormats: ["glb"],
+        blockedExportClaims: [
+            "native-USDZ-export",
+            "browser-video-recording-pipeline",
+            "AR-Quick-Look-and-Scene-Viewer-platform-parity",
+            "ecommerce-PIM-or-commerce-platform-integration"
+        ]
+    };
+}
+function finiteOrDefault(value, fallback, name) {
+    if (value === undefined)
+        return fallback;
+    if (!Number.isFinite(value) && value !== Number.POSITIVE_INFINITY)
+        throw new RangeError(`${name} must be finite.`);
+    return value;
+}
+function integerOrDefault(value, fallback, name) {
+    if (value === undefined)
+        return fallback;
+    if (!Number.isInteger(value) || value < 0)
+        throw new RangeError(`${name} must be a non-negative integer.`);
+    return value;
+}
+function hashProductTurntable(values) {
+    let hash = 0x811c9dc5;
+    for (const value of values) {
+        const scaled = Math.round(value * 1000);
+        hash ^= scaled & 0xff;
+        hash = Math.imul(hash, 0x01000193) >>> 0;
+        hash ^= (scaled >>> 8) & 0xff;
+        hash = Math.imul(hash, 0x01000193) >>> 0;
+        hash ^= (scaled >>> 16) & 0xff;
+        hash = Math.imul(hash, 0x01000193) >>> 0;
+    }
+    return hash.toString(16).padStart(8, "0");
+}
+//# sourceMappingURL=ProductTurntable.js.map