@jcendal/opencode-digital-pet 0.2.2 → 0.3.0

package/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-10-06
+
+### Changed
+
+- Feat/cursor pet display
+
+
+## [0.2.3] - 2026-10-06
+
+### Changed
+
+- chore(digital-pet-core): mark stages for a release probe
+
+
 ## [0.2.2] - 2026-10-06
 
 ### Changed

package/dist/digital-pet-animation/sequences/evolution-artwork.d.ts

@@ -5,4 +5,4 @@ export type EvolutionArtworkScene = {
     readonly progress: number;
 };
 export declare const renderEvolutionArtwork: (catalog: MonsterFrameCatalog, fromSprite: string, toSprite: string, scene: EvolutionArtworkScene, viewportWidth: number, tick?: number) => string;
-export declare const runEvolutionAnimation: (catalog: MonsterFrameCatalog, fromSprite: string, toSprite: string, viewportWidth: number, onFrame: (artwork: string) => Promise<void>) => Promise<void>;
+export declare const runEvolutionAnimation: (catalog: MonsterFrameCatalog, fromSprite: string, toSprite: string, viewportWidth: number, onFrame: (artwork: string) => Promise<void>, onReveal?: () => Promise<void>) => Promise<void>;

package/dist/digital-pet-animation/sequences/evolution-battle-artwork.d.ts

@@ -8,6 +8,18 @@ export type EvolutionBattleShooter = "player" | "opponent";
 export type EvolutionBattleOutcome = EvolutionBattleShooter;
 export type BattleSpritePose = "attack" | "injured" | "happy" | "idle";
 export type EvolutionBattleResultLabel = "hit" | "miss" | null;
+/** Scores and caption accompanying the shared frame; frontends choose their HUD style. */
+export type BattleFrameHud = {
+    readonly playerHits: number;
+    readonly opponentHits: number;
+    readonly hitsToWin: number;
+    readonly caption: string | null;
+    readonly gapStartColumn: number;
+    readonly gapColumns: number;
+    readonly scoreRow: number;
+    readonly captionRow: number;
+};
+export type BattleFrameListener = (artwork: string, hud?: BattleFrameHud) => Promise<void>;
 export type EvolutionBattleShot = {
     readonly shooter: EvolutionBattleShooter;
     readonly hit: boolean;
@@ -30,4 +42,4 @@ export declare const planEvolutionBattle: (outcome: EvolutionBattleOutcome, rand
 export declare const defaultBattleScene: (overrides?: Partial<EvolutionBattleScene>) => EvolutionBattleScene;
 export declare const renderBattleIntroArtwork: (viewportWidth: number, _progress: number, tick?: number) => string;
 export declare const renderEvolutionBattleArtwork: (catalog: MonsterFrameCatalog, playerSprite: string, opponentSprite: string, scene: EvolutionBattleScene, viewportWidth: number) => string;
-export declare const runEvolutionBattleAnimation: (catalog: MonsterFrameCatalog, playerSprite: string, opponentSprite: string, viewportWidth: number, outcome: EvolutionBattleOutcome, onFrame: (artwork: string) => Promise<void>, random?: () => number) => Promise<EvolutionBattleOutcome>;
+export declare const runEvolutionBattleAnimation: (catalog: MonsterFrameCatalog, playerSprite: string, opponentSprite: string, viewportWidth: number, outcome: EvolutionBattleOutcome, onFrame: BattleFrameListener, random?: () => number) => Promise<EvolutionBattleOutcome>;

package/dist/digital-pet-animation/sessions/evolution-battle-session.d.ts

@@ -3,12 +3,15 @@ import type { SidebarSnapshot } from "../../digital-pet-core/application/ports/s
 import { type EvolutionBattleRepository } from "../../digital-pet-core/application/use-cases/resolve-evolution-battle.js";
 import type { DigimonCatalog } from "../../digital-pet-core/data/catalog.js";
 import type { MonsterFrameCatalog } from "../../digital-pet-core/data/monster-frame-catalog.js";
+import { type BattleFrameListener } from "../sequences/evolution-battle-artwork.js";
+import type { PresentationStateListener } from "./presentation-state.js";
 export type EvolutionBattleSessionDependencies = {
     readonly frameCatalog: MonsterFrameCatalog;
     readonly digimonCatalog: DigimonCatalog;
     readonly repository: EvolutionBattleRepository;
     readonly random?: () => number;
-    readonly onArtwork: (artwork: string) => Promise<void>;
+    readonly onState?: PresentationStateListener;
+    readonly onArtwork: BattleFrameListener;
     readonly onResolved?: (result: ResolveEvolutionBattleOutcome) => Promise<void>;
 };
 export declare const runEvolutionBattleSession: (snapshot: SidebarSnapshot, viewportWidth: number, dependencies: EvolutionBattleSessionDependencies) => Promise<boolean>;

package/dist/digital-pet-animation/sessions/evolution-reveal-session.d.ts

@@ -1,9 +1,11 @@
 import type { UsageEvolutionTransition } from "../../digital-pet-core/application/models/usage.js";
 import type { DigimonCatalog } from "../../digital-pet-core/data/catalog.js";
 import type { MonsterFrameCatalog } from "../../digital-pet-core/data/monster-frame-catalog.js";
+import type { PresentationStateListener } from "./presentation-state.js";
 export type EvolutionRevealSessionDependencies = {
     readonly frameCatalog: MonsterFrameCatalog;
     readonly digimonCatalog: DigimonCatalog;
+    readonly onState?: PresentationStateListener;
     readonly onArtwork: (artwork: string) => Promise<void>;
 };
 export declare const runEvolutionRevealSession: (evolution: UsageEvolutionTransition, viewportWidth: number, dependencies: EvolutionRevealSessionDependencies) => Promise<boolean>;

package/dist/digital-pet-animation/sessions/presentation-state.d.ts

@@ -0,0 +1,16 @@
+/** Semantic animation phases; each frontend chooses its own layout and styling. */
+export type PresentationState = {
+    readonly phase: "idle";
+} | {
+    readonly phase: "battle";
+    readonly fromNodeId: string;
+    readonly opponentNodeId: string;
+} | {
+    readonly phase: "evolving" | "evolved";
+    readonly fromNodeId: string;
+    readonly toNodeId: string;
+} | {
+    readonly phase: "defeated";
+    readonly fromNodeId: string;
+};
+export type PresentationStateListener = (state: PresentationState) => Promise<void>;

package/dist/tui/sidebar-card.d.ts

@@ -1,9 +1,11 @@
+import type { PresentationState } from "../digital-pet-animation/sessions/presentation-state.js";
 import { type Accessor } from "solid-js";
 import type { SidebarCardModel } from "../digital-pet-core/view-models/sidebar-view-model.js";
 import type { MonsterAnimationOutput, MonsterAnimationResult } from "../digital-pet-animation/idle/monster-animation.js";
 export declare const DigitalPetSidebarCard: (props: {
     readonly model: Accessor<SidebarCardModel>;
     readonly animation: Accessor<MonsterAnimationOutput | MonsterAnimationResult>;
+    readonly presentationState?: Accessor<PresentationState>;
     readonly customArtwork?: Accessor<string | undefined>;
     readonly onArtworkWidthChange?: (width: number) => void;
     readonly onUrlClick?: (url: string) => void;

package/dist/tui.js

@@ -7680,7 +7680,17 @@ var renderEvolutionBattleArtwork = (catalog, playerSprite, opponentSprite, scene
   return rows.map((row) => `${" ".repeat(padding)}${row}`).join("\n");
 };
 var postScene = async (catalog, playerSprite, opponentSprite, viewportWidth, scene, onFrame) => {
-  await onFrame(renderEvolutionBattleArtwork(catalog, playerSprite, opponentSprite, scene, viewportWidth));
+  const battleWidth = MONSTER_FRAME_COLUMNS * 2 + BATTLE_GAP_COLUMNS;
+  await onFrame(renderEvolutionBattleArtwork(catalog, playerSprite, opponentSprite, scene, viewportWidth), {
+    playerHits: scene.playerHits,
+    opponentHits: scene.opponentHits,
+    hitsToWin: EVOLUTION_BATTLE_HITS_TO_WIN,
+    caption: scene.outcomeLabel ?? (scene.lastResult === null ? null : scene.lastResult === "hit" ? "HIT!" : "MISS"),
+    gapStartColumn: Math.max(Math.floor((viewportWidth - battleWidth) / 2), 0) + MONSTER_FRAME_COLUMNS,
+    gapColumns: BATTLE_GAP_COLUMNS,
+    scoreRow: 0,
+    captionRow: MONSTER_FRAME_ROWS - 1
+  });
 };
 var animateBattleIntro = async (viewportWidth, onFrame) => {
   const steps = Math.max(1, Math.ceil(EVOLUTION_BATTLE_INTRO_MS / EVOLUTION_BATTLE_TICK_MS));
@@ -7868,10 +7878,11 @@ var animatePhase = async (catalog, fromSprite, toSprite, viewportWidth, phase, d
     if (step < steps) await sleep(EVOLUTION_TICK_MS);
   }
 };
-var runEvolutionAnimation = async (catalog, fromSprite, toSprite, viewportWidth, onFrame) => {
+var runEvolutionAnimation = async (catalog, fromSprite, toSprite, viewportWidth, onFrame, onReveal) => {
   await sleep(EVOLUTION_PRE_ANIMATION_MS);
   await animatePhase(catalog, fromSprite, toSprite, viewportWidth, "glow", EVOLUTION_GLOW_MS, onFrame);
   await animatePhase(catalog, fromSprite, toSprite, viewportWidth, "morph", EVOLUTION_MORPH_MS, onFrame);
+  await onReveal?.();
   await animatePhase(catalog, fromSprite, toSprite, viewportWidth, "reveal", EVOLUTION_REVEAL_MS, onFrame);
 };
 
@@ -7880,12 +7891,16 @@ var runEvolutionRevealSession = async (evolution, viewportWidth, dependencies) =
   const from = dependencies.digimonCatalog.byId.get(evolution.fromNodeId);
   const to = dependencies.digimonCatalog.byId.get(evolution.toNodeId);
   if (from === void 0 || to === void 0) return false;
+  await dependencies.onState?.({ phase: "evolving", ...evolution });
   await runEvolutionAnimation(
     dependencies.frameCatalog,
     from.sprite,
     to.sprite,
     viewportWidth,
-    async (artwork) => dependencies.onArtwork(artwork)
+    dependencies.onArtwork,
+    async () => {
+      await dependencies.onState?.({ phase: "evolved", ...evolution });
+    }
   );
   return true;
 };
@@ -7898,7 +7913,8 @@ var runEvolutionBattleSession = async (snapshot, viewportWidth, dependencies) =>
   if (player === void 0 || opponent === void 0) return false;
   const random = dependencies.random ?? Math.random;
   const outcome = random() < 0.5 ? "player" : "opponent";
-  const postArtwork = async (artwork) => dependencies.onArtwork(artwork);
+  const postArtwork = async (artwork, hud) => dependencies.onArtwork(artwork, hud);
+  await dependencies.onState?.({ phase: "battle", fromNodeId: player.id, opponentNodeId: opponent.id });
   await runEvolutionBattleAnimation(
     dependencies.frameCatalog,
     player.sprite,
@@ -7915,10 +7931,12 @@ var runEvolutionBattleSession = async (snapshot, viewportWidth, dependencies) =>
       {
         frameCatalog: dependencies.frameCatalog,
         digimonCatalog: dependencies.digimonCatalog,
-        onArtwork: postArtwork
+        onArtwork: postArtwork,
+        ...dependencies.onState === void 0 ? {} : { onState: dependencies.onState }
       }
     );
   } else {
+    await dependencies.onState?.({ phase: "defeated", fromNodeId: player.id });
     await runDefeatAnimation(dependencies.frameCatalog, player.sprite, viewportWidth, postArtwork);
   }
   const result = resolveEvolutionBattleForPartner(
@@ -8958,13 +8976,18 @@ var DigitalPetSidebarCard = (props) => {
         updateText(gauge, "");
         updateText(url, "");
         return;
-      case "partner":
+      case "partner": {
         updateText(name, model.isSetOverride ? `${model.name} (set)` : model.name);
         updateText(stage, model.frozen ? `${model.stage} (frozen)` : model.stage);
-        updateText(nextCheck, buildNextCheckLine(model, nextCheckWidth?.width ?? 0));
+        const phase = props.presentationState?.().phase ?? "idle";
+        updateText(
+          nextCheck,
+          phase === "idle" ? buildNextCheckLine(model, nextCheckWidth?.width ?? 0) : phase.toUpperCase()
+        );
         updateText(gauge, model.isTerminal ? "-/-" : `${formatCount(model.gauge)}/${formatCount(model.threshold)}`);
         updateText(url, URL_LABEL);
         return;
+      }
     }
   };
   createEffect(renderCard);
@@ -9429,6 +9452,7 @@ var createTui = (loadInputs, settings, scheduling = {}) => async (api) => {
     offset: 0,
     facing: "left"
   });
+  const [presentationState, setPresentationState] = createSignal({ phase: "idle" });
   const [customArtwork, setCustomArtwork] = createSignal();
   const controller = new MonsterAnimationController(
     MONSTER_FRAME_CATALOG,
@@ -9458,6 +9482,15 @@ var createTui = (loadInputs, settings, scheduling = {}) => async (api) => {
         digimonCatalog: DIGIMON_CATALOG,
         repository: scheduling.battleRepository,
         ...scheduling.random === void 0 ? {} : { random: scheduling.random },
+        onState: async (state) => {
+          setPresentationState(state);
+          if (state.phase === "evolved") {
+            const current = inputs();
+            const node = DIGIMON_CATALOG.byId.get(state.toNodeId);
+            if (current.kind === "partner" && node !== void 0) setInputs({ ...current, node });
+          }
+          api.renderer.requestRender();
+        },
         onArtwork: async (artwork) => {
           setCustomArtwork(artwork);
           api.renderer.requestRender();
@@ -9481,6 +9514,7 @@ var createTui = (loadInputs, settings, scheduling = {}) => async (api) => {
       return battled;
     } finally {
       battleInProgress = false;
+      setPresentationState({ phase: "idle" });
       setCustomArtwork(void 0);
     }
   };
@@ -9498,6 +9532,15 @@ var createTui = (loadInputs, settings, scheduling = {}) => async (api) => {
       const revealed = await runEvolutionRevealSession(evolution, artworkWidth, {
         frameCatalog: MONSTER_FRAME_CATALOG,
         digimonCatalog: DIGIMON_CATALOG,
+        onState: async (state) => {
+          setPresentationState(state);
+          if (state.phase === "evolved") {
+            const current = inputs();
+            const node = DIGIMON_CATALOG.byId.get(state.toNodeId);
+            if (current.kind === "partner" && node !== void 0) setInputs({ ...current, node });
+          }
+          api.renderer.requestRender();
+        },
         onArtwork: async (artwork) => {
           setCustomArtwork(artwork);
           api.renderer.requestRender();
@@ -9512,6 +9555,7 @@ var createTui = (loadInputs, settings, scheduling = {}) => async (api) => {
       return true;
     } finally {
       battleInProgress = false;
+      setPresentationState({ phase: "idle" });
       setCustomArtwork(void 0);
     }
   };
@@ -9651,6 +9695,7 @@ var createTui = (loadInputs, settings, scheduling = {}) => async (api) => {
             model: () => buildSidebarCardModel(inputs(), settings),
             animation,
             customArtwork,
+            presentationState,
             onArtworkWidthChange: (width) => {
               if (disposed) return;
               artworkWidth = width;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jcendal/opencode-digital-pet",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "An OpenCode virtual-pet plugin with /digital-pet-spawn, /digital-pet-freeze, /digital-pet-unfreeze, /digital-pet-set, /digital-pet-dex, and /digital-pet-history commands.",
   "author": "Jorge Cendal",
   "contributors": [