easter-egg-quest 1.0.1 → 1.0.3

package/README.md

@@ -1,23 +1,26 @@
 # 🥚 Easter Egg Quest
 
-Drop a hidden Easter-themed mini-game onto **any website** with a single line of code. Users discover a secret entry point on your page and solve three poetic riddles — *Stillness*, *Motion*, *Rhythm* — to collect three symbolic eggs.
+Something is hiding on your website. Your visitors don't know it yet.
 
-**Zero configuration required.** The game overlays your page without breaking layout. Fully self-contained — Three.js 3D rendering is built in.
+One line of code — and your page holds a secret. A poetic journey disguised as ordinary text. Three riddles. Three eggs. One question: *will they notice?*
 
-## Quick Start
+No buttons. No banners. No hints. Just a quiet invitation woven into the fabric of your page.
 
-### CDN (simplest)
+Those who find it will never look at your website the same way again.
+
+---
+
+## Installation
+
+### One line (CDN)
 
 ```html
-<script src="https://unpkg.com/easter-egg-quest"></script>
-<script>
-  EasterEggQuest.init();
-</script>
+<script src="https://unpkg.com/easter-egg-quest/dist/easter-egg-quest.umd.js"></script>
 ```
 
-That's it. The game hides itself inside your page content and waits to be discovered.
+Nothing else needed. The script activates itself after your page loads.
 
-### npm
+### npm / yarn
 
 ```bash
 npm install easter-egg-quest
@@ -29,59 +32,50 @@ import { EasterEggQuest } from 'easter-egg-quest';
 EasterEggQuest.init();
 ```
 
-## How It Works
+---
+
+## What happens next?
+
+That's for your visitors to discover.
+
+We'll only say this: the experience has three chapters, each asking something different. Something about stillness. Something about motion. Something about the space between.
 
-1. **Hidden entry** — the game injects a subtle "start hunt" trigger into existing text on your page
-2. **Stage 1: Stillness** — stop moving. The egg comes to those who wait
-3. **Stage 2: Motion** — keep moving. Be the river
-4. **Stage 3: Rhythm** — find the pulse. Breathe
-5. **Finale** — all three eggs appear in a 3D carousel with a "Happy Easter!" greeting
-6. **Results** — a personalized profile card based on your behavior (shareable as image)
+The whole thing takes a few minutes. At the end, each person gets a unique result — a portrait of how they moved through the unknown.
 
-The user clicks "finish" to close — the game removes all traces of itself from the DOM.
+---
 
 ## Configuration
 
-All options are optional:
+Everything works out of the box. But if you want control:
 
 ```js
 EasterEggQuest.init({
-  // Lifecycle callbacks
   callbacks: {
-    onInit: () => {},
-    onEntryFound: () => {},
-    onStageStart: (stage) => {},
-    onEggFound: (eggIndex) => {},
-    onComplete: (score) => {},
-    onDestroy: () => {},
+    onComplete: (score) => {
+      // The visitor finished the quest
+    },
   },
 
-  // Stage durations
   stageDurations: {
     stillnessMs: 20000,
     motionMs: 20000,
     rhythmCycles: 6,
   },
 
-  // Rendering: 'auto' | '3d' | '2d'
-  renderer: 'auto',
+  renderer: 'auto',          // 'auto' | '3d' | '2d'
 
-  // Accessibility
   accessibility: {
-    reducedMotion: 'auto',   // follows prefers-reduced-motion
-    disableHiddenEntry: false, // shows a visible button instead
+    reducedMotion: 'auto',
+    disableHiddenEntry: false,
   },
 
-  // Hidden entry targeting
   hiddenEntry: {
-    selector: undefined,       // CSS selector to limit entry candidates
-    excludeSelectors: [],      // selectors to exclude
+    selector: undefined,
+    excludeSelectors: [],
   },
 
-  // Custom narrative text
   narrative: {
-    // Override any dialogue array:
-    // stage1Intro: ['your', 'custom', 'lines'],
+    // Your own words for any chapter
   },
 });
 ```
@@ -89,26 +83,26 @@ EasterEggQuest.init({
 ## API
 
 ```js
-EasterEggQuest.init(config?)   // Start the game
-EasterEggQuest.pause()         // Pause
-EasterEggQuest.resume()        // Resume
-EasterEggQuest.destroy()       // Remove everything, restore DOM
+EasterEggQuest.init(config?)   // Awaken the quest
+EasterEggQuest.pause()         // Freeze time
+EasterEggQuest.resume()        // Let it breathe again
+EasterEggQuest.destroy()       // Erase all traces
 ```
 
-## Safety
+---
 
-Designed to be safe on production websites:
+## Safe by design
 
-- **No layout shifts** — all UI is `position: fixed` overlay
-- **Shadow DOM isolation** — CSS never collides with your styles
-- **Smart element filtering** — hidden entry avoids Buy, Delete, Checkout, Submit buttons
-- **Clean destroy** — removes all DOM elements, listeners, and WebGL resources
+- Your layout stays untouched — everything floats above
+- Styles are sealed in Shadow DOM — no collisions
+- Dangerous buttons (Buy, Delete, Submit) are never used as entry points
+- `destroy()` leaves your page exactly as it was
 
-## Browser Support
+## Compatibility
 
-Chrome/Edge 90+ · Firefox 90+ · Safari 15+ · Mobile browsers
+Chrome · Edge · Firefox · Safari · Mobile
 
-Falls back to CSS 2D rendering if WebGL is unavailable.
+Falls back gracefully without WebGL.
 
 ## License
 

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

@@ -729,8 +729,8 @@ class HiddenEntry {
     this._injectShimmerStyles();
     this._createHintContainer();
     const hints = this.script.hiddenEntryHints;
-    const FIRST_HINT_DELAY = 5e3;
-    const HINT_INTERVAL = 3e3;
+    const FIRST_HINT_DELAY = 3e5;
+    const HINT_INTERVAL = 6e4;
     for (let i = 0; i < hints.length; i++) {
       const delay = FIRST_HINT_DELAY + i * HINT_INTERVAL;
       const timer = setTimeout(() => {
@@ -739,7 +739,7 @@ class HiddenEntry {
       }, delay);
       this.hintTimers.push(timer);
     }
-    const shimmerDelay = 12e3;
+    const shimmerDelay = 42e4;
     const shimmerTimer = setTimeout(() => {
       if (this._destroyed || !this.targetElement) return;
       this.targetElement.classList.add("eeq-entry-target");
@@ -950,10 +950,10 @@ class NarrativeRenderer {
     this.currentLine = line;
     this.clearTimer = setTimeout(() => {
       this.clear();
-    }, 5e3);
+    }, 12e3);
   }
   /** Show a sequence of lines with pauses. */
-  async showSequence(lines, pauseMs = 1500) {
+  async showSequence(lines, pauseMs = 4500) {
     for (const line of lines) {
       this.showLine(line);
       await new Promise((r) => setTimeout(r, pauseMs));
@@ -3980,7 +3980,7 @@ class StillnessStage {
     const introLines = this.script.stage1Intro;
     for (let i = 0; i < introLines.length; i++) {
       this.bus.emit("narrative:show", introLines[i]);
-      await this._wait(1500);
+      await this._wait(4500);
     }
     this.bus.emit("narrative:clear");
     await this._wait(1e3);
@@ -4020,7 +4020,7 @@ class StillnessStage {
   _handleBreak() {
     this._breaks++;
     const now = Date.now();
-    if (now - this._lastBreakNarrativeTime > 5e3) {
+    if (now - this._lastBreakNarrativeTime > 6e4) {
       this._lastBreakNarrativeTime = now;
       const reactions = this.script.stage1Reactions;
       const line = reactions[this._narrativeIndex % reactions.length];
@@ -4060,7 +4060,7 @@ class MotionStage {
     const introLines = this.script.stage2Intro;
     for (let i = 0; i < introLines.length; i++) {
       this.bus.emit("narrative:show", introLines[i]);
-      await this._wait(1500);
+      await this._wait(4500);
     }
     this.bus.emit("narrative:clear");
     await this._wait(1e3);
@@ -4115,7 +4115,7 @@ class MotionStage {
   // ─── Internal ──────────────────────────────────────────────────────────
   _handleFade() {
     const now = Date.now();
-    if (now - this._lastFadeNarrativeTime > 5e3) {
+    if (now - this._lastFadeNarrativeTime > 6e4) {
       this._lastFadeNarrativeTime = now;
       const reactions = this.script.stage2Reactions;
       const line = reactions[this._narrativeIndex % reactions.length];
@@ -4159,7 +4159,7 @@ class RhythmStage {
     const introLines = this.script.stage3Intro;
     for (let i = 0; i < introLines.length; i++) {
       this.bus.emit("narrative:show", introLines[i]);
-      await this._wait(1500);
+      await this._wait(4500);
     }
     this.bus.emit("narrative:clear");
     await this._wait(1e3);
@@ -4219,7 +4219,7 @@ class RhythmStage {
   }
   _showReaction() {
     const now = Date.now();
-    if (now - this._lastNarrativeTime > 5e3) {
+    if (now - this._lastNarrativeTime > 6e4) {
       this._lastNarrativeTime = now;
       const reactions = this.script.stage3Reactions;
       const line = reactions[this._narrativeIndex % reactions.length];
@@ -4683,7 +4683,7 @@ class GameController {
     this.hiddenEntry = null;
     this._startAnticipationTremor();
     (_b2 = this.shrine) == null ? void 0 : _b2.show();
-    await ((_c = this.narrative) == null ? void 0 : _c.showSequence(this.script.entryConfirmation, 1500));
+    await ((_c = this.narrative) == null ? void 0 : _c.showSequence(this.script.entryConfirmation, 4200));
     (_d = this.narrative) == null ? void 0 : _d.clear();
     this._stopAnticipationTremor();
     await this._wait(800);
@@ -4799,7 +4799,7 @@ class GameController {
       (_b2 = (_a2 = this.config.callbacks).onStageComplete) == null ? void 0 : _b2.call(_a2, this.fsm.state, result);
     }
     const successLines = eggIndex === 0 ? this.script.stage1Success : eggIndex === 1 ? this.script.stage2Success : this.script.stage3Success;
-    await ((_c = this.narrative) == null ? void 0 : _c.showSequence(successLines, 1500));
+    await ((_c = this.narrative) == null ? void 0 : _c.showSequence(successLines, 4500));
     (_d = this.narrative) == null ? void 0 : _d.clear();
     await this._wait(800);
     if (this.threeRenderer) {
@@ -4880,7 +4880,7 @@ class GameController {
     (_c = this.shrine) == null ? void 0 : _c.hideAll();
     await this._wait(1e3);
     (_d = this.eggRenderer) == null ? void 0 : _d.startFinale();
-    await ((_e = this.narrative) == null ? void 0 : _e.showSequence(this.script.finale, 1500));
+    await ((_e = this.narrative) == null ? void 0 : _e.showSequence(this.script.finale, 5e3));
     (_f = this.narrative) == null ? void 0 : _f.clear();
     await this._wait(4e3);
     this.fsm.transitionTo("results");