@docyrus/animaguru 0.35.0 → 0.35.1

package/README.md

@@ -61,7 +61,7 @@ CLI 0.33.0 adds **Cartoon Host Explainer** (`cartoon-host-explainer`): the talki
 
 CLI 0.34.0 adds `"thumbnail"` to `film.config.json` for a designed cover. It names a PNG, JPEG or WebP in the film's folder, such as generated key art at `production/thumbnail.png`. `npm run export:mp4` saves that image as `FILM.jpg` instead of the `"poster"` frame, cropped to the film's shape, so every re-export keeps the cover and `youtube upload` sets it. A wrong path or an unreadable image stops the export before it renders. `submit --file FILM.mp4` now uses the `FILM.jpg` beside it as the AnimaGuru cover; `--poster FILE` chooses another and `--poster none` skips it. `videos poster VIDEO_ID --file IMAGE --yes` replaces the poster of a video already uploaded, and MCP's `set_video_poster` does the same from a saved project image, a public URL or base64.
 
-CLI 0.35.0 adds photoreal Gaussian splats: `assets generate --type model --model idol --reference SHA` turns the object in a saved image into splats with Sperid Labs' Idol on fal (`--photo` for a camera photo, `--splats` 32,768–1,048,576, `--seed`), saved as `.spz`, upright and facing +Z. New video workspaces include Spark, and the kit's `stage.splat()` draws splats in a three.js shot, sorted for each frame's camera, with `photoView()` to open on the reference image's exact view and `softShadow()` to ground them. See the `animaguru-3d-models` skill.
+CLI 0.35.0 adds photoreal Gaussian splats: `assets generate --type model --model idol --reference SHA` turns the object in a saved image into splats with Sperid Labs' Idol on fal (`--photo` for a camera photo, `--splats` 32,768–1,048,576, `--seed`), saved as `.spz`, upright and facing +Z. New video workspaces include Spark, and the kit's `stage.splat()` draws splats in a three.js shot, sorted for each frame's camera, with `photoView()` to open on the reference image's exact view and `softShadow()` to ground them. See the `animaguru-3d-models` skill. CLI 0.35.1 fixes `photoView()` for product images Idol reads as near-orthographic (a field of view under 0.1°): it widens the view to 6° and moves the camera in, so the shot still opens on the product.
 
 CLI 0.16.2 also installs `animaguru-art-motion` for Codex and Claude Code: one skill with 36 English art-treatment references and nine explainer motion grammars, plus AnimaGuru generation, timing, camera and review guidance. Request it explicitly for a custom film treatment; its references are separate from the gallery presets. Source coverage and the upstream MIT notice are included in the skill.
 

package/dist/animaguru.js

@@ -19761,7 +19761,7 @@ var require_ignore2 = __commonJS({
 // cli/package.json
 var package_default = {
   name: "@docyrus/animaguru",
-  version: "0.35.0",
+  version: "0.35.1",
   description: "Agent-friendly AnimaGuru CLI built with CrustJS",
   type: "module",
   bin: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docyrus/animaguru",
-  "version": "0.35.0",
+  "version": "0.35.1",
   "description": "Agent-friendly AnimaGuru CLI built with CrustJS",
   "type": "module",
   "bin": {

package/templates/video/src/kit/three-stage.ts

@@ -214,15 +214,23 @@ export function normalize<T extends THREE.Object3D>(object: T, height: number):
   return object;
 }
 
+/** The narrowest field of view photoView() uses; Idol reports near-orthographic cameras (under 0.1°, ~1,000 units away) for some product shots. */
+const MIN_PHOTO_FOV = 6;
+
 /**
   Puts the camera where an AnimaGuru splat's reference image was taken from (the asset's result.model.view), after
-  the splat is placed: a shot that opens on exactly the product photo, then moves into 3D. Returns the point it looks at.
+  the splat is placed: a shot that opens on exactly the product photo, then moves into 3D. A field of view under 6°
+  is widened to 6°, with the camera moved in along the same line so the product keeps its size in frame. Returns the
+  point it looks at.
 */
 export function photoView(splat: THREE.Object3D, view: SplatView, camera: THREE.PerspectiveCamera) {
   splat.updateMatrixWorld(true);
-  camera.position.copy(splat.localToWorld(new THREE.Vector3(...view.position)));
+  const fov = Math.max(view.fov, MIN_PHOTO_FOV);
+  const toward = new THREE.Vector3(...view.position);
+  toward.multiplyScalar(Math.tan((view.fov * Math.PI) / 360) / Math.tan((fov * Math.PI) / 360));
+  camera.position.copy(splat.localToWorld(toward));
   const target = splat.localToWorld(new THREE.Vector3());
-  camera.fov = view.fov;
+  camera.fov = fov;
   camera.updateProjectionMatrix();
   camera.lookAt(target);
   return target;