oneko 0.3.1 → 0.4.0

package/dist/chunks/{vanilla-BmeHFErE.js → vanilla-BNtPCdx5.js}

@@ -555,7 +555,12 @@ const ONEKO_DEFAULTS = {
   napWhileTyping: false,
   followFocus: false,
   perchOnHover: false,
-  pettable: false
+  pettable: false,
+  seasonal: true,
+  grabbable: false,
+  treats: false,
+  timeOfDay: false,
+  affection: false
 };
 function isValidRect(rect) {
   return Object.values(rect).every(Number.isFinite) && rect.right > rect.left && rect.bottom > rect.top;
@@ -671,6 +676,55 @@ function constrainZoneMovement(from, to, blocked) {
   }
   return { x: from.x + dx * limit, y: from.y + dy * limit };
 }
+const clamp = (value, min, max) => Math.max(min, Math.min(Math.max(min, max), value));
+function visibleRect(el) {
+  if (!el.isConnected) return null;
+  const rect = el.getBoundingClientRect();
+  if (rect.width === 0 || rect.height === 0) return null;
+  if (rect.bottom < 0 || rect.right < 0 || rect.top > window.innerHeight) return null;
+  if (rect.left > window.innerWidth) return null;
+  return rect;
+}
+function errandPoint(s, errand) {
+  const half = TILE * s.scale / 2;
+  const maxX = window.innerWidth - 16;
+  const maxY = window.innerHeight - 16;
+  switch (errand.kind) {
+    case "sit":
+      return { x: s.nekoPosX, y: s.nekoPosY };
+    case "treat":
+      return errand.treat.eaten ? null : { x: errand.treat.x, y: errand.treat.y };
+    case "goTo": {
+      const { target } = errand;
+      if (!(target instanceof Element))
+        return { x: clamp(target.x, 16, maxX), y: clamp(target.y, 16, maxY) };
+      const rect = visibleRect(target);
+      if (!rect) return null;
+      const below = rect.bottom + half + 4;
+      return {
+        x: clamp(rect.left + rect.width / 2, 16, maxX),
+        y: below < maxY ? below : clamp(rect.top - half - 4, 16, maxY)
+      };
+    }
+    case "box": {
+      const rect = visibleRect(errand.el);
+      if (!rect) return null;
+      return {
+        x: clamp(rect.left + rect.width / 2, 16, maxX),
+        y: clamp(Math.max(rect.top + half, rect.bottom - half - 2), 16, maxY)
+      };
+    }
+    case "knock": {
+      const rect = visibleRect(errand.el);
+      if (!rect) return null;
+      const x = errand.direction === 1 ? rect.left - half * 0.75 : rect.right + half * 0.75;
+      return {
+        x: clamp(x, 16, maxX),
+        y: clamp(Math.max(rect.top + half / 2, rect.bottom - half), 16, maxY)
+      };
+    }
+  }
+}
 const EMPTY_ZONES = [];
 function createZoneState() {
   return {
@@ -758,7 +812,9 @@ function updateZoneTarget(s, width, height, random = Math.random) {
     }
   }
   const favorite = favorites.find((zone) => zone.id === zones.targetId);
-  const desired = !s.followCursorCfg || s.typingNap || s.held ? { x: s.nekoPosX, y: s.nekoPosY } : s.perchTarget ?? (favorite ? {
+  const errand = s.errand && errandPoint(s, s.errand);
+  const requested = s.errand?.kind === "goTo" || s.errand?.kind === "sit";
+  const desired = errand && requested ? errand : !s.followCursorCfg || s.typingNap || s.held ? { x: s.nekoPosX, y: s.nekoPosY } : errand ?? s.perchTarget ?? (favorite ? {
     x: (favorite.rect.left + favorite.rect.right) / 2,
     y: (favorite.rect.top + favorite.rect.bottom) / 2
   } : s.leaderTarget ?? { x: s.mousePosX, y: s.mousePosY });
@@ -768,6 +824,161 @@ function updateZoneTarget(s, width, height, random = Math.random) {
   } : desired;
   if (oldId !== zones.targetId) s.lastPathRecalcFrame = -PATH_RECALC_INTERVAL;
 }
+const OUTLINE = "#1b1b1b";
+function pixelArtSVG(rows, colors) {
+  const width = rows[0].length + 2;
+  const height = rows.length + 2;
+  const filled = (x, y) => Boolean(colors[rows[y]?.[x] ?? "."]);
+  const rects = [];
+  for (let y = -1; y <= rows.length; y++) {
+    for (let x = -1; x <= rows[0].length; x++) {
+      const fill = filled(x, y) ? colors[rows[y][x]] : filled(x - 1, y) || filled(x + 1, y) || filled(x, y - 1) || filled(x, y + 1) ? OUTLINE : null;
+      if (fill) rects.push(`<rect x="${x + 1}" y="${y + 1}" width="1" height="1" fill="${fill}"/>`);
+    }
+  }
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" shape-rendering="crispEdges" style="display:block;width:100%;height:100%">${rects.join("")}</svg>`;
+}
+const ONEKO_SEASONS = ["halloween", "winter", "newYear"];
+function isOnekoSeason(value) {
+  return ONEKO_SEASONS.includes(value);
+}
+function seasonForDate(date) {
+  const month = date.getMonth() + 1;
+  const day = date.getDate();
+  if (month === 10 && day >= 20) return "halloween";
+  if (month === 12 && day >= 18 && day <= 29) return "winter";
+  if (month === 12 && day >= 30 || month === 1 && day <= 2) return "newYear";
+  return null;
+}
+function resolveSeason(setting, date = /* @__PURE__ */ new Date()) {
+  if (setting === false) return null;
+  if (setting === true) return seasonForDate(date);
+  return isOnekoSeason(setting) ? setting : null;
+}
+const SEASON_MESSAGES = {
+  halloween: [
+    "trick or treat. mostly treat",
+    "I am the spooky one in this house",
+    "black cat energy, any coat",
+    "boo. did I scare you",
+    "this pumpkin smells like nap",
+    "I dressed up as a cat"
+  ],
+  winter: [
+    "is the tree for climbing",
+    "I helped wrap the presents",
+    "the box is the present",
+    "warm lap wanted, apply within",
+    "snow is just cold sand"
+  ],
+  newYear: [
+    "new year, same nap spot",
+    "resolution: more treats",
+    "the fireworks can stop now",
+    "I stayed up past midnight. barely",
+    "counting down to my next nap"
+  ]
+};
+const HATS = {
+  halloween: {
+    rows: [
+      ".......PP..",
+      "......PPP..",
+      ".....PPPP..",
+      ".....PPPP..",
+      "....PPPPPP.",
+      "....PPPPPP.",
+      "...POOOOOP.",
+      "PPPPPPPPPPP"
+    ],
+    colors: { P: "#4a2470", O: "#f28c28" }
+  },
+  winter: {
+    rows: [
+      "........WW.",
+      ".......RWW.",
+      "......RR...",
+      ".....RRRR..",
+      "....RRRRRR.",
+      "...RRRRRRR.",
+      "WWWWWWWWWWW",
+      "WWWWWWWWWWW"
+    ],
+    colors: { R: "#d62839", W: "#f4f1ea" }
+  },
+  newYear: {
+    rows: [
+      ".....YY....",
+      ".....GG....",
+      "....GBBG...",
+      "....BGGB...",
+      "...GBBBBG..",
+      "...BGGGGB..",
+      "..GBBBBBBG.",
+      "..BGGGGGGB."
+    ],
+    colors: { Y: "#ffd23f", G: "#ffb627", B: "#2e86de" }
+  }
+};
+const HAT_WIDTH = 13;
+const HAT_HEIGHT = 10;
+function hatSVG(season) {
+  return pixelArtSVG(HATS[season].rows, HATS[season].colors);
+}
+function hatOffset(spriteX, spriteY) {
+  const anchor = HAT_ANCHORS[`${spriteX},${spriteY}`];
+  if (!anchor) return null;
+  return { left: anchor[0] - Math.floor(HAT_WIDTH / 2), top: anchor[1] - (HAT_HEIGHT - 1) };
+}
+const HAT_ANCHORS = {
+  // idle, tired, alert: sitting, facing the viewer
+  "-3,-3": [16, 6],
+  "-3,-2": [16, 6],
+  "-7,-3": [16, 5],
+  // scratchSelf
+  "-5,0": [11, 7],
+  "-6,0": [11, 7],
+  "-7,0": [14, 5],
+  // scratchWallN: seen from behind
+  "0,0": [15, 4],
+  "0,-1": [15, 4],
+  // scratchWallS
+  "-7,-1": [16, 13],
+  "-6,-2": [16, 13],
+  // scratchWallE
+  "-2,-2": [25, 4],
+  "-2,-3": [25, 4],
+  // scratchWallW
+  "-4,0": [7, 4],
+  "-4,-1": [7, 4],
+  // sleeping
+  "-2,0": [18, 13],
+  "-2,-1": [19, 16],
+  // N
+  "-1,-2": [16, 4],
+  "-1,-3": [16, 4],
+  // NE
+  "0,-2": [22, 5],
+  "0,-3": [22, 4],
+  // E
+  "-3,0": [25, 7],
+  "-3,-1": [25, 7],
+  // SE
+  "-5,-1": [26, 12],
+  "-5,-2": [23, 10],
+  // S
+  "-6,-3": [16, 4],
+  "-7,-2": [16, 4],
+  // SW
+  "-5,-3": [7, 12],
+  "-6,-1": [7, 10],
+  // W
+  "-4,-2": [7, 7],
+  "-4,-3": [7, 7],
+  // NW
+  "-1,0": [10, 5],
+  "-1,-1": [10, 5]
+};
 function pickFromPool(deps, pool) {
   const s = deps.stateRef.current;
   let idx = Math.floor(Math.random() * pool.length);
@@ -808,6 +1019,9 @@ function messageForActivity(deps) {
   if (idleAnimationMessage) {
     return idleAnimationMessage;
   }
+  if (s.season && Math.random() < 0.35) {
+    return pickFromPool(deps, SEASON_MESSAGES[s.season]);
+  }
   if (s.idleTime > 0) {
     return pickFromPool(deps, IDLE_MESSAGES);
   }
@@ -829,6 +1043,7 @@ function showBubble(deps) {
 function hideBubble(deps) {
   const s = deps.stateRef.current;
   s.bubbleVisible = false;
+  s.bubbleForced = false;
   deps.bubbleEl.style.opacity = "0";
   s.bubbleCooldown = s.bubbleCooldownFramesCfg;
 }
@@ -894,7 +1109,15 @@ function shouldTriggerBubble(deps) {
 }
 function updateBubble(deps) {
   const s = deps.stateRef.current;
-  if (!s.bubbleEnabledCfg) {
+  if (s.sayRequest) {
+    s.bubbleVisible = true;
+    s.bubbleForced = true;
+    s.bubbleTimer = s.sayRequest.frames;
+    deps.bubbleTextEl.textContent = s.sayRequest.text;
+    deps.bubbleEl.style.opacity = "1";
+    s.sayRequest = null;
+  }
+  if (!s.bubbleEnabledCfg && !s.bubbleForced) {
     if (s.bubbleVisible) {
       hideBubble(deps);
     }
@@ -933,6 +1156,17 @@ function leaderPosition(state) {
   const leader = pack[pack.indexOf(state) - 1];
   return leader ? { x: leader.nekoPosX, y: leader.nekoPosY } : null;
 }
+function isNearestCat(state, point) {
+  const distance = (cat) => Math.hypot(cat.nekoPosX - point.x, cat.nekoPosY - point.y);
+  const mine = distance(state);
+  const order = pack.indexOf(state);
+  return pack.every(
+    (cat, index) => cat === state || distance(cat) > mine || distance(cat) === mine && index > order
+  );
+}
+function packSize() {
+  return pack.length;
+}
 function napmateNearby(state) {
   const reach = TILE * Math.max(1, state.scale) * 2;
   return pack.some(
@@ -969,8 +1203,181 @@ function onCatsHiddenChange(callback) {
     window.removeEventListener("storage", onStorage);
   };
 }
+const GREETING_GAP_MS = 30 * 60 * 1e3;
+const MAX_AFFECTION = 999;
+function parseAffection(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const { version, affection, lastVisit } = value;
+  if (version !== 1) return null;
+  if (typeof affection !== "number" || !Number.isFinite(affection)) return null;
+  if (typeof lastVisit !== "number" || !Number.isFinite(lastVisit)) return null;
+  return {
+    version: 1,
+    affection: Math.max(0, Math.min(MAX_AFFECTION, Math.floor(affection))),
+    lastVisit
+  };
+}
+function readAffection(key) {
+  try {
+    return parseAffection(JSON.parse(window.localStorage.getItem(key) ?? "null"));
+  } catch {
+    return null;
+  }
+}
+function writeAffection(key, affection, lastVisit = Date.now()) {
+  try {
+    window.localStorage.setItem(key, JSON.stringify({ version: 1, affection, lastVisit }));
+  } catch {
+  }
+}
+function affectionTier(affection) {
+  if (affection >= 15) return 3;
+  if (affection >= 5) return 2;
+  if (affection >= 1) return 1;
+  return 0;
+}
+const GREETINGS = {
+  0: ["oh. a new hooman", "who are you. do you have snacks", "hello, stranger"],
+  1: ["you again. acceptable", "I remember you. vaguely", "back so soon?"],
+  2: ["my hooman is back!", "I saved you a warm pixel", "there you are. I waited"],
+  3: [
+    "I missed you. don't tell anyone",
+    "best hooman has returned",
+    "finally. I have so much to tell you"
+  ]
+};
+function greetingFor(saved, now = Date.now()) {
+  if (saved && now - saved.lastVisit < GREETING_GAP_MS) return null;
+  const pool = GREETINGS[affectionTier(saved?.affection ?? 0)];
+  return pool[Math.floor(Math.random() * pool.length)];
+}
+const NEUTRAL_MOOD = { speed: 1, freerun: 1, idle: 1 };
+function moodForHour(hour) {
+  if (hour >= 5 && hour < 8) return { speed: 1.25, freerun: 2.5, idle: 1.5 };
+  if (hour >= 8 && hour < 12) return { speed: 1.1, freerun: 1.4, idle: 1 };
+  if (hour >= 12 && hour < 17) return { speed: 0.9, freerun: 0.7, idle: 0.6 };
+  if (hour >= 17 && hour < 21) return { speed: 1.25, freerun: 2.5, idle: 1.5 };
+  if (hour >= 21 && hour < 23) return { speed: 1, freerun: 0.8, idle: 0.8 };
+  return { speed: 0.7, freerun: 0.25, idle: 0.35 };
+}
+const TREAT_MESSAGES = [
+  "nom nom nom",
+  "fish! my favorite food group",
+  "more please",
+  "this is why I keep you around",
+  "crunchy. 5 stars"
+];
+const TOSS_SOFT_MESSAGES = [
+  "I meant to do that",
+  "nailed the landing",
+  "10/10 would fly again",
+  "always land on my feet",
+  "wheee. again?"
+];
+const TOSS_HARD_MESSAGES = [
+  "HEY. rude",
+  "I was not done being held",
+  "this is a lawsuit",
+  "my dignity. gone",
+  "do that again and I sit on your keyboard"
+];
+const HELD_MESSAGES = [
+  "put me down",
+  "unhand me, hooman",
+  "I am a liquid",
+  "where are we going"
+];
+const BOX_MESSAGES = [
+  "if I fits, I sits",
+  "this box is mine now",
+  "perfect fit",
+  "box. good."
+];
+const KNOCK_STARE_MESSAGES = [
+  "...",
+  "don't you dare look away",
+  "what's this",
+  "watch this"
+];
+const KNOCK_MESSAGES = [
+  "oops",
+  "it was in my way",
+  "gravity check: still works",
+  "I regret nothing",
+  "you saw nothing"
+];
+const FOND_PET_MESSAGES = [
+  "purrrrrr",
+  "you are my favorite",
+  "more pets. now. forever",
+  "this is the good stuff",
+  "*slow blink*"
+];
+const FISH = pixelArtSVG([".OO...O", "OOOO.OO", "OBOOOOO", "OOOO.OO", ".OO...O"], {
+  O: "#f4a261",
+  B: "#1b1b1b"
+});
+const PIXEL = 2;
+const MAX_TREATS = 5;
+const treats = [];
+function nearestTreat(x, y, skip) {
+  let best;
+  for (const treat of treats)
+    if (skip?.(treat)) continue;
+    else if (!best || Math.hypot(treat.x - x, treat.y - y) < Math.hypot(best.x - x, best.y - y))
+      best = treat;
+  return best;
+}
+function dropTreat(x, y, zIndex) {
+  const el = document.createElement("div");
+  el.setAttribute("aria-hidden", "true");
+  el.setAttribute("data-oneko-treat", "");
+  el.innerHTML = FISH;
+  const width = 9 * PIXEL;
+  const height = 7 * PIXEL;
+  const clampedX = Math.max(width, Math.min(window.innerWidth - width, x));
+  const clampedY = Math.max(height, Math.min(window.innerHeight - height, y));
+  el.style.cssText = [
+    "position:fixed",
+    "pointer-events:none",
+    `left:${clampedX - width / 2}px`,
+    `top:${clampedY - height / 2}px`,
+    `width:${width}px`,
+    `height:${height}px`,
+    `z-index:${zIndex}`
+  ].join(";");
+  document.body.appendChild(el);
+  el.animate?.(
+    [
+      { transform: "translateY(-14px)", opacity: 0 },
+      { transform: "none", opacity: 1 }
+    ],
+    { duration: 220, easing: "cubic-bezier(0.3, 1.4, 0.6, 1)" }
+  );
+  const treat = { x: clampedX, y: clampedY, el, eaten: false };
+  treats.push(treat);
+  while (treats.length > MAX_TREATS) removeTreat(treats[0]);
+  return treat;
+}
+function removeTreat(treat) {
+  treat.eaten = true;
+  treat.el.remove();
+  const index = treats.indexOf(treat);
+  if (index !== -1) treats.splice(index, 1);
+}
+function eatTreat(treat) {
+  if (treat.eaten) return false;
+  removeTreat(treat);
+  return true;
+}
+function clearTreats() {
+  while (treats.length) removeTreat(treats[0]);
+}
 function getActivityLabel(deps) {
   const s = deps.stateRef.current;
+  if (s.grab && s.grab.phase !== "landed") {
+    return "alert";
+  }
   if (s.freerunMode) {
     return "freerun";
   }
@@ -1006,6 +1413,551 @@ function playSound(deps, pool) {
     s.soundCooldown = 0;
   });
 }
+function setSprite(deps, name, frame) {
+  const sprites = defaultSpriteSets[name];
+  if (!sprites?.length) {
+    return;
+  }
+  const sprite = sprites[frame % sprites.length];
+  deps.el.style.backgroundPosition = `${sprite[0] * TILE}px ${sprite[1] * TILE}px`;
+  if (deps.hat) {
+    const offset = hatOffset(sprite[0], sprite[1]);
+    deps.hat.style.display = offset ? "" : "none";
+    if (offset) deps.hat.style.transform = `translate(${offset.left}px, ${offset.top}px)`;
+  }
+}
+function getDirectionFromAngle(angle) {
+  if (angle >= 157.5 || angle < -157.5) {
+    return "W";
+  }
+  for (const range of DIRECTION_RANGES) {
+    if (angle >= range.min && angle < range.max) {
+      return range.dir;
+    }
+  }
+  return "E";
+}
+function directionFromDelta(dx, dy) {
+  if (Math.abs(dx) < 1 && Math.abs(dy) < 1) {
+    return null;
+  }
+  return getDirectionFromAngle(Math.atan2(dy, dx) * (180 / Math.PI));
+}
+function clearRotation(deps) {
+  const s = deps.stateRef.current;
+  if (s.currentRotation !== 0) {
+    s.currentRotation = 0;
+    deps.el.style.transform = `scale(${s.scale}) rotate(0deg)`;
+  }
+}
+const CLOCK_CHECK_FRAMES = 600;
+const ERRAND_CHECK_FRAMES = 50;
+const ERRAND_CHANCE = 0.25;
+const ERRAND_REST_FRAMES = 300;
+const BOX_NAP_FRAMES = 150;
+const KNOCK_STARE_FRAMES = 12;
+const KNOCKED_DOWN_MS = 5e3;
+const MAX_TOSS_SPEED = 3;
+const HARD_TOSS_SPEED = 1.6;
+const TYPING_TARGETS = "a,button,input,select,textarea,label,summary,[role='button'],[contenteditable]";
+function speak(deps, pool) {
+  const s = deps.stateRef.current;
+  if (!s.bubbleEnabledCfg) return;
+  s.bubbleVisible = true;
+  s.bubbleTimer = s.bubbleDisplayFramesCfg;
+  s.bubbleCooldown = 0;
+  deps.bubbleTextEl.textContent = pickFromPool(deps, pool);
+  deps.bubbleEl.style.opacity = "1";
+}
+function bumpAffection(s) {
+  s.affection = Math.min(MAX_AFFECTION, s.affection + 1);
+  if (s.affectionCfg) writeAffection(s.affectionKey, s.affection);
+  return s.affection;
+}
+function rouse(s) {
+  s.typingNap = false;
+  s.freerunMode = false;
+  s.idleAnimation = null;
+  s.idleAnimationFrame = 0;
+  s.idleTime = Math.max(s.idleTime, 1);
+}
+function petCat(deps) {
+  const s = deps.stateRef.current;
+  rouse(s);
+  const affection = bumpAffection(s);
+  speak(deps, s.affectionCfg && affectionTier(affection) >= 2 ? FOND_PET_MESSAGES : PET_MESSAGES);
+  playSound(deps, PET_SOUND_POOL);
+  s.handlers.onPet?.({ affection });
+}
+const knocked = /* @__PURE__ */ new Map();
+function knockOver(el, direction) {
+  if (knocked.has(el) || !(el instanceof HTMLElement || el instanceof SVGElement)) return;
+  const rect = el.getBoundingClientRect();
+  const fall = Math.max(0, window.innerHeight - rect.bottom - 4);
+  const animation = el.animate(
+    [
+      { transform: "none", offset: 0 },
+      {
+        transform: `translateX(${direction * 6}px) rotate(${direction * 12}deg)`,
+        offset: 0.25
+      },
+      {
+        transform: `translate(${direction * 48}px, ${fall}px) rotate(${direction * 100}deg)`,
+        offset: 1
+      }
+    ],
+    {
+      duration: 700,
+      easing: "cubic-bezier(0.5, 0, 0.9, 0.6)",
+      fill: "forwards"
+    }
+  );
+  knocked.set(el, animation);
+  setTimeout(() => {
+    animation.playbackRate = 2;
+    animation.reverse();
+    animation.finished.then(
+      () => {
+        animation.cancel();
+        knocked.delete(el);
+      },
+      () => knocked.delete(el)
+    );
+  }, KNOCKED_DOWN_MS);
+}
+function restoreKnocked() {
+  for (const animation of knocked.values()) animation.cancel();
+  knocked.clear();
+}
+function isVisible(el) {
+  const rect = el.getBoundingClientRect();
+  return rect.width > 0 && rect.height > 0 && rect.top >= 0 && rect.left >= 0 && rect.bottom <= window.innerHeight && rect.right <= window.innerWidth;
+}
+const handledEvents = /* @__PURE__ */ new WeakSet();
+function isOverText(x, y) {
+  const node = document.caretRangeFromPoint?.(x, y)?.startContainer;
+  if (!node || node.nodeType !== Node.TEXT_NODE || !node.textContent?.trim()) return false;
+  const range = document.createRange();
+  range.selectNodeContents(node);
+  return [...range.getClientRects()].some(
+    (rect) => x >= rect.left && x <= rect.right && y >= rect.top && y <= rect.bottom
+  );
+}
+function createPlay(deps) {
+  const s = () => deps.stateRef.current;
+  const { el } = deps;
+  let seasonKey = "";
+  let seasonCheckedFrame = -Infinity;
+  let grabbable = null;
+  let flight = 0;
+  let sayTarget = null;
+  let sayTimer;
+  const unreachable = /* @__PURE__ */ new WeakSet();
+  const wearHat = () => {
+    const state = s();
+    const key = String(state.seasonalCfg);
+    if (key === seasonKey && state.frameCount - seasonCheckedFrame < CLOCK_CHECK_FRAMES) return;
+    seasonKey = key;
+    seasonCheckedFrame = state.frameCount;
+    const season = resolveSeason(state.seasonalCfg);
+    if (season === state.season && (deps.hat || !season)) return;
+    state.season = season;
+    deps.hat?.remove();
+    deps.hat = void 0;
+    if (!season) return;
+    const hat = document.createElement("div");
+    hat.setAttribute("data-oneko-hat", season);
+    hat.style.cssText = `position:absolute;left:0;top:0;width:${HAT_WIDTH}px;height:${HAT_HEIGHT}px;pointer-events:none;display:none`;
+    hat.innerHTML = hatSVG(season);
+    el.appendChild(hat);
+    deps.hat = hat;
+  };
+  const readClock = () => {
+    const state = s();
+    if (!state.timeOfDayCfg) {
+      state.mood = NEUTRAL_MOOD;
+      state.moodCheckedFrame = -Infinity;
+    } else if (state.frameCount - state.moodCheckedFrame >= CLOCK_CHECK_FRAMES) {
+      state.mood = moodForHour((/* @__PURE__ */ new Date()).getHours());
+      state.moodCheckedFrame = state.frameCount;
+    }
+  };
+  const greet = () => {
+    const state = s();
+    if (!state.affectionCfg) {
+      state.affectionLoaded = false;
+      return;
+    }
+    if (state.affectionLoaded) return;
+    state.affectionLoaded = true;
+    const saved = readAffection(state.affectionKey);
+    state.affection = Math.max(state.affection, saved?.affection ?? 0);
+    const greeting = greetingFor(saved);
+    writeAffection(state.affectionKey, state.affection);
+    if (greeting && state.bubbleEnabledCfg)
+      state.sayRequest = {
+        text: greeting,
+        frames: state.bubbleDisplayFramesCfg
+      };
+  };
+  const syncGrabbable = () => {
+    const on = s().grabbableCfg;
+    if (on === grabbable) return;
+    grabbable = on;
+    el.style.pointerEvents = on ? "auto" : "none";
+    el.style.cursor = on ? "grab" : "";
+    el.style.touchAction = on ? "none" : "";
+    if (!on) el.removeAttribute("title");
+    else if (!el.hasAttribute("aria-label")) el.title = "Drag to toss, click to pet";
+  };
+  const chooseErrand = () => {
+    const state = s();
+    if (state.grab || !state.followCursorCfg || state.typingNap || state.held) return;
+    const current = state.errand?.kind;
+    if (current === "goTo" || current === "sit") return;
+    const treat = nearestTreat(state.nekoPosX, state.nekoPosY, (item) => unreachable.has(item));
+    if (treat && current !== "treat") {
+      rouse(state);
+      state.errand = { kind: "treat", treat, frames: 0 };
+      return;
+    }
+    if (state.errand || state.laserPointerCfg || state.perchTarget || state.zoneState.targetId)
+      return;
+    if (--state.errandCooldown > 0) return;
+    state.errandCooldown = ERRAND_CHECK_FRAMES;
+    if (state.idleTime === 0 || Math.random() >= ERRAND_CHANCE) return;
+    const size = TILE * state.scale;
+    const boxes = [...document.querySelectorAll("[data-oneko-box]")].filter((box) => {
+      const rect = box.getBoundingClientRect();
+      return isVisible(box) && rect.width >= size * 0.75 && rect.height >= size * 0.5;
+    });
+    const knockables = [...document.querySelectorAll("[data-oneko-knockable]")].filter(
+      (item) => isVisible(item) && !knocked.has(item)
+    );
+    const pick = [...boxes, ...knockables][Math.floor(Math.random() * (boxes.length + knockables.length))];
+    if (!pick) return;
+    if (boxes.includes(pick)) {
+      state.errand = { kind: "box", el: pick, frames: 0, arrived: false };
+    } else {
+      const rect = pick.getBoundingClientRect();
+      state.errand = {
+        kind: "knock",
+        el: pick,
+        frames: 0,
+        phase: "approach",
+        // Approach from the side the cat is already on, then push the other way.
+        direction: state.nekoPosX <= rect.left + rect.width / 2 ? 1 : -1
+      };
+    }
+  };
+  const upkeep = () => {
+    const state = s();
+    wearHat();
+    readClock();
+    greet();
+    syncGrabbable();
+    if (state.petRequest) {
+      state.petRequest = false;
+      petCat(deps);
+    }
+    chooseErrand();
+  };
+  const endErrand = (cooldown = 0) => {
+    const state = s();
+    state.errand = null;
+    if (cooldown) state.errandCooldown = cooldown;
+  };
+  const tickErrand = () => {
+    const state = s();
+    const errand = state.errand;
+    const chasingCursor = !errand && state.followCursorCfg && !state.typingNap && !state.held && !state.perchTarget && !state.leaderTarget && !state.zoneState.targetId;
+    const toCursor = Math.hypot(state.mousePosX - state.nekoPosX, state.mousePosY - state.nekoPosY);
+    if (!chasingCursor) state.chasingFar = false;
+    else if (toCursor > 160 && state.idleTime === 0) state.chasingFar = true;
+    else if (state.chasingFar && state.idleTime > 0) {
+      state.chasingFar = false;
+      state.handlers.onCatchCursor?.();
+    }
+    if (!errand || errand.kind === "sit") return;
+    const point = errandPoint(state, errand);
+    if (!point) {
+      if (errand.kind === "goTo") errand.resolve?.(false);
+      endErrand();
+      return;
+    }
+    const distance = Math.hypot(point.x - state.nekoPosX, point.y - state.nekoPosY);
+    const arrived = distance < 14 || state.idleTime > 2 && distance < 64;
+    switch (errand.kind) {
+      case "goTo":
+        if (!errand.arrived && (arrived || state.idleTime > 2 && ++errand.frames > 30)) {
+          errand.arrived = true;
+          errand.resolve?.(true);
+          errand.resolve = void 0;
+        }
+        return;
+      case "treat":
+        if (arrived) {
+          if (eatTreat(errand.treat)) {
+            const affection = bumpAffection(state);
+            speak(deps, TREAT_MESSAGES);
+            playSound(deps, LASER_CATCH_POOL);
+            state.handlers.onTreat?.({ affection });
+          }
+          endErrand();
+        } else if (++errand.frames > 300 || state.idleTime > 20) {
+          unreachable.add(errand.treat);
+          endErrand();
+        }
+        return;
+      case "box":
+        if (!errand.arrived) {
+          if (arrived) {
+            errand.arrived = true;
+            errand.frames = 0;
+            speak(deps, BOX_MESSAGES);
+            if (state.sleepEnabledCfg) {
+              state.idleAnimation = "sleeping";
+              state.idleAnimationFrame = 0;
+            }
+          } else if (++errand.frames > 100) endErrand(ERRAND_REST_FRAMES);
+        } else if (++errand.frames > BOX_NAP_FRAMES) endErrand(ERRAND_REST_FRAMES);
+        return;
+      case "knock":
+        if (errand.phase === "approach") {
+          if (arrived) {
+            errand.phase = "stare";
+            errand.frames = 0;
+            rouse(state);
+            speak(deps, KNOCK_STARE_MESSAGES);
+          } else if (++errand.frames > 100) endErrand(ERRAND_REST_FRAMES);
+          return;
+        }
+        setSprite(
+          deps,
+          ++errand.frames >= KNOCK_STARE_FRAMES ? errand.direction === 1 ? "E" : "W" : "idle",
+          errand.frames
+        );
+        if (errand.frames >= KNOCK_STARE_FRAMES) {
+          knockOver(errand.el, errand.direction);
+          speak(deps, KNOCK_MESSAGES);
+          playSound(deps, HISS_POOL);
+          endErrand(ERRAND_REST_FRAMES);
+        }
+        return;
+    }
+  };
+  const place = (x, y) => {
+    const state = s();
+    state.nekoPosX = x;
+    state.nekoPosY = y;
+    el.style.left = `${Math.floor(x - TILE / 2)}px`;
+    el.style.top = `${Math.floor(y - TILE / 2)}px`;
+  };
+  const land = (hard) => {
+    const state = s();
+    cancelAnimationFrame(flight);
+    flight = 0;
+    state.grab = { phase: "landed", frames: 8 };
+    state.nekoVelX = state.nekoVelY = 0;
+    state.currentPath = [];
+    clearRotation(deps);
+    speak(deps, hard ? TOSS_HARD_MESSAGES : TOSS_SOFT_MESSAGES);
+    playSound(deps, hard ? HISS_POOL : PET_SOUND_POOL);
+  };
+  const fly = (vx, vy, hard) => {
+    let last = performance.now();
+    let spin = 0;
+    const step = (now) => {
+      const state = s();
+      if (state.grab?.phase !== "flying") return;
+      const dt = Math.min(50, now - last);
+      last = now;
+      if (state.pausedCfg) {
+        flight = requestAnimationFrame(step);
+        return;
+      }
+      const from = { x: state.nekoPosX, y: state.nekoPosY };
+      let x = from.x + vx * dt;
+      let y = from.y + vy * dt;
+      const maxX = window.innerWidth - 16;
+      const maxY = window.innerHeight - 16;
+      if (x < 16 || x > maxX) {
+        vx *= -0.5;
+        x = Math.max(16, Math.min(maxX, x));
+      }
+      if (y < 16 || y > maxY) {
+        vy *= -0.5;
+        y = Math.max(16, Math.min(maxY, y));
+      }
+      const safe = constrainZoneMovement(from, { x, y }, state.zoneState.blocked);
+      if (safe.x !== x || safe.y !== y) vx = vy = 0;
+      place(safe.x, safe.y);
+      const drag = Math.exp(-dt / 260);
+      vx *= drag;
+      vy *= drag;
+      spin += vx * dt * 0.9;
+      el.style.transform = `scale(${state.scale}) rotate(${spin}deg)`;
+      if (Math.hypot(vx, vy) < 0.06) land(hard);
+      else flight = requestAnimationFrame(step);
+    };
+    flight = requestAnimationFrame(step);
+  };
+  const tickGrab = () => {
+    const state = s();
+    const grab = state.grab;
+    if (!grab) return false;
+    state.idleAnimation = null;
+    state.freerunMode = false;
+    if (grab.phase === "landed") {
+      setSprite(deps, "idle", 0);
+      state.idleTime = Math.max(state.idleTime, 1);
+      if (--grab.frames <= 0) state.grab = null;
+      return true;
+    }
+    setSprite(deps, "alert", 0);
+    state.idleTime = 0;
+    return true;
+  };
+  const onPointerDown = (event) => {
+    const state = s();
+    if (!state.grabbableCfg || event.button > 0 || state.pausedCfg) return;
+    event.preventDefault();
+    el.setPointerCapture?.(event.pointerId);
+    cancelAnimationFrame(flight);
+    rouse(state);
+    if (state.errand?.kind === "box" || state.errand?.kind === "knock") endErrand();
+    state.grab = {
+      phase: "held",
+      samples: [{ x: event.clientX, y: event.clientY, t: event.timeStamp }],
+      startT: event.timeStamp,
+      travel: 0
+    };
+    el.style.cursor = "grabbing";
+    setSprite(deps, "alert", 0);
+    clearRotation(deps);
+  };
+  const onPointerMove = (event) => {
+    const state = s();
+    const grab = state.grab;
+    if (grab?.phase !== "held") return;
+    const previous = grab.samples.at(-1);
+    grab.travel += Math.hypot(event.clientX - previous.x, event.clientY - previous.y);
+    grab.samples.push({
+      x: event.clientX,
+      y: event.clientY,
+      t: event.timeStamp
+    });
+    if (grab.samples.length > 8) grab.samples.shift();
+    place(
+      Math.max(16, Math.min(window.innerWidth - 16, event.clientX)),
+      Math.max(16, Math.min(window.innerHeight - 16, event.clientY))
+    );
+    state.mousePosX = event.clientX;
+    state.mousePosY = event.clientY;
+    if (grab.travel > 40 && !state.bubbleVisible && Math.random() < 0.02)
+      speak(deps, HELD_MESSAGES);
+  };
+  const onPointerUp = (event) => {
+    const state = s();
+    const grab = state.grab;
+    if (grab?.phase !== "held") return;
+    el.style.cursor = "grab";
+    if (grab.travel < 6 && event.timeStamp - grab.startT < 500) {
+      state.grab = null;
+      petCat(deps);
+      return;
+    }
+    const recent = grab.samples.filter((sample) => event.timeStamp - sample.t < 100);
+    const first = recent[0] ?? grab.samples.at(-1);
+    const elapsed = Math.max(16, event.timeStamp - first.t);
+    let vx = (event.clientX - first.x) / elapsed;
+    let vy = (event.clientY - first.y) / elapsed;
+    const speed = Math.hypot(vx, vy);
+    if (speed > MAX_TOSS_SPEED) {
+      vx = vx / speed * MAX_TOSS_SPEED;
+      vy = vy / speed * MAX_TOSS_SPEED;
+    }
+    if (speed < 0.25) {
+      land(false);
+      return;
+    }
+    const hard = speed > HARD_TOSS_SPEED;
+    state.grab = { phase: "flying", vx, vy, spin: 0, hard };
+    state.handlers.onToss?.({
+      speed: Math.round(Math.min(speed, MAX_TOSS_SPEED) * 1e3)
+    });
+    fly(vx, vy, hard);
+  };
+  const onPointerCancel = () => {
+    if (s().grab?.phase === "held") land(false);
+  };
+  const onDoubleClick = (event) => {
+    const state = s();
+    if (!state.treatsCfg || handledEvents.has(event)) return;
+    if (event.target instanceof Element && event.target.closest(TYPING_TARGETS)) return;
+    if (window.getSelection()?.toString().trim() || isOverText(event.clientX, event.clientY))
+      return;
+    const point = { x: event.clientX, y: event.clientY };
+    if (state.zoneState.blocked.some((rect) => containsPoint(rect, point))) return;
+    handledEvents.add(event);
+    dropTreat(point.x, point.y, state.zIndex);
+  };
+  const requestSay = (target) => {
+    const state = s();
+    const text = target.getAttribute("data-oneko-say")?.trim();
+    if (!text || !state.bubbleEnabledCfg || state.pausedCfg) return;
+    const rect = target.getBoundingClientRect();
+    if (!isNearestCat(state, {
+      x: rect.left + rect.width / 2,
+      y: rect.top + rect.height / 2
+    }))
+      return;
+    state.sayRequest = {
+      text: text.slice(0, 200),
+      frames: state.bubbleDisplayFramesCfg
+    };
+  };
+  const onMouseOver = (event) => {
+    const target = event.target instanceof Element ? event.target.closest("[data-oneko-say]") : null;
+    if (target === sayTarget) return;
+    sayTarget = target;
+    clearTimeout(sayTimer);
+    if (target) sayTimer = setTimeout(() => requestSay(target), 350);
+  };
+  const onFocusIn = (event) => {
+    const target = event.target instanceof Element ? event.target.closest("[data-oneko-say]") : null;
+    if (target) requestSay(target);
+  };
+  syncGrabbable();
+  el.addEventListener("pointerdown", onPointerDown);
+  el.addEventListener("pointermove", onPointerMove);
+  el.addEventListener("pointerup", onPointerUp);
+  el.addEventListener("pointercancel", onPointerCancel);
+  document.addEventListener("dblclick", onDoubleClick);
+  document.addEventListener("mouseover", onMouseOver);
+  document.addEventListener("focusin", onFocusIn);
+  const dispose = () => {
+    const state = s();
+    cancelAnimationFrame(flight);
+    clearTimeout(sayTimer);
+    el.removeEventListener("pointerdown", onPointerDown);
+    el.removeEventListener("pointermove", onPointerMove);
+    el.removeEventListener("pointerup", onPointerUp);
+    el.removeEventListener("pointercancel", onPointerCancel);
+    document.removeEventListener("dblclick", onDoubleClick);
+    document.removeEventListener("mouseover", onMouseOver);
+    document.removeEventListener("focusin", onFocusIn);
+    if (state.affectionCfg && state.affectionLoaded)
+      writeAffection(state.affectionKey, state.affection);
+    if (state.errand?.kind === "goTo") state.errand.resolve?.(false);
+    state.errand = null;
+    state.grab = null;
+    state.season = null;
+    deps.hat?.remove();
+    deps.hat = void 0;
+  };
+  return { upkeep, tickGrab, tickErrand, dispose };
+}
 const PERCH_SELECTOR = "a[href],button,[role='button'],[data-oneko-perch]";
 const PERCH_DELAY_MS = 700;
 const NOT_TYPED_INPUTS = /* @__PURE__ */ new Set([
@@ -1020,7 +1972,7 @@ const NOT_TYPED_INPUTS = /* @__PURE__ */ new Set([
   "submit"
 ]);
 function stopDistance(s) {
-  if (s.perchTarget) return Math.min(s.followDistanceCfg, 8);
+  if (s.errand || s.perchTarget) return Math.min(s.followDistanceCfg, 8);
   if (s.leaderTarget) return Math.max(s.followDistanceCfg, TILE * s.scale);
   return s.followDistanceCfg;
 }
@@ -1142,19 +2094,7 @@ function makePettable(deps) {
     if (!event.repeat) pet();
   };
   const pet = () => {
-    const s = deps.stateRef.current;
-    s.typingNap = false;
-    s.freerunMode = false;
-    s.idleAnimation = null;
-    s.idleAnimationFrame = 0;
-    s.idleTime = Math.max(s.idleTime, 1);
-    if (s.bubbleEnabledCfg) {
-      s.bubbleVisible = true;
-      s.bubbleTimer = s.bubbleDisplayFramesCfg;
-      deps.bubbleTextEl.textContent = pickFromPool(deps, PET_MESSAGES);
-      deps.bubbleEl.style.opacity = "1";
-    }
-    playSound(deps, PET_SOUND_POOL);
+    petCat(deps);
     announcer.textContent = ++pets % 2 ? "The cat purrs." : "The cat purrs happily.";
   };
   el.addEventListener("focus", onFocus);
@@ -1340,7 +2280,7 @@ function collectObstacles() {
   const vh = window.innerHeight;
   const rects = [];
   for (const node of document.querySelectorAll(OBSTACLE_SELECTOR)) {
-    if (node.closest('[data-oneko-zone="attract"]')) continue;
+    if (node.closest('[data-oneko-zone="attract"],[data-oneko-box]')) continue;
     const r = node.getBoundingClientRect();
     if (shouldIncludeObstacleRect(r, vw, vh)) {
       rects.push(toObstacleRect(r));
@@ -1514,40 +2454,8 @@ function findRoute(startIdx, goalIdx, grid, cols, rows) {
   }
   return smoothPath(reconstructCellPath(prev, goalIdx), cols);
 }
-function setSprite(deps, name, frame) {
-  const sprites = defaultSpriteSets[name];
-  if (!sprites?.length) {
-    return;
-  }
-  const sprite = sprites[frame % sprites.length];
-  deps.el.style.backgroundPosition = `${sprite[0] * TILE}px ${sprite[1] * TILE}px`;
-}
-function getDirectionFromAngle(angle) {
-  if (angle >= 157.5 || angle < -157.5) {
-    return "W";
-  }
-  for (const range of DIRECTION_RANGES) {
-    if (angle >= range.min && angle < range.max) {
-      return range.dir;
-    }
-  }
-  return "E";
-}
-function directionFromDelta(dx, dy) {
-  if (Math.abs(dx) < 1 && Math.abs(dy) < 1) {
-    return null;
-  }
-  return getDirectionFromAngle(Math.atan2(dy, dx) * (180 / Math.PI));
-}
-function clearRotation(deps) {
-  const s = deps.stateRef.current;
-  if (s.currentRotation !== 0) {
-    s.currentRotation = 0;
-    deps.el.style.transform = `scale(${s.scale}) rotate(0deg)`;
-  }
-}
 function idleFrameThreshold(s) {
-  return Math.max(1, Math.round(s.idleThresholdMs / 100));
+  return Math.max(1, Math.round(s.idleThresholdMs * s.mood.idle / 100));
 }
 function wallScratchAnimations(s) {
   return [
@@ -1690,7 +2598,7 @@ function moveToward(deps, targetX, targetY) {
     s.nekoVelY *= 0.5;
     return;
   }
-  const currentSpeed = s.currentSpeed;
+  const currentSpeed = s.currentSpeed * s.mood.speed;
   s.nekoVelX += (dx / dist * currentSpeed - s.nekoVelX) * STEER_LERP;
   s.nekoVelY += (dy / dist * currentSpeed - s.nekoVelY) * STEER_LERP;
   const velMag = Math.hypot(s.nekoVelX, s.nekoVelY);
@@ -1780,7 +2688,7 @@ function chaseCursor(deps) {
     tickFreerun(deps);
     return;
   }
-  if (!s.noFollow && Math.random() < s.freerunChanceCfg) {
+  if (!s.noFollow && !s.errand && Math.random() < s.freerunChanceCfg * s.mood.freerun) {
     enterFreerun(deps);
     moveToward(deps, s.zoneState.movementTarget.x, s.zoneState.movementTarget.y);
     return;
@@ -1884,6 +2792,7 @@ function tickSounds(deps) {
   if (currentState !== deps.lastStateRef.current) {
     deps.lastStateRef.current = currentState;
     deps.onStateChangeRef.current?.(currentState);
+    if (currentState === "sleeping") deps.stateRef.current.handlers.onSleep?.();
     const pool = SOUND_POOLS[currentState];
     if (pool) {
       playSound(deps, pool);
@@ -1892,17 +2801,23 @@ function tickSounds(deps) {
   tickAmbientSounds(deps, currentState);
   return currentState;
 }
-function createFrameLoop(deps) {
+function createFrameLoop(deps, play) {
   const { maybeRenderDebug } = createDebugRenderer(deps);
   const frame = () => {
     const s = deps.stateRef.current;
     if (s.pausedCfg) return;
     if (!refreshZones(deps)) return;
     tickPrelude(s);
+    play?.upkeep();
     tickAttention(deps);
     updateZoneTarget(s, window.innerWidth, window.innerHeight);
     const dist = Math.hypot(s.mousePosX - s.nekoPosX, s.mousePosY - s.nekoPosY);
-    tickMovement(deps, dist);
+    if (play?.tickGrab()) {
+      updateBubble(deps);
+    } else {
+      tickMovement(deps, dist);
+      play?.tickErrand();
+    }
     maybeRenderDebug();
     const currentState = tickSounds(deps);
     tickLiveState(deps, dist, currentState);
@@ -2452,13 +3367,13 @@ function readPersistedPosition(storageKey = ONEKO_DEFAULTS.storageKey) {
     return null;
   }
   if (!position) return null;
-  const clamp = (value, extent) => {
+  const clamp2 = (value, extent) => {
     const inset = Math.min(TILE / 2, Math.max(0, extent / 2));
     return Math.max(inset, Math.min(Math.max(inset, extent - inset), value));
   };
   return {
-    x: clamp(position.x, window.innerWidth),
-    y: clamp(position.y, window.innerHeight)
+    x: clamp2(position.x, window.innerWidth),
+    y: clamp2(position.y, window.innerHeight)
   };
 }
 function loadPersistedCatState(stateRef, el, storageKey = ONEKO_DEFAULTS.storageKey) {
@@ -2543,6 +3458,8 @@ function startCatAnimation({
 }) {
   stateRef.current.bubbleVisible = false;
   stateRef.current.bubbleTimer = 0;
+  stateRef.current.zIndex = zIndex;
+  stateRef.current.affectionKey = `${storageKey}:affection`;
   const el = createCatElement(stateRef.current, zIndex);
   elRef.current = el;
   const debugSVG = createDebugSVG(zIndex);
@@ -2560,7 +3477,8 @@ function startCatAnimation({
     onStateChangeRef,
     liveStateRef
   };
-  const frame = createFrameLoop(deps);
+  const play = createPlay(deps);
+  const frame = createFrameLoop(deps, play);
   const debugControls = createDebugControls({
     stateRef,
     el,
@@ -2584,7 +3502,9 @@ function startCatAnimation({
   document.addEventListener("mousemove", onMouseMove);
   const onPointerDown = (event) => {
     if (event.pointerType !== "touch") return;
-    if (event.target instanceof Element && event.target.closest("button,a,input,select,textarea,label,summary,[role='button']"))
+    if (event.target instanceof Element && event.target.closest(
+      "button,a,input,select,textarea,label,summary,[role='button'],[data-oneko-cat]"
+    ))
       return;
     onMouseMove(event);
   };
@@ -2612,7 +3532,12 @@ function startCatAnimation({
   return () => {
     stopPetting?.();
     stopWatchingPage();
+    play.dispose();
     leavePack();
+    if (packSize() === 0) {
+      clearTreats();
+      restoreKnocked();
+    }
     persist?.();
     teardownCatAnimation(
       { el, debugSVG, debugWrapper, bubbleEl },
@@ -2667,7 +3592,13 @@ function defaultRuntimeConfigState() {
     chaseCfg: ONEKO_DEFAULTS.chase,
     napWhileTypingCfg: ONEKO_DEFAULTS.napWhileTyping,
     followFocusCfg: ONEKO_DEFAULTS.followFocus,
-    perchOnHoverCfg: ONEKO_DEFAULTS.perchOnHover
+    perchOnHoverCfg: ONEKO_DEFAULTS.perchOnHover,
+    seasonalCfg: ONEKO_DEFAULTS.seasonal,
+    grabbableCfg: ONEKO_DEFAULTS.grabbable,
+    treatsCfg: ONEKO_DEFAULTS.treats,
+    timeOfDayCfg: ONEKO_DEFAULTS.timeOfDay,
+    affectionCfg: ONEKO_DEFAULTS.affection,
+    handlers: {}
   };
 }
 function applyRuntimeConfig(state, config) {
@@ -2717,6 +3648,20 @@ function applyRuntimeConfig(state, config) {
   state.perchOnHoverCfg = config.perchOnHover ?? ONEKO_DEFAULTS.perchOnHover;
   if (!state.napWhileTypingCfg) state.typingNap = false;
   if (!state.perchOnHoverCfg) state.perchTarget = null;
+  const seasonal = config.seasonal ?? ONEKO_DEFAULTS.seasonal;
+  state.seasonalCfg = typeof seasonal === "boolean" || isOnekoSeason(seasonal) ? seasonal : true;
+  state.grabbableCfg = config.grabbable ?? ONEKO_DEFAULTS.grabbable;
+  state.treatsCfg = config.treats ?? ONEKO_DEFAULTS.treats;
+  state.timeOfDayCfg = config.timeOfDay ?? ONEKO_DEFAULTS.timeOfDay;
+  state.affectionCfg = config.affection ?? ONEKO_DEFAULTS.affection;
+  state.handlers = {
+    onPet: config.onPet,
+    onCatchCursor: config.onCatchCursor,
+    onSleep: config.onSleep,
+    onToss: config.onToss,
+    onTreat: config.onTreat
+  };
+  if (!state.grabbableCfg && state.grab?.phase === "held") state.grab = null;
 }
 const classic = "data:image/png;base64,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";
 const classicSheet = {
@@ -2800,6 +3745,67 @@ async function loadSkinSource(skin = "classic") {
   }
   return loaded.get(id) ?? loaded.get("classic");
 }
+function createCatControls(stateRef) {
+  const s = () => stateRef.current;
+  const release = () => {
+    const errand = s().errand;
+    if (errand?.kind === "goTo") errand.resolve?.(false);
+    s().errand = null;
+  };
+  return {
+    goTo(target) {
+      const resolved = typeof target === "string" ? document.querySelector(target) : target;
+      release();
+      if (!resolved) return Promise.resolve(false);
+      return new Promise((resolve) => {
+        const state = s();
+        state.errand = {
+          kind: "goTo",
+          target: resolved,
+          frames: 0,
+          arrived: false,
+          resolve
+        };
+        state.typingNap = false;
+      });
+    },
+    say(text, options = {}) {
+      const state = s();
+      const frames = Number.isFinite(options.duration) ? Math.max(1, Math.round(options.duration / 100)) : state.bubbleDisplayFramesCfg;
+      state.sayRequest = { text: String(text).slice(0, 280), frames };
+    },
+    sit() {
+      release();
+      s().errand = { kind: "sit" };
+    },
+    follow: release,
+    pet() {
+      s().petRequest = true;
+    },
+    dropTreat(x, y) {
+      const state = s();
+      dropTreat(x ?? state.mousePosX, y ?? state.mousePosY, state.zIndex);
+    }
+  };
+}
+function defaultPlayState() {
+  return {
+    season: null,
+    grab: null,
+    errand: null,
+    errandCooldown: 50,
+    sayRequest: null,
+    bubbleForced: false,
+    petRequest: false,
+    chasingFar: false,
+    mood: { speed: 1, freerun: 1, idle: 1 },
+    moodCheckedFrame: -Infinity,
+    affection: 0,
+    affectionLoaded: false,
+    affectionKey: "oneko:affection",
+    zIndex: DEFAULT_Z_INDEX
+  };
+}
 function createInitialCatState(options) {
   const startX = options.initialPos?.x ?? DEFAULT_POSITION.x;
   const startY = options.initialPos?.y ?? DEFAULT_POSITION.y;
@@ -2838,7 +3844,8 @@ function createInitialCatState(options) {
     typingNap: false,
     held: false,
     perchTarget: null,
-    leaderTarget: null
+    leaderTarget: null,
+    ...defaultPlayState()
   };
   applyRuntimeConfig(state, options);
   return state;
@@ -2919,6 +3926,7 @@ function createOneko(initial = {}, base = {}) {
   const stopWatchingHidden = onCatsHiddenChange(start);
   start();
   return {
+    ...createCatControls(stateRef),
     update(next) {
       if (destroyed) return;
       const previous = options;
@@ -2978,10 +3986,11 @@ export {
   applyRuntimeConfig as a,
   createInitialCatState as b,
   createOneko as c,
-  areCatsHidden as d,
-  ONEKO_SKINS as e,
-  setCatsHidden as f,
+  createCatControls as d,
+  areCatsHidden as e,
+  ONEKO_SKINS as f,
   getSkinSource as g,
+  setCatsHidden as h,
   isOnekoSkin as i,
   loadSkinSource as l,
   mountLaserCursor as m,