create-aura3d 1.3.3 → 1.4.1

package/dist/showcase-spec-types.d.ts

@@ -0,0 +1,319 @@
+export type ShowcaseSpecClaimLabel = "createAuraApp" | "prototype" | "roadmap";
+export type ShowcaseSpecFinalStatus = "release-ready candidate" | "prototype-blocked" | "internal-diagnostic" | "removed-from-public-showcase";
+export type ShowcaseSpecReplacementRequiredRole = "architecture" | "building" | "character" | "data-station" | "effect-core" | "environment" | "facility" | "industrial" | "level" | "platformer-world" | "stage" | "track" | "vehicle" | "world";
+export interface ShowcaseSpecAssetPolicy {
+    readonly allowReplacement: boolean;
+    readonly replacementQuery?: string;
+    readonly requiredRole?: ShowcaseSpecReplacementRequiredRole;
+    readonly minQuality?: "candidate" | "release";
+    readonly requireRenderedProbe?: boolean;
+    readonly requireDeployPass?: boolean;
+}
+export interface ShowcaseSpecAsset {
+    readonly id: string;
+    readonly role: string;
+    readonly typedRef: string;
+    readonly quality: "release" | "candidate" | "prototype";
+    readonly hasDurableProvenance: boolean;
+    readonly hasRenderedProbe: boolean;
+    readonly hasOrientationEvidence: boolean;
+    readonly hasForegroundBounds: boolean;
+    readonly assetPolicy?: ShowcaseSpecAssetPolicy;
+}
+export interface ShowcaseSpecCapability {
+    readonly name: string;
+    readonly status: "root-proven" | "partial" | "internal-only" | "roadmap" | "unsupported";
+    readonly evidence?: string;
+}
+export type ShowcasePlatformerGameplayRequirement = "movement" | "jump" | "checkpoint" | "progression";
+export type ShowcasePlatformerPlayableSurfaceSource = "asset-bound-playable-surfaces" | "asset-derived-playable-surfaces" | "authored-route-rectangles";
+export type ShowcaseGeometryEvidenceSource = "asset-mesh-extracted" | "manifest-authored" | "manifest-authored-overlay-validated" | "compiler-authored" | "compiler-authored-overlay-validated";
+export interface ShowcaseRacingTrackTopologyPoint {
+    readonly x: number;
+    readonly z: number;
+    readonly width?: number;
+}
+export interface ShowcaseRacingTrackTopologyCheckpoint {
+    readonly progress: number;
+    readonly width: number;
+}
+export interface ShowcaseGeometryEvidenceRef {
+    readonly sourceAsset: string;
+    readonly renderedProbe?: string;
+    readonly routeOverlay?: string;
+    readonly notes: string;
+}
+export interface ShowcaseGeometryModelBounds {
+    readonly min: readonly [number, number, number];
+    readonly max: readonly [number, number, number];
+}
+export interface ShowcaseRacingTopologyModelAlignment {
+    readonly source: ShowcaseGeometryEvidenceSource;
+    readonly modelBounds: ShowcaseGeometryModelBounds;
+    readonly modelPoint: readonly [number, number, number];
+    readonly gamePoint: {
+        readonly x: number;
+        readonly z: number;
+    };
+    readonly anchorPairs?: readonly {
+        readonly id: string;
+        readonly modelPoint: readonly [number, number, number];
+        readonly gamePoint: {
+            readonly x: number;
+            readonly z: number;
+        };
+    }[];
+    readonly evidence: {
+        readonly routeOverlay?: string;
+        readonly notes: string;
+    };
+}
+export interface ShowcasePlatformerSurfaceModelAlignment {
+    readonly source: ShowcaseGeometryEvidenceSource;
+    readonly modelBounds: ShowcaseGeometryModelBounds;
+    readonly modelPoint: readonly [number, number, number];
+    readonly gamePoint: {
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly anchorPairs?: readonly {
+        readonly id: string;
+        readonly modelPoint: readonly [number, number, number];
+        readonly gamePoint: {
+            readonly x: number;
+            readonly y: number;
+        };
+    }[];
+    readonly evidence: {
+        readonly routeOverlay?: string;
+        readonly notes: string;
+    };
+}
+export type ShowcaseGameAssetPairEvidenceCategory = "racing" | "platformer";
+export type ShowcaseGameAssetPairEvidenceVerdict = "pass" | "fail";
+export type ShowcaseGameGeometryEvidenceKind = "racing-track-topology" | "platformer-playable-surface-map";
+export interface ShowcaseGameGeometryEvidenceAsset {
+    readonly id: string;
+    readonly hash: string;
+}
+export interface ShowcaseGameGeometryEvidence {
+    readonly category: ShowcaseGameAssetPairEvidenceCategory;
+    readonly kind: ShowcaseGameGeometryEvidenceKind;
+    readonly source: ShowcaseGeometryEvidenceSource;
+    readonly report: string;
+    readonly screenshotEvidence: string;
+    readonly routePrimaryScreenshotSha256: string;
+    readonly assets: readonly ShowcaseGameGeometryEvidenceAsset[];
+}
+export interface ShowcaseGameAssetPairEvidence {
+    readonly category: ShowcaseGameAssetPairEvidenceCategory;
+    readonly assets: readonly string[];
+    readonly screenshotEvidence: string;
+    readonly routePrimaryProbe?: string;
+    readonly screenshotSha256?: string;
+    readonly geometryEvidence?: ShowcaseGameGeometryEvidence;
+    readonly verdict: ShowcaseGameAssetPairEvidenceVerdict;
+    readonly notes: string;
+    readonly blockers: readonly string[];
+}
+export interface ShowcaseRacingTrackTopology {
+    readonly assetId: string;
+    readonly assetHash: string;
+    readonly source: ShowcaseGeometryEvidenceSource;
+    readonly roadCenterline: readonly ShowcaseRacingTrackTopologyPoint[];
+    readonly checkpoints: readonly ShowcaseRacingTrackTopologyCheckpoint[];
+    readonly lapLengthMeters?: number;
+    readonly estimatedLapSeconds: number;
+    readonly confidence: number;
+    readonly modelAlignment: ShowcaseRacingTopologyModelAlignment;
+    readonly evidence: ShowcaseGeometryEvidenceRef;
+}
+export interface ShowcasePlatformerPlayableSurface {
+    readonly id: string;
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly kind: "ground" | "platform" | "moving" | "hazard" | "checkpoint" | "finish";
+}
+export interface ShowcasePlatformerPlayableSurfaceMap {
+    readonly assetId: string;
+    readonly assetHash: string;
+    readonly source: ShowcaseGeometryEvidenceSource;
+    readonly surfaces: readonly ShowcasePlatformerPlayableSurface[];
+    readonly levelLength: number;
+    readonly estimatedCompletionSeconds: number;
+    readonly characterScaleRatio: number;
+    readonly confidence: number;
+    readonly modelAlignment: ShowcasePlatformerSurfaceModelAlignment;
+    readonly evidence: ShowcaseGeometryEvidenceRef;
+}
+export interface ShowcasePlatformerSpec {
+    readonly characterAsset: string;
+    readonly worldAssets: readonly string[];
+    readonly cameraIntent: "side-scroller";
+    readonly layoutConstraints: {
+        readonly keepCharacterReadable: boolean;
+        readonly uiAvoidsEvidenceArea: boolean;
+    };
+    readonly gameplayRequirements: readonly ShowcasePlatformerGameplayRequirement[];
+    readonly levelDesign: {
+        readonly minPlayableSeconds: number;
+        readonly minCheckpoints: number;
+        readonly requiresHazardRespawn: boolean;
+        readonly requiresFinish: boolean;
+        readonly authoredLevelFlow: boolean;
+        readonly playableSurfaceSource: ShowcasePlatformerPlayableSurfaceSource;
+        readonly playableSurfaceLayoutValidated: boolean;
+        readonly playableSurfaceEvidence?: string;
+        readonly playableSurfaceMap?: ShowcasePlatformerPlayableSurfaceMap;
+        readonly assetPairEvidence?: ShowcaseGameAssetPairEvidence;
+        readonly characterWorldScaleCompatible: boolean;
+        readonly styleCompatible: boolean;
+        readonly primitivePrimaryWorldRejected: boolean;
+    };
+    readonly releaseAssetRequirements: {
+        readonly characterRole: "character";
+        readonly worldRoles: readonly ("level" | "world" | "stage")[];
+        readonly requiresOrientationEvidence: boolean;
+        readonly requiresScaleNormalizationEvidence: boolean;
+        readonly requiresRenderedProbe: boolean;
+        readonly requiresDurableProvenance: boolean;
+        readonly requiresSuitabilityReason: boolean;
+    };
+}
+export type ShowcaseRacingGameplayRequirement = "throttle" | "steering" | "reset" | "checkpoint" | "lap" | "multi-lap";
+export interface ShowcaseRacingSpec {
+    readonly vehicleAsset: string;
+    readonly trackAsset: string;
+    readonly cameraIntent: "track-overview";
+    readonly layoutConstraints: {
+        readonly keepVehicleReadable: boolean;
+        readonly keepTrackReadable: boolean;
+        readonly uiAvoidsEvidenceArea: boolean;
+    };
+    readonly gameplayRequirements: readonly ShowcaseRacingGameplayRequirement[];
+    readonly raceDesign: {
+        readonly minCheckpoints: number;
+        readonly minLaps: number;
+        readonly minLapSeconds: number;
+        readonly routeAlignedToTrackAsset: boolean;
+        readonly visibleTrackTopology: "asset-bound-road-topology" | "authored-route-over-visible-track" | "mesh-road-topology";
+        readonly trackTopologyEvidence?: string;
+        readonly trackTopology?: ShowcaseRacingTrackTopology;
+        readonly assetPairEvidence?: ShowcaseGameAssetPairEvidence;
+        readonly carTrackScaleCompatible: boolean;
+        readonly noDebugLocatorDisk: boolean;
+    };
+    readonly releaseAssetRequirements: {
+        readonly vehicleRole: "vehicle";
+        readonly trackRole: "track";
+        readonly requiresOrientationEvidence: boolean;
+        readonly requiresScaleNormalizationEvidence: boolean;
+        readonly requiresRenderedProbe: boolean;
+        readonly requiresDurableProvenance: boolean;
+        readonly requiresSuitabilityReason: boolean;
+    };
+}
+export type ShowcaseCategoryPlanKind = "architecture-environment" | "industrial-digital-twin" | "particle-diagnostic" | "data-diagnostic";
+export type ShowcaseCategoryCameraIntent = "architecture-hero" | "industrial-overview" | "diagnostic-core" | "data-observatory";
+export type ShowcaseCategoryBackendClaim = "webgl-particle" | "native-webgpu" | "fallback";
+export interface ShowcaseCategoryPlan {
+    readonly kind: ShowcaseCategoryPlanKind;
+    readonly primaryAsset: string;
+    readonly cameraIntent: ShowcaseCategoryCameraIntent;
+    readonly backendClaim?: ShowcaseCategoryBackendClaim;
+    readonly layoutConstraints: {
+        readonly keepHeroReadable: boolean;
+        readonly uiAvoidsEvidenceArea: boolean;
+    };
+    readonly claims: {
+        readonly allowed: readonly string[];
+        readonly notAllowed: readonly string[];
+    };
+}
+export interface ShowcaseSpec {
+    readonly schema: "aura3d-showcase-spec/1.0";
+    readonly routeId: string;
+    readonly label: string;
+    readonly category: string;
+    readonly path: string;
+    readonly globalName: string;
+    readonly claimLabel: ShowcaseSpecClaimLabel;
+    readonly publicStatus: ShowcaseSpecFinalStatus;
+    readonly layout: {
+        readonly heroAsset: string;
+        readonly uiPlacement: "left-panel" | "right-panel" | "bottom-bar" | "none";
+    };
+    readonly platformer?: ShowcasePlatformerSpec;
+    readonly racing?: ShowcaseRacingSpec;
+    readonly categoryPlan?: ShowcaseCategoryPlan;
+    readonly primaryAssets: readonly ShowcaseSpecAsset[];
+    readonly evidence: {
+        readonly routePrimaryProbe: string;
+        readonly routePrimaryScreenshot: string;
+        readonly deployCommand: string;
+        readonly deployEvidence?: string;
+        readonly deployPassed: boolean;
+        readonly routePrimaryPassed: boolean;
+        readonly gameplayProof?: string;
+        readonly gameplayPassed?: boolean;
+        readonly releaseAssetProbes?: Readonly<Record<string, string>>;
+    };
+    readonly capabilities: readonly ShowcaseSpecCapability[];
+}
+export interface CompileShowcaseSpecOptions {
+    readonly outputDir: string;
+    readonly projectDir?: string;
+}
+export interface CompileShowcaseSpecFileOptions extends CompileShowcaseSpecOptions {
+    readonly specPath: string;
+}
+export interface CompileShowcaseSpecReport {
+    readonly ok: boolean;
+    readonly schema: "aura3d-showcase-spec-compile-report/1.0";
+    readonly routeId: string;
+    readonly finalStatus: ShowcaseSpecFinalStatus;
+    readonly generatedFiles: readonly string[];
+    readonly blockers: readonly string[];
+    readonly evidenceChecklistPath: string;
+    readonly routeGatePatchPath: string;
+    readonly rejectedAssets: readonly ShowcaseSpecRejectedAsset[];
+    readonly replacementCandidates: readonly ShowcaseSpecReplacementCandidate[];
+    readonly selectedReplacement?: ShowcaseSpecSelectedReplacement;
+}
+export interface ShowcaseSpecRejectedAsset {
+    readonly id: string;
+    readonly reason: "release-probe-blank" | "release-probe-failing" | "release-probe-missing" | "route-primary-clipped" | "route-primary-missing" | "route-primary-unreadable" | "game-asset-pair-failing";
+    readonly evidence: string;
+    readonly failures: readonly string[];
+}
+export interface ShowcaseSpecReplacementProvenance {
+    readonly sourcePage?: string;
+    readonly downloadUrl?: string;
+    readonly license?: string;
+    readonly licenseUrl?: string;
+    readonly author?: string;
+    readonly assetHash?: string;
+}
+export interface ShowcaseSpecReplacementCandidate {
+    readonly id: string;
+    readonly role: string;
+    readonly typedRef: string;
+    readonly score: number;
+    readonly reasons: readonly string[];
+    readonly penalties: readonly string[];
+    readonly provenance: ShowcaseSpecReplacementProvenance;
+    readonly evidence?: string;
+    readonly accepted: boolean;
+    readonly selected: boolean;
+}
+export interface ShowcaseSpecSelectedReplacement {
+    readonly replaces: string;
+    readonly id: string;
+    readonly role: string;
+    readonly score: number;
+    readonly reasons: readonly string[];
+    readonly provenance: ShowcaseSpecReplacementProvenance;
+}
+//# sourceMappingURL=showcase-spec-types.d.ts.map

package/dist/showcase-spec-types.d.ts.map

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

package/dist/showcase-spec-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=showcase-spec-types.js.map

package/dist/showcase-spec-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"showcase-spec-types.js","sourceRoot":"","sources":["../../../../packages/create-aura3d/src/showcase-spec-types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,15 +1,18 @@
 {
   "name": "create-aura3d",
-  "version": "1.3.3",
+  "version": "1.4.1",
   "type": "module",
   "bin": {
     "create-aura3d": "dist/cli.js"
   },
   "files": [
+    "README.md",
     "dist",
     "templates/product-viewer",
     "templates/cinematic-scene",
     "templates/mini-game",
+    "templates/racing-starter",
+    "templates/falling-blocks-starter",
     "templates/fighting-game",
     "templates/animation-channel",
     "templates/prompt-animation-channel",
@@ -23,7 +26,21 @@
     "templates/three-compat-character-viewer",
     "templates/three-compat-postprocess-scene",
     "templates/three-compat-custom-threejs-migration",
-    "templates/three-compat-large-scene"
+    "templates/three-compat-large-scene",
+    "!templates/**/node_modules/**",
+    "!templates/**/node_modules.publish-aside/**",
+    "!templates/**/dist/**",
+    "!templates/**/.turbo/**",
+    "!templates/**/coverage/**",
+    "!templates/**/test-results/**",
+    "!templates/**/playwright-report/**",
+    "!templates/**/tests/reports/**",
+    "!templates/**/package-lock.json",
+    "!templates/**/.DS_Store",
+    "!templates/**/*.png",
+    "!templates/**/*.jpg",
+    "!templates/**/*.jpeg",
+    "!templates/**/*.csv"
   ],
   "publishConfig": {
     "access": "public"
@@ -36,26 +53,43 @@
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "description": "Scaffold Aura3D browser 3D apps for product viewers, cinematic scenes, mini-games, fighting-game runtimes, prompt-driven animation channels, animation studios, and episode builders.",
+  "dependencies": {
+    "@aura3d/asset-index": "1.4.1"
+  },
+  "description": "Scaffold Vite browser 3D apps with Aura3D, typed GLB/glTF assets, route-health tests, and screenshot-ready starter templates.",
   "keywords": [
     "create-aura3d",
     "vite",
+    "vite-template",
+    "3d",
     "3d-template",
+    "3d-starter",
+    "3d-scaffold",
     "browser-3d",
+    "web-3d",
+    "webgl",
+    "typescript",
+    "typescript-3d",
+    "ai-agents",
+    "coding-agents",
+    "prompt-to-3d",
+    "prompt-to-code",
+    "gltf",
+    "glb",
+    "typed-assets",
     "product-viewer",
+    "product-configurator",
+    "cinematic-scene",
+    "mini-game",
     "fighting-game",
+    "game-prototype",
     "prompt-animation-channel",
+    "animation-channel",
     "animation-studio",
     "episode-builder",
-    "animation-animation",
-    "prompt-to-video",
-    "game-runtime",
-    "gltf",
-    "glb",
-    "typescript",
-    "ai-agents"
+    "prompt-to-video"
   ],
-  "homepage": "https://github.com/auraoneai/aura3d#readme",
+  "homepage": "https://aura3d.auraone.ai",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/auraoneai/aura3d.git",

package/templates/animation-channel/package.json

@@ -12,7 +12,7 @@
     "test:negative-failed-puppets": "playwright test tests/concept-2-5d.spec.ts tests/puppet-2d.spec.ts tests/image-puppet.spec.ts tests/concept-2-5d-animation.spec.ts tests/puppet-2d-animation.spec.ts tests/image-puppet-animation.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/engine": "1.3.3"
+    "@aura3d/engine": "1.4.1"
   },
   "devDependencies": {
     "@playwright/test": "^1.52.0",

package/templates/animation-studio/package.json

@@ -16,11 +16,11 @@
     "preview": "vite preview --host 0.0.0.0"
   },
   "dependencies": {
-    "@aura3d/animation": "1.3.2",
-    "@aura3d/assets": "1.3.2",
-    "@aura3d/core": "1.3.2",
-    "@aura3d/engine": "1.3.3",
-    "@aura3d/physics": "1.3.2",
+    "@aura3d/animation": "1.4.1",
+    "@aura3d/assets": "1.4.1",
+    "@aura3d/core": "1.4.1",
+    "@aura3d/engine": "1.4.1",
+    "@aura3d/physics": "1.4.1",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "sharp": "^0.33.5"

package/templates/animation-studio/scripts/animation-scene.ts

@@ -33,7 +33,7 @@ import { validateEpisodeDocument } from "../src/animation-episode-validator.js";
 import { addShot, clearProps, placeProp, removeDialogueLine, removeShot, retimeDialogue, retimeShot, setBlocking, setCamera, setCharacterScale, setDialogueLine, setGesture } from "../src/studio/scene-tools.js";
 import { compileEpisodeDocument } from "../src/director/compile-episode-document.js";
 import type { DirectorSceneInput } from "../src/director/director-heuristics.js";
-import { generateSceneFromPrompt } from "../src/director/prompt-to-scene.js";
+import { generateSceneFromPrompt } from "../src/director/prompt-scene.js";
 import { SET_TEMPLATES, getSetTemplate, pickSetForPrompt } from "../src/set-templates.js";
 import { resolveAsset, resolveLocalGlb, type ResolvedAsset } from "./resolve-asset.js";
 

package/templates/animation-studio/scripts/author-office-scene.ts

@@ -7,7 +7,7 @@
 import { writeFileSync } from "node:fs";
 import { resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
-import { generateSceneFromPrompt } from "../src/director/prompt-to-scene.js";
+import { generateSceneFromPrompt } from "../src/director/prompt-scene.js";
 import { directScene } from "../src/director/director-heuristics.js";
 import { estimateSpeechDuration } from "../src/episode-document.js";
 

package/templates/animation-studio/scripts/build-characters.ts

@@ -1480,7 +1480,7 @@ function main(): void {
     );
   }
   // The generator binds prompt casts to NEUTRAL copies (cast-a/cast-b) of the two leads
-  // (see src/director/prompt-to-scene.ts). Re-copy them byte-for-byte from the freshly
+  // (see src/director/prompt-scene.ts). Re-copy them byte-for-byte from the freshly
   // textured leads so the default generated cast picks up the new bitmap textures too.
   if (!LOW_FI) {
     const COPIES: readonly { from: string; to: string }[] = [

package/templates/animation-studio/src/director/director-heuristics.ts

@@ -409,7 +409,7 @@ const LOW_MOTION = new Set<PerformanceClip>(["idle", "talk"]);
  *     (as speaker OR listener) — unless that character is explicitly `staged` (e.g. a
  *     background extra the director deliberately froze).
  * It also flags the absence of any gesture or any listener reaction, which the
- * prompt-to-scene proof asserts must both be present.
+ * prompt-scene proof asserts must both be present.
  *
  * `stagedStatic` lists character ids that are *allowed* to be motionless on purpose.
  */
@@ -462,7 +462,7 @@ export function validateDirectedActing(
     }
   }
 
-  // (3) Variety asserts the prompt-to-scene proof depends on.
+  // (3) Variety asserts the prompt-scene proof depends on.
   const GESTURE_INTENTS = new Set<PerformanceClip>(["gesture", "point", "nod"]);
   if (!beats.some((b) => GESTURE_INTENTS.has(b.speakingIntent))) {
     issues.push({ code: "NO_GESTURE", message: "No speaker ever gestures/points/nods — acting is all talk." });

package/templates/animation-studio/src/director/{prompt-to-scene.ts → prompt-scene.ts}

@@ -1,5 +1,5 @@
 /**
- * prompt-to-scene.ts — Phase F2: a FULL, deterministic prompt → EpisodeDocument generator
+ * prompt-scene.ts — Phase F2: a FULL, deterministic prompt → EpisodeDocument generator
  * with NO fallback to a content fixture (no Moon Garden, no hard-coded miko/luma cast).
  *
  * Given a free-text prompt this produces a *complete, renderable* EpisodeDocument whose

package/templates/character-controller/package.json

@@ -11,9 +11,9 @@
     "test": "playwright test tests/route-health.spec.ts tests/screenshot.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/animation": "1.3.2",
-    "@aura3d/engine": "1.3.3",
-    "@aura3d/physics": "1.3.2"
+    "@aura3d/animation": "1.4.1",
+    "@aura3d/engine": "1.4.1",
+    "@aura3d/physics": "1.4.1"
   },
   "devDependencies": {
     "@playwright/test": "^1.52.0",

package/templates/cinematic-scene/package.json

@@ -11,7 +11,7 @@
     "test": "playwright test tests/route-health.spec.ts tests/screenshot.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/engine": "1.3.3"
+    "@aura3d/engine": "1.4.1"
   },
   "devDependencies": {
     "@playwright/test": "^1.52.0",

package/templates/cinematic-scene/tests/screenshot.spec.ts

@@ -31,8 +31,8 @@ test("Aura3D cinematic scene screenshot shows the rainy neon hero prompt", async
         const luminance = r * 0.2126 + g * 0.7152 + b * 0.0722;
         if (luminance > 30) buckets.add(`${r >> 5}-${g >> 5}-${b >> 5}`);
         if (b > 110 && g > 90 && b > r * 1.22) cyanPixels += 1;
-        if (r > 160 && g > 105 && b < 125) amberPixels += 1;
-        if (r > 165 && g > 185 && b > 205) rainPixels += 1;
+        if (r > 145 && g > 105 && b < 180 && r >= g * 0.95 && g >= b * 0.65) amberPixels += 1;
+        if (r > 130 && g > 140 && b > 145 && Math.max(r, g, b) - Math.min(r, g, b) < 75) rainPixels += 1;
         if (y < target.height * 0.36 && ((b > 95 && g > 65 && b > r * 1.12) || (r > 105 && g > 62 && b < 95))) wetReflectionPixels += 1;
         if (x > target.width * 0.32 && x < target.width * 0.68 && y > target.height * 0.26 && y < target.height * 0.78 && luminance > 75) centerHeroPixels += 1;
         if (luminance > 8 && luminance < 36 && b >= r && x > target.width * 0.08 && x < target.width * 0.92) darkAlleyPixels += 1;
@@ -50,8 +50,6 @@ test("Aura3D cinematic scene screenshot shows the rainy neon hero prompt", async
   expect(profile.rainPixels).toBeGreaterThan(90);
   expect(profile.wetReflectionPixels).toBeGreaterThan(60);
   expect(profile.centerHeroPixels).toBeGreaterThan(600);
-  // Measured 174 on 2026-06-10 after engine lighting/material updates (neutral-gray
-  // default fallback, bloom retune) brightened the alley floor slightly.
   expect(profile.darkAlleyPixels).toBeGreaterThan(150);
   expect(profile.uniqueBuckets).toBeGreaterThan(22);
   expect(screenshot.byteLength).toBeGreaterThan(1000);

package/templates/episode-builder/package.json

@@ -11,7 +11,7 @@
     "test": "playwright test tests/route-health.spec.ts tests/storyboard-playback.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/engine": "1.3.3"
+    "@aura3d/engine": "1.4.1"
   },
   "devDependencies": {
     "@playwright/test": "^1.52.0",

package/templates/falling-blocks-starter/README.md

@@ -0,0 +1,18 @@
+# Aura3D Falling Blocks Starter
+
+Keyboard-playable falling-block starter using only the public
+`@aura3d/engine` API.
+
+- The arcade cabinet is a typed GLB asset in `src/aura-assets.ts`.
+- `game.fallingBlocks(...)` owns board state, movement, rotation, hold,
+  gravity, hard drop, line clear, score, replay, and checksum behavior.
+- `tests/playable.spec.ts` drives keyboard input and verifies move, rotate,
+  hold, reset, and line clear behavior.
+
+Run:
+
+```bash
+npm install
+npm run dev
+npm test
+```

package/templates/falling-blocks-starter/index.html

@@ -0,0 +1,23 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Aura3D Falling Blocks Starter</title>
+    <style>
+      html,
+      body,
+      #app {
+        width: 100%;
+        height: 100%;
+        margin: 0;
+        overflow: hidden;
+        background: #05070a;
+      }
+    </style>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="./src/main.ts"></script>
+  </body>
+</html>

package/templates/falling-blocks-starter/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "aura3d-falling-blocks-starter",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite --host 127.0.0.1",
+    "typecheck": "tsc --noEmit",
+    "build": "npm run typecheck && vite build",
+    "preview": "vite preview --host 127.0.0.1",
+    "test": "playwright test tests/playable.spec.ts --workers=1"
+  },
+  "dependencies": {
+    "@aura3d/engine": "1.4.1"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.52.0",
+    "typescript": "^5.8.3",
+    "vite": "^7.3.2"
+  }
+}