@idle-screens/saver-metaquarium 0.14.0 → 0.15.0

package/README.md

@@ -232,6 +232,24 @@ textures, downloads, shadow maps or additional lights. Flora, shards, snow and
 bubbles scale with the existing device prop budget. `inspect().props.scenery`
 reports actual populations; prop draw-call/triangle totals include the world.
 
+## Reading a scene back
+
+A SaverSpec explains itself; a metaquarium scene is `{id: "metaquarium"}` plus a control track. `describeMetaquarium` reads that back as parts, using the tank's own parsers and room presets, for a viewer's scene card, a channel's state, or an agent with no eyes:
+
+```ts
+import { describeMetaquarium, metaquariumParamsFromTrack } from '@idle-screens/saver-metaquarium/manifest';
+
+const { params, timed } = metaquariumParamsFromTrack(scene.track.deltas); // in force at mount, plus later choreography
+const a = describeMetaquarium(params, timed);
+a.summary;  // '3 octopuses, a starfish, a crab and 4 baby fish in the reef; slow orbit.'
+a.cast;     // [{ slots: [0, 2], count: 3, breed: 'octopus', label: 'octopuses', motion: 'floor', … }, …]
+a.sections; // [{ name: 'Room', items: ['Reef', 'dunes floor', 'water overhead'] }, { name: 'Camera', … }, …]
+a.palette;  // the author's colours, else the room's own
+a.problems; // params set but doing nothing (validateMetaquariumParams)
+```
+
+It reports only what the params say, and only what the author set (plus the room and camera, which every scene has).
+
 ## For agents (MCP)
 
 Everything an agent needs to author a scene is data, importable without three.js:
@@ -242,6 +260,7 @@ import { RECIPES, recipeTrack, PARAM_DOCS, GRAMMAR, validateMetaquariumParams }
 const scene = RECIPES.find((r) => r.id === 'stage-duet')!;
 publishScene({ spec: { id: 'metaquarium' }, track: recipeTrack(scene.params) });
 validateMetaquariumParams({ vignette: 'a >home1', geodeHomes: 0 }); // → [{ path: 'vignette', message: 'beat 1: no mark "home1" …' }]
+validateMetaquariumParams({ fishMix: 'dori:3,blowfish:2', fishCount: 14 }); // → [{ path: 'fishCount', also: ['fishMix'], message: 'ignored: a non-empty fishMix sets the cast (5 fish) …' }]
 ```
 
-`PARAM_DOCS` has one line per param (a test keeps it complete), `GRAMMAR` documents the five small DSLs and the marks a vignette can name, and the playground mounts every recipe unchanged on its "recipes" shelf.
+`PARAM_DOCS` has one line per param (a test keeps it complete), `GRAMMAR` documents the five small DSLs and the marks a vignette can name, and the playground mounts every recipe unchanged on its "recipes" shelf. `validateMetaquariumParams` also names the params that would do nothing: one another param overrides (`fishCount` beside a `fishMix`), a slot past the end of the cast, or a dial on something switched off (`shoalKind` with no shoal); a problem that involves other params lists them in `also`.

package/dist/{chunk-XLPOK4TE.js → chunk-XPNWX4OU.js}

@@ -1898,7 +1898,7 @@ function parseFloraMix(src) {
   for (const raw of src.split(",")) {
     const part = raw.trim();
     if (!part) continue;
-    const m = /^([a-z]+)\s*(?::\s*([0-9]+(?:\.[0-9]+)?|\.[0-9]+))?$/i.exec(part);
+    const m = /^([a-z]+)\s*(?::\s*([0-9]*\.?[0-9]+))?$/i.exec(part);
     const name = m?.[1]?.toLowerCase();
     if (!m || !name || !FLORA_SPECIES.includes(name)) {
       problems.push(`"${part}": expected species[:weight] with species one of ${FLORA_SPECIES.join(", ")}`);
@@ -1946,7 +1946,7 @@ function parseGeodeMix(src) {
   for (const raw of src.split(",")) {
     const part = raw.trim();
     if (!part) continue;
-    const m = /^([a-z]+)\s*(?::\s*([0-9]+(?:\.[0-9]+)?|\.[0-9]+))?$/i.exec(part);
+    const m = /^([a-z]+)\s*(?::\s*([0-9]*\.?[0-9]+))?$/i.exec(part);
     const name = m?.[1]?.toLowerCase();
     if (!m || !name || !GEODE_KINDS.includes(name)) {
       problems.push(`"${part}": expected kind[:weight] with kind one of ${GEODE_KINDS.join(", ")}`);
@@ -2390,6 +2390,7 @@ var PARAM_DOCS = {
   danceTempo: "Beats per minute for the starfish dance (60\u2013180, default 128). Glides on the beat.",
   fishLook: "`neon` dresses the bundled creatures (crab, glowfish, shark\u2026) for blacklight: near-black coats, eyes and a crab's mouth glowing a neon of their own. Best in a dark room (abyss, void) with `finish`. `natural` is the default.",
   swimWave: "Fish bend as they swim: a wave runs nose to tail and the body curls into turns (0 = rigid wiggle). Skips the turtle, crab and fish that already have a skeleton; the seahorse gets its own motion instead \u2014 fin, tail and nod.",
+  fishAvoid: "Fish make way for each other instead of swimming through one another: a pair about to meet parts a second ahead, the smaller fish giving more, over or under before round. 1 (default) is on, 0 is the old pass-through. `inspect().crowding` counts the pairs still touching.",
   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.",
@@ -2709,6 +2710,30 @@ var RECIPES = [
       cameraAzimuth: 0,
       autoRotate: 1
     }
+  },
+  {
+    id: "reef-characters",
+    label: "Reef characters",
+    what: "The bundled characters on a coral reef: tangs that look back at you, blowfish that puff up and flirt, an octopus that changes colour and inks, a crab on the floor. A slow orbit.",
+    params: {
+      ...ALIVE,
+      environment: "reef",
+      fishMix: "dori:3,blowfish:2,octopus:1,crab:1",
+      floraDensity: 0.6,
+      marineSnow: 0.3,
+      finish: 0.5,
+      swimSpeed: 0.7,
+      cameraDistance: 160,
+      cameraElevation: 13,
+      cameraAzimuth: 20,
+      autoRotate: 0.6
+    }
+  },
+  {
+    id: "starfish-class",
+    label: "Starfish aerobics",
+    what: "Seven starfish stand up on a pale ice floor, face the camera and dance an aerobics routine in unison, an instructor in front.",
+    params: { environment: "ice", fishMix: "starfish:7", starfishDance: "aerobics", danceTempo: 120, shot: "front", autoRotate: 0 }
   }
 ];
 var recipe = (id) => RECIPES.find((r) => r.id === id);
@@ -2748,8 +2773,238 @@ function validateMetaquariumParams(params) {
     if (params.fountain === "vent" || params.fountain === "geode") world.fountain = at;
     push("vignette", parseVignette(resolveVignette(str("vignette")), indoors ? INTERIOR_MARKS : { ...OPEN_MARKS, ...world }).problems);
   }
+  out.push(...dependencyProblems(params));
   return out;
 }
+var CAST_CAP = 24;
+var ORBIT_PARAMS = ["cameraElevation", "cameraDistance"];
+function dependencyProblems(params) {
+  const out = [];
+  const set = (k) => params[k] !== void 0 && params[k] !== null;
+  const num = (k, fallback) => {
+    const v = Number(params[k]);
+    return set(k) && Number.isFinite(v) ? v : fallback;
+  };
+  const str = (k, fallback = "") => typeof params[k] === "string" ? params[k].trim() : fallback;
+  const mix = str("fishMix") ? parseFishMix(str("fishMix")).entries : [];
+  const mixTotal = mix.reduce((n, e) => n + e.count, 0);
+  const cast = mix.length ? Math.min(mixTotal, CAST_CAP) : Math.min(Math.max(1, Math.round(num("fishCount", 1))), CAST_CAP);
+  const castWhy = mix.length ? `fishMix casts ${cast}` : `the cast is fishCount ${cast}`;
+  const castParams = mix.length ? ["fishMix"] : ["fishCount"];
+  if (mix.length) {
+    for (const k of ["fishCount", "fishUrl"]) {
+      if (set(k)) out.push({ path: k, also: ["fishMix"], message: `ignored: a non-empty fishMix sets the cast (${mixTotal} fish) \u2014 put the counts in fishMix` });
+    }
+    if (mixTotal > CAST_CAP) out.push({ path: "fishMix", message: `casts ${mixTotal} fish, but at most ${CAST_CAP} swim (fewer on smaller devices): slots ${CAST_CAP}+ never appear` });
+  }
+  const noFish = (slot) => `slot ${slot} has no fish \u2014 ${castWhy} (slots 0\u2013${cast - 1})`;
+  const follow = Math.round(num("cameraFollow", -1));
+  if (follow >= cast) out.push({ path: "cameraFollow", also: castParams, message: noFish(follow) });
+  const rig = parseSpotRig(str("spotRig")).spots;
+  const spot2 = Math.round(num("followSpot", -1));
+  if (rig.length && set("followSpot")) out.push({ path: "followSpot", also: ["spotRig"], message: "ignored: a spotRig replaces the single followSpot" });
+  else if (spot2 >= cast) out.push({ path: "followSpot", also: castParams, message: noFish(spot2) });
+  for (const s of rig) if (s.slot >= cast) out.push({ path: "spotRig", also: castParams, message: noFish(s.slot) });
+  if (str("vignette")) {
+    const { actors } = parseVignette(resolveVignette(str("vignette")), { ...OPEN_MARKS, ...INTERIOR_MARKS });
+    if (actors > cast) out.push({ path: "vignette", also: castParams, message: `needs ${actors} fish (actors a\u2013${"abc"[actors - 1]} are slots 0\u2013${actors - 1}), but ${castWhy}` });
+  }
+  const dance = str("starfishDance", "off") || "off";
+  const starfishSwims = mix.some((e, i) => e.breed === "starfish" && mix.slice(0, i).reduce((n, p) => n + p.count, 0) < CAST_CAP);
+  if (dance !== "off" && !starfishSwims) {
+    out.push({ path: "starfishDance", also: ["fishMix"], message: "no starfish in the cast to dance \u2014 add e.g. starfish:7 (slots past the cap never swim)" });
+  }
+  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)" });
+  } 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` });
+  }
+  const spotOn = rig.length > 0 || spot2 >= 0;
+  if (!spotOn) {
+    for (const k of ["spotStrength", "spotShadow", "spotColor"]) if (set(k)) out.push({ path: k, also: ["followSpot", "spotRig"], message: "does nothing with no spot on (followSpot is -1 and spotRig is empty)" });
+  } else if (rig.length && set("spotColor")) {
+    out.push({ path: "spotColor", also: ["spotRig"], message: "colours the single followSpot; a spotRig gives each of its spots its own colour (slot/#rrggbb)" });
+  }
+  if (Math.round(num("shoal", 0) * CAST_CAP * 2.5) < 3) {
+    for (const k of ["shoalKind", "shoalSpeed"]) if (set(k)) out.push({ path: k, also: ["shoal"], message: "does nothing while shoal is too low to make a school (under 3 fish; 0 is off)" });
+  }
+  if (num("floraDensity", 0) <= 0) {
+    for (const k of ["floraMix", "floraPalette", "floraLayout"]) if (set(k)) out.push({ path: k, also: ["floraDensity"], message: "does nothing while floraDensity is 0 (no plants)" });
+  }
+  return out;
+}
+
+// src/anatomy.ts
+var CAST_CAP2 = 24;
+var FLOOR_BREEDS = /* @__PURE__ */ new Set(["crab", "starfish", "octopus"]);
+var BREED_NOUN = {
+  dori: ["tang", "tangs"],
+  babyfish: ["baby fish", "baby fish"],
+  blowfish: ["blowfish", "blowfish"],
+  octopus: ["octopus", "octopuses"],
+  starfish: ["starfish", "starfish"],
+  crab: ["crab", "crabs"],
+  shark: ["shark", "sharks"],
+  glowfish: ["glowfish", "glowfish"],
+  hackerfish: ["hackerfish", "hackerfish"],
+  betafish: ["betafish", "betafish"],
+  angelfish: ["angelfish", "angelfish"],
+  seahorse: ["seahorse", "seahorses"],
+  seaturtle: ["sea turtle", "sea turtles"]
+};
+var noun = (breed, n) => (BREED_NOUN[breed] ?? [breed, `${breed}s`])[n === 1 ? 0 : 1];
+function metaquariumParamsFromTrack(deltas) {
+  const params = {};
+  const timed = [];
+  for (const d of deltas ?? []) {
+    if (!d || typeof d.path !== "string") continue;
+    const t = typeof d.t === "number" && Number.isFinite(d.t) ? d.t : 0;
+    if (t <= 0 || typeof d.liveAt === "number") params[d.path] = d.value;
+    else timed.push({ atMs: t, path: d.path, value: d.value });
+  }
+  timed.sort((a, b) => a.atMs - b.atMs);
+  return { params, timed };
+}
+var defaultOf = (k) => METAQUARIUM_PARAMS[k]?.default;
+function describeMetaquarium(params, timed = []) {
+  const has = (k) => params[k] !== void 0 && params[k] !== null && params[k] !== "";
+  const val = (k) => has(k) ? params[k] : defaultOf(k);
+  const num = (k) => {
+    const n = Number(val(k));
+    return Number.isFinite(n) ? n : 0;
+  };
+  const str = (k) => String(val(k) ?? "").trim();
+  const pct = (k) => `${Math.round(num(k) * 100)}%`;
+  const cast = [];
+  const swimStyle = str("swimStyle");
+  const motionOf = (breed, style) => FLOOR_BREEDS.has(breed) ? "floor" : style ?? (has("swimStyle") ? swimStyle : "swims");
+  const mix = has("fishMix") ? parseFishMix(str("fishMix")).entries : [];
+  if (mix.length) {
+    const slots = expandFishMixSlots(mix, Number.MAX_SAFE_INTEGER);
+    let at = 0;
+    for (const e of mix) {
+      const minted = isMintedId(e.id);
+      cast.push({
+        slots: [at, at + e.count - 1],
+        count: e.count,
+        visible: Math.max(0, Math.min(e.count, CAST_CAP2 - at)),
+        breed: e.breed,
+        label: minted ? e.count > 1 ? `${e.breed} from #${e.id}` : `${e.breed} #${e.id}` : noun(e.breed, e.count),
+        motion: motionOf(e.breed, e.style),
+        size: slots[at]?.size ?? null,
+        offstage: at >= CAST_CAP2
+      });
+      at += e.count;
+    }
+  } else {
+    const n = Math.min(Math.max(1, Math.round(num("fishCount"))), CAST_CAP2);
+    const id = Number(/fish_(\d+)_/.exec(str("fishUrl"))?.[1] ?? NaN);
+    const breed = Number.isFinite(id) && breedOf(id) || "fish";
+    cast.push({ slots: [0, n - 1], count: n, visible: n, breed, label: Number.isFinite(id) ? `${breed} #${id}` : breed, motion: motionOf(breed), size: null, offstage: false });
+  }
+  const castTotal = Math.min(cast.reduce((n, r) => n + r.count, 0), CAST_CAP2);
+  const slotName = (slot) => {
+    const row = cast.find((r) => slot >= r.slots[0] && slot <= r.slots[1]);
+    return row ? `slot ${slot} (${row.breed === "fish" ? "fish" : noun(row.breed, 1)})` : `slot ${slot} (empty)`;
+  };
+  const env = environmentOf(str("environment"));
+  const room = [env.label];
+  if (has("floorKind") && str("floorKind") !== "auto") room.push(`${str("floorKind")} floor`);
+  else room.push(`${env.floor} floor`);
+  if (env.water) room.push("water overhead");
+  if (num("water") > 0) room.push(`water ${pct("water")}${has("waterClarity") ? `, clarity ${pct("waterClarity")}` : ""}`);
+  if (num("caustics") > 0) room.push(`caustics ${pct("caustics")}`);
+  if (num("surfaceMirror") > 0) room.push(`surface mirror ${pct("surfaceMirror")}`);
+  const rays = has("rayStrength") && num("rayStrength") >= 0 ? num("rayStrength") : env.rays?.strength ?? null;
+  if (rays !== null) room.push(rays === 0 ? "no light shafts" : `light shafts ${Math.round(rays * 100)}%`);
+  if (has("fogNear") || has("fogFar")) room.push(`fog ${num("fogNear")}\u2013${num("fogFar")}`);
+  if (str("interior") === "geode") room.push("inside a geode home");
+  const world = [];
+  if (str("landmark") !== "none") world.push(`the ${str("landmark")}`);
+  if (num("geodeHomes") > 0) world.push(`${num("geodeHomes")} geode home${num("geodeHomes") === 1 ? "" : "s"}`);
+  if (num("paths") > 0) world.push(`paths${has("pathMaterial") && str("pathMaterial") !== "auto" ? ` (${str("pathMaterial")})` : ""}`);
+  if (str("fountain") !== "none") world.push(`${str("fountain")} fountain`);
+  if (num("streetLamps") > 0) world.push("street lamps");
+  if (num("floraDensity") > 0) world.push(`plants ${pct("floraDensity")}${has("floraMix") ? `: ${str("floraMix")}` : ""}`);
+  if (num("rockDensity") > 0) world.push(`rocks ${pct("rockDensity")}`);
+  if (num("geodes") > 0) world.push(`wild geodes ${pct("geodes")}`);
+  if (has("propMix")) {
+    const props = parsePropMix(str("propMix")).entries;
+    const n = props.reduce((k, e) => k + e.count, 0);
+    if (n) world.push(`${n} crystal${n === 1 ? "" : "s"}: ${props.map((e) => `${e.count > 1 ? `${e.count} ` : ""}${e.palette === "env" ? "" : `${e.palette} `}${e.habit}${e.size > 1 ? ` \xD7${e.size}` : ""}`).join(", ")}`);
+  }
+  if (num("skyLanterns") > 0) world.push("jellyfish lanterns overhead");
+  if (num("horizon") > 0) world.push("a far horizon");
+  if (num("bubbleVents") > 0) world.push("bubble vents");
+  if (num("marineSnow") > 0) world.push("marine snow");
+  if (num("co2Mist") > 0) world.push("CO\u2082 mist");
+  if (num("pearling") > 0) world.push("pearling plants");
+  if (Math.round(num("shoal") * CAST_CAP2 * 2.5) >= 3) world.push(`a school of ${str("shoalKind")}`);
+  const stage = [];
+  const rig = parseSpotRig(str("spotRig")).spots;
+  if (rig.length) stage.push(`${rig.length} spotlight${rig.length === 1 ? "" : "s"} on ${rig.map((s) => slotName(s.slot)).join(", ")}`);
+  else if (num("followSpot") >= 0) stage.push(`follow-spot on ${slotName(num("followSpot"))}`);
+  if (has("spotCues") && (rig.length || num("followSpot") >= 0)) {
+    const sheet = parseSpotCues(str("spotCues"), Math.max(1, rig.length));
+    stage.push(`${sheet.cues.length} light cues, ${Math.round(sheet.duration)}s loop`);
+  }
+  if (has("vignette")) {
+    const v = str("vignette");
+    stage.push(VIGNETTES[v] ? `vignette: ${v}` : `vignette: ${v.split(/[|\n]/).filter((b) => b.trim()).length} beats`);
+  }
+  if (str("starfishDance") !== "off") stage.push(`starfish ${str("starfishDance")}${has("danceTempo") ? ` at ${num("danceTempo")} bpm` : ""}`);
+  const camera = [];
+  const follow = Math.round(num("cameraFollow"));
+  if (follow >= 0) {
+    camera.push(`rides with ${slotName(follow)}`);
+    if (has("followDistance")) camera.push(`${num("followDistance")} behind`);
+    if (has("followAngle") && num("followAngle") !== 0) camera.push(`${num("followAngle")}\xB0 round`);
+  } else {
+    if (str("shot") !== "orbit") camera.push(`${str("shot")} shot`);
+    camera.push(`distance ${num("cameraDistance")}`, `elevation ${num("cameraElevation")}\xB0`);
+    const spin = num("autoRotate");
+    camera.push(spin > 0 ? `orbits ${spin}\xB0/s` : "holds still");
+  }
+  const motion = [];
+  if (has("swimSpeed")) motion.push(`speed \xD7${num("swimSpeed")}`);
+  if (has("pathShape")) motion.push(`${str("pathShape")} paths`);
+  if (has("formationShape")) motion.push(`${str("formationShape")} formation`);
+  if (str("maneuver") !== "none") motion.push(`${str("maneuver")} maneuvers`);
+  if (num("bodyWiggle") > 0) motion.push(`wiggle ${pct("bodyWiggle")}`);
+  if (has("fishSize") && num("fishSize") !== 1) motion.push(`fish \xD7${num("fishSize")} size`);
+  const look = [];
+  if (str("fishLighting") === "flat") look.push("flat-lit fish");
+  if (str("fishLook") === "neon") look.push("neon (blacklight) coats");
+  if (num("eyeLife") > 0) look.push("living eyes");
+  if (num("finish") > 0) look.push(`finish ${pct("finish")}`);
+  if (has("fishGlow")) look.push(`glow ${pct("fishGlow")}`);
+  if (num("fishAmbient") > 0) look.push(`fish ambient ${pct("fishAmbient")}`);
+  if (str("dither") === "on") look.push("dither");
+  const sections = [["Room", room], ["World", world], ["Stage", stage], ["Camera", camera], ["Motion", motion], ["Look", look]].filter(([, items]) => items.length > 0).map(([name, items]) => ({ name, items: [...items] }));
+  const palette = [];
+  const add = (c) => {
+    if (typeof c === "string" && /^#[0-9a-f]{3}(?:[0-9a-f]{3})?$/i.test(c) && !palette.includes(c.toLowerCase())) palette.push(c.toLowerCase());
+  };
+  const roomOr = (k, room2) => add(has(k) ? params[k] : room2 ?? defaultOf(k));
+  roomOr("fogColor", env.palette?.fog);
+  roomOr("floorColor", env.palette?.floor);
+  if (num("moteDensity") > 0 || num("marineSnow") > 0 || env.palette) roomOr("moteColor", env.palette?.mote);
+  if (num("water") > 0) roomOr("waterTint", env.palette?.tint);
+  for (const s of rig) add(s.color);
+  if (!rig.length && num("followSpot") >= 0) add(str("spotColor"));
+  if (has("floraPalette")) for (const c of str("floraPalette").split(",")) add(c.trim());
+  const swimming = cast.filter((r) => r.visible > 0);
+  const nameOf = (r) => r.visible < r.count && !r.label.includes("#") ? noun(r.breed, r.visible) : r.label;
+  const names = swimming.map((r) => r.visible === 1 ? `${/^[aeiou]/.test(nameOf(r)) ? "an" : "a"} ${nameOf(r)}` : `${r.visible} ${nameOf(r)}`);
+  const list = names.length > 1 ? `${names.slice(0, -1).join(", ")} and ${names[names.length - 1]}` : names[0] ?? "no fish";
+  const where = str("interior") === "geode" ? "inside a geode home" : `in the ${env.label.toLowerCase()}`;
+  const act = stage.find((x) => x.startsWith("starfish ")) ?? stage.find((x) => x.startsWith("vignette")) ?? stage[0];
+  const extra = act ?? (str("landmark") !== "none" ? `around the ${str("landmark")}` : num("geodeHomes") > 0 ? "in a village" : null);
+  const cam = follow >= 0 ? `following ${slotName(follow)}` : num("autoRotate") > 0 ? "slow orbit" : "still camera";
+  const summary = `${list} ${where}${extra ? `, ${extra}` : ""}; ${cam}.`;
+  return { summary, cast, castTotal, sections, palette, timed, problems: validateMetaquariumParams(params) };
+}
 
 // src/manifest.ts
 var METAQUARIUM_PARAMS = {
@@ -3003,6 +3258,11 @@ var METAQUARIUM_PARAMS = {
   /** 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" },
+  /** Elbow room, 0..1: fish see each other coming and make way — the smaller
+   *  gives more, over or under before round. Pure in t, like every motion here.
+   *  On by default, the one exception to "defaults keep the old look":
+   *  fish swimming through fish was a bug, not a look. 0 is the old tank. */
+  fishAvoid: { type: "number", default: 1, 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" },
@@ -3180,7 +3440,7 @@ var BLOOM_COLORS = [
 var metaquariumManifest = {
   id: "metaquarium",
   label: "Metaquarium",
-  description: "A living fish tank: skinned GLB fish swim seeded Catmull-Rom paths through a dark, fogged aquarium.",
+  description: "A voxel fish tank you configure by params: a cast of fish and characters (tangs, blowfish, an octopus, crabs, starfish, minted fish) in rooms, gardens, villages and castles, with stage spotlights and small scripted scenes.",
   minBackend: "webgl2",
   costTier: "medium",
   motionIntensity: "calm",
@@ -3325,6 +3585,8 @@ export {
   recipe,
   recipeTrack,
   validateMetaquariumParams,
+  metaquariumParamsFromTrack,
+  describeMetaquarium,
   METAQUARIUM_PARAMS,
   MIAMI_VICE_COLORS,
   BLOOM_COLORS,
@@ -3333,4 +3595,4 @@ export {
   paramSpaceWith,
   coerceNum
 };
-//# sourceMappingURL=chunk-XLPOK4TE.js.map
+//# sourceMappingURL=chunk-XPNWX4OU.js.map