easter-egg-quest 1.0.14 → 1.0.16

package/dist/types/entry/HiddenEntry.d.ts

@@ -27,11 +27,32 @@ export declare class HiddenEntry {
     private _hintVisibleStart;
     private _hintCheckInterval;
     private _hintVisibilityHandler;
+    private _domObserver;
+    private _intersectionObserver;
+    private _mutationDebounce;
+    private _navigationHandler;
     constructor(config: ResolvedConfig, script: NarrativeScript, onFound: () => void);
     start(): void;
     cleanup(): void;
     private _possessElement;
     private _injectIntoExisting;
+    /**
+     * Watch for the injected trigger element being removed from the DOM
+     * (SPA re-render, route change, virtual scroll) or scrolled out of view.
+     *
+     * Uses IntersectionObserver (zero layout cost) for visibility,
+     * a MutationObserver on a stable ancestor (survives Angular/React re-renders),
+     * and navigation event listeners for SPA route changes.
+     */
+    private _startWatchdog;
+    /**
+     * Walk up the DOM to find a stable ancestor that won't be replaced
+     * by SPA framework routing (Angular <router-outlet>, React root, etc.).
+     */
+    private _findStableAncestor;
+    private _stopWatchdog;
+    /** Remove old trigger (if still in DOM) and re-inject into a new element. */
+    private _reinject;
     /**
      * Try to insert the trigger span between words inside a text node.
      * Picks a random word boundary in the element's first direct text node.

package/dist/types/rendering/PageBreather.d.ts

@@ -17,6 +17,7 @@ export declare class PageBreather {
     private _startTime;
     private _isUserMoving;
     private _inSync;
+    private _accuracy;
     /** Full breath cycle duration in ms (move half + pause half). */
     private readonly CYCLE_MS;
     start(): void;

package/dist/types/rendering/ThreeRenderer.d.ts

@@ -80,6 +80,8 @@ export declare class ThreeRenderer {
     addTrail(x: number, y: number, velocity: number): void;
     /** Spawn gentle ambient particles to show stage progress. */
     showProgressParticles(progress: number): void;
+    /** Mark all ambient particles for rapid fade-out (rhythm lost). */
+    fadeOutAmbientParticles(): void;
     /** Start the finale composition. */
     startFinale(): void;
     /** Re-draw the festive (3rd) egg texture with a specific seed for uniqueness. */
@@ -90,7 +92,7 @@ export declare class ThreeRenderer {
     private _setupLights;
     private _setupEnvironment;
     private _createEggs;
-    /** Create a tiny egg-shaped geometry (same squash as main eggs, lower poly). */
+    /** Create a tiny egg-shaped geometry — rounder, less elongated. */
     private _createMiniEggGeo;
     /** Create a minimalist randomly-decorated mini egg material. */
     /** Create a decorated mini egg material — pastel base with visible patterns. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easter-egg-quest",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "A hidden Easter-themed narrative mini-game overlay for any website",
   "main": "dist/easter-egg-quest.umd.js",
   "module": "dist/easter-egg-quest.es.js",