@mingxy/opencode-mascot 0.5.9 → 0.6.0

package/README.md

@@ -6,16 +6,25 @@ Customizable ASCII mascots that breathe, walk, sleep, get launched across the sc
 
 [English](./README.md) | [简体中文](./README_zh-CN.md)
 
+## 🏠 Home Page
+
+![home demo](./assets/demo-home.gif)
+
+## 💼 Work Page
+
+![work demo](./assets/demo-work.gif)
+
 ---
 
 ## ✨ Features
 
-### 🎭 Built-in Characters (2)
+### 🎭 Built-in Characters (3)
 
 | Character | Description | Color |
 |-----------|-------------|-------|
 | **yueer** | Purple-haired girl with an ahoge, tsundere style, default mascot | `#8B7EB8` lavender |
 | **baozi** | A steaming hot bun, warm and cozy | `#D4885A` warm orange |
+| **cat** | Orange tabby cat — purring, kneading, tail-swishing | `#FFA500` orange |
 
 Each character includes **5 expression frames**: default / blink / happy / thinking / sleeping
 
@@ -54,6 +63,17 @@ Each character includes **5 expression frames**: default / blink / happy / think
 | 15 | Alien text bubble | busy/thinking | 12 alien-text phrases rotate |
 | 16 | Drag panic | While dragging | `( °□° )` |
 
+**cat exclusive:**
+
+| # | Animation | Trigger | Effect |
+|---|-----------|---------|--------|
+| 17 | Tail swish | Every 0.6s | Tail `|_)` ↔ `|~)` |
+| 18 | Ear twitch | Random (20% / 2.5s) | Ear `/\` → `/╲` |
+| 19 | Pupil dilate | Random (15% / 4s, idle) | Eyes `o.o` → `@.@` |
+| 20 | Kneading | idle state | Paws alternate `/||  |\` ↔ `/|  ||\` |
+| 21 | Purr bubble | busy/thinking | 12 purr phrases rotate (purrr~/mrrrow~/nyaa~) |
+| 22 | Drag bristle | While dragging | Ears bristle `/╲╱╲` + shocked face `>.<` |
+
 ---
 
 ### 🖱️ Interactions (5)
@@ -157,7 +177,8 @@ opencode-mascot/
 │   │   └── sidebar-mascot.tsx       # Work page mascot (peek-a-boo)
 │   └── builtins/
 │       ├── yueer/                   # yueer (frames + effects)
-│       └── baozi/                   # baozi (frames + effects)
+│       ├── baozi/                   # baozi (frames + effects)
+│       └── cat/                     # cat (frames + effects)
 ```
 
 ## 🎨 Custom Characters
@@ -197,16 +218,16 @@ All built-in animations (blink/breath/walk/jump/sleep/drag/color-flash/bomb/fall
 
 | Category | Count |
 |----------|-------|
-| Built-in characters | 2 |
+| Built-in characters | 3 |
 | Expression frames | 5 / character |
-| Auto animations | 16 |
+| Auto animations | 22 |
 | Interactions | 5 |
 | Peek-a-boo behaviors | 3 |
 | Random events | 3 |
 | Alien text phrases | 24 (12/character) |
 | Flash colors | 8 |
 | Drag alien text | 6 |
-| **Total** | **33+** |
+| **Total** | **39+** |
 
 ## 📄 License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mingxy/opencode-mascot",
-  "version": "0.5.9",
+  "version": "0.6.0",
   "description": "OpenCode TUI mascot plugin framework - customizable ASCII mascots for your terminal",
   "author": "mingxy",
   "license": "MIT",

package/src/builtins/cat/frames.ts

@@ -0,0 +1,48 @@
+//     0123456789
+const defaultFrame = [
+  "  /\\_/\\   ",
+  " ( o.o )  ",
+  "  > ^ <   ",
+  " /|   |\\  ",
+  "(_|   |_) ",
+];
+
+const blinkFrame = [
+  "  /\\_/\\   ",
+  " ( -.- )  ",
+  "  > ^ <   ",
+  " /|   |\\  ",
+  "(_|   |_) ",
+];
+
+const happyFrame = [
+  "  /\\_/\\   ",
+  " ( ^ω^ )  ",
+  "  > ω <   ",
+  " /|   |\\  ",
+  "(_|   |_) ",
+];
+
+const thinkingFrame = [
+  "  /\\_/\\   ",
+  " ( o_o )  ",
+  "  > ? <   ",
+  " /|   |\\  ",
+  "(_|   |_) ",
+];
+
+const sleepingFrame = [
+  "  /\\_/\\   ",
+  " ( -.- )  ",
+  "  > z <   ",
+  " /|   |\\  ",
+  "(_|   |_) ",
+];
+
+export const frames = {
+  default: defaultFrame,
+  blink: blinkFrame,
+  happy: happyFrame,
+  thinking: thinkingFrame,
+  sleeping: sleepingFrame,
+};

package/src/builtins/cat/index.ts

@@ -0,0 +1,167 @@
+import type { MascotPack, EffectRenderCtx } from "../../core/types";
+import { frames } from "./frames";
+
+const PURR_TEXTS = [
+  "ᵖᵘʳʳʳ~", "ᵐʳʳᵒʷ~", "ᵐʷᵃᵃ~", "ⁿʸᵃᵃ~",
+  "ᵖᵘʳʳ..", "ᵐʸᵃ~..", "ᶠᵘʳʳ~", "ᵐⁱᵃᵒ~",
+  "ᶜʰᵘʳʳ..", "ᵉᵘⁿ~..", "ˢʰᵖᵘʳʳ~", "ⁿʸᵒ~",
+];
+const THINKING_FACES = ["o_o", "O_O", ">_o", "o_<", "⊙_⊙", "◑_◑"];
+
+const catEffects: MascotPack["effects"] = {
+  signals: [
+    { name: "tailAlt", initial: false },
+    { name: "earTwitch", initial: false },
+    { name: "pupilWide", initial: false },
+    { name: "kneadAlt", initial: false },
+    { name: "purrIdx", initial: 0 },
+    { name: "thinkingFaceIdx", initial: 0 },
+    { name: "thinkingCountdown", initial: 0 },
+  ],
+
+  timers: [
+    {
+      interval: 600,
+      update(ctx) {
+        ctx.set("tailAlt", !(ctx.get("tailAlt") as boolean));
+      },
+    },
+    {
+      interval: 2500,
+      update(ctx) {
+        if (Math.random() < 0.2) {
+          ctx.set("earTwitch", true);
+          setTimeout(() => ctx.set("earTwitch", false), 250);
+        }
+      },
+    },
+    {
+      interval: 4000,
+      update(ctx) {
+        if (ctx.state === "idle" && Math.random() < 0.15) {
+          ctx.set("pupilWide", true);
+          setTimeout(() => ctx.set("pupilWide", false), 1000);
+        }
+      },
+    },
+    {
+      interval: 400,
+      update(ctx) {
+        if (ctx.state === "idle") {
+          ctx.set("kneadAlt", !(ctx.get("kneadAlt") as boolean));
+        }
+      },
+    },
+    {
+      interval: 2000,
+      update(ctx) {
+        if (ctx.state === "busy" || ctx.state === "thinking") {
+          ctx.set("purrIdx", ((ctx.get("purrIdx") as number) + 1) % PURR_TEXTS.length);
+        }
+      },
+    },
+    {
+      interval: 1000,
+      update(ctx) {
+        if (ctx.state === "thinking" || ctx.state === "busy") {
+          let cd = ctx.get("thinkingCountdown") as number;
+          if (!cd || cd <= 0) cd = 5 + Math.floor(Math.random() * 11);
+          cd--;
+          if (cd <= 0) {
+            ctx.set("thinkingFaceIdx", ((ctx.get("thinkingFaceIdx") as number) + 1) % THINKING_FACES.length);
+          }
+          ctx.set("thinkingCountdown", cd);
+        } else {
+          ctx.set("thinkingFaceIdx", 0);
+          ctx.set("thinkingCountdown", 0);
+        }
+      },
+    },
+  ],
+
+  render(lines: string[], ctx: EffectRenderCtx): string[] {
+    const { state, breathPhase, dragging, get } = ctx;
+    let result = [...lines];
+
+    const tailAlt = get("tailAlt") as boolean;
+    const earTwitch = get("earTwitch") as boolean;
+    const pupilWide = get("pupilWide") as boolean;
+    const kneadAlt = get("kneadAlt") as boolean;
+
+    if (dragging) {
+      result[0] = "  /╲╱╲\\   ";
+      result[1] = " ( >.< )  ";
+      result[2] = "  > ! <   ";
+      result[3] = " /|   |\\  ";
+      result[4] = "(_|   |_) ";
+      return result;
+    }
+
+    if (!breathPhase) {
+      result = result.map((l) => l.replace(/\^/g, "'"));
+    }
+
+    if (earTwitch) {
+      result[0] = result[0].replace("/\\_/\\", "/╲_/\\");
+    }
+
+    if (tailAlt) {
+      result[4] = "(_|   |~) ";
+    } else {
+      result[4] = "(_|   |_) ";
+    }
+
+    if (pupilWide) {
+      const faceLine = result.findIndex((l) => /\(.*\)/.test(l));
+      if (faceLine >= 0) {
+        result[faceLine] = result[faceLine].replace("o.o", "@.@");
+      }
+    }
+
+    if (state === "idle") {
+      const armLine = result.findIndex((l) => l.includes("/|   |\\"));
+      if (armLine >= 0) {
+        result[armLine] = kneadAlt ? " /||  |\\  " : " /|  ||\\  ";
+      }
+    }
+
+    if (state === "thinking" || state === "busy") {
+      const faceIdx = get("thinkingFaceIdx") as number;
+      const faceLine = result.findIndex((l) => /\(.*\)/.test(l));
+      if (faceLine >= 0) {
+        result[faceLine] = result[faceLine].replace(/\(.*?\)/, `( ${THINKING_FACES[faceIdx]} )`);
+      }
+    }
+
+    if (state === "busy" || state === "thinking") {
+      const idx = get("purrIdx") as number;
+      const earLine = 0;
+      result[earLine] = result[earLine].trimEnd() + " " + PURR_TEXTS[idx];
+    }
+
+    return result;
+  },
+};
+
+export const catPack: MascotPack = {
+  name: "@mingxy/mascot-cat",
+  displayName: "小猫",
+  version: "0.1.0",
+  author: "mingxy",
+  description: "Orange tabby cat — purring, kneading, and knocking things off your terminal.",
+
+  frames,
+
+  colors: {
+    defaultFg: "#FFA500",
+  },
+
+  animations: {
+    blinkInterval: 2500,
+    blinkChance: 0.3,
+    expressionInterval: 8000,
+    idleTimeout: 90000,
+  },
+
+  effects: catEffects,
+};

package/src/core/mascot-loader.ts

@@ -1,10 +1,12 @@
 import type { MascotPack } from "./types"
 import { yueerPack } from "../builtins/yueer"
 import { baoziPack } from "../builtins/baozi"
+import { catPack } from "../builtins/cat"
 
 const BUILTINS: Record<string, MascotPack> = {
   yueer: yueerPack,
   baozi: baoziPack,
+  cat: catPack,
 }
 
 const ALL_NAMES = Object.keys(BUILTINS)