easter-egg-quest 1.0.18 → 1.0.19

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

@@ -57,33 +57,24 @@ 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",
-    "what do all living things share?",
-    "you already know the answer",
-    "you’ve been doing it since birth",
-    "listen to yourself",
-    "closer...",
-    "can you feel it?",
-    "the body remembers",
+    "move for a few seconds",
+    "then hold still for a moment",
+    "don’t rush it",
+    "alternate move and pause",
     "in",
     "out"
   ],
   stage3Success: [
     "rhythm was the answer",
-    "you found the third egg",
-    "nice work"
+    "you found the third egg"
   ],
   // ── Finale ────────────────────────────────────────────────────────────
   finale: [
@@ -331,8 +322,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 +464,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 +488,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 +502,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 +1317,7 @@ class NarrativeRenderer {
     this.container = null;
     this.currentLine = null;
     this.clearTimer = null;
+    this.awaitingConfirm = false;
     this.config = config;
   }
   mount() {
@@ -1335,14 +1341,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 +1385,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 +1398,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 +1423,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;
@@ -4569,6 +4580,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 +4676,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,6 +4777,7 @@ class RhythmStage {
     this._totalCycles = 0;
     this._lastPhaseCount = 0;
     this._bestAccuracy = 0;
+    this._lastGuideTime = 0;
     this.IDEAL_MOVE_MIN = 1800;
     this.IDEAL_MOVE_MAX = 5e3;
     this.IDEAL_PAUSE_MIN = 1200;
@@ -4776,8 +4792,11 @@ class RhythmStage {
     this._attempts = 1;
     this._goodCycles = 0;
     this._totalCycles = 0;
+    this.input.configurePhaseDetection({ stillThresholdMs: 900, minPhaseMs: 500 });
     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 +4812,8 @@ class RhythmStage {
     this.input.resetPhases();
     this._lastPhaseCount = this.input.phases.length;
     this._introPlayed = true;
+    this.bus.emit("narrative:show", "move for a few seconds, then hold still");
+    this._lastGuideTime = Date.now();
   }
   update(_dt) {
     if (this._status === "complete" || !this._introPlayed) return this._status;
@@ -4819,7 +4840,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.bus.emit("narrative:show", "try this: move 2-4s, then stay still 1-3s");
+    }
     if (this._goodCycles >= requiredCycles) {
       this._status = "complete";
       this.bus.emit("stage:progress", 1);
@@ -4829,6 +4860,7 @@ class RhythmStage {
     return this._status;
   }
   cleanup() {
+    this.input.resetPhaseDetection();
   }
   getResult() {
     return {
@@ -4848,7 +4880,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 +4996,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 +5012,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 ? "Move" : "Hold still";
+        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 +5038,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 = "Move";
+    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 +5181,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 +5193,10 @@ 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 > 1200 || data.stillDuration > 900;
+      if ((rhythmSignal > 0.08 || hasLiveCycleSignal) && this.threeRenderer) {
+        this.threeRenderer.showProgressParticles(0.45 + rhythmSignal * 0.55);
       } else if (this.threeRenderer) {
         this.threeRenderer.fadeOutAmbientParticles();
       }
@@ -5493,7 +5560,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");