@idle-screens/saver-metaquarium 0.22.0 → 0.23.0

package/dist/{chunk-42RIVUT4.js → chunk-M2PKNQNY.js}

@@ -2564,9 +2564,9 @@ function parseChoreography(value, moves) {
       }
       const cue = { b0, beats: Math.min(beats, 512), move: m[2], turn: 0, lift: 0 };
       for (const tok of (m[3] ?? "").replace(/^[,\s]+/, "").split(/\s+/).filter(Boolean)) {
-        const mod = /^([>@~^/%*])(.+)$/.exec(tok);
+        const mod = /^([>@~^/%*x=])(.+)$/.exec(tok);
         if (!mod) {
-          problems.push(`"${raw}": "${tok}" is not >to, @face, ~turn, ^leap, /lean, %crouch or *groove`);
+          problems.push(`"${raw}": "${tok}" is not >to, @face, ~turn, ^leap, /lean, %crouch, *groove, xspeed or =pose`);
           continue;
         }
         const [, op, arg] = mod;
@@ -2587,6 +2587,12 @@ function parseChoreography(value, moves) {
         } else if (op === "%") {
           if (Number.isFinite(Number(arg)) && Number(arg) > 0) cue.squash = clamp(Number(arg), 0.4, 1.5);
           else problems.push(`"${raw}": crouch "${arg}" is not a height scale`);
+        } else if (op === "=") {
+          if (arg !== "" && Number.isFinite(Number(arg)) && Number(arg) >= 0 && Number(arg) <= 1) cue.pose = Number(arg);
+          else problems.push(`"${raw}": pose "${arg}" is not a fraction of the move (0\u20131)`);
+        } else if (op === "x") {
+          if (Number.isFinite(Number(arg)) && Number(arg) > 0) cue.rate = clamp(Number(arg), 0.25, 4);
+          else problems.push(`"${raw}": speed "${arg}" is not a multiple`);
         } else if (op === "*") {
           if (Number.isFinite(Number(arg)) && Number(arg) > 0) cue.groove = clamp(Number(arg), 0.02, 0.3);
           else problems.push(`"${raw}": groove "${arg}" is not a depth`);
@@ -3304,11 +3310,13 @@ var PARAM_DOCS = {
   cameraDistance: "Distance from the tank centre. 80 is a close-up, 170\u2013220 a village, 300+ a landmark.",
   shot: "A framing: `orbit`, `hero` (three-quarter), `front` (level, long lens), `low`, `top` (a map), `surface`, `macro` (nearest landmark), `cast` (the mix's first three). Azimuth and autoRotate turn it, distance scales it.",
   shotBlend: "Seconds a change of `shot` takes (0 = a cut): the camera moves to the new framing, eased.",
-  cameraFollow: "Ride with one fish (cast slot); -1 is the orbit camera, whose params are ignored while following. With `followSpot` on the slot, 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 (40\u201370 is a chase). Under ~18 it is the fish's eye; a floor walker sees from its own head height.",
-  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: the chase camera rises over low clutter or pulls in, eased. For walks through a village.",
+  cameraFollow: "Ride with one fish (cast slot); -1 is the orbit camera (its params ignored while following).",
+  followAngle: "Where round the followed fish the chase camera stands, degrees: 0 behind (default), 90 beside, 180 facing it. A choreographed dancer is measured from the stage's facing instead.",
+  followDistance: "How far behind the followed fish the camera rides (40\u201370 is a chase). Under ~18 it is the fish's eye (a walker's: its head height).",
+  autoRotate: "Turntable speed, degrees/second. 0 holds the shot, 1\u20132 a slow reveal. frame.state.camera.bearing: where it stands now.",
+  followAvoid: "Keep the followed fish in view, 0\u20131: the chase camera rises or pulls in, eased.",
+  followHeight: "Chase camera height in body lengths over its feet, aimed at them (0.2: feet); -1 off.",
+  followLens: "Chase lens, degrees (0: 55; 25 long).",
   nearFade: "A creature at the lens dissolves, not sliced, 0\u20131. The followed fish never fades.",
   // cast
   fishCount: "How many fish when `fishMix` is empty (all are `fishUrl`).",
@@ -3452,7 +3460,7 @@ geodeMineral  world | mineral, \u2026   amethyst agate celestine citrine carneli
 floraPalette  world | #rrggbb, \u2026  (\u22646)                          world \xB7 #ff4fa0, #ffb347, #4fd1ff
 spotRig   slot|@mark[/color][*radius], \u2026  (\u22643; they become a, b, c)   0/#ffd27a*24, 1/#ff8ad0*24, 2/#7fdcff*24
 spotCues  <sec>s:<spots>, \u2026  loops                               4s:-, 7s:a, 7s:b, 12s:a+b
-choreography  [a|*:] <beats>:<move> [>to @face ~turn ^leap /lean %crouch *groove],\u2026|\u2026  moves ${STARFISH_MOVE_NAMES.join(" ")}
+choreography  [a|*:] <beats>:<move> [>to @face ~turn ^leap /lean %crouch *groove xspeed =pose],\u2026|\u2026  moves ${STARFISH_MOVE_NAMES.join(" ")}
 signs     kind[@place][>target][/#color][*size][:text], \u2026   plank@gate:"Welcome to the reef", neon@home1/#ff4fa0:OPEN, led@plaza:TIDE 4.2M
           kinds plank arrow ring porthole neon led \xB7 places gate plaza courtyard hub fountain home1 home2 home3 centre left right front back
           an arrow points at >target \xB7 text \u2264 plank 24, arrow 16, ring 10, porthole 4 (empty = a fish), neon 14, led 64 (scrolls) \xB7 \u2264 8 signs
@@ -4030,7 +4038,7 @@ function dependencyProblems(params) {
   if (set("danceTempo") && dance === "off" && !choreographed) out.push({ path: "danceTempo", also: ["starfishDance"], message: "does nothing while starfishDance is off" });
   if (choreographed && !starfishSwims) out.push({ path: "choreography", also: ["fishMix"], message: "no starfish in the cast to dance it \u2014 add e.g. starfish:5" });
   if (follow < 0) {
-    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)" });
+    for (const k of ["followDistance", "followAngle", "followAvoid", "followHeight", "followLens"]) 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` });
   }
@@ -4262,7 +4270,8 @@ var METAQUARIUM_PARAMS = {
   followDistance: { type: "number", default: 45, min: 0, max: 160, ease: "smooth" },
   /** Where round the followed fish the chase camera stands, degrees: 0 behind
    *  it (the default), 90 at its side, 180 in front looking back at its face
-   *  — a hackerfish's screen, a crab's smile. */
+   *  — a hackerfish's screen, a crab's smile. A choreographed dancer is framed
+   *  from its stage's front instead, so a spin turns the dancer, not the shot. */
   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
@@ -4270,6 +4279,15 @@ var METAQUARIUM_PARAMS = {
    *  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" },
+  /** The chase camera's height over the followed fish's feet, in its body
+   *  lengths. -1 (default) rides a little above it, looking at its middle;
+   *  set, the camera stands at that height aimed at its feet — 0.1–0.3 on a
+   *  long lens is a shot of a walker's feet, the floor behind them. */
+  followHeight: { type: "number", default: -1, min: -1, max: 3, ease: "step" },
+  /** The chase camera's lens: degrees of view, top to bottom. 0 (default) is
+   *  the orbit camera's 55; 20–30 is a long lens — flatter and tighter, from
+   *  further back. */
+  followLens: { type: "number", default: 0, min: 0, max: 90, ease: "step" },
   /** 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" },
@@ -4980,4 +4998,4 @@ export {
   paramSpaceWith,
   coerceNum
 };
-//# sourceMappingURL=chunk-42RIVUT4.js.map
+//# sourceMappingURL=chunk-M2PKNQNY.js.map