@idle-screens/saver-metaquarium 0.5.0 → 0.6.0

package/dist/{chunk-23P73MYY.js → chunk-O676ILL6.js}

@@ -1,55 +1,69 @@
 // src/environments.ts
 var FLOOR_KINDS = ["flat", "dunes", "ridges", "basin"];
 var ENVIRONMENTS = [
-  { name: "void", label: "Void", water: null, floor: "flat", rays: null },
+  { name: "void", label: "Void", water: null, floor: "flat", rays: null, seedSalt: 0 },
   {
     name: "abyss",
     label: "Abyss",
     water: null,
     floor: "basin",
-    rays: { strength: 0.35, color: "#0e4a6e", y: -620 }
+    seedSalt: 161,
+    rays: { strength: 0.35, color: "#0e4a6e", y: -620 },
+    palette: { fog: "#02030a", floor: "#05070f", mote: "#4fd4a8" }
   },
   {
     name: "reef",
     label: "Reef",
     water: { y: 150, color: "#2ad4ff", opacity: 0.18 },
     floor: "dunes",
-    rays: { strength: 0.5, color: "#bfefff", y: 900 }
+    rays: { strength: 0.5, color: "#bfefff", y: 900 },
+    seedSalt: 162,
+    palette: { fog: "#0a3d5c", floor: "#123c50", mote: "#bfe8ff" }
   },
   {
     name: "kelp",
     label: "Kelp forest",
     water: { y: 170, color: "#1e6f5c", opacity: 0.2 },
     floor: "ridges",
-    rays: { strength: 0.4, color: "#9ef5d0", y: 820 }
+    rays: { strength: 0.4, color: "#9ef5d0", y: 820 },
+    seedSalt: 163,
+    palette: { fog: "#07271e", floor: "#0c2f22", mote: "#a5f2c6" }
   },
   {
     name: "ice",
     label: "Under ice",
     water: { y: 132, color: "#cfefff", opacity: 0.32 },
     floor: "flat",
-    rays: { strength: 0.6, color: "#eaf8ff", y: 1e3 }
+    rays: { strength: 0.6, color: "#eaf8ff", y: 1e3 },
+    seedSalt: 164,
+    palette: { fog: "#12283c", floor: "#1b3d59", mote: "#d8f2ff" }
   },
   {
     name: "vent",
     label: "Hydrothermal vent",
     water: null,
     floor: "ridges",
-    rays: { strength: 0.45, color: "#ff7a3c", y: -520 }
+    seedSalt: 165,
+    rays: { strength: 0.45, color: "#ff7a3c", y: -520 },
+    palette: { fog: "#170502", floor: "#4a1a0a", mote: "#ff8a3c" }
   },
   {
     name: "lagoon",
     label: "Lagoon",
     water: { y: 118, color: "#7ff3d0", opacity: 0.22 },
     floor: "dunes",
-    rays: { strength: 0.55, color: "#fff3b0", y: 950 }
+    rays: { strength: 0.55, color: "#fff3b0", y: 950 },
+    seedSalt: 166,
+    palette: { fog: "#0d453f", floor: "#6e4457", mote: "#eafff4" }
   },
   {
     name: "universe",
     label: "Universe",
     water: null,
     floor: "ridges",
-    rays: { strength: 0.3, color: "#c39bff", y: 1200 }
+    seedSalt: 167,
+    rays: { strength: 0.3, color: "#c39bff", y: 1200 },
+    palette: { fog: "#0d0618", floor: "#171030", mote: "#cfa8ff" }
   }
 ];
 var ENVIRONMENT_NAMES = ENVIRONMENTS.map((e) => e.name);
@@ -74,7 +88,10 @@ var SWIM_STYLES = [
   { name: "loop", label: "Loop", speedMul: 1, band: "free", bobAmp: 0, bobHz: 0, formation: false, travel: 1 },
   { name: "school", label: "School", speedMul: 1, band: "free", bobAmp: 1.5, bobHz: 0.5, formation: true, travel: 1 },
   { name: "drift", label: "Drift", speedMul: 0.35, band: "mid", bobAmp: 5, bobHz: 0.13, formation: false, travel: 0.6 },
-  { name: "hover", label: "Hover", speedMul: 0.2, band: "free", bobAmp: 7, bobHz: 0.3, formation: false, travel: 0.12 },
+  // speedMul 0.55, not 0.2: QA measured hover at swimSpeed 0.5 pinned to a
+  // fixed screen x for 8+ seconds — frozen, not station-keeping. The two
+  // multiplied slowdowns (speedMul x travel) were the freeze.
+  { name: "hover", label: "Hover", speedMul: 0.55, band: "free", bobAmp: 7, bobHz: 0.3, formation: false, travel: 0.12 },
   { name: "patrol", label: "Patrol", speedMul: 0.55, band: "mid", bobAmp: 1, bobHz: 0.09, formation: false, travel: 1 },
   { name: "bottom", label: "Bottom-hugger", speedMul: 0.7, band: "floor", bobAmp: 2, bobHz: 0.4, formation: false, travel: 1 },
   { name: "surface", label: "Surface-skimmer", speedMul: 0.9, band: "ceiling", bobAmp: 3, bobHz: 0.55, formation: false, travel: 1 }
@@ -105,6 +122,10 @@ function fishVariation(index, variance) {
     anchor: fishHash(index, 7)
   };
 }
+function anchorFraction(style, index, variance) {
+  if (style.name === "loop") return 0;
+  return fishVariation(index, variance).anchor;
+}
 var FISH_LENGTH = 18;
 var FORMATION_HALF_WIDTH = 62;
 var FORMATION_SHAPES = ["phalanx", "line", "ring", "wedge", "ball"];
@@ -138,12 +159,12 @@ function formationSlot(index, count, variance, halfWidth = FORMATION_HALF_WIDTH,
     const within = index % VSIZE;
     const rank = within + 1 >> 1;
     const wing = within === 0 ? 0 : within % 2 === 1 ? -1 : 1;
+    const droop = (rank - 2) * FISH_LENGTH * (layers === 1 ? 0.24 : 0.12);
+    const pitch2 = layers === 1 ? 1.5 : 1.2;
+    const jit2 = layers === 1 ? 0.2 : 0.15;
     return {
       side: wing * rank * FISH_LENGTH * 1.25 + (fishHash(index, 4) - 0.5) * FISH_LENGTH * 0.3 * j,
-      // 1.5 body lengths per layer with a small jitter: adjacent layers seat
-      // the same rank directly above each other, so pitch minus worst-case
-      // jitter closure must clear one body length.
-      up: (layer - (layers - 1) / 2) * FISH_LENGTH * 1.5 + (fishHash(index, 5) - 0.5) * FISH_LENGTH * 0.2 * j,
+      up: (layer - (layers - 1) / 2) * FISH_LENGTH * pitch2 + (fishHash(index, 5) - 0.5) * FISH_LENGTH * jit2 * j - droop,
       back: (rank - 2) * FISH_LENGTH * 1.35
     };
   }
@@ -371,11 +392,13 @@ function swimPoseAtDistance(plan, dist) {
 // src/maneuver.ts
 var MANEUVERS = ["none", "dart", "startle", "graze", "curious", "zoomies"];
 var SPECS = {
-  dart: { name: "dart", dur: 2.4, interval: 14, advance: 4.5, kick: 0.5, lift: 0, flurry: 1.1, bursts: 1 },
-  startle: { name: "startle", dur: 1.8, interval: 18, advance: 1.2, kick: 2.8, lift: 0.4, flurry: 1.3, bursts: 1 },
-  graze: { name: "graze", dur: 5.5, interval: 16, advance: -3.2, kick: 0.6, lift: -0.7, flurry: 0.3, bursts: 1 },
-  curious: { name: "curious", dur: 4, interval: 15, advance: 0.8, kick: 2, lift: 0.2, flurry: 0.5, bursts: 1 },
-  zoomies: { name: "zoomies", dur: 3.2, interval: 20, advance: 7.5, kick: 0.9, lift: 0.15, flurry: 1.5, bursts: 3 }
+  dart: { name: "dart", dur: 2.4, interval: 14, advance: 4.5, kick: 0.5, lift: 0, flurry: 1.1, bursts: 1, pitch: 0, contagious: false },
+  startle: { name: "startle", dur: 1.8, interval: 18, advance: 1.2, kick: 2.8, lift: 0.4, flurry: 1.3, bursts: 1, pitch: 0.18, contagious: true },
+  // Graze sinks for real now: lift beyond ±1 is deliberate — QA measured the
+  // old -0.7 × 0.6 at 7.6u of drop, indistinguishable from hover's idle bob.
+  graze: { name: "graze", dur: 5.5, interval: 16, advance: -3.2, kick: 0.6, lift: -2.1, flurry: 0.3, bursts: 1, pitch: -0.55, contagious: false },
+  curious: { name: "curious", dur: 4, interval: 15, advance: 0.8, kick: 2, lift: 0.2, flurry: 0.5, bursts: 1, pitch: 0.12, contagious: false },
+  zoomies: { name: "zoomies", dur: 3.2, interval: 20, advance: 7.5, kick: 0.9, lift: 0.15, flurry: 1.5, bursts: 3, pitch: 0, contagious: false }
 };
 function maneuverSpecOf(name) {
   return Object.hasOwn(SPECS, name) ? SPECS[name] : null;
@@ -390,38 +413,44 @@ function surges(u, bursts) {
   if (u <= 0) return 0;
   if (u >= 1) return 1;
   const x = u * bursts;
-  return (Math.floor(x) + smooth(x - Math.floor(x))) / bursts;
+  const frac = x - Math.floor(x);
+  return (Math.floor(x) + smooth(frac / 0.55)) / bursts;
 }
-var IDLE = { along: 0, alongBump: 0, side: 0, up: 0, flurry: 0 };
-function maneuverAt(spec, index, tSec, rate, intensity) {
+var IDLE = { along: 0, alongBump: 0, side: 0, up: 0, flurry: 0, pitch: 0 };
+function maneuverAt(spec, index, tSec, rate, intensity, seatDelay = null) {
   if (!spec || rate <= 0 || intensity <= 0 || tSec < 0) return IDLE;
-  const interval = spec.interval * (3 - 2 * Math.min(1, rate));
+  const interval = rate <= 1 ? spec.interval * (3 - 2 * rate) : Math.max(spec.dur * 1.15, spec.interval / rate);
   const k0 = Math.floor(tSec / interval);
   let along = 0;
   let side = 0;
   let up = 0;
   let flurry = 0;
+  let pitch = 0;
   let alongBump = 0;
   const done = Math.max(0, k0 - 1);
-  along += done * spec.advance * intensity;
+  const perm = 0.6 + 0.8 * fishHash(index, 37);
+  along += done * spec.advance * intensity * perm;
   for (const k of [k0 - 1, k0, k0 + 1]) {
     if (k < 0) continue;
-    const start = (k + fishHash(index, 11 + k)) * interval;
+    const wave = spec.contagious && seatDelay !== null;
+    const jitter = wave ? fishHash(1013, 11 + k) : fishHash(index, 11 + k);
+    const start = (k + jitter) * interval + (wave ? seatDelay : 0);
     const u = (tSec - start) / spec.dur;
     if (u <= 0) continue;
     if (u >= 1) {
-      if (k >= done) along += spec.advance * intensity;
+      if (k >= done) along += spec.advance * intensity * perm;
       continue;
     }
     const sign = fishHash(index, 23 + k) < 0.5 ? -1 : 1;
     const env = bump(u) * intensity;
-    along += spec.advance * surges(u, spec.bursts) * intensity;
+    along += spec.advance * surges(u, spec.bursts) * intensity * perm;
     alongBump += spec.advance * bump(u) * intensity;
     side += sign * spec.kick * env;
     up += spec.lift * spec.kick * env;
     flurry += spec.flurry * env;
+    pitch += spec.pitch * env;
   }
-  return { along, alongBump, side, up, flurry };
+  return { along, alongBump, side, up, flurry, pitch };
 }
 
 // src/asset-cids.ts
@@ -1095,6 +1124,26 @@ var NPC_CATALOG = [
 function parseFishMix(mix, catalog = FISH_CATALOG) {
   const entries = [];
   const problems = [];
+  const unique = catalog === FISH_CATALOG;
+  const used = /* @__PURE__ */ new Set();
+  const allocate = (breed, want) => {
+    const b = BREEDS.find((x) => x.breed === breed);
+    if (!b?.range) return null;
+    const [lo, hi] = b.range;
+    if (!used.has(want) && want >= lo && want <= hi) {
+      used.add(want);
+      return want;
+    }
+    for (let d = 1; d <= hi - lo; d += 1) {
+      for (const cand of [want + d, want - d]) {
+        if (cand >= lo && cand <= hi && !used.has(cand)) {
+          used.add(cand);
+          return cand;
+        }
+      }
+    }
+    return null;
+  };
   for (const rawToken of mix.split(",")) {
     const token = rawToken.trim();
     if (token === "") continue;
@@ -1108,8 +1157,8 @@ function parseFishMix(mix, catalog = FISH_CATALOG) {
     if (!fish && catalog === FISH_CATALOG && /^\d+$/.test(key)) {
       const n = Number(key);
       const url2 = fishAsset(n, "3d");
-      const breed = breedOf(n);
-      if (url2 && breed) fish = { id: n, name: `Fish ${n}`, breed, ipfs3d: url2, localGlb: "" };
+      const breed2 = breedOf(n);
+      if (url2 && breed2) fish = { id: n, name: `Fish ${n}`, breed: breed2, ipfs3d: url2, localGlb: "" };
     }
     if (!fish) {
       const breeds = [...new Set(catalog.map((f) => f.breed))].join(", ");
@@ -1137,7 +1186,34 @@ function parseFishMix(mix, catalog = FISH_CATALOG) {
         count = n;
       }
     }
-    entries.push({ id: fish.id, url, count });
+    if (!unique || fish.id > TOTAL_SUPPLY) {
+      entries.push({ id: fish.id, url, count });
+      continue;
+    }
+    const breed = breedOf(fish.id);
+    if (!breed) {
+      entries.push({ id: fish.id, url, count });
+      continue;
+    }
+    const isAlias = !/^\d+$/.test(key);
+    const b = BREEDS.find((x) => x.breed === breed);
+    for (let i = 0; i < count; i += 1) {
+      const want = isAlias && b?.range ? b.range[0] + Math.floor((b.range[1] - b.range[0]) * i / Math.max(1, count)) : fish.id;
+      const got = allocate(breed, want);
+      if (got === null) {
+        problems.push(`"${token}": only ${i} distinct ${breed} left \u2014 a minted fish appears once per scene`);
+        break;
+      }
+      if (!isAlias && i === 0 && got !== fish.id) {
+        problems.push(`fish ${fish.id} already cast \u2014 fish ${got} swims instead`);
+      }
+      const gotUrl = fishAsset(got, "3d");
+      if (!gotUrl) {
+        problems.push(`fish ${got}: no asset URL`);
+        continue;
+      }
+      entries.push({ id: got, url: gotUrl, count: 1 });
+    }
   }
   return { entries, problems };
 }
@@ -1173,7 +1249,10 @@ var METAQUARIUM_PARAMS = {
   fishUrl: { type: "string", default: "ipfs://QmaHbEQAP6k2zopJHJBzyaK62zNX5yH8yASDjkaG4DY9Dp/fish_257_of_the_metaquarium_3d.glb" },
   /** Mixed population DSL: comma-separated `id[:count]` of a minted token id
    *  (1-512, default catalog) or breed name — e.g. "257:3,100:2,seaturtle:1".
-   *  A custom catalog is a closed world (no farm/IPFS fallback). Counts are
+   *  A minted fish is an INDIVIDUAL: no id appears twice in a scene, and a
+   *  count casts that many DISTINCT fish of the breed ("300:12" is twelve
+   *  different angelfish). A custom catalog is a closed world (no farm/IPFS
+   *  fallback, no uniqueness — NPC entries are species). Counts are
    *  absolute; the expanded total clamps to the device tier's fish cap.
    *  Non-empty mix OVERRIDES fishUrl and fishCount; empty string = single-
    *  breed mode. Unknown ids/bad counts degrade (good tokens still parse);
@@ -1239,8 +1318,9 @@ var METAQUARIUM_PARAMS = {
    *  addressable. `none` (default) changes nothing. */
   maneuver: { type: "enum", default: "none", options: [...MANEUVERS], ease: "step" },
   /** How often events fire: 0 never, 1 the maneuver's own tempo (roughly
-   *  every 14-20s per fish, desynchronised). */
-  maneuverRate: { type: "number", default: 0.5, min: 0, max: 1, ease: "smooth" },
+   *  every 14-20s per fish, desynchronised), above 1 faster — 3 packs events
+   *  nearly back to back. Values <=1 mean exactly what they always did. */
+  maneuverRate: { type: "number", default: 0.5, min: 0, max: 3, ease: "smooth" },
   /** How hard: scales the surge, the kick, and the tail flurry together. */
   maneuverIntensity: { type: "number", default: 0.7, min: 0, max: 1, ease: "smooth" },
   /** Procedural body yaw for models that carry NO animation clip — most of
@@ -1355,6 +1435,7 @@ export {
   swimStyleOf,
   fishHash,
   fishVariation,
+  anchorFraction,
   FISH_LENGTH,
   FORMATION_SHAPES,
   formationSlot,
@@ -1394,4 +1475,4 @@ export {
   paramSpaceWith,
   coerceNum
 };
-//# sourceMappingURL=chunk-23P73MYY.js.map
+//# sourceMappingURL=chunk-O676ILL6.js.map