@idle-screens/saver-metaquarium 0.9.0 → 0.11.0

package/dist/{chunk-PHXRMLJT.js → chunk-YCW7OXBF.js}

@@ -18,7 +18,7 @@ var ENVIRONMENTS = [
     floor: "dunes",
     rays: { strength: 0.5, color: "#bfefff", y: 900 },
     seedSalt: 162,
-    palette: { fog: "#0a3d5c", floor: "#123c50", mote: "#bfe8ff" }
+    palette: { fog: "#0a3d5c", floor: "#123c50", mote: "#bfe8ff", tint: "#6fd6ff" }
   },
   {
     name: "kelp",
@@ -27,7 +27,7 @@ var ENVIRONMENTS = [
     floor: "ridges",
     rays: { strength: 0.4, color: "#9ef5d0", y: 820 },
     seedSalt: 163,
-    palette: { fog: "#07271e", floor: "#0c2f22", mote: "#a5f2c6" }
+    palette: { fog: "#07271e", floor: "#0c2f22", mote: "#a5f2c6", tint: "#8fd07a" }
   },
   {
     name: "ice",
@@ -36,7 +36,7 @@ var ENVIRONMENTS = [
     floor: "flat",
     rays: { strength: 0.6, color: "#eaf8ff", y: 1e3 },
     seedSalt: 164,
-    palette: { fog: "#12283c", floor: "#1b3d59", mote: "#d8f2ff" }
+    palette: { fog: "#12283c", floor: "#1b3d59", mote: "#d8f2ff", tint: "#cdeeff" }
   },
   {
     name: "vent",
@@ -54,7 +54,7 @@ var ENVIRONMENTS = [
     floor: "dunes",
     rays: { strength: 0.55, color: "#fff3b0", y: 950 },
     seedSalt: 166,
-    palette: { fog: "#0d453f", floor: "#6e4457", mote: "#eafff4" }
+    palette: { fog: "#0d453f", floor: "#6e4457", mote: "#eafff4", tint: "#7ff0d8" }
   },
   {
     name: "universe",
@@ -82,6 +82,11 @@ function affordableLayers(budget, preset) {
   }
   return { floor: true, water, rayCount };
 }
+function roomColor(p, room) {
+  const authored = p.resolvedDefault !== p.manifestDefault || p.tracked;
+  if (room && !authored) return room;
+  return p.current === void 0 ? void 0 : String(p.current);
+}
 
 // src/swim.ts
 var SWIM_STYLES = [
@@ -1873,11 +1878,16 @@ function parseVignette(script, marks) {
           const tg = target(word.slice(1));
           if (tg) for (const i of who) state[i] = { ...state[i], faceActor: tg.actor === i ? null : tg.actor, facePoint: tg.point };
         } else if (word === "circle" || word === "follow") {
-          const tg = target(words[w + 1] ?? "");
+          const targetName = words[w + 1] ?? "";
+          const tg = target(targetName);
           w += 1;
           if (!tg) continue;
+          if (word === "follow" && tg.actor === null) {
+            problems.push(`beat ${bi + 1}: "follow ${targetName}" needs another actor, not a mark`);
+            continue;
+          }
           for (const i of who) {
-            if (word === "follow" && tg.actor !== null && tg.actor !== i) state[i] = { ...state[i], follow: tg.actor };
+            if (word === "follow" && tg.actor !== i) state[i] = { ...state[i], follow: tg.actor };
             else if (word === "circle") state[i] = { ...state[i], circle: tg, faceActor: null };
           }
           for (const i of who) {
@@ -1891,6 +1901,9 @@ function parseVignette(script, marks) {
         }
       }
     }
+    state.forEach((sb, i) => {
+      if (sb.circle) state[i] = { ...sb, to: at[i] };
+    });
     state.forEach((sb, i) => {
       if (sb.follow === null) return;
       const lead = state[sb.follow].to;
@@ -2159,9 +2172,13 @@ var PARAM_DOCS = {
   cameraAzimuth: "Orbit bearing in degrees. 0 looks at the village from the front.",
   cameraElevation: "Degrees above the floor. 8\u201315 is eye level with the fish; 40+ looks down on a castle.",
   cameraDistance: "Distance from the tank centre. 80 is a close-up, 170\u2013220 a village, 300+ a landmark.",
+  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.",
+  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.",
   autoRotate: "Turntable speed, degrees/second. 0 holds the shot (stages, vignettes); 1\u20132 is a slow reveal.",
   // 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).",
   fishUrl: "The single model used when `fishMix` is empty. ipfs:// or https.",
   fishMix: "The cast: `id[:count][@style]`, comma-separated. `100:2@drift, 257:1, seahorse:3`. Overrides fishCount/fishUrl.",
   dracoPath: "Where the Draco decoder lives; leave empty on a channel.",
@@ -2173,25 +2190,37 @@ var PARAM_DOCS = {
   maneuver: "Which set-piece moves the cast may break into.",
   maneuverRate: "How often maneuvers happen.",
   maneuverIntensity: "How big they are.",
-  bodyWiggle: "Body yaw while swimming, for models without an animation clip.",
+  bodyWiggle: "Body yaw while swimming, for models without an animation clip. A fish the swim wave bends (`swimWave` > 0) ignores it.",
   lightSeek: "How much fish are drawn toward light sources.",
   formationBreathe: "How much a formation swells and tightens.",
+  shoal: "An ambient school of small fish swimming as one body beside the cast; the odd one wanders out and back (0 = none). Up to 2.5\xD7 the device's fish cap.",
+  shoalKind: "Who the school is: `neon` (blue line, red rear), `rummynose` (red face, barred tail) or `ember` (orange).",
+  shoalSpeed: "How fast the school travels (0.3\u20132, default 0.8), independent of `swimSpeed`. It swims above the plants, across the front of the shot unless the camera orbits.",
   // look
   fishLighting: "`lit` (default) lights fish with a studio rig and their own glow parts; `flat` is the unlit original.",
+  fishAmbient: "The water's light on the fish in lit mode: the sunlit water on their backs, the water around on their flanks, the floor under their bellies, mirrored in metal plates. Fixes fish reading dark; 0.6\u20131 in bright tanks. Dims with a follow-spot's house lights.",
   fishGlow: "How strongly GLOW- parts of a fish bloom and light their neighbours and the floor.",
   fishMetal: "`on` (default) gives METAL- parts a polished, reflective finish.",
+  swimWave: "Fish bend as they swim: a wave runs nose to tail and the body curls into turns (0 = rigid wiggle). Skips the turtle, seahorse, crab, jellies and fish that already have a skeleton.",
   eyeLife: "Eyes blink, look, and emote (0 = painted on). Redraws each token's own pixel-grid eye; black and white only.",
   // water and room
   fogColor: "The water colour; also the background. Dark blues and purples make light sources read.",
   fogNear: "Where fog starts.",
   fogFar: "Where everything has dissolved into the water. Raise to 700\u20131000 for castles and horizons.",
   floorColor: "Sea-floor colour.",
+  water: "Water instead of fog: red fades with distance first, then green, blue last \u2014 a red fish goes blue-green before it goes into the murk. 0.6\u20131 for most scenes; 0 is plain fog.",
+  waterClarity: "With `water` on: 0 murky (colour lost fast, short reach), 0.5 as before, 1 clear (colour kept, reach \xD71.5). Bright tanks want 0.7\u20131.",
+  waterTint: "The sunlit water, `#rrggbb`: distant things fade into it looking up, half of it on the level, none looking down, and the background becomes that gradient. Empty = off; with `water` on, reef, kelp, ice and lagoon bring their own.",
+  dither: "`on` adds an invisible dither that removes colour banding in dark fogged gradients on TVs. Recommended with `water`; `off` (default) is byte-exact with older scenes.",
   moteDensity: "Suspended motes.",
   moteColor: "Their colour.",
   environment: "A room preset (floor, ceiling, light shafts). `void` for the mineral-world scenes.",
   floorKind: "Flat floor or terrain.",
   waterY: "Height of the water ceiling; -1 = the environment's own.",
   rayStrength: "Light shafts from the surface.",
+  caustics: "The dancing net of light from the surface on the floor, rocks, plants and fish (0 = none). Sharp near the top, soft and dim deep down.",
+  causticScale: "Size of the caustic cells: below 1 a fine shimmer, above 1 broad slow bands.",
+  surfaceMirror: "The surface from below: a window up to the light and a rippling mirror of the tank around it (0 = the plain sheet). Needs reef, kelp, ice or lagoon; pays off on the `surface` and `low` shots. High tier reflects the real tank, mid tier the deep water.",
   // world
   propMix: "Crystals: `crystal[:count][@habit][/palette][*size]`. Habits lotus\xB7spire\xB7druse\xB7scatter\xB7coral; palettes env\xB7rainbow or a colour (blue hotpink purple seafoam yellow orange cyan white glass); `*6` is tower-sized. `crystal:3@druse/rainbow`.",
   envProps: "`on` lets the environment preset plant its own crystals when `propMix` is empty.",
@@ -2206,6 +2235,9 @@ var PARAM_DOCS = {
   interior: "`geode` sets the whole scene INSIDE a geode home: furniture, chandelier, marks like `table`, `bed`, `door`.",
   floraDensity: "Voxel plants around each crystal: grass, tube anemones, bulbs, sea fans, kelp \u2014 swaying, lit, shedding spores.",
   bubbleVents: "Bubbles from chimneys, fissures and crystals.",
+  bubbleStyle: "How vent bubbles live: `classic` loops puffs; `live` grows each bubble at the vent, lets it go, rises it to the water surface (if the environment has one) and pops it, and rests a vent for a minute now and then. Distant bubbles dim instead of fattening.",
+  pearling: "Oxygen pearls on the plants: beads grow on the leaves over half a minute or more, sway with them and let go (0 = none). Needs floraDensity > 0; with no flora there is nothing to pearl on.",
+  co2Mist: "A fine haze of tiny bubbles from the vents, drifting on a slow current (0 = none).",
   marineSnow: "Drifting lit particles; gives the water depth.",
   skyLanterns: "The sky motif: voxel jellyfish lanterns overhead (three species), pulsing, lighting what is under them.",
   skyHeight: "How high the lanterns ride. 1 overhead; ~0.3 brings them down among the houses.",
@@ -2477,8 +2509,8 @@ var RECIPES = [
   }
 ];
 var recipe = (id) => RECIPES.find((r) => r.id === id);
-function recipeTrack(params) {
-  return { deltas: Object.entries(params).map(([path, value]) => ({ t: 0, path, value })) };
+function recipeTrack(params, seed = 0) {
+  return { program: "metaquarium", seed, deltas: Object.entries(params).map(([path, value]) => ({ t: 0, path, value })) };
 }
 function validateMetaquariumParams(params) {
   const out = [];
@@ -2519,6 +2551,18 @@ var METAQUARIUM_PARAMS = {
   cameraElevation: { type: "number", default: 15, min: -5, max: 60, ease: "smooth" },
   /** Camera distance from tank center, world units. */
   cameraDistance: { type: "number", default: 110, min: 80, max: 400, ease: "smooth" },
+  /** A named framing: `orbit` (the classic camera), hero, front, low, top,
+   *  surface (looking up at the water's underside) or macro (close on the
+   *  landmark nearest the front). Azimuth and autoRotate still turn it;
+   *  distance scales it. A change is a cut. */
+  shot: { type: "enum", default: "orbit", options: ["orbit", "hero", "front", "low", "top", "surface", "macro"], ease: "step" },
+  /** Ride with one fish (a cast slot, 0 = first); -1 (default) is the orbit
+   *  camera. The orbit params are ignored while following. */
+  cameraFollow: { type: "number", default: -1, min: -1, max: 23, ease: "step" },
+  /** How far behind the followed fish the camera rides, along the path it
+   *  swam. Under about one body length (18) it is the fish's own eye, and the
+   *  fish itself is hidden. */
+  followDistance: { type: "number", default: 45, min: 0, max: 160, 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" },
@@ -2553,6 +2597,23 @@ var METAQUARIUM_PARAMS = {
   /** Fog full-opacity distance. Kept under the camera far plane (1400);
    *  the tank enforces far > near + 20. */
   fogFar: { type: "number", default: 500, min: 120, max: 1100, ease: "smooth" },
+  /** Water instead of fog: red is lost with distance first, green next, blue
+   *  last (blue keeps today's fog curve, so everything still meets the
+   *  background at `fogFar`). 0 (default) is today's fog exactly. */
+  water: { type: "number", default: 0, min: 0, max: 1, ease: "smooth" },
+  /** How clear the water is, when `water` is on: 0 murky (colour lost fast,
+   *  a short reach), 0.5 the water as it has been, 1 clear (colour kept, the
+   *  far fade pushed back half again). */
+  waterClarity: { type: "number", default: 0.5, min: 0, max: 1, ease: "smooth" },
+  /** The sunlit water, '#rrggbb' (empty = off): what distant things fade into
+   *  looking up toward the light, half of it on the level, none looking down
+   *  into the deep — and the background with it. With \`water\` on, a room's
+   *  own tint applies when this is empty. */
+  waterTint: { type: "string", default: "", ease: "step" },
+  /** Output dither (±½ of an 8-bit step) on every material: the cure for
+   *  banding in dark fogged gradients on TV panels. Costs nothing per frame;
+   *  off by default only because turning it on recompiles every material. */
+  dither: { type: "enum", default: "off", options: ["on", "off"], ease: "step" },
   /** Plankton mote density, 0-1 of the device tier's mote budget. Default 0
    *  = off, so the baseline look is untouched until steered. */
   moteDensity: { type: "number", default: 0, min: 0, max: 1, ease: "smooth" },
@@ -2583,6 +2644,18 @@ var METAQUARIUM_PARAMS = {
    *  same sentinel reason: ramping -1 → 0 would read as FULL strength until it
    *  snapped off. */
   rayStrength: { type: "number", default: -1, min: -1, max: 1, ease: "step" },
+  /** Caustics: the net of light a rippled surface throws on the floor, rocks,
+   *  plants and fish — sharp near the surface, broad and dim deep down,
+   *  brightest on faces that look up. 0 compiles the stock programs. */
+  caustics: { type: "number", default: 0, min: 0, max: 1, ease: "smooth" },
+  /** Size of the caustic cells (1 = about two-thirds of a fish). */
+  causticScale: { type: "number", default: 1, min: 0.4, max: 3, ease: "smooth" },
+  /** The water's surface seen from below: a window straight up to the light
+   *  (Snell's window), a mirror of the tank everywhere else. The high tier
+   *  reflects the real tank when it can be seen (the \`surface\` and \`low\`
+   *  shots); mid tier reflects the deep water; low tier: off. Needs an
+   *  environment with a surface (reef, kelp, ice, lagoon). */
+  surfaceMirror: { type: "number", default: 0, min: 0, max: 1, ease: "smooth" },
   /** How the fish move. `loop` is exactly the pre-style behaviour, so the
    *  default changes nothing. A small named set on purpose: a silhouette of
    *  movement you can name is one you can choose from. `auto` lets each
@@ -2642,6 +2715,14 @@ var METAQUARIUM_PARAMS = {
    *  slow (~15 s) cycle. 0 (default) is the rigid lattice; 1 opens it by up
    *  to a fifth. Only ever expands, so the spacing guarantee holds. */
   formationBreathe: { type: "number", default: 0, min: 0, max: 1, ease: "smooth" },
+  /** An ambient school of small voxel fish swimming as one body beside the
+   *  cast — relaxed formation, burst-and-coast tails, the odd fish wandering
+   *  out and back. The amount sets the count (up to 2.5× the tier's fish cap). */
+  shoal: { type: "number", default: 0, min: 0, max: 1, ease: "step" },
+  shoalKind: { type: "enum", default: "neon", options: ["neon", "rummynose", "ember"], ease: "step" },
+  /** How fast the school travels its route — its own speed, not the cast's `swimSpeed`,
+   *  so a slow, contemplative scene still has a school that goes somewhere. */
+  shoalSpeed: { type: "number", default: 0.8, min: 0.3, max: 2, ease: "smooth" },
   // ---- The look. These three are the RENDERER, not settings a scene must
   // carry: every tank is lit, glowing and reflective with no params at all,
   // and the room, the cast and the camera never need to know. Each exists only
@@ -2657,8 +2738,18 @@ var METAQUARIUM_PARAMS = {
    *  a glowing fin colours the body beside it. `flat` is the original unlit
    *  look. Read at mount. */
   fishLighting: { type: "enum", default: "lit", options: ["lit", "flat"], ease: "step" },
+  /** The water's light on the fish (lit mode): the bright water above on
+   *  their backs, the water around on their flanks, the floor under their
+   *  bellies — and mirrored in silvered plates. 0 is the studio alone. */
+  fishAmbient: { type: "number", default: 0, min: 0, max: 1, ease: "smooth" },
+  /** The finish: one full-screen pass — a gentle grade, dither against
+   *  banding, and restrained bloom on high-end devices. 0 draws straight to
+   *  the screen as before; the low tier never runs it. */
+  finish: { type: "number", default: 0, min: 0, max: 1, ease: "smooth" },
   /** Metallic plates read as metal (a generated chrome matcap — reflection
-   *  with no environment map and no lights). `off` is the flat unlit atlas. */
+   *  with no environment map and no lights). `off` is non-metallic instead —
+   *  still lit under `fishLighting: 'lit'`; pair with `fishLighting: 'flat'`
+   *  for the original unlit atlas look. */
   fishMetal: { type: "enum", default: "on", options: ["on", "off"], ease: "step" },
   /** Eye life, 0..1: blinks on a personal clock, idle saccades, pupils that
    *  lead a turn or a climb, eyes on whoever a vignette has it talking to, a
@@ -2667,6 +2758,9 @@ var METAQUARIUM_PARAMS = {
    *  stock eye program, byte for byte — because every param this saver adds
    *  defaults to the previous look; a scene opts in with 1. */
   eyeLife: { type: "number", default: 0, min: 0, max: 1, ease: "smooth" },
+  /** A body wave from nose to tail, beating with distance swum and curling
+   *  into turns. 0 keeps the legacy rigid wiggle and the stock programs. */
+  swimWave: { type: "number", default: 0, min: 0, max: 1, ease: "smooth" },
   /** Independent mineral-world layers. Zero preserves legacy scenes; counts
    * are reduced by the device's existing prop budget. All motion is analytic. */
   rockDensity: { type: "number", default: 0, min: 0, max: 1, ease: "step" },
@@ -2710,6 +2804,15 @@ var METAQUARIUM_PARAMS = {
   interior: { type: "enum", default: "none", options: ["none", "geode"], ease: "step" },
   floraDensity: { type: "number", default: 0, min: 0, max: 1, ease: "step" },
   bubbleVents: { type: "number", default: 0, min: 0, max: 1, ease: "step" },
+  /** `live` puts the vents on a real bubble life: each one grows at the mouth,
+   *  lets go, rises, sits at the water surface and pops; a vent coughs and goes
+   *  quiet for a minute now and then. `classic` is the looping puffs. */
+  bubbleStyle: { type: "enum", default: "classic", options: ["classic", "live"], ease: "step" },
+  /** Oxygen pearls: beads that grow on the flora's leaves over half a minute
+   *  or more, sway with the leaf, and let go. Needs `floraDensity`. */
+  pearling: { type: "number", default: 0, min: 0, max: 1, ease: "step" },
+  /** A fine CO₂ mist of tiny bubbles from the vents, drifting on a current. */
+  co2Mist: { type: "number", default: 0, min: 0, max: 1, ease: "step" },
   marineSnow: { type: "number", default: 0, min: 0, max: 1, ease: "step" },
   /** The sky motif: voxel jellyfish lanterns drifting in the water overhead,
    *  pulsing as they rise and sink; a few hang far out as fogged silhouettes.
@@ -2857,6 +2960,7 @@ export {
   LAYER_COST,
   RAY_COUNT,
   affordableLayers,
+  roomColor,
   SWIM_STYLES,
   AUTO_STYLE_BY_BREED,
   autoStyleFor,
@@ -2936,4 +3040,4 @@ export {
   paramSpaceWith,
   coerceNum
 };
-//# sourceMappingURL=chunk-PHXRMLJT.js.map
+//# sourceMappingURL=chunk-YCW7OXBF.js.map