create-aura3d 3.0.1 → 4.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/dist/agent-skills.d.ts +38 -0
- package/dist/agent-skills.d.ts.map +1 -0
- package/dist/agent-skills.js +103 -0
- package/dist/agent-skills.js.map +1 -0
- package/dist/cli.js +32 -5
- package/dist/cli.js.map +1 -1
- package/dist/index.d.ts +32 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +52 -10
- package/dist/index.js.map +1 -1
- package/dist/showcase-spec-artifacts.d.ts +1 -1
- package/dist/showcase-spec-game-geometry-extractor.js +8 -11
- package/dist/showcase-spec-game-geometry-extractor.js.map +1 -1
- package/dist/template-hdri.d.ts +12 -0
- package/dist/template-hdri.d.ts.map +1 -0
- package/dist/template-hdri.js +49 -0
- package/dist/template-hdri.js.map +1 -0
- package/hdri/ATTRIBUTION.md +8 -0
- package/hdri/autumn_field_puresky_1k.hdr +0 -0
- package/hdri/kloppenheim_06_puresky_1k.hdr +0 -0
- package/hdri/night-2k.hdr +0 -0
- package/hdri/studio_small_08_1k.hdr +0 -0
- package/package.json +14 -10
- package/skills/agent-files/AGENTS.md +3 -0
- package/skills/aura3d-animation-studio/SKILL.md +153 -0
- package/skills/aura3d-animation-studio/references/shot-looks.md +26 -0
- package/skills/aura3d-art-direction/SKILL.md +84 -0
- package/skills/aura3d-art-direction/references/failure-gallery.md +64 -0
- package/skills/aura3d-art-direction/references/framing-and-shots.md +45 -0
- package/skills/aura3d-art-direction/references/look-recipes.md +32 -0
- package/skills/aura3d-art-direction/references/quality-bar.md +103 -0
- package/skills/aura3d-art-direction/references/reference-frames.md +82 -0
- package/skills/aura3d-assets/SKILL.md +132 -0
- package/skills/aura3d-assets/references/preview-under-look.md +26 -0
- package/skills/aura3d-browser-game/SKILL.md +127 -0
- package/skills/aura3d-browser-game/references/genre-looks.md +52 -0
- package/skills/aura3d-character-animation/SKILL.md +129 -0
- package/skills/aura3d-character-animation/references/stage-and-lighting.md +31 -0
- package/skills/aura3d-core/SKILL.md +121 -0
- package/skills/aura3d-core/references/boundaries.md +91 -0
- package/skills/aura3d-evidence-review/SKILL.md +106 -0
- package/skills/aura3d-game-art/SKILL.md +118 -0
- package/skills/aura3d-game-art/references/sheet-check.mjs +58 -0
- package/skills/aura3d-game-art/references/sprite-palettes.md +25 -0
- package/skills/aura3d-materials-environments/SKILL.md +139 -0
- package/skills/aura3d-performance/SKILL.md +97 -0
- package/skills/aura3d-retexture/SKILL.md +115 -0
- package/skills/aura3d-retexture/references/geometry-hash.mjs +89 -0
- package/skills/aura3d-scene-authoring/SKILL.md +132 -0
- package/skills/aura3d-scene-authoring/references/look-by-family.md +28 -0
- package/skills/aura3d-threejs-migration/SKILL.md +125 -0
- package/skills/aura3d-threejs-migration/references/look-mapping.md +27 -0
- package/skills/llms.txt +117 -0
- package/skills/manifest.json +163 -0
- package/skills/meshy-cli/SKILL.md +133 -0
- package/templates/animation-channel/.claude/CLAUDE.md +3 -0
- package/templates/animation-channel/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/animation-channel/AGENTS.md +3 -0
- package/templates/animation-channel/package.json +3 -2
- package/templates/animation-channel/src/main.ts +5 -6
- package/templates/animation-channel/src/render-plan.ts +5 -3
- package/templates/animation-channel/tests/look-floor.ts +270 -0
- package/templates/animation-channel/tests/route-health.spec.ts +1 -1
- package/templates/animation-channel/tests/screenshot.spec.ts +10 -5
- package/templates/animation-channel/vite.config.ts +7 -0
- package/templates/animation-studio/.claude/CLAUDE.md +3 -0
- package/templates/animation-studio/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/animation-studio/AGENTS.md +2 -70
- package/templates/animation-studio/package.json +4 -3
- package/templates/animation-studio/scripts/build-clip-library.ts +6 -5
- package/templates/animation-studio/scripts/resolve-asset.ts +7 -4
- package/templates/animation-studio/src/scene-player.ts +6 -6
- package/templates/animation-studio/src/set-templates.ts +13 -9
- package/templates/animation-studio/tests/look-floor.ts +270 -0
- package/templates/animation-studio/tests/route-health.spec.ts +2 -2
- package/templates/animation-studio/tests/screenshot.spec.ts +18 -10
- package/templates/animation-studio/vite.config.ts +2 -0
- package/templates/architecture-interior/.claude/CLAUDE.md +3 -0
- package/templates/architecture-interior/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/architecture-interior/AGENTS.md +3 -0
- package/templates/architecture-interior/README.md +16 -0
- package/templates/architecture-interior/aura.assets.json +24 -0
- package/templates/architecture-interior/package.json +24 -0
- package/templates/architecture-interior/public/aura-assets/kenneyModularDungeonRoomSmall.a7e74a5f.glb +0 -0
- package/templates/architecture-interior/src/aura-assets.ts +16 -0
- package/templates/architecture-interior/src/main.ts +23 -0
- package/templates/architecture-interior/tests/look-floor.ts +270 -0
- package/templates/{three-compat-architecture-interior → architecture-interior}/tests/route-health.spec.ts +3 -3
- package/templates/architecture-interior/tests/screenshot.spec.ts +21 -0
- package/templates/architecture-interior/vite.config.ts +7 -0
- package/templates/arena-shooter/.claude/CLAUDE.md +3 -0
- package/templates/arena-shooter/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/arena-shooter/AGENTS.md +3 -0
- package/templates/arena-shooter/README.md +45 -0
- package/templates/arena-shooter/aura.assets.json +62 -0
- package/templates/arena-shooter/index.html +32 -0
- package/templates/arena-shooter/package.json +23 -0
- package/templates/arena-shooter/playwright.config.ts +15 -0
- package/templates/arena-shooter/public/aura-assets/craft_miner.de323205.glb +0 -0
- package/templates/arena-shooter/public/aura-assets/craft_racer.bce8cb3d.glb +0 -0
- package/templates/arena-shooter/public/aura-assets/meteor_detailed.f30379ab.glb +0 -0
- package/templates/arena-shooter/src/aura-assets.ts +56 -0
- package/templates/arena-shooter/src/main.ts +616 -0
- package/templates/arena-shooter/tests/look-floor.ts +270 -0
- package/templates/arena-shooter/tests/playable.spec.ts +56 -0
- package/templates/arena-shooter/tests/route-health.spec.ts +87 -0
- package/templates/arena-shooter/tests/screenshot.spec.ts +22 -0
- package/templates/arena-shooter/tsconfig.json +15 -0
- package/templates/arena-shooter/vite.config.ts +7 -0
- package/templates/asset-inspector/.claude/CLAUDE.md +3 -0
- package/templates/asset-inspector/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/asset-inspector/AGENTS.md +3 -0
- package/templates/asset-inspector/README.md +13 -0
- package/templates/asset-inspector/aura.assets.json +24 -0
- package/templates/{three-compat-custom-threejs-migration → asset-inspector}/package.json +5 -3
- package/templates/asset-inspector/public/aura-assets/kenneyCarKitSedanSports.2889c428.glb +0 -0
- package/templates/asset-inspector/src/aura-assets.ts +16 -0
- package/templates/asset-inspector/src/main.ts +23 -0
- package/templates/asset-inspector/tests/look-floor.ts +270 -0
- package/templates/{three-compat-character-viewer → asset-inspector}/tests/route-health.spec.ts +3 -3
- package/templates/asset-inspector/tests/screenshot.spec.ts +21 -0
- package/templates/asset-inspector/vite.config.ts +7 -0
- package/templates/character-controller/.claude/CLAUDE.md +3 -0
- package/templates/character-controller/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/character-controller/AGENTS.md +3 -0
- package/templates/character-controller/README.md +7 -1
- package/templates/character-controller/aura.assets.json +29 -22
- package/templates/character-controller/index.html +4 -5
- package/templates/character-controller/package.json +5 -4
- package/templates/character-controller/public/aura-assets/auraclash-player-rig.glb +0 -0
- package/templates/character-controller/src/aura-assets.ts +25 -7
- package/templates/character-controller/src/main.ts +190 -47
- package/templates/character-controller/tests/certified-rig.spec.ts +2 -2
- package/templates/character-controller/tests/look-floor.ts +270 -0
- package/templates/character-controller/tests/route-health.spec.ts +31 -6
- package/templates/character-controller/tests/screenshot.spec.ts +17 -5
- package/templates/character-controller/vite.config.ts +7 -0
- package/templates/character-viewer/.claude/CLAUDE.md +3 -0
- package/templates/character-viewer/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/character-viewer/AGENTS.md +3 -0
- package/templates/character-viewer/README.md +13 -0
- package/templates/character-viewer/aura.assets.json +24 -0
- package/templates/{three-compat-asset-inspector → character-viewer}/package.json +5 -3
- package/templates/character-viewer/public/aura-assets/kenneyMiniForestCharacterArcher.0fd0f92e.glb +0 -0
- package/templates/character-viewer/src/aura-assets.ts +16 -0
- package/templates/character-viewer/src/main.ts +21 -0
- package/templates/character-viewer/tests/look-floor.ts +270 -0
- package/templates/{three-compat-custom-threejs-migration → character-viewer}/tests/route-health.spec.ts +3 -3
- package/templates/character-viewer/tests/screenshot.spec.ts +21 -0
- package/templates/character-viewer/vite.config.ts +7 -0
- package/templates/cinematic-scene/.claude/CLAUDE.md +3 -0
- package/templates/cinematic-scene/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/cinematic-scene/AGENTS.md +3 -0
- package/templates/cinematic-scene/README.md +11 -2
- package/templates/cinematic-scene/package.json +3 -2
- package/templates/cinematic-scene/src/main.ts +30 -7
- package/templates/cinematic-scene/tests/look-floor.ts +270 -0
- package/templates/cinematic-scene/tests/route-health.spec.ts +31 -3
- package/templates/cinematic-scene/tests/screenshot.spec.ts +34 -45
- package/templates/cinematic-scene/vite.config.ts +7 -0
- package/templates/custom-scene/.claude/CLAUDE.md +3 -0
- package/templates/custom-scene/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/custom-scene/AGENTS.md +3 -0
- package/templates/custom-scene/README.md +13 -0
- package/templates/custom-scene/aura.assets.json +24 -0
- package/templates/{three-compat-character-viewer → custom-scene}/package.json +5 -3
- package/templates/custom-scene/public/aura-assets/kenneyPirateKitShipMedium.279ea019.glb +0 -0
- package/templates/custom-scene/src/aura-assets.ts +16 -0
- package/templates/custom-scene/src/main.ts +23 -0
- package/templates/custom-scene/tests/look-floor.ts +270 -0
- package/templates/{three-compat-asset-inspector → custom-scene}/tests/route-health.spec.ts +3 -3
- package/templates/custom-scene/tests/screenshot.spec.ts +21 -0
- package/templates/custom-scene/vite.config.ts +7 -0
- package/templates/episode-builder/.claude/CLAUDE.md +3 -0
- package/templates/episode-builder/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/episode-builder/AGENTS.md +3 -0
- package/templates/episode-builder/package.json +3 -2
- package/templates/episode-builder/src/main.ts +5 -3
- package/templates/episode-builder/src/render-plan.ts +5 -3
- package/templates/episode-builder/tests/look-floor.ts +270 -0
- package/templates/episode-builder/tests/screenshot.spec.ts +10 -4
- package/templates/episode-builder/vite.config.ts +7 -0
- package/templates/falling-blocks-starter/.claude/CLAUDE.md +3 -0
- package/templates/falling-blocks-starter/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/falling-blocks-starter/AGENTS.md +3 -0
- package/templates/falling-blocks-starter/README.md +10 -1
- package/templates/falling-blocks-starter/aura.assets.json +40 -23
- package/templates/falling-blocks-starter/package.json +3 -2
- package/templates/falling-blocks-starter/public/aura-assets/quaternius-cube-crate.glb +0 -0
- package/templates/falling-blocks-starter/public/aura-assets/quaternius-wall-modular.glb +0 -0
- package/templates/falling-blocks-starter/src/aura-assets.ts +33 -10
- package/templates/falling-blocks-starter/src/main.ts +316 -117
- package/templates/falling-blocks-starter/tests/look-floor.ts +270 -0
- package/templates/falling-blocks-starter/tests/playable.spec.ts +51 -18
- package/templates/falling-blocks-starter/tests/route-health.spec.ts +17 -7
- package/templates/falling-blocks-starter/tests/screenshot.spec.ts +21 -0
- package/templates/falling-blocks-starter/vite.config.ts +7 -0
- package/templates/fighting-game/.claude/CLAUDE.md +3 -0
- package/templates/fighting-game/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/fighting-game/AGENTS.md +3 -0
- package/templates/fighting-game/README.md +2 -0
- package/templates/fighting-game/aura.assets.json +56 -46
- package/templates/fighting-game/package.json +4 -2
- package/templates/fighting-game/public/aura-assets/auraclash-player-rig.glb +0 -0
- package/templates/fighting-game/public/aura-assets/auraclash-rival-rig.glb +0 -0
- package/templates/fighting-game/src/aura-assets.ts +54 -20
- package/templates/fighting-game/src/game/fighters.ts +57 -12
- package/templates/fighting-game/src/main.ts +135 -53
- package/templates/fighting-game/tests/certified-rig.spec.ts +1 -1
- package/templates/fighting-game/tests/gameplay-smoke.spec.ts +2 -8
- package/templates/fighting-game/tests/look-floor.ts +270 -0
- package/templates/fighting-game/tests/route-health.spec.ts +12 -4
- package/templates/fighting-game/tests/screenshot.spec.ts +10 -4
- package/templates/fighting-game/vite.config.ts +7 -0
- package/templates/large-scene/.claude/CLAUDE.md +3 -0
- package/templates/large-scene/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/large-scene/AGENTS.md +3 -0
- package/templates/large-scene/README.md +13 -0
- package/templates/large-scene/aura.assets.json +40 -0
- package/templates/{three-compat-architecture-interior → large-scene}/package.json +5 -3
- package/templates/large-scene/public/aura-assets/kenneyMiniForestRocksHigh.226728a0.glb +0 -0
- package/templates/large-scene/public/aura-assets/kenneyMiniForestTree.0075d505.glb +0 -0
- package/templates/large-scene/src/aura-assets.ts +28 -0
- package/templates/large-scene/src/main.ts +43 -0
- package/templates/large-scene/tests/look-floor.ts +270 -0
- package/templates/large-scene/tests/route-health.spec.ts +16 -0
- package/templates/large-scene/tests/screenshot.spec.ts +21 -0
- package/templates/large-scene/vite.config.ts +7 -0
- package/templates/material-authoring/.claude/CLAUDE.md +3 -0
- package/templates/material-authoring/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/material-authoring/AGENTS.md +3 -0
- package/templates/material-authoring/README.md +15 -0
- package/templates/material-authoring/aura.assets.json +24 -0
- package/templates/material-authoring/package.json +24 -0
- package/templates/material-authoring/public/aura-assets/kenneyCarKitSedanSports.2889c428.glb +0 -0
- package/templates/material-authoring/src/aura-assets.ts +16 -0
- package/templates/material-authoring/src/main.ts +78 -0
- package/templates/material-authoring/tests/look-floor.ts +270 -0
- package/templates/material-authoring/tests/route-health.spec.ts +16 -0
- package/templates/material-authoring/tests/screenshot.spec.ts +21 -0
- package/templates/material-authoring/vite.config.ts +7 -0
- package/templates/mini-game/.claude/CLAUDE.md +3 -0
- package/templates/mini-game/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/mini-game/AGENTS.md +3 -0
- package/templates/mini-game/README.md +9 -6
- package/templates/mini-game/aura.assets.json +177 -36
- package/templates/mini-game/package.json +3 -1
- package/templates/mini-game/public/aura-assets/kaykit-barbarian.glb +0 -0
- package/templates/mini-game/public/aura-assets/kenneyPlatformerKitKey.2e930961.glb +0 -0
- package/templates/mini-game/public/aura-assets/kenneyPlatformerKitStar.a102a1b9.glb +0 -0
- package/templates/mini-game/public/aura-assets/quaternius-crate.glb +0 -0
- package/templates/mini-game/public/aura-assets/quaternius-cube-crate.glb +0 -0
- package/templates/mini-game/src/aura-assets.ts +140 -32
- package/templates/mini-game/src/main.ts +204 -71
- package/templates/mini-game/tests/certified-rig.spec.ts +2 -2
- package/templates/mini-game/tests/look-floor.ts +270 -0
- package/templates/mini-game/tests/playable.spec.ts +23 -2
- package/templates/mini-game/tests/route-health.spec.ts +2 -2
- package/templates/mini-game/tests/screenshot.spec.ts +44 -53
- package/templates/mini-game/vite.config.ts +7 -0
- package/templates/postprocess-scene/.claude/CLAUDE.md +3 -0
- package/templates/postprocess-scene/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/postprocess-scene/AGENTS.md +3 -0
- package/templates/postprocess-scene/README.md +17 -0
- package/templates/postprocess-scene/aura.assets.json +38 -0
- package/templates/postprocess-scene/package.json +24 -0
- package/templates/postprocess-scene/public/aura-assets/showcaseLuma.ef389217.glb +0 -0
- package/templates/postprocess-scene/public/aura-assets/showcaseMiko.fcdc2b75.glb +0 -0
- package/templates/postprocess-scene/src/aura-assets.ts +28 -0
- package/templates/postprocess-scene/src/main.ts +29 -0
- package/templates/postprocess-scene/tests/look-floor.ts +270 -0
- package/templates/postprocess-scene/tests/route-health.spec.ts +16 -0
- package/templates/postprocess-scene/tests/screenshot.spec.ts +21 -0
- package/templates/postprocess-scene/vite.config.ts +7 -0
- package/templates/premium-product-viewer/.claude/CLAUDE.md +3 -0
- package/templates/premium-product-viewer/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/premium-product-viewer/AGENTS.md +3 -0
- package/templates/premium-product-viewer/README.md +18 -0
- package/templates/premium-product-viewer/aura.assets.json +24 -0
- package/templates/premium-product-viewer/package.json +24 -0
- package/templates/premium-product-viewer/public/aura-assets/khronosToyCar.01a60862.glb +0 -0
- package/templates/premium-product-viewer/src/aura-assets.ts +16 -0
- package/templates/premium-product-viewer/src/main.ts +33 -0
- package/templates/premium-product-viewer/tests/look-floor.ts +270 -0
- package/templates/premium-product-viewer/tests/route-health.spec.ts +16 -0
- package/templates/premium-product-viewer/tests/screenshot.spec.ts +21 -0
- package/templates/premium-product-viewer/vite.config.ts +7 -0
- package/templates/product-viewer/.claude/CLAUDE.md +3 -0
- package/templates/product-viewer/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/product-viewer/AGENTS.md +3 -0
- package/templates/product-viewer/README.md +10 -8
- package/templates/product-viewer/package.json +3 -1
- package/templates/product-viewer/src/aura-assets.ts +1 -1
- package/templates/product-viewer/src/main.ts +78 -19
- package/templates/product-viewer/tests/look-floor.ts +270 -0
- package/templates/product-viewer/tests/route-health.spec.ts +19 -1
- package/templates/product-viewer/tests/screenshot.spec.ts +35 -41
- package/templates/product-viewer/vite.config.ts +7 -0
- package/templates/prompt-animation-channel/.claude/CLAUDE.md +3 -0
- package/templates/prompt-animation-channel/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/prompt-animation-channel/AGENTS.md +3 -0
- package/templates/prompt-animation-channel/package.json +3 -2
- package/templates/prompt-animation-channel/src/main.ts +5 -3
- package/templates/prompt-animation-channel/src/render-plan.ts +5 -3
- package/templates/prompt-animation-channel/tests/look-floor.ts +270 -0
- package/templates/prompt-animation-channel/tests/route-health.spec.ts +1 -1
- package/templates/prompt-animation-channel/tests/screenshot.spec.ts +10 -4
- package/templates/prompt-animation-channel/tests/storyboard-playback.spec.ts +1 -1
- package/templates/prompt-animation-channel/vite.config.ts +7 -0
- package/templates/racing-starter/.claude/CLAUDE.md +3 -0
- package/templates/racing-starter/.github/workflows/aura3d-lookdev.yml +67 -0
- package/templates/racing-starter/AGENTS.md +3 -0
- package/templates/racing-starter/README.md +8 -6
- package/templates/racing-starter/package.json +3 -2
- package/templates/racing-starter/src/main.ts +168 -146
- package/templates/racing-starter/tests/geometry-certification.json +34 -0
- package/templates/racing-starter/tests/look-floor.ts +270 -0
- package/templates/racing-starter/tests/playable.spec.ts +63 -80
- package/templates/racing-starter/tests/route-health.spec.ts +14 -12
- package/templates/racing-starter/tests/screenshot.spec.ts +21 -0
- package/templates/racing-starter/vite.config.ts +7 -0
- package/templates/character-controller/public/aura-assets/showcaseWalkAnimatedGirl.93872fc2.glb +0 -0
- package/templates/character-controller/public/aura-assets/showcaseWalkAnimatedGirl.thumb.svg +0 -1
- package/templates/falling-blocks-starter/public/aura-assets/showcaseBlockfallCabinet.679d52fe.glb +0 -0
- package/templates/falling-blocks-starter/public/aura-assets/showcaseBlockfallCabinet.thumb.svg +0 -1
- package/templates/fighting-game/public/aura-assets/showcaseRunnerRobot.252b3a16.glb +0 -0
- package/templates/fighting-game/public/aura-assets/showcaseRunnerRobot.thumb.svg +0 -1
- package/templates/fighting-game/public/aura-assets/showcaseWalkAnimatedGirl.93872fc2.glb +0 -0
- package/templates/fighting-game/public/aura-assets/showcaseWalkAnimatedGirl.thumb.svg +0 -1
- package/templates/mini-game/public/aura-assets/showcaseKenneyOobiPlatformerHero.3f821141.glb +0 -0
- package/templates/mini-game/public/aura-assets/showcaseKenneyOobiPlatformerHero.thumb.svg +0 -1
- package/templates/three-compat-architecture-interior/aura.assets.json +0 -7
- package/templates/three-compat-architecture-interior/src/aura-assets.ts +0 -3
- package/templates/three-compat-architecture-interior/src/main.ts +0 -27
- package/templates/three-compat-architecture-interior/tests/screenshot.spec.ts +0 -15
- package/templates/three-compat-asset-inspector/aura.assets.json +0 -7
- package/templates/three-compat-asset-inspector/src/aura-assets.ts +0 -3
- package/templates/three-compat-asset-inspector/src/main.ts +0 -17
- package/templates/three-compat-asset-inspector/tests/screenshot.spec.ts +0 -15
- package/templates/three-compat-character-viewer/aura.assets.json +0 -7
- package/templates/three-compat-character-viewer/src/aura-assets.ts +0 -3
- package/templates/three-compat-character-viewer/src/main.ts +0 -17
- package/templates/three-compat-character-viewer/tests/screenshot.spec.ts +0 -15
- package/templates/three-compat-custom-threejs-migration/aura.assets.json +0 -7
- package/templates/three-compat-custom-threejs-migration/src/aura-assets.ts +0 -3
- package/templates/three-compat-custom-threejs-migration/src/main.ts +0 -16
- package/templates/three-compat-custom-threejs-migration/tests/screenshot.spec.ts +0 -15
- package/templates/three-compat-large-scene/aura.assets.json +0 -7
- package/templates/three-compat-large-scene/package.json +0 -22
- package/templates/three-compat-large-scene/src/aura-assets.ts +0 -3
- package/templates/three-compat-large-scene/src/main.ts +0 -31
- package/templates/three-compat-large-scene/tests/route-health.spec.ts +0 -16
- package/templates/three-compat-large-scene/tests/screenshot.spec.ts +0 -15
- package/templates/three-compat-material-authoring/aura.assets.json +0 -7
- package/templates/three-compat-material-authoring/package.json +0 -22
- package/templates/three-compat-material-authoring/src/aura-assets.ts +0 -3
- package/templates/three-compat-material-authoring/src/main.ts +0 -33
- package/templates/three-compat-material-authoring/tests/route-health.spec.ts +0 -16
- package/templates/three-compat-material-authoring/tests/screenshot.spec.ts +0 -15
- package/templates/three-compat-postprocess-scene/aura.assets.json +0 -7
- package/templates/three-compat-postprocess-scene/package.json +0 -22
- package/templates/three-compat-postprocess-scene/src/aura-assets.ts +0 -3
- package/templates/three-compat-postprocess-scene/src/main.ts +0 -17
- package/templates/three-compat-postprocess-scene/tests/route-health.spec.ts +0 -16
- package/templates/three-compat-postprocess-scene/tests/screenshot.spec.ts +0 -15
- package/templates/three-compat-premium-product-viewer/aura.assets.json +0 -7
- package/templates/three-compat-premium-product-viewer/package.json +0 -22
- package/templates/three-compat-premium-product-viewer/src/aura-assets.ts +0 -3
- package/templates/three-compat-premium-product-viewer/src/main.ts +0 -18
- package/templates/three-compat-premium-product-viewer/tests/route-health.spec.ts +0 -16
- package/templates/three-compat-premium-product-viewer/tests/screenshot.spec.ts +0 -15
- /package/templates/{three-compat-architecture-interior → architecture-interior}/index.html +0 -0
- /package/templates/{three-compat-architecture-interior → architecture-interior}/playwright.config.ts +0 -0
- /package/templates/{three-compat-architecture-interior → architecture-interior}/tsconfig.json +0 -0
- /package/templates/{three-compat-asset-inspector → asset-inspector}/index.html +0 -0
- /package/templates/{three-compat-asset-inspector → asset-inspector}/playwright.config.ts +0 -0
- /package/templates/{three-compat-asset-inspector → asset-inspector}/tsconfig.json +0 -0
- /package/templates/{three-compat-character-viewer → character-viewer}/index.html +0 -0
- /package/templates/{three-compat-character-viewer → character-viewer}/playwright.config.ts +0 -0
- /package/templates/{three-compat-character-viewer → character-viewer}/tsconfig.json +0 -0
- /package/templates/{three-compat-custom-threejs-migration → custom-scene}/index.html +0 -0
- /package/templates/{three-compat-custom-threejs-migration → custom-scene}/playwright.config.ts +0 -0
- /package/templates/{three-compat-custom-threejs-migration → custom-scene}/tsconfig.json +0 -0
- /package/templates/{three-compat-large-scene → large-scene}/index.html +0 -0
- /package/templates/{three-compat-large-scene → large-scene}/playwright.config.ts +0 -0
- /package/templates/{three-compat-large-scene → large-scene}/tsconfig.json +0 -0
- /package/templates/{three-compat-material-authoring → material-authoring}/index.html +0 -0
- /package/templates/{three-compat-material-authoring → material-authoring}/playwright.config.ts +0 -0
- /package/templates/{three-compat-material-authoring → material-authoring}/tsconfig.json +0 -0
- /package/templates/{three-compat-postprocess-scene → postprocess-scene}/index.html +0 -0
- /package/templates/{three-compat-postprocess-scene → postprocess-scene}/playwright.config.ts +0 -0
- /package/templates/{three-compat-postprocess-scene → postprocess-scene}/tsconfig.json +0 -0
- /package/templates/{three-compat-premium-product-viewer → premium-product-viewer}/index.html +0 -0
- /package/templates/{three-compat-premium-product-viewer → premium-product-viewer}/playwright.config.ts +0 -0
- /package/templates/{three-compat-premium-product-viewer → premium-product-viewer}/tsconfig.json +0 -0
|
@@ -0,0 +1,270 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PRD-13 T3.12/T3.13 — the shared template look floor.
|
|
3
|
+
*
|
|
4
|
+
* Every create-aura3d template's `tests/screenshot.spec.ts` calls
|
|
5
|
+
* `assertTemplateLookFloor(page, ...)` after readiness: the same five checks
|
|
6
|
+
* everywhere (PRD §6.5/T3.12):
|
|
7
|
+
*
|
|
8
|
+
* 1. non-blank — sampled WebGL pixels are lit and varied (not a uniform
|
|
9
|
+
* clear/void frame);
|
|
10
|
+
* 2. `diagnostics().look.lint` carries no `severity === "error"` finding
|
|
11
|
+
* (empty when A3D_QR_LOOKS is off — the check never silently skips);
|
|
12
|
+
* 3. `appliedLook.environment.specularIntensity > 0` — an environment map
|
|
13
|
+
* actually reached the frame;
|
|
14
|
+
* 4. `appliedLook.shadows.strength >= 0.8` when the look declares a shadow
|
|
15
|
+
* caster (a null ShadowReport means the renderer produced no shadow
|
|
16
|
+
* evidence — recorded, not failed);
|
|
17
|
+
* 5. `appliedLook.pixelRatio >= min(devicePixelRatio, tierCap)` — the
|
|
18
|
+
* renderer used the display density up to the tier cap (2).
|
|
19
|
+
*
|
|
20
|
+
* …plus the optional §T3.12 subject check: the lit-pixel bounding box of the
|
|
21
|
+
* canvas' central region must sit within `tolerance` of the expected subject
|
|
22
|
+
* bounds (default ±10% of frame).
|
|
23
|
+
*
|
|
24
|
+
* Templates that mount through `createAuraApp` surface `appliedLook`/`look`
|
|
25
|
+
* via the global `__AURA3D_LIVE_APPS__` registry — no per-template wiring.
|
|
26
|
+
* `skipAppDiagnostics` covers the bespoke-renderer template (animation-studio),
|
|
27
|
+
* which reports its stage environment through its own readiness evidence.
|
|
28
|
+
*/
|
|
29
|
+
|
|
30
|
+
import { expect, type Page } from "@playwright/test";
|
|
31
|
+
|
|
32
|
+
/** Normalized canvas-space bounds the lit subject mass is expected to occupy. */
|
|
33
|
+
export interface LookFloorSubjectBounds {
|
|
34
|
+
readonly x: number;
|
|
35
|
+
readonly y: number;
|
|
36
|
+
readonly width: number;
|
|
37
|
+
readonly height: number;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
export interface LookFloorOptions {
|
|
41
|
+
/** Expected subject bounds in normalized canvas units. Omit to skip. */
|
|
42
|
+
readonly subject?: LookFloorSubjectBounds;
|
|
43
|
+
/** Fractional tolerance on each bound axis. Default 0.1 (±10%). */
|
|
44
|
+
readonly tolerance?: number;
|
|
45
|
+
/** Template has no `__AURA3D_LIVE_APPS__` app (bespoke renderer). */
|
|
46
|
+
readonly skipAppDiagnostics?: boolean;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
export interface LookFloorReport {
|
|
50
|
+
readonly sampledPixels: number;
|
|
51
|
+
readonly brightPixels: number;
|
|
52
|
+
readonly uniqueBuckets: number;
|
|
53
|
+
readonly subjectBounds: LookFloorSubjectBounds | null;
|
|
54
|
+
readonly appliedLook: {
|
|
55
|
+
readonly specularIntensity: number;
|
|
56
|
+
readonly shadowStrength: number | null;
|
|
57
|
+
readonly pixelRatio: number;
|
|
58
|
+
readonly renderPath: string;
|
|
59
|
+
readonly background: string | null;
|
|
60
|
+
} | null;
|
|
61
|
+
readonly lookLintErrors: readonly string[];
|
|
62
|
+
readonly devicePixelRatio: number;
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
const MIN_BRIGHT_FRACTION = 0.02;
|
|
66
|
+
const MIN_UNIQUE_BUCKETS = 8;
|
|
67
|
+
|
|
68
|
+
export async function assertTemplateLookFloor(page: Page, options: LookFloorOptions = {}): Promise<LookFloorReport> {
|
|
69
|
+
const canvas = page.locator("canvas").first();
|
|
70
|
+
await expect(canvas).toBeVisible();
|
|
71
|
+
|
|
72
|
+
/*
|
|
73
|
+
* Deterministic frame before profiling: pause every live app, rewind its
|
|
74
|
+
* runtime clock and step a fixed 45 frames at 1/60 — through `stepAsync`,
|
|
75
|
+
* not the synchronous registry `settle()`. The production renderer mounts
|
|
76
|
+
* asynchronously, so a sync step loop renders nothing while the mount is in
|
|
77
|
+
* flight and never yields for it to finish (the failure mode on software-GL
|
|
78
|
+
* runners: blank frames, `environment.intensity` still NaN in diagnostics).
|
|
79
|
+
* Awaiting each step also lets pending environment/IBL/asset promises resolve
|
|
80
|
+
* between frames, and one final dt=0 step re-renders the same simulated
|
|
81
|
+
* instant once that work has applied.
|
|
82
|
+
*/
|
|
83
|
+
const report = await page.evaluate(async (): Promise<LookFloorReport> => {
|
|
84
|
+
interface LiveApp {
|
|
85
|
+
pause?: () => void;
|
|
86
|
+
resetRuntimeClock?: () => void;
|
|
87
|
+
step?: (dt?: number) => void;
|
|
88
|
+
stepAsync?: (dt?: number) => Promise<unknown>;
|
|
89
|
+
diagnostics?: () => Record<string, unknown>;
|
|
90
|
+
}
|
|
91
|
+
const empty = (code: string): LookFloorReport => ({
|
|
92
|
+
sampledPixels: 0,
|
|
93
|
+
brightPixels: 0,
|
|
94
|
+
uniqueBuckets: 0,
|
|
95
|
+
subjectBounds: null,
|
|
96
|
+
appliedLook: null,
|
|
97
|
+
lookLintErrors: [code],
|
|
98
|
+
devicePixelRatio: globalThis.devicePixelRatio ?? 1
|
|
99
|
+
});
|
|
100
|
+
const registry = (globalThis as { __AURA3D_LIVE_APPS__?: { all?: () => readonly LiveApp[] } }).__AURA3D_LIVE_APPS__;
|
|
101
|
+
const apps = [...(registry?.all?.() ?? [])];
|
|
102
|
+
const stepApp = async (app: LiveApp, dt: number): Promise<void> => {
|
|
103
|
+
if (app.stepAsync) {
|
|
104
|
+
try {
|
|
105
|
+
await Promise.race([
|
|
106
|
+
app.stepAsync(dt),
|
|
107
|
+
new Promise((resolvePromise) => setTimeout(resolvePromise, 30_000))
|
|
108
|
+
]);
|
|
109
|
+
return;
|
|
110
|
+
} catch {
|
|
111
|
+
// synchronous step fallback below
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
app.step?.(dt);
|
|
115
|
+
};
|
|
116
|
+
/*
|
|
117
|
+
* Wall-clock bound on the settle loop: on software-GL CI runners a single
|
|
118
|
+
* stepped render of a heavy scene costs several seconds, so an unbounded
|
|
119
|
+
* 45-step loop outlives the test budget and fails with a bare timeout and
|
|
120
|
+
* no report. Cap the stepping and always take the dt=0 settle frame — a
|
|
121
|
+
* partially settled scene still yields a readable floor report.
|
|
122
|
+
*/
|
|
123
|
+
const STEP_WALLCLOCK_BUDGET_MS = 420_000;
|
|
124
|
+
const settleStartedAt = Date.now();
|
|
125
|
+
for (const app of apps) {
|
|
126
|
+
app.pause?.();
|
|
127
|
+
app.resetRuntimeClock?.();
|
|
128
|
+
for (let index = 0; index < 45; index += 1) {
|
|
129
|
+
if (Date.now() - settleStartedAt > STEP_WALLCLOCK_BUDGET_MS) break;
|
|
130
|
+
await stepApp(app, 1 / 60);
|
|
131
|
+
}
|
|
132
|
+
await stepApp(app, 0);
|
|
133
|
+
}
|
|
134
|
+
/*
|
|
135
|
+
* Renderers outside the liveApps registry (bespoke renderers, e.g.
|
|
136
|
+
* animation-studio's A3DRenderer) cannot be stepped. Two animation
|
|
137
|
+
* frames guarantee at least one full app render finished inside this
|
|
138
|
+
* evaluate task, so the readPixels below sees a real presented frame
|
|
139
|
+
* instead of a compositor-cleared buffer.
|
|
140
|
+
*/
|
|
141
|
+
if (apps.length === 0) {
|
|
142
|
+
await new Promise<void>((resolve) => {
|
|
143
|
+
requestAnimationFrame(() => requestAnimationFrame(() => resolve()));
|
|
144
|
+
});
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
const diagnostics = apps[0]?.diagnostics?.() as
|
|
148
|
+
| { appliedLook?: { environment?: { specularIntensity?: number; background?: string }; shadows?: { strength?: number | null } | null; pixelRatio?: number; renderPath?: string }; look?: { lint?: readonly { severity?: string; code?: string }[] } }
|
|
149
|
+
| undefined;
|
|
150
|
+
const appliedLook = diagnostics?.appliedLook
|
|
151
|
+
? {
|
|
152
|
+
specularIntensity: diagnostics.appliedLook.environment?.specularIntensity ?? 0,
|
|
153
|
+
shadowStrength: diagnostics.appliedLook.shadows?.strength ?? null,
|
|
154
|
+
pixelRatio: diagnostics.appliedLook.pixelRatio ?? 0,
|
|
155
|
+
renderPath: diagnostics.appliedLook.renderPath ?? "unknown",
|
|
156
|
+
background: diagnostics.appliedLook.environment?.background ?? null
|
|
157
|
+
}
|
|
158
|
+
: null;
|
|
159
|
+
const lookLintErrors = (diagnostics?.look?.lint ?? [])
|
|
160
|
+
.filter((finding) => finding.severity === "error")
|
|
161
|
+
.map((finding) => finding.code ?? "unknown");
|
|
162
|
+
const devicePixelRatio = globalThis.devicePixelRatio ?? 1;
|
|
163
|
+
|
|
164
|
+
/*
|
|
165
|
+
* The app's WebGL context is not preserveDrawingBuffer, so readPixels must
|
|
166
|
+
* run in the same task as the stepped render, before compositing clears the
|
|
167
|
+
* drawing buffer. That also removes the composited element screenshot that
|
|
168
|
+
* software-GL runners could not produce inside a test timeout.
|
|
169
|
+
*/
|
|
170
|
+
const target = [...document.querySelectorAll("canvas")]
|
|
171
|
+
.map((element) => ({
|
|
172
|
+
element,
|
|
173
|
+
gl: (element.getContext("webgl2") ?? element.getContext("webgl")) as WebGL2RenderingContext | WebGLRenderingContext | null
|
|
174
|
+
}))
|
|
175
|
+
.find((entry) => entry.gl !== null);
|
|
176
|
+
if (!target?.gl) return { ...empty("no-webgl-context"), appliedLook, lookLintErrors };
|
|
177
|
+
const gl = target.gl;
|
|
178
|
+
const width = gl.drawingBufferWidth;
|
|
179
|
+
const height = gl.drawingBufferHeight;
|
|
180
|
+
if (width === 0 || height === 0) return { ...empty("empty-drawing-buffer"), appliedLook, lookLintErrors };
|
|
181
|
+
// readPixels reads the currently bound framebuffer: renderers that end a
|
|
182
|
+
// frame with an offscreen target bound (shadow/post FBOs — e.g.
|
|
183
|
+
// animation-studio's bespoke renderer) would return that target's pixels
|
|
184
|
+
// instead of the canvas backbuffer. Rebind the default framebuffer first;
|
|
185
|
+
// every renderer rebinds its own targets at the start of its next frame.
|
|
186
|
+
gl.bindFramebuffer(gl.FRAMEBUFFER, null);
|
|
187
|
+
const pixels = new Uint8Array(width * height * 4);
|
|
188
|
+
gl.readPixels(0, 0, width, height, gl.RGBA, gl.UNSIGNED_BYTE, pixels);
|
|
189
|
+
|
|
190
|
+
const BRIGHT_LUMA = 48;
|
|
191
|
+
const stride = 4; // pixels — 16×16 sample grid
|
|
192
|
+
let sampled = 0;
|
|
193
|
+
let bright = 0;
|
|
194
|
+
const buckets = new Set<number>();
|
|
195
|
+
// Central-region lit-pixel bbox: edges carry floor/backdrop, the subject
|
|
196
|
+
// mass is what every §6.4 template frames mid-frame.
|
|
197
|
+
const x0 = Math.floor(width * 0.1);
|
|
198
|
+
const x1 = Math.floor(width * 0.9);
|
|
199
|
+
const y0 = Math.floor(height * 0.1);
|
|
200
|
+
const y1 = Math.floor(height * 0.9);
|
|
201
|
+
let minX = Number.POSITIVE_INFINITY;
|
|
202
|
+
let maxX = Number.NEGATIVE_INFINITY;
|
|
203
|
+
let minY = Number.POSITIVE_INFINITY;
|
|
204
|
+
let maxY = Number.NEGATIVE_INFINITY;
|
|
205
|
+
for (let y = 0; y < height; y += stride) {
|
|
206
|
+
for (let x = 0; x < width; x += stride) {
|
|
207
|
+
const offset = (y * width + x) * 4;
|
|
208
|
+
const r = pixels[offset] ?? 0;
|
|
209
|
+
const g = pixels[offset + 1] ?? 0;
|
|
210
|
+
const b = pixels[offset + 2] ?? 0;
|
|
211
|
+
sampled += 1;
|
|
212
|
+
buckets.add(((r >> 4) << 8) | ((g >> 4) << 4) | (b >> 4));
|
|
213
|
+
const luma = 0.2126 * r + 0.7152 * g + 0.0722 * b;
|
|
214
|
+
if (luma > BRIGHT_LUMA) {
|
|
215
|
+
bright += 1;
|
|
216
|
+
if (x >= x0 && x <= x1 && y >= y0 && y <= y1) {
|
|
217
|
+
minX = Math.min(minX, x);
|
|
218
|
+
maxX = Math.max(maxX, x);
|
|
219
|
+
minY = Math.min(minY, y);
|
|
220
|
+
maxY = Math.max(maxY, y);
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
}
|
|
225
|
+
// readPixels rows run bottom-up; report `y` in the same top-down
|
|
226
|
+
// convention the composited-screenshot path produced so stored
|
|
227
|
+
// expectations stay comparable across the switch.
|
|
228
|
+
const subjectBounds = Number.isFinite(minX)
|
|
229
|
+
? { x: minX / width, y: 1 - maxY / height, width: (maxX - minX) / width, height: (maxY - minY) / height }
|
|
230
|
+
: null;
|
|
231
|
+
|
|
232
|
+
return {
|
|
233
|
+
sampledPixels: sampled,
|
|
234
|
+
brightPixels: bright,
|
|
235
|
+
uniqueBuckets: buckets.size,
|
|
236
|
+
subjectBounds,
|
|
237
|
+
appliedLook,
|
|
238
|
+
lookLintErrors,
|
|
239
|
+
devicePixelRatio
|
|
240
|
+
};
|
|
241
|
+
});
|
|
242
|
+
|
|
243
|
+
// 1. Non-blank.
|
|
244
|
+
expect(report.brightPixels / Math.max(1, report.sampledPixels)).toBeGreaterThan(MIN_BRIGHT_FRACTION);
|
|
245
|
+
expect(report.uniqueBuckets).toBeGreaterThan(MIN_UNIQUE_BUCKETS);
|
|
246
|
+
|
|
247
|
+
if (!options.skipAppDiagnostics) {
|
|
248
|
+
// 2–5. Renderer/look evidence via __AURA3D_LIVE_APPS__.
|
|
249
|
+
expect(report.appliedLook, "appliedLook diagnostics missing — is the app mounted via createAuraApp?").not.toBeNull();
|
|
250
|
+
expect(report.lookLintErrors).toEqual([]);
|
|
251
|
+
expect(report.appliedLook!.specularIntensity).toBeGreaterThan(0);
|
|
252
|
+
if (report.appliedLook!.shadowStrength !== null) {
|
|
253
|
+
expect(report.appliedLook!.shadowStrength!).toBeGreaterThanOrEqual(0.8);
|
|
254
|
+
}
|
|
255
|
+
expect(report.appliedLook!.pixelRatio).toBeGreaterThanOrEqual(Math.min(report.devicePixelRatio, 2));
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
// 6. Subject bounds ±10%.
|
|
259
|
+
if (options.subject) {
|
|
260
|
+
const tolerance = options.tolerance ?? 0.1;
|
|
261
|
+
const measured = `measured ${JSON.stringify(report.subjectBounds)}`;
|
|
262
|
+
expect(report.subjectBounds, "no lit subject mass in the central frame").not.toBeNull();
|
|
263
|
+
expect(Math.abs(report.subjectBounds!.x - options.subject.x), measured).toBeLessThanOrEqual(tolerance);
|
|
264
|
+
expect(Math.abs(report.subjectBounds!.y - options.subject.y), measured).toBeLessThanOrEqual(tolerance);
|
|
265
|
+
expect(Math.abs(report.subjectBounds!.width - options.subject.width), measured).toBeLessThanOrEqual(tolerance);
|
|
266
|
+
expect(Math.abs(report.subjectBounds!.height - options.subject.height), measured).toBeLessThanOrEqual(tolerance);
|
|
267
|
+
}
|
|
268
|
+
|
|
269
|
+
return report;
|
|
270
|
+
}
|
|
@@ -2,7 +2,7 @@ import { mkdirSync, writeFileSync } from "node:fs";
|
|
|
2
2
|
import { resolve } from "node:path";
|
|
3
3
|
import { expect, test } from "@playwright/test";
|
|
4
4
|
|
|
5
|
-
test.setTimeout(
|
|
5
|
+
test.setTimeout(240_000);
|
|
6
6
|
|
|
7
7
|
// The animation-studio route is the generic scene player (render-live-route.ts ->
|
|
8
8
|
// scene-player.ts). Its readiness contract is window.__AURA_LIVE_ROUTE_READY__ /
|
|
@@ -20,7 +20,7 @@ test("Aura3D animation studio live route reaches ready state", async ({ page })
|
|
|
20
20
|
if (w.__AURA_LIVE_ROUTE_ERROR__) return `error: ${w.__AURA_LIVE_ROUTE_ERROR__}`;
|
|
21
21
|
return w.__AURA_LIVE_ROUTE_READY__?.ready === true ? "ready" : "pending";
|
|
22
22
|
}),
|
|
23
|
-
{ timeout:
|
|
23
|
+
{ timeout: 150_000 }
|
|
24
24
|
)
|
|
25
25
|
.toBe("ready");
|
|
26
26
|
const proof = await page.evaluate(
|
|
@@ -1,30 +1,38 @@
|
|
|
1
1
|
import { mkdirSync, writeFileSync } from "node:fs";
|
|
2
2
|
import { resolve } from "node:path";
|
|
3
3
|
import { expect, test } from "@playwright/test";
|
|
4
|
+
import { assertTemplateLookFloor } from "./look-floor";
|
|
5
|
+
import { moonGardenDocument } from "../src/examples/moon-garden.example";
|
|
4
6
|
|
|
5
|
-
test.setTimeout(
|
|
7
|
+
test.setTimeout(600_000);
|
|
6
8
|
|
|
7
|
-
//
|
|
8
|
-
//
|
|
9
|
-
|
|
9
|
+
// PRD-13 T3.12 — look floor: non-blank, look.lint error-free, appliedLook
|
|
10
|
+
// environment specular > 0, shadow strength >= 0.8, pixelRatio at tier cap,
|
|
11
|
+
// subject bounds within ±10% — plus this template's bespoke assertions.
|
|
12
|
+
test("Aura3D animation studio screenshot clears the look floor", async ({ page }) => {
|
|
13
|
+
// The route renders whatever lands on __AURA_EPISODE_DOCUMENT__ — with no injection it
|
|
14
|
+
// plays the intentionally empty studio void (Q-13-12: uniform canvas by design, not a
|
|
15
|
+
// renderer fault). Inject the real example scene so the floor measures real content.
|
|
16
|
+
await page.addInitScript((doc) => {
|
|
17
|
+
(window as unknown as { __AURA_EPISODE_DOCUMENT__?: unknown }).__AURA_EPISODE_DOCUMENT__ = doc;
|
|
18
|
+
}, moonGardenDocument);
|
|
10
19
|
await page.goto("/");
|
|
11
20
|
await expect
|
|
12
21
|
.poll(
|
|
13
22
|
() =>
|
|
14
23
|
page.evaluate(() => {
|
|
15
|
-
const w = window as unknown as {
|
|
16
|
-
__AURA_LIVE_ROUTE_READY__?: { ready?: boolean };
|
|
17
|
-
__AURA_LIVE_ROUTE_ERROR__?: string;
|
|
18
|
-
};
|
|
24
|
+
const w = window as unknown as { __AURA_LIVE_ROUTE_READY__?: { ready?: boolean }; __AURA_LIVE_ROUTE_ERROR__?: string };
|
|
19
25
|
if (w.__AURA_LIVE_ROUTE_ERROR__) return `error: ${w.__AURA_LIVE_ROUTE_ERROR__}`;
|
|
20
26
|
return w.__AURA_LIVE_ROUTE_READY__?.ready === true ? "ready" : "pending";
|
|
21
27
|
}),
|
|
22
|
-
{ timeout:
|
|
28
|
+
{ timeout: 150_000 }
|
|
23
29
|
)
|
|
24
30
|
.toBe("ready");
|
|
31
|
+
|
|
32
|
+
const floor = await assertTemplateLookFloor(page, { subject: { x: 0.15, y: 0.25, width: 0.7, height: 0.6 }, skipAppDiagnostics: true });
|
|
25
33
|
const screenshot = await page.screenshot({ fullPage: false });
|
|
26
34
|
mkdirSync(resolve("tests/reports"), { recursive: true });
|
|
27
35
|
writeFileSync(resolve("tests/reports/screenshot.png"), screenshot);
|
|
28
|
-
writeFileSync(resolve("tests/reports/screenshot.json"), `${JSON.stringify({ bytes: screenshot.byteLength }, null, 2)}\n`);
|
|
36
|
+
writeFileSync(resolve("tests/reports/screenshot.json"), `${JSON.stringify({ bytes: screenshot.byteLength, floor }, null, 2)}\n`);
|
|
29
37
|
expect(screenshot.byteLength).toBeGreaterThan(1000);
|
|
30
38
|
});
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { defineConfig } from "vite";
|
|
2
|
+
import { auraDecodersPlugin } from "@aura3d/assets/vite";
|
|
2
3
|
|
|
3
4
|
// The episode package is rendered to `dist/episodes/<id>/` by `npm run episode:render`.
|
|
4
5
|
// Vite's default `emptyOutDir` wipes the whole `dist/` on every `vite build`, which
|
|
@@ -6,6 +7,7 @@ import { defineConfig } from "vite";
|
|
|
6
7
|
// build and the episode render output can coexist in `dist/` without clobbering each
|
|
7
8
|
// other. (Order-independent: build and render no longer destroy one another.)
|
|
8
9
|
export default defineConfig({
|
|
10
|
+
plugins: [auraDecodersPlugin()],
|
|
9
11
|
// The legacy SVG-puppet `index.html` → `src/main.ts` route was deleted. The real
|
|
10
12
|
// live-3D render route is the only entry: `live-route.html` → `src/render-live-route.ts`.
|
|
11
13
|
build: {
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
name: Aura3D look-dev
|
|
2
|
+
|
|
3
|
+
# Captures this scene's screenshot tests on an Apple-silicon GPU runner
|
|
4
|
+
# (ANGLE Metal) and uploads the report as the `lookdev` artifact.
|
|
5
|
+
# `aura3d look capture --runner gh-actions` dispatches this workflow and
|
|
6
|
+
# downloads the artifacts; it can also be run manually from the Actions tab.
|
|
7
|
+
# No secrets are used; workflow_dispatch only — never runs forked code.
|
|
8
|
+
|
|
9
|
+
on:
|
|
10
|
+
workflow_dispatch:
|
|
11
|
+
inputs:
|
|
12
|
+
shots:
|
|
13
|
+
description: "Shot names to capture (comma-separated; the template's defaults when empty)"
|
|
14
|
+
required: false
|
|
15
|
+
default: ""
|
|
16
|
+
viewports:
|
|
17
|
+
description: "Viewport names (comma-separated; the template's defaults when empty)"
|
|
18
|
+
required: false
|
|
19
|
+
default: ""
|
|
20
|
+
|
|
21
|
+
permissions:
|
|
22
|
+
contents: read
|
|
23
|
+
|
|
24
|
+
jobs:
|
|
25
|
+
capture:
|
|
26
|
+
name: Look-dev captures (macos-14, ANGLE Metal)
|
|
27
|
+
runs-on: macos-14
|
|
28
|
+
timeout-minutes: 45
|
|
29
|
+
env:
|
|
30
|
+
QRC_GPU_ARGS: "--use-angle=metal --enable-gpu --ignore-gpu-blocklist"
|
|
31
|
+
A3D_LOOKDEV_SHOTS: ${{ inputs.shots }}
|
|
32
|
+
A3D_LOOKDEV_VIEWPORTS: ${{ inputs.viewports }}
|
|
33
|
+
steps:
|
|
34
|
+
- name: Checkout
|
|
35
|
+
uses: actions/checkout@v4
|
|
36
|
+
with:
|
|
37
|
+
lfs: false
|
|
38
|
+
|
|
39
|
+
- name: Setup Node.js
|
|
40
|
+
uses: actions/setup-node@v4
|
|
41
|
+
with:
|
|
42
|
+
node-version: '22'
|
|
43
|
+
cache: 'npm'
|
|
44
|
+
|
|
45
|
+
- name: Install dependencies
|
|
46
|
+
run: npm ci
|
|
47
|
+
|
|
48
|
+
- name: Build the app
|
|
49
|
+
run: npm run build
|
|
50
|
+
|
|
51
|
+
- name: Install Playwright Chromium
|
|
52
|
+
run: npx playwright install chromium
|
|
53
|
+
|
|
54
|
+
- name: Capture screenshots
|
|
55
|
+
run: npx playwright test tests/screenshot.spec.ts --reporter=line
|
|
56
|
+
env:
|
|
57
|
+
CHROMIUM_FLAGS: ${{ env.QRC_GPU_ARGS }}
|
|
58
|
+
|
|
59
|
+
- name: Upload look-dev artifacts
|
|
60
|
+
if: always()
|
|
61
|
+
uses: actions/upload-artifact@v4
|
|
62
|
+
with:
|
|
63
|
+
name: lookdev
|
|
64
|
+
path: |
|
|
65
|
+
tests/reports/**
|
|
66
|
+
if-no-files-found: warn
|
|
67
|
+
retention-days: 30
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# Aura3D architecture interior
|
|
2
|
+
|
|
3
|
+
Three-compat starter on the public `@aura3d/engine` API.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
npm install
|
|
7
|
+
npm run dev
|
|
8
|
+
npm run test
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
Hero: a textured Kenney **Modular Dungeon Kit** room GLB (CC0-1.0) under the
|
|
12
|
+
`interior-warm` look — warm interior light, fog, and grade — with orbit
|
|
13
|
+
control.
|
|
14
|
+
|
|
15
|
+
Mirrors the three.js r185 example `webgl_lights_rectarealight` (an interior
|
|
16
|
+
lit by area light); composition mirror only, no parity claim.
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema": "aura3d.assets/1.0",
|
|
3
|
+
"assetBasePath": "/aura-assets/",
|
|
4
|
+
"outputDir": "public/aura-assets",
|
|
5
|
+
"typegen": "src/aura-assets.ts",
|
|
6
|
+
"assets": [
|
|
7
|
+
{
|
|
8
|
+
"id": "room",
|
|
9
|
+
"type": "model",
|
|
10
|
+
"format": "glb",
|
|
11
|
+
"source": "public/aura-assets/kenneyModularDungeonRoomSmall.a7e74a5f.glb",
|
|
12
|
+
"outputPath": "public/aura-assets/kenneyModularDungeonRoomSmall.a7e74a5f.glb",
|
|
13
|
+
"url": "/aura-assets/kenneyModularDungeonRoomSmall.a7e74a5f.glb",
|
|
14
|
+
"hash": "sha256-a7e74a5f2c91ce0503190bcda140259545478d7c80f60243d2c13a897e01af20",
|
|
15
|
+
"sizeBytes": 412996,
|
|
16
|
+
"bounds": [12, 5.233, 12],
|
|
17
|
+
"materials": ["colormap"],
|
|
18
|
+
"animations": [],
|
|
19
|
+
"textures": [],
|
|
20
|
+
"license": "CC0-1.0",
|
|
21
|
+
"provenance": "Kenney Modular Dungeon Kit room-small (CC0)"
|
|
22
|
+
}
|
|
23
|
+
]
|
|
24
|
+
}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "aura3d-architecture-interior",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"private": true,
|
|
5
|
+
"type": "module",
|
|
6
|
+
"scripts": {
|
|
7
|
+
"dev": "vite --host 127.0.0.1",
|
|
8
|
+
"typecheck": "tsc --noEmit",
|
|
9
|
+
"build": "npm run typecheck && vite build",
|
|
10
|
+
"preview": "vite preview --host 127.0.0.1",
|
|
11
|
+
"test": "playwright test tests/route-health.spec.ts tests/screenshot.spec.ts --workers=1"
|
|
12
|
+
},
|
|
13
|
+
"dependencies": {
|
|
14
|
+
"@aura3d/engine": "4.0.0",
|
|
15
|
+
"@aura3d/navigation-recast": "4.0.0",
|
|
16
|
+
"@aura3d/assets": "4.0.0"
|
|
17
|
+
},
|
|
18
|
+
"devDependencies": {
|
|
19
|
+
"@playwright/test": "1.59.1",
|
|
20
|
+
"@types/node": "^22.15.30",
|
|
21
|
+
"typescript": "^5.8.3",
|
|
22
|
+
"vite": "^7.3.2"
|
|
23
|
+
}
|
|
24
|
+
}
|
|
Binary file
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { defineAuraAssets } from "@aura3d/engine";
|
|
2
|
+
|
|
3
|
+
export const assets = defineAuraAssets({
|
|
4
|
+
room: {
|
|
5
|
+
type: "model",
|
|
6
|
+
format: "glb",
|
|
7
|
+
url: "/aura-assets/kenneyModularDungeonRoomSmall.a7e74a5f.glb",
|
|
8
|
+
bounds: [12, 5.233, 12],
|
|
9
|
+
hash: "sha256-a7e74a5f2c91ce0503190bcda140259545478d7c80f60243d2c13a897e01af20",
|
|
10
|
+
metadata: {
|
|
11
|
+
materials: ["colormap"],
|
|
12
|
+
animations: [],
|
|
13
|
+
textures: []
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
} as const);
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
// Three-compat architecture interior: a textured Kenney room kit under the
|
|
2
|
+
// `interior-warm` look (warm key, interior fog, warm grade), orbiting into the
|
|
3
|
+
// room. Mirrors three.js r185 `webgl_lights_rectarealight` (no parity claim).
|
|
4
|
+
import { camera, createAuraApp, interactions, looks, material, model, primitives, scene } from "@aura3d/engine";
|
|
5
|
+
import { assets } from "./aura-assets";
|
|
6
|
+
|
|
7
|
+
const LOOK_ID = "interior-warm" as const;
|
|
8
|
+
|
|
9
|
+
createAuraApp("#app", {
|
|
10
|
+
scene: scene()
|
|
11
|
+
.add(looks.preset(LOOK_ID))
|
|
12
|
+
.add(primitives.plane({ name: "interior apron floor", size: [14, 1, 14], material: material.fabric({ color: "#3a3129", roughness: 0.85 }), receiveShadow: true }))
|
|
13
|
+
// Room kit is 12×5.2×12 m; scale to a 4.2 m readable interior.
|
|
14
|
+
.add(model(assets.room, { name: "textured room kit" }).position(0, 0, -0.4).scale(0.35))
|
|
15
|
+
.add(interactions.orbit({ target: "textured room kit" }))
|
|
16
|
+
.camera(camera.orbit({ target: [0, 0.95, -0.4], distance: 5.6, fov: 42 }))
|
|
17
|
+
});
|
|
18
|
+
|
|
19
|
+
(window as unknown as { __AURA3D_ARCHITECTURE_INTERIOR__?: unknown }).__AURA3D_ARCHITECTURE_INTERIOR__ = {
|
|
20
|
+
look: { id: LOOK_ID, category: looks.describe(LOOK_ID).category },
|
|
21
|
+
hero: { assetId: assets.room.id, url: assets.room.url, provenance: "Kenney Modular Dungeon Kit room-small, CC0-1.0" },
|
|
22
|
+
mirrors: "three.js r185 webgl_lights_rectarealight"
|
|
23
|
+
};
|