@idle-screens/saver-metaquarium 0.18.0 → 0.19.0

package/dist/{chunk-G2ZD33CA.js → chunk-7ZYKA2WS.js}

@@ -2929,8 +2929,9 @@ var PARAM_DOCS = {
   shot: "A named framing to cut to: `orbit` (default), `hero` (three-quarter establishing), `front` (level, long lens), `low` (among the plants looking up), `top` (steep, the floor as a map), `surface` (looking up at the water's underside), `macro` (close on the landmark nearest the front). Azimuth and autoRotate turn it; distance scales it.",
   cameraFollow: "Ride with one fish (cast slot, 0 = first); -1 is the orbit camera. Orbit params are ignored while following. Pair with `followSpot` on the same slot for a spotlit chase.",
   followAngle: "Where round the followed fish the chase camera stands, degrees: 0 behind (default), 90 beside, 180 in front looking back at its face.",
-  followDistance: "How far behind the followed fish the camera rides, along its own path (40\u201370 a chase). Under ~18 it is the fish's eye and the fish is hidden.",
+  followDistance: "How far behind the followed fish the camera rides, along its own path (40\u201370 a chase). Under ~18 it is the fish's eye and the fish is hidden; a floor walker (Dot, crab, octopus, snail, starfish) sees from its own head height, pitched with the ground ahead.",
   autoRotate: "Turntable speed, degrees/second. 0 holds the shot (stages, vignettes); 1\u20132 is a slow reveal. frame.state.camera.bearing: where it stands now.",
+  followAvoid: "Keep the followed fish in view, 0\u20131 (default 0): with something in the way (a home, a wall, a lamp, a kelp stand) the chase camera rises a little over low clutter and otherwise pulls in toward the fish \u2014 eased, like a game camera's spring arm. Use it for long walking takes through a village. No effect in the fish's own eye (followDistance under about 16).",
   // cast
   fishCount: "How many fish when `fishMix` is empty (all are `fishUrl`).",
   finish: "A final full-screen pass: gentle grade, soft vignette, dither against banding, and restrained bloom on high-end devices (0 = none; never on the low tier).",
@@ -3524,7 +3525,7 @@ function dependencyProblems(params) {
   }
   if (set("danceTempo") && dance === "off") out.push({ path: "danceTempo", also: ["starfishDance"], message: "does nothing while starfishDance is off" });
   if (follow < 0) {
-    for (const k of ["followDistance", "followAngle"]) if (set(k)) out.push({ path: k, also: ["cameraFollow"], message: "does nothing while cameraFollow is -1 (the orbit camera)" });
+    for (const k of ["followDistance", "followAngle", "followAvoid"]) if (set(k)) out.push({ path: k, also: ["cameraFollow"], message: "does nothing while cameraFollow is -1 (the orbit camera)" });
   } else if (follow < cast) {
     for (const k of ORBIT_PARAMS) if (set(k)) out.push({ path: k, also: ["cameraFollow"], message: `ignored while cameraFollow rides with slot ${follow} \u2014 they return when it is -1` });
   }
@@ -3753,6 +3754,12 @@ var METAQUARIUM_PARAMS = {
    *  it (the default), 90 at its side, 180 in front looking back at its face
    *  — a hackerfish's screen, a crab's smile. */
   followAngle: { type: "number", default: 0, min: -180, max: 180, ease: "smooth" },
+  /** Keep the followed fish in view (sightline.ts): when a home, a wall, a lamp
+   *  or a kelp stand comes between it and the chase camera, the camera rises a
+   *  little to look over low clutter and otherwise pulls in toward the fish, as
+   *  a game camera's spring arm does — eased, never a snap. 0 (default) is the
+   *  plain chase camera; 1 the full arm. Not the fish's-eye view (it has none). */
+  followAvoid: { type: "number", default: 0, min: 0, max: 1, ease: "smooth" },
   /** Continuous orbit speed, degrees/second. Zero by default: the tank is
    *  still, letting the fish movement carry the scene. Steer up for an orbit. */
   autoRotate: { type: "number", default: 0, min: 0, max: 12, ease: "smooth" },
@@ -4385,4 +4392,4 @@ export {
   paramSpaceWith,
   coerceNum
 };
-//# sourceMappingURL=chunk-G2ZD33CA.js.map
+//# sourceMappingURL=chunk-7ZYKA2WS.js.map