easter-egg-quest 1.0.18 → 1.0.20

package/dist/easter-egg-quest.es.js

@@ -57,33 +57,25 @@ const DEFAULT_SCRIPT = {
   stage2Success: [
     "movement was the answer",
     "the second egg appears",
-    "for those who never stop",
-    "not stillness this time",
-    "but life in motion"
+    "hold it to collect"
   ],
   // ── Stage 3: Rhythm ───────────────────────────────────────────────────
   stage3Intro: [
-    "two truths that shouldn’t exist together",
     "the final riddle:",
-    "I am the conversation between opposites. Every living thing knows me. You’ve been doing me your whole life without thinking."
+    "Every living thing knows it. You’ve been doing it your whole life without thinking."
   ],
   stage3Reactions: [
-    "one truth alone isn’t enough",
-    "the other alone isn’t either",
+    "one truth alone is not enough",
+    "the other alone is not enough either",
     "what do all living things share?",
-    "you already know the answer",
-    "you’ve been doing it since birth",
+    "you have known it since the beginning",
     "listen to yourself",
-    "closer...",
-    "can you feel it?",
-    "the body remembers",
     "in",
     "out"
   ],
   stage3Success: [
     "rhythm was the answer",
-    "you found the third egg",
-    "nice work"
+    "you found the third egg"
   ],
   // ── Finale ────────────────────────────────────────────────────────────
   finale: [
@@ -331,8 +323,10 @@ class InputTracker {
     this._prevX = 0;
     this._prevY = 0;
     this._prevMoveTs = 0;
-    this.STILL_THRESHOLD_MS = 400;
-    this.MIN_PHASE_MS = 300;
+    this.DEFAULT_STILL_THRESHOLD_MS = 400;
+    this._stillThresholdMs = this.DEFAULT_STILL_THRESHOLD_MS;
+    this.DEFAULT_MIN_PHASE_MS = 300;
+    this._minPhaseMs = this.DEFAULT_MIN_PHASE_MS;
     this._stillTimer = null;
     this._handlers = [];
     this._active = false;
@@ -471,6 +465,18 @@ class InputTracker {
     this._snapshot.totalDistance = 0;
     this._snapshot.maxVelocity = 0;
   }
+  configurePhaseDetection(opts) {
+    if (typeof opts.stillThresholdMs === "number") {
+      this._stillThresholdMs = Math.max(250, opts.stillThresholdMs);
+    }
+    if (typeof opts.minPhaseMs === "number") {
+      this._minPhaseMs = Math.max(150, opts.minPhaseMs);
+    }
+  }
+  resetPhaseDetection() {
+    this._stillThresholdMs = this.DEFAULT_STILL_THRESHOLD_MS;
+    this._minPhaseMs = this.DEFAULT_MIN_PHASE_MS;
+  }
   // ─── Movement / Stillness transition logic ─────────────────────────────
   _registerMove(now) {
     this._snapshot.lastMoveTime = now;
@@ -483,7 +489,7 @@ class InputTracker {
     if (this._stillTimer) clearTimeout(this._stillTimer);
     this._stillTimer = setTimeout(() => {
       this._becomeStill();
-    }, this.STILL_THRESHOLD_MS);
+    }, this._stillThresholdMs);
   }
   _becomeStill() {
     if (!this._snapshot.isMoving) return;
@@ -497,7 +503,7 @@ class InputTracker {
   }
   _completePhase(type, endTime) {
     const duration = endTime - this._currentPhaseStart;
-    if (duration >= this.MIN_PHASE_MS) {
+    if (duration >= this._minPhaseMs) {
       this._phases.push({
         type,
         startTime: this._currentPhaseStart,
@@ -1312,6 +1318,7 @@ class NarrativeRenderer {
     this.container = null;
     this.currentLine = null;
     this.clearTimer = null;
+    this.awaitingConfirm = false;
     this.config = config;
   }
   mount() {
@@ -1335,14 +1342,22 @@ class NarrativeRenderer {
     this.container.className = "eeq-narrative";
     this.shadow.appendChild(this.container);
   }
+  _removeCurrentLine(immediate = false) {
+    if (!this.currentLine) return;
+    const prev = this.currentLine;
+    this.currentLine = null;
+    if (immediate) {
+      prev.remove();
+      return;
+    }
+    prev.classList.add("eeq-narrative-exit");
+    setTimeout(() => prev.remove(), 750);
+  }
   /** Show a single narrative line. Fades in, replaces any previous line. */
   showLine(text, className = "eeq-line") {
     if (!this.container) return;
-    if (this.currentLine) {
-      const prev = this.currentLine;
-      prev.classList.add("eeq-narrative-exit");
-      setTimeout(() => prev.remove(), 750);
-    }
+    if (this.awaitingConfirm) return;
+    this._removeCurrentLine(true);
     if (this.clearTimer) {
       clearTimeout(this.clearTimer);
       this.clearTimer = null;
@@ -1371,11 +1386,8 @@ class NarrativeRenderer {
         resolve();
         return;
       }
-      if (this.currentLine) {
-        const prev = this.currentLine;
-        prev.classList.add("eeq-narrative-exit");
-        setTimeout(() => prev.remove(), 750);
-      }
+      this.awaitingConfirm = true;
+      this._removeCurrentLine(true);
       if (this.clearTimer) {
         clearTimeout(this.clearTimer);
         this.clearTimer = null;
@@ -1387,7 +1399,10 @@ class NarrativeRenderer {
       const btn = document.createElement("button");
       btn.className = "eeq-confirm-btn";
       btn.textContent = "OK";
-      btn.addEventListener("click", () => resolve(), { once: true });
+      btn.addEventListener("click", () => {
+        this.awaitingConfirm = false;
+        resolve();
+      }, { once: true });
       line.appendChild(btn);
       requestAnimationFrame(() => {
         requestAnimationFrame(() => {
@@ -1409,22 +1424,19 @@ class NarrativeRenderer {
     this.showLine(text, "eeq-line eeq-celebration");
   }
   /** Clear current narrative text. */
-  clear() {
+  clear(force = false) {
+    if (this.awaitingConfirm && !force) return;
     if (this.clearTimer) {
       clearTimeout(this.clearTimer);
       this.clearTimer = null;
     }
-    if (this.currentLine) {
-      this.currentLine.classList.add("eeq-narrative-exit");
-      const ref = this.currentLine;
-      setTimeout(() => ref.remove(), 750);
-      this.currentLine = null;
-    }
+    this._removeCurrentLine(force);
+    this.awaitingConfirm = false;
   }
   /** Remove all DOM. */
   destroy() {
     var _a2;
-    this.clear();
+    this.clear(true);
     (_a2 = this.host) == null ? void 0 : _a2.remove();
     this.host = null;
     this.shadow = null;
@@ -1753,6 +1765,7 @@ class ThreeRenderer {
     this._greetingOverlay = null;
     this._trailParticles = [];
     this._ambientParticles = [];
+    this._lastAmbientSpawnAt = 0;
     this._revealParticles = [];
     this._disposed = false;
     this._interactiveEgg = null;
@@ -2119,32 +2132,43 @@ class ThreeRenderer {
       }
     }
   }
-  /** Spawn gentle ambient particles to show stage progress. */
-  showProgressParticles(progress) {
+  /** Spawn ambient particles to show stage progress. */
+  showProgressParticles(progress, source = "default") {
     if (!this.THREE || !this.scene || progress < 0.05) return;
     const T = this.THREE;
-    if (Math.random() > progress * 0.3) return;
-    const angle = Math.random() * Math.PI * 2;
-    const radius = 2 + Math.random() * 2;
-    const x = Math.cos(angle) * radius;
-    const y = -2 + Math.random() * 4;
-    const size = 0.02 + Math.random() * 0.025;
-    const geo = this._createMiniEggGeo(T, size);
-    const mat = this._createMiniEggMat(T, 0);
-    const p = new T.Mesh(geo, mat);
-    p.position.set(x, y, -1 + Math.random() * 0.5);
-    p.rotation.set(
-      Math.random() * Math.PI,
-      Math.random() * Math.PI,
-      Math.random() * Math.PI
-    );
-    this.scene.add(p);
-    this._ambientParticles.push({
-      mesh: p,
-      life: 1,
-      vy: 0.2 + Math.random() * 0.3,
-      fadeIn: true
-    });
+    const now = performance.now();
+    const isRhythm = source === "rhythm";
+    if (isRhythm) {
+      const minGap = Math.max(80, 180 - progress * 120);
+      if (now - this._lastAmbientSpawnAt < minGap) return;
+    } else if (Math.random() > progress * 0.3) {
+      return;
+    }
+    this._lastAmbientSpawnAt = now;
+    const spawnCount = isRhythm && progress > 0.6 ? 2 : 1;
+    for (let i = 0; i < spawnCount; i++) {
+      const angle = Math.random() * Math.PI * 2;
+      const radius = isRhythm ? 1.1 + Math.random() * 1.8 : 2 + Math.random() * 2;
+      const x = Math.cos(angle) * radius;
+      const y = isRhythm ? -2.8 - Math.random() * 0.9 : -2 + Math.random() * 4;
+      const size = isRhythm ? 0.03 + Math.random() * 0.03 : 0.02 + Math.random() * 0.025;
+      const geo = this._createMiniEggGeo(T, size);
+      const mat = this._createMiniEggMat(T, 0);
+      const p = new T.Mesh(geo, mat);
+      p.position.set(x, y, -1 + Math.random() * 0.5);
+      p.rotation.set(
+        Math.random() * Math.PI,
+        Math.random() * Math.PI,
+        Math.random() * Math.PI
+      );
+      this.scene.add(p);
+      this._ambientParticles.push({
+        mesh: p,
+        life: isRhythm ? 1.25 : 1,
+        vy: isRhythm ? 0.45 + Math.random() * 0.35 : 0.2 + Math.random() * 0.3,
+        fadeIn: true
+      });
+    }
     if (this._ambientParticles.length > 60) {
       const old = this._ambientParticles.shift();
       if (old) {
@@ -4569,6 +4593,8 @@ class StillnessStage {
     this._attempts = 1;
     this.input.resetPhases();
     this.input.resetCounts();
+    this.bus.emit("narrative:clear");
+    await this._wait(850);
     this._introPlayed = false;
     const introLines = this.script.stage1Intro;
     for (let i = 0; i < introLines.length; i++) {
@@ -4663,6 +4689,8 @@ class MotionStage {
     this._attempts = 1;
     this.input.resetPhases();
     this.input.resetCounts();
+    this.bus.emit("narrative:clear");
+    await this._wait(850);
     this._introPlayed = false;
     const introLines = this.script.stage2Intro;
     for (let i = 0; i < introLines.length; i++) {
@@ -4762,10 +4790,11 @@ class RhythmStage {
     this._totalCycles = 0;
     this._lastPhaseCount = 0;
     this._bestAccuracy = 0;
-    this.IDEAL_MOVE_MIN = 1800;
-    this.IDEAL_MOVE_MAX = 5e3;
-    this.IDEAL_PAUSE_MIN = 1200;
-    this.IDEAL_PAUSE_MAX = 4e3;
+    this._lastGuideTime = 0;
+    this.IDEAL_MOVE_MIN = 900;
+    this.IDEAL_MOVE_MAX = 4200;
+    this.IDEAL_PAUSE_MIN = 600;
+    this.IDEAL_PAUSE_MAX = 2800;
     this.config = config;
     this.script = script;
     this.input = input;
@@ -4776,8 +4805,11 @@ class RhythmStage {
     this._attempts = 1;
     this._goodCycles = 0;
     this._totalCycles = 0;
+    this.input.configurePhaseDetection({ stillThresholdMs: 450, minPhaseMs: 350 });
     this.input.resetPhases();
     this.input.resetCounts();
+    this.bus.emit("narrative:clear");
+    await this._wait(850);
     this._introPlayed = false;
     const introLines = this.script.stage3Intro;
     for (let i = 0; i < introLines.length; i++) {
@@ -4793,6 +4825,7 @@ class RhythmStage {
     this.input.resetPhases();
     this._lastPhaseCount = this.input.phases.length;
     this._introPlayed = true;
+    this._lastGuideTime = Date.now();
   }
   update(_dt) {
     if (this._status === "complete" || !this._introPlayed) return this._status;
@@ -4807,7 +4840,7 @@ class RhythmStage {
         if (isGood) {
           this._goodCycles++;
         } else {
-          this._goodCycles = Math.max(0, this._goodCycles - 1);
+          this._goodCycles = Math.max(0, this._goodCycles - 0.5);
           this._showReaction();
         }
         this._lastPhaseCount += 2;
@@ -4819,7 +4852,17 @@ class RhythmStage {
     if (accuracy > this._bestAccuracy) this._bestAccuracy = accuracy;
     const progress = Math.min(1, this._goodCycles / requiredCycles);
     this.bus.emit("stage:progress", progress);
-    this.bus.emit("rhythm:breathe", { accuracy, isMoving: this.input.snapshot.isMoving });
+    this.bus.emit("rhythm:breathe", {
+      accuracy,
+      isMoving: this.input.snapshot.isMoving,
+      progress,
+      moveDuration: this.input.moveDuration,
+      stillDuration: this.input.stillDuration
+    });
+    if (accuracy === 0 && Date.now() - this._lastGuideTime > 12e3) {
+      this._lastGuideTime = Date.now();
+      this._showReaction();
+    }
     if (this._goodCycles >= requiredCycles) {
       this._status = "complete";
       this.bus.emit("stage:progress", 1);
@@ -4829,6 +4872,7 @@ class RhythmStage {
     return this._status;
   }
   cleanup() {
+    this.input.resetPhaseDetection();
   }
   getResult() {
     return {
@@ -4848,7 +4892,7 @@ class RhythmStage {
   }
   _showReaction() {
     const now = Date.now();
-    if (now - this._lastNarrativeTime > 6e4) {
+    if (now - this._lastNarrativeTime > 12e3) {
       this._lastNarrativeTime = now;
       const reactions = this.script.stage3Reactions;
       const line = reactions[this._narrativeIndex % reactions.length];
@@ -4964,6 +5008,7 @@ class PageBreather {
     this._targetIntensity = 0;
     this._rafId = 0;
     this._overlay = null;
+    this._label = null;
     this._startTime = 0;
     this._isUserMoving = false;
     this._inSync = false;
@@ -4979,9 +5024,16 @@ class PageBreather {
       const shouldMove = phase < 0.5;
       this._inSync = this._accuracy > 0 && shouldMove === this._isUserMoving;
       const baseOpacity = wave * 0.85;
-      const syncBonus = this._inSync ? 0.15 : 0;
-      const opacity = this._intensity * (baseOpacity + (1 - wave) * 0.05 + syncBonus);
-      this._overlay.style.opacity = String(Math.min(1, opacity));
+      const syncBonus = this._inSync ? 0.22 : 0;
+      const opacity = this._intensity * (0.18 + baseOpacity + (1 - wave) * 0.12 + syncBonus);
+      this._overlay.style.opacity = String(Math.min(0.9, opacity));
+      this._overlay.style.transform = `scale(${1 + wave * 0.015})`;
+      if (this._label) {
+        this._label.textContent = shouldMove ? "In" : "Out";
+        this._label.style.opacity = shouldMove === this._isUserMoving ? "0.98" : "0.82";
+        this._label.style.boxShadow = this._inSync ? "0 0 28px rgba(212,165,80,0.4)" : "0 0 20px rgba(255,255,255,0.08)";
+        this._label.style.borderColor = this._inSync ? "rgba(212,165,80,0.55)" : "rgba(255,255,255,0.12)";
+      }
     };
   }
   start() {
@@ -4998,31 +5050,56 @@ class PageBreather {
       "pointer-events:none",
       "z-index:999980",
       "opacity:0",
-      "background:radial-gradient(ellipse at center, transparent 30%, rgba(0,0,0,0.7) 100%)",
+      "background:radial-gradient(ellipse at center, rgba(255,255,255,0.03) 0%, rgba(255,255,255,0.02) 24%, rgba(8,12,22,0.18) 46%, rgba(4,6,12,0.82) 100%)",
       "transition:opacity 0.3s ease"
     ].join(";");
     document.body.appendChild(el);
     this._overlay = el;
+    const label = document.createElement("div");
+    label.style.cssText = [
+      "position:fixed",
+      "left:50%",
+      "top:18%",
+      "transform:translateX(-50%)",
+      "pointer-events:none",
+      "z-index:999981",
+      "padding:8px 14px",
+      "border-radius:999px",
+      "font-family:Georgia, Times New Roman, serif",
+      "font-size:12px",
+      "letter-spacing:0.12em",
+      "text-transform:uppercase",
+      "color:rgba(255,248,232,0.95)",
+      "background:rgba(8,10,18,0.36)",
+      "border:1px solid rgba(255,255,255,0.12)",
+      "box-shadow:0 0 20px rgba(255,255,255,0.08)",
+      "opacity:0.78"
+    ].join(";");
+    label.textContent = "In";
+    document.body.appendChild(label);
+    this._label = label;
     this._tick();
   }
   update(accuracy, isMoving) {
     if (!this._active) return;
     this._isUserMoving = isMoving;
     this._accuracy = accuracy;
-    const raw = Math.max(0, Math.min(1, (accuracy - 0.05) / 0.5));
-    this._targetIntensity = 0.5 + raw * 0.5;
+    const raw = Math.max(0, Math.min(1, (accuracy - 0.02) / 0.45));
+    this._targetIntensity = 0.68 + raw * 0.32;
   }
   /** Whether the user is currently in sync with the breathing rhythm. */
   isInSync() {
     return this._inSync;
   }
   stop() {
-    var _a2;
+    var _a2, _b2;
     if (!this._active) return;
     this._active = false;
     cancelAnimationFrame(this._rafId);
     (_a2 = this._overlay) == null ? void 0 : _a2.remove();
     this._overlay = null;
+    (_b2 = this._label) == null ? void 0 : _b2.remove();
+    this._label = null;
     this._intensity = 0;
     this._targetIntensity = 0;
     this._inSync = false;
@@ -5116,7 +5193,7 @@ class GameController {
     });
     this.bus.on("narrative:clear", () => {
       var _a3;
-      return (_a3 = this.narrative) == null ? void 0 : _a3.clear();
+      return (_a3 = this.narrative) == null ? void 0 : _a3.clear(true);
     });
     this.bus.on("egg:reveal", (index) => this._handleEggReveal(index));
     this.bus.on("stage:progress", (p) => this._handleStageProgress(p));
@@ -5128,8 +5205,11 @@ class GameController {
       var _a3, _b3;
       (_a3 = this.eggRenderer) == null ? void 0 : _a3.setBreathIntensity(data.accuracy);
       (_b3 = this.pageBreather) == null ? void 0 : _b3.update(data.accuracy, data.isMoving);
-      if (data.accuracy > 0 && this.threeRenderer) {
-        this.threeRenderer.showProgressParticles(0.6 + data.accuracy * 0.4);
+      const rhythmSignal = Math.max(data.accuracy, data.progress * 0.75);
+      const hasLiveCycleSignal = data.moveDuration > 700 || data.stillDuration > 700;
+      if ((rhythmSignal > 0.08 || hasLiveCycleSignal) && this.threeRenderer) {
+        const liveSignal = hasLiveCycleSignal ? 0.2 : 0;
+        this.threeRenderer.showProgressParticles(Math.max(0.35, 0.45 + Math.max(rhythmSignal, liveSignal) * 0.55), "rhythm");
       } else if (this.threeRenderer) {
         this.threeRenderer.fadeOutAmbientParticles();
       }
@@ -5493,7 +5573,7 @@ class GameController {
     (_d = this.narrative) == null ? void 0 : _d.showCelebration(congrats[eggIndex] ?? "egg collected");
     await this._wait(3500);
     (_e = this.narrative) == null ? void 0 : _e.clear();
-    await this._wait(400);
+    await this._wait(900);
     if (eggIndex < 2) {
       if (eggIndex === 0) {
         this.fsm.transitionTo("stage2-intro");