lively-mascot 0.2.0

package/src/core/emotions.js

@@ -0,0 +1,206 @@
+/**
+ * lively-mascot · Emotion Definitions
+ *
+ * Grouped by:
+ * - Lifecycle (00-09): Core states like idle, sleeping, waking up.
+ * - Reactions (10-19): Immediate responses to user actions.
+ * - Work States (20-31): What the bot/agent is doing (thinking, searching, etc.).
+ *
+ * Each emotion can define:
+ * - bodyAnim:   CSS animation override for .lively-body
+ * - bodyFilter: CSS filter override for .lively-body
+ * - blink:      false = force eyes closed/locked (default true)
+ * - gaze:       false = pause cursor tracking (default true)
+ * - hop:        true = allow interval-driven hopping for this expression
+ * - leafAnim:   CSS animation override for .lively__leaf
+ * - footAnim:   CSS animation override for .lively__foot
+ */
+
+var LivelyEmotions = {
+  // ===================== LIFECYCLE (00-09) =====================
+  "00": { id: "00", name: "Sleep",      group: "lifecycle", desc: "深度睡眠",
+          blink: false, gaze: false,
+          bodyFilter: "brightness(0.55) saturate(0.6)",
+          leafAnim: "lively-leaf-sleep 6s ease-in-out infinite",
+          footAnim: "lively-foot-rest 4s ease-in-out infinite" },
+  "01": { id: "01", name: "Wake",       group: "lifecycle", desc: "刚睡醒",
+          bodyAnim: "lively-wake 1.2s ease-out",
+          leafAnim: "lively-leaf-wake 0.8s ease-out",
+          footAnim: "lively-foot-wake 0.6s ease-out" },
+  "02": { id: "02", name: "Idle",       group: "lifecycle", desc: "待机" },
+  "03": { id: "03", name: "Breathe",    group: "lifecycle", desc: "平稳呼吸",
+          bodyAnim: "lively-deep-breathe 4s ease-in-out infinite",
+          leafAnim: "lively-leaf-breathe 4s ease-in-out infinite",
+          footAnim: "lively-foot-rest 4s ease-in-out infinite" },
+  "04": { id: "04", name: "Ready",      group: "lifecycle", desc: "随时待命",
+          bodyAnim: "lively-ready 2s ease-in-out infinite",
+          leafAnim: "lively-leaf-ready 1.5s ease-in-out infinite",
+          footAnim: "lively-foot-ready 1.8s ease-in-out infinite" },
+  "05": { id: "05", name: "Pause",      group: "lifecycle", desc: "暂停中",
+          bodyFilter: "saturate(0.4) brightness(0.85)",
+          leafAnim: "lively-leaf-pause 6s ease-in-out infinite",
+          footAnim: "lively-foot-rest 4s ease-in-out infinite" },
+  "06": { id: "06", name: "Refresh",    group: "lifecycle", desc: "正在刷新",
+          bodyAnim: "lively-refresh 0.8s ease-in-out infinite",
+          leafAnim: "lively-leaf-refresh 0.6s ease-in-out infinite" },
+  "07": { id: "07", name: "LowBattery", group: "lifecycle", desc: "电量不足",
+          bodyFilter: "saturate(0.3) brightness(0.7)",
+          bodyAnim: "lively-lowbatt 2.5s ease-in-out infinite",
+          leafAnim: "lively-leaf-droop 3s ease-in-out infinite",
+          footAnim: "lively-foot-rest 5s ease-in-out infinite" },
+  "08": { id: "08", name: "Offline",    group: "lifecycle", desc: "已离线",
+          blink: false, gaze: false,
+          bodyFilter: "grayscale(1) brightness(0.5)",
+          leafAnim: "lively-leaf-droop 8s ease-in-out infinite" },
+  "09": { id: "09", name: "Boot",       group: "lifecycle", desc: "启动中",
+          bodyAnim: "lively-boot 0.5s ease-in-out 3",
+          leafAnim: "lively-leaf-boot 0.4s ease-out 3",
+          footAnim: "lively-foot-boot 0.3s ease-out 3" },
+
+  // ===================== REACTIONS (10-19) =====================
+  "10": { id: "10", name: "Happy",     group: "reaction", desc: "开心",
+          gaze: false,
+          bodyAnim: "lively-happy-bounce 0.6s ease-in-out 2",
+          leafAnim: "lively-leaf-happy 0.4s ease-in-out 4",
+          footAnim: "lively-foot-happy 0.35s ease-in-out 4" },
+  "11": { id: "11", name: "Excited",   group: "reaction", desc: "兴奋",
+          gaze: false,
+          bodyAnim: "lively-excited 0.5s ease-in-out 3",
+          leafAnim: "lively-leaf-excited 0.3s ease-in-out 5",
+          footAnim: "lively-foot-excited 0.25s ease-in-out 6" },
+  "12": { id: "12", name: "Sad",       group: "reaction", desc: "难过",
+          gaze: false,
+          bodyAnim: "lively-sad 3s ease-in-out infinite",
+          bodyFilter: "brightness(0.85) saturate(0.7)",
+          leafAnim: "lively-leaf-droop 2s ease-in-out infinite",
+          footAnim: "lively-foot-rest 4s ease-in-out infinite" },
+  "13": { id: "13", name: "Angry",     group: "reaction", desc: "生气",
+          gaze: false,
+          bodyAnim: "lively-angry 0.15s linear infinite",
+          bodyFilter: "hue-rotate(340deg) saturate(1.5) brightness(0.95)",
+          leafAnim: "lively-leaf-angry 0.12s linear infinite",
+          footAnim: "lively-foot-stomp 0.18s ease-in-out infinite" },
+  "14": { id: "14", name: "Surprised", group: "reaction", desc: "惊讶",
+          gaze: false,
+          bodyAnim: "lively-surprise 0.5s ease-out",
+          leafAnim: "lively-leaf-wake 0.5s ease-out" },
+  "15": { id: "15", name: "Shy",       group: "reaction", desc: "害羞",
+          gaze: false,
+          bodyAnim: "lively-confused 2s ease-in-out infinite",
+          leafAnim: "lively-leaf-shy 2s ease-in-out infinite" },
+  "16": { id: "16", name: "Love",      group: "reaction", desc: "心动",
+          gaze: false,
+          bodyAnim: "lively-love-pulse 0.8s ease-in-out infinite",
+          leafAnim: "lively-leaf-happy 0.6s ease-in-out infinite" },
+  "17": { id: "17", name: "Confused",  group: "reaction", desc: "困惑",
+          bodyAnim: "lively-confused 2s ease-in-out infinite",
+          leafAnim: "lively-leaf-confused 1.5s ease-in-out infinite" },
+  "18": { id: "18", name: "Cool",      group: "reaction", desc: "耍酷",
+          bodyFilter: "contrast(1.15) brightness(1.05)",
+          leafAnim: "lively-leaf-ready 2s ease-in-out infinite" },
+  "19": { id: "19", name: "Smug",      group: "reaction", desc: "得意",
+          bodyAnim: "lively-smug 2s ease-in-out infinite",
+          leafAnim: "lively-leaf-ready 1.8s ease-in-out infinite" },
+
+  // ===================== WORK STATES (20-31) =====================
+  "20": { id: "20", name: "Thinking",   group: "work", desc: "思考中",
+          blink: false,
+          bodyAnim: "lively-thinking 2.5s ease-in-out infinite",
+          leafAnim: "lively-leaf-thinking 2s ease-in-out infinite" },
+  "21": { id: "21", name: "Listening",  group: "work", desc: "倾听中",
+          bodyAnim: "lively-listening 2s ease-in-out infinite",
+          leafAnim: "lively-leaf-listen 1.8s ease-in-out infinite" },
+  "22": { id: "22", name: "Talking",    group: "work", desc: "说话中",
+          bodyAnim: "lively-talking 0.5s ease-in-out infinite",
+          leafAnim: "lively-leaf-talking 0.8s ease-in-out infinite" },
+  "23": { id: "23", name: "Searching",  group: "work", desc: "搜索中",
+          bodyAnim: "lively-searching 1.5s ease-in-out infinite",
+          leafAnim: "lively-leaf-searching 1.2s ease-in-out infinite",
+          footAnim: "lively-foot-pace 0.8s ease-in-out infinite" },
+  "24": { id: "24", name: "Reading",    group: "work", desc: "阅读中",
+          bodyAnim: "lively-reading 3s ease-in-out infinite",
+          leafAnim: "lively-leaf-reading 2.5s ease-in-out infinite" },
+  "25": { id: "25", name: "Writing",    group: "work", desc: "写作中",
+          bodyAnim: "lively-writing 1.8s ease-in-out infinite",
+          leafAnim: "lively-leaf-writing 1.5s ease-in-out infinite",
+          footAnim: "lively-foot-writing 1.2s ease-in-out infinite" },
+  "26": { id: "26", name: "Coding",     group: "work", desc: "编程中",
+          blink: false,
+          bodyAnim: "lively-coding 2.5s ease-in-out infinite",
+          leafAnim: "lively-leaf-coding 2s ease-in-out infinite" },
+  "27": { id: "27", name: "Designing",  group: "work", desc: "设计中",
+          bodyAnim: "lively-designing 3s ease-in-out infinite",
+          leafAnim: "lively-leaf-designing 2.5s ease-in-out infinite" },
+  "28": { id: "28", name: "Loading",    group: "work", desc: "加载中",
+          gaze: false,
+          // Loading state is communicated by the rotated ring (CSS).
+          // Disable the base body sway so the ring stays concentric; the
+          // whole rig bounces instead to make the live mascot feel alive.
+          bodyAnim: "lively-loading-bounce 0.9s ease-in-out infinite",
+          footAnim: "lively-foot-rest 3s ease-in-out infinite" },
+  "29": { id: "29", name: "Processing", group: "work", desc: "处理中",
+          bodyAnim: "lively-processing 1.5s ease-in-out infinite",
+          leafAnim: "lively-leaf-thinking 1.2s ease-in-out infinite" },
+  "30": { id: "30", name: "Success",    group: "work", desc: "任务完成",
+          gaze: false,
+          bodyAnim: "lively-success 0.7s ease-out",
+          leafAnim: "lively-leaf-happy 0.5s ease-out 2" },
+  "31": { id: "31", name: "Error",      group: "work", desc: "发生错误",
+          gaze: false,
+          bodyFilter: "brightness(0.8) saturate(0.6)",
+          bodyAnim: "lively-error 0.25s linear 4",
+          leafAnim: "lively-leaf-error 0.2s linear 4" },
+
+  // ===================== EXTENDED (32-34) =====================
+  "32": { id: "32", name: "Grateful",   group: "reaction", desc: "感谢",
+          gaze: false,
+          bodyAnim: "lively-love-pulse 1.2s ease-in-out infinite",
+          leafAnim: "lively-leaf-happy 1s ease-in-out infinite" },
+  "33": { id: "33", name: "Retrying",   group: "work", desc: "重试中",
+          bodyAnim: "lively-searching 1.2s ease-in-out infinite",
+          leafAnim: "lively-leaf-confused 1s ease-in-out infinite",
+          footAnim: "lively-foot-pace 0.6s ease-in-out infinite" },
+  "34": { id: "34", name: "Cancelled",  group: "work", desc: "已取消",
+          bodyFilter: "saturate(0.5) brightness(0.8)",
+          leafAnim: "lively-leaf-droop 3s ease-in-out infinite",
+          footAnim: "lively-foot-rest 3s ease-in-out infinite" },
+  "35": { id: "35", name: "Crying",     group: "reaction", desc: "哭泣",
+          gaze: false,
+          bodyFilter: "brightness(0.9) saturate(0.8)",
+          bodyAnim: "lively-sad 2s ease-in-out infinite",
+          leafAnim: "lively-leaf-droop 1.5s ease-in-out infinite",
+          footAnim: "lively-foot-rest 3s ease-in-out infinite" },
+  "36": { id: "36", name: "Bored",      group: "reaction", desc: "无聊",
+          bodyAnim: "lively-bored 4s ease-in-out infinite",
+          leafAnim: "lively-leaf-droop 5s ease-in-out infinite",
+          footAnim: "lively-foot-rest 4s ease-in-out infinite" },
+  "37": { id: "37", name: "Nervous",    group: "reaction", desc: "紧张",
+          bodyAnim: "lively-nervous 0.8s ease-in-out infinite",
+          leafAnim: "lively-leaf-nervous 0.6s ease-in-out infinite",
+          footAnim: "lively-foot-nervous 0.3s ease-in-out infinite" },
+  "38": { id: "38", name: "Eureka",     group: "reaction", desc: "灵光一现",
+          gaze: false,
+          bodyAnim: "lively-eureka 0.6s ease-out",
+          leafAnim: "lively-leaf-eureka 0.4s ease-out 2",
+          footAnim: "lively-foot-happy 0.3s ease-out 3" },
+  "39": { id: "39", name: "Waiting",    group: "work", desc: "等待中",
+          bodyAnim: "lively-waiting 2s ease-in-out infinite",
+          leafAnim: "lively-leaf-waiting 1.5s ease-in-out infinite",
+          footAnim: "lively-foot-tap 0.5s ease-in-out infinite" }
+};
+
+var LivelyEmotionGroups = {
+  "lifecycle": { name: "生命周期", order: 0 },
+  "reaction":  { name: "情绪反应", order: 1 },
+  "work":      { name: "工作状态", order: 2 }
+};
+
+// Keep the no-build browser global while making the data consumable from
+// Node/CommonJS when the source SDK is used as an npm entry point.
+if (typeof module === "object" && module.exports) {
+  module.exports = { emotions: LivelyEmotions, groups: LivelyEmotionGroups };
+}
+if (typeof globalThis !== "undefined") {
+  globalThis.LivelyEmotions = LivelyEmotions;
+  globalThis.LivelyEmotionGroups = LivelyEmotionGroups;
+}

package/src/core/rig.js

@@ -0,0 +1,282 @@
+/**
+ * lively-mascot · Core Animation Rig
+ *
+ * Handles gaze tracking, blinking, hopping, and emotion state management.
+ * This is the "engine" that drives the mascot's movement.
+ *
+ * Requires: src/core/emotions.js (loaded before this script)
+ * Globals: LivelyEmotions (from emotions.js), clamp (defined below)
+ */
+
+// --- Helpers ---
+var clamp = function (v, min, max) { return v < min ? min : v > max ? max : v; };
+
+// --- Core Rig ---
+function createRig(root, rigEl, config, handlers) {
+  config = config || {};
+  handlers = handlers || {};
+  var animated = config.animated !== false;
+  var followCursor = config.followCursor !== false;
+  var gazeRadiusX = config.gazeRadiusX || 200;
+  var gazeRadiusY = config.gazeRadiusY || 160;
+  var currentHopInterval = config.hopInterval === undefined ? [6, 13] : config.hopInterval;
+  var pupils = [];
+  var eyes = [];
+  var face = null;
+  var happy = false;
+  var hopping = false;
+  var following = animated && followCursor;
+  var currentEmotionId = "02"; // Default idle
+  var bodyEl = null;
+  var leafEl = null;
+  var leafUseLeafAnim = true;
+  var feetEl = null;
+  var gazeEl = null;
+  var faceAccessories = {};
+  var activeFaceAccessory = null;
+
+  var api = {
+    registerPupil: function (elm, spec) {
+      for (var i = 0; i < pupils.length; i++) { if (pupils[i].el === elm) { pupils[i].spec = spec; return; } }
+      pupils.push({ el: elm, spec: spec || { maxX: 8, maxY: 6 } });
+    },
+    registerEye: function (elm) { if (eyes.indexOf(elm) === -1) eyes.push(elm); },
+    registerFace: function (elm) { face = elm; },
+    registerBody: function (elm) { bodyEl = elm; },
+    registerLeaf: function (elm, opts) {
+      leafEl = elm;
+      // sprout uses its emotion `leafAnim` data; cat drives ears via its own CSS.
+      leafUseLeafAnim = !(opts && opts.useLeafAnim === false);
+    },
+    registerFeet: function (elm) { feetEl = elm; },
+    registerGazeWrap: function (elm) { gazeEl = elm; },
+    registerFaceAccessory: function (name, elm) {
+      if (!name || !elm) return;
+      faceAccessories[String(name)] = elm;
+      elm.classList.add("lively-face-accessory");
+      if (activeFaceAccessory === null) activeFaceAccessory = String(name);
+      elm.classList.toggle("is-active", activeFaceAccessory === String(name));
+    },
+    setFaceAccessory: function (name) {
+      var key = name == null ? null : String(name);
+      activeFaceAccessory = key;
+      for (var accessoryName in faceAccessories) {
+        if (Object.prototype.hasOwnProperty.call(faceAccessories, accessoryName)) {
+          faceAccessories[accessoryName].classList.toggle("is-active", accessoryName === key);
+        }
+      }
+    },
+    setEmotionState: function (id) {
+      currentEmotionId = String(id);
+      applyEmotionBehavior(currentEmotionId);
+      syncHop();
+    }
+  };
+
+  function setHappy(v) { if (happy === v) return; happy = v; root.classList.toggle("is-happy", v); }
+  function setHopping(v) { if (hopping === v) return; hopping = v; root.classList.toggle("is-hopping", v); }
+
+  // --- Emotion Behavior ---
+  function getEmotionDef(id) { return LivelyEmotions[String(id)]; }
+
+  function clearEmotionBehavior() {
+    if (bodyEl) { bodyEl.style.animation = ""; bodyEl.style.filter = ""; }
+    rigEl.style.animation = "";
+    if (leafEl && leafUseLeafAnim) { leafEl.style.animation = ""; }
+    if (feetEl) {
+      feetEl.style.removeProperty("--lively-state-filter");
+      var footL = feetEl.querySelector(".lively__foot--l");
+      var footR = feetEl.querySelector(".lively__foot--r");
+      if (footL) footL.style.animation = "";
+      if (footR) footR.style.animation = "";
+    }
+  }
+
+  function applyEmotionBehavior(id) {
+    var def = getEmotionDef(id);
+    if (!def) { clearEmotionBehavior(); return; }
+    // Static mode: the visible face is driven by the `is-emotion-XX` class
+    // (set on the root by the SDK), so we keep that but apply no motion —
+    // no body/leaf/foot animation and no filter flicker.
+    if (!animated) {
+      if (bodyEl) bodyEl.style.filter = def.bodyFilter || "";
+      if (feetEl) feetEl.style.setProperty("--lively-state-filter", def.bodyFilter || "brightness(1)");
+      return;
+    }
+    // Body
+    if (bodyEl) {
+      bodyEl.style.animation = def.bodyAnim || "";
+      bodyEl.style.filter = def.bodyFilter || "";
+    }
+    // Leaf (top decoration). Only drive it from emotion data when the
+    // character opts in (sprout). Cat drives its ears via its own CSS rules.
+    if (leafEl && leafUseLeafAnim) {
+      leafEl.style.animation = def.leafAnim || "";
+    }
+    // Feet
+    if (feetEl) {
+      feetEl.style.setProperty("--lively-state-filter", def.bodyFilter || "brightness(1)");
+      var footL = feetEl.querySelector(".lively__foot--l");
+      var footR = feetEl.querySelector(".lively__foot--r");
+      if (footL) footL.style.animation = def.footAnim || "";
+      if (footR) footR.style.animation = def.footAnim || "";
+    }
+    // Refresh (06) + Loading (28): drive the entire rig (whole mascot
+    // bounces / rotates with feet attached) instead of just the body.
+    if (id === "06" || id === "28") {
+      if (bodyEl) bodyEl.style.animation = "";
+      rigEl.style.animation = def.bodyAnim || "";
+    } else {
+      // Everything else: keep the rig stationary so overlays line up.
+      rigEl.style.animation = "";
+    }
+  }
+
+  // --- Gaze ---
+  var raf = 0, rect = root.getBoundingClientRect(), rectAt = performance.now();
+  var targetX = 0, targetY = 0, curX = 0, curY = 0;
+
+  function shouldGaze() {
+    // Explicit gaze:false emotions
+    var def = getEmotionDef(currentEmotionId);
+    if (def && def.gaze === false) return false;
+    // All active emotions (non-idle) pause gaze following
+    if (currentEmotionId !== "02") return false;
+    return following;
+  }
+
+  function onPointerMove(e) {
+    if (!shouldGaze()) return;
+    var now = performance.now();
+    if (now - rectAt > 250) { rect = root.getBoundingClientRect(); rectAt = now; }
+    var cx = rect.left + rect.width / 2;
+    var cy = rect.top + rect.height / 2;
+    targetX = clamp((e.clientX - cx) / gazeRadiusX, -1, 1);
+    targetY = clamp((e.clientY - cy) / gazeRadiusY, -1, 1);
+  }
+
+  function tick() {
+    if (!shouldGaze()) { targetX = 0; targetY = 0; }
+    curX += (targetX - curX) * 0.2;
+    curY += (targetY - curY) * 0.2;
+    for (var i = 0; i < pupils.length; i++) {
+      var p = pupils[i];
+      p.el.setAttribute("transform", "translate(" + (curX * p.spec.maxX).toFixed(2) + " " + (curY * p.spec.maxY).toFixed(2) + ")");
+    }
+    if (face) face.setAttribute("transform", "rotate(" + (curX * 3).toFixed(2) + " 50 52)");
+    var postureEl = gazeEl || rigEl;
+    if (root.classList.contains("lively-mascot--3d")) {
+      // Keep the character's parts in one shared 3D posture layer. Pointer
+      // position steers the turn, while active expressions retain a subtle
+      // living tilt after gaze tracking has intentionally paused.
+      var emotionPhase = performance.now() / 720 + Number(currentEmotionId || 0) * 0.67;
+      var emotionPitch = currentEmotionId === "02" ? 0 : Math.sin(emotionPhase) * 1.2;
+      var emotionYaw = currentEmotionId === "02" ? 0 : Math.cos(emotionPhase * 0.82) * 1.7;
+      var pitch = 3.2 - curY * 7.2 + emotionPitch;
+      var yaw = -3.2 + curX * 9.4 + emotionYaw;
+      // A flat SVG silhouette naturally narrows at a camera angle. Gently
+      // compensate that projection so the mascot keeps its rounded volume.
+      var volumeX = 1 + Math.abs(yaw) * 0.0027;
+      var volumeY = 1 + Math.abs(pitch) * 0.0022;
+      root.style.setProperty("--lively-gloss-x", (25 + curX * 15).toFixed(1) + "%");
+      root.style.setProperty("--lively-gloss-y", (18 + curY * 12).toFixed(1) + "%");
+      postureEl.style.transform = "translate3d(" + (curX * 2.2).toFixed(1) + "px, " + (curY * 1.4).toFixed(1) + "px, 3px) scale3d(" + volumeX.toFixed(3) + ", " + volumeY.toFixed(3) + ", 1) rotateZ(" + (curX * 1.8).toFixed(2) + "deg) rotateX(" + pitch.toFixed(2) + "deg) rotateY(" + yaw.toFixed(2) + "deg)";
+    } else {
+      postureEl.style.transform = "rotate(" + (curX * 5).toFixed(2) + "deg) translate3d(" + (curX * 4).toFixed(1) + "px, " + (curY * 2.5).toFixed(1) + "px, 0)";
+    }
+    raf = requestAnimationFrame(tick);
+  }
+
+  // --- Blink ---
+  var blinkTimer = 0, phaseTimer = 0;
+  function scheduleBlink() {
+    var def = getEmotionDef(currentEmotionId);
+    // No blink if disabled
+    if (def && def.blink === false) {
+      blinkTimer = window.setTimeout(scheduleBlink, 300);
+      return;
+    }
+    var blinkDelay = def && def.blink === "fast" ? 800 + Math.random() * 1200 : 2200 + Math.random() * 2600;
+    blinkTimer = window.setTimeout(function () {
+      for (var i = 0; i < eyes.length; i++) eyes[i].classList.add("is-blinking");
+      phaseTimer = window.setTimeout(function () {
+        for (var i = 0; i < eyes.length; i++) eyes[i].classList.remove("is-blinking");
+        if (Math.random() < 0.18) {
+          phaseTimer = window.setTimeout(function () {
+            for (var i = 0; i < eyes.length; i++) eyes[i].classList.add("is-blinking");
+            phaseTimer = window.setTimeout(function () {
+              for (var i = 0; i < eyes.length; i++) eyes[i].classList.remove("is-blinking");
+              scheduleBlink();
+            }, 90);
+          }, 160);
+        } else scheduleBlink();
+      }, 110);
+    }, blinkDelay);
+  }
+
+  // --- Hop ---
+  var hopTimer = 0, hopResetTimer = 0;
+
+  // A hop is an expression-specific action, never a background interruption.
+  function canHop() {
+    var def = getEmotionDef(currentEmotionId);
+    return animated && !!currentHopInterval && !!(def && def.hop);
+  }
+
+  function stopHop() {
+    clearTimeout(hopTimer);
+    clearTimeout(hopResetTimer);
+    hopTimer = 0;
+    hopResetTimer = 0;
+    setHopping(false);
+  }
+
+  function scheduleHop() {
+    if (!canHop()) return;
+    hopTimer = window.setTimeout(function () {
+      if (!canHop()) return;
+      setHopping(true);
+      hopResetTimer = window.setTimeout(function () {
+        setHopping(false);
+        scheduleHop();
+      }, 900);
+    }, currentHopInterval[0] * 1000 + Math.random() * (currentHopInterval[1] - currentHopInterval[0]) * 1000);
+  }
+
+  function syncHop() {
+    stopHop();
+    scheduleHop();
+  }
+
+  function fireClick() {
+    if (handlers.onClick) handlers.onClick();
+    // Skip happy flash if a non-idle emotion is active (avoid face overlap)
+    if (currentEmotionId !== "02") return;
+    setHappy(true);
+    setTimeout(function(){ setHappy(false); }, 950);
+  }
+
+  if (following) { raf = requestAnimationFrame(tick); window.addEventListener("pointermove", onPointerMove, { passive: true }); }
+  if (animated) {
+    scheduleBlink();
+    syncHop();
+    root.addEventListener("pointerdown", fireClick);
+  }
+
+  return {
+    api: api,
+    click: fireClick,
+    setFollowCursor: function(e){ following=e; },
+    destroy: function() {
+      cancelAnimationFrame(raf);
+      window.removeEventListener("pointermove", onPointerMove);
+      clearTimeout(blinkTimer); clearTimeout(phaseTimer);
+      clearTimeout(hopTimer); clearTimeout(hopResetTimer);
+    }
+  };
+}
+
+// The browser build still uses the top-level function. Exporting it here
+// also lets the CommonJS SDK entry assemble the same runtime in Node.
+if (typeof module === "object" && module.exports) module.exports = { createRig: createRig };
+if (typeof globalThis !== "undefined") globalThis.createRig = createRig;