@linxin666/dsh-pet 0.1.14 → 0.1.16

package/lib/invariant.js

@@ -1,4 +1,4 @@
-import { l as defaultAffinityConfig, n as animationForPhase, o as AFFINITY_RANKS } from "./state-P-wsVJ6O.js";
+import { n as animationForPhase, o as AFFINITY_RANKS, u as defaultAffinityConfig } from "./state-CFyJv0sQ.js";
 //#region src/invariant.ts
 /**
 * Package invariants — cheap structural checks run at import time on the

package/lib/{state-P-wsVJ6O.js → state-CFyJv0sQ.js}

@@ -48,6 +48,20 @@ function rankOf(points) {
 	for (const candidate of AFFINITY_RANKS) if (points >= candidate.min) rank = candidate;
 	return rank;
 }
+/** Derive the read-only view of one affinity state at a wall-clock instant. */
+function affinityViewOf(state, nowMs, config = defaultAffinityConfig) {
+	const rank = rankOf(state.points);
+	return {
+		points: state.points,
+		rank: rank.name,
+		rankEmoji: rank.emoji,
+		pets: state.pets,
+		feeds: state.feeds,
+		turns: state.turns,
+		petCooldown: nowMs - state.lastPetAt < config.petCooldownMs,
+		feedCooldown: nowMs - state.lastFeedAt < config.feedCooldownMs
+	};
+}
 function clamp(points) {
 	return Math.min(100, Math.max(0, points));
 }
@@ -196,4 +210,4 @@ var PetStateMachine = class {
 	}
 };
 //#endregion
-export { AFFINITY_MAX as a, applyTurnReward as c, rankOf as d, rowOf as i, defaultAffinityConfig as l, animationForPhase as n, AFFINITY_RANKS as o, defaultPetStateConfig as r, applyInteraction as s, PetStateMachine as t, emptyAffinity as u };
+export { AFFINITY_MAX as a, applyInteraction as c, emptyAffinity as d, rankOf as f, rowOf as i, applyTurnReward as l, animationForPhase as n, AFFINITY_RANKS as o, defaultPetStateConfig as r, affinityViewOf as s, PetStateMachine as t, defaultAffinityConfig as u };

package/lib/types/affinity.d.ts

@@ -71,6 +71,21 @@ export interface InteractionOutcome {
 }
 /** Rank for a point total. */
 export declare function rankOf(points: number): (typeof AFFINITY_RANKS)[number];
+/** Read-only affinity snapshot suited for the RPC view shape. */
+export interface PetAffinityView {
+    points: number;
+    rank: string;
+    rankEmoji: string;
+    pets: number;
+    feeds: number;
+    turns: number;
+    /** True while the pet interaction is inside its cooldown. */
+    petCooldown: boolean;
+    /** True while the feed is inside its cooldown. */
+    feedCooldown: boolean;
+}
+/** Derive the read-only view of one affinity state at a wall-clock instant. */
+export declare function affinityViewOf(state: AffinityState, nowMs: number, config?: AffinityConfig): PetAffinityView;
 /**
  * Apply one interaction to a copy of the state (immutable style: returns a
  * new object; the caller replaces the persisted state). Cooldowns only

package/lib/types/affinity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"affinity.d.ts","sourceRoot":"","sources":["../../src/affinity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uDAAuD;AACvD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,CAAA;AAE3C,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;CACd;AAED,eAAO,MAAM,YAAY,MAAM,CAAA;AAE/B;;iEAEiE;AACjE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;EAKjB,CAAA;AAEV,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAA;IACrB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,eAAO,MAAM,qBAAqB,EAAE,cAMnC,CAAA;AAED,wBAAgB,aAAa,IAAI,aAAa,CAE7C;AAED,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,QAAQ,EAAE,aAAa,CAAA;IACvB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAA;IACb,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAA;IAChB,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,8BAA8B;AAC9B,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAMtE;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,cAAsC,GAC7C,kBAAkB,CA+BpB;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,MAAM,GAAE,cAAsC,GAC7C,aAAa,CAKf"}
+{"version":3,"file":"affinity.d.ts","sourceRoot":"","sources":["../../src/affinity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uDAAuD;AACvD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,CAAA;AAE3C,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;CACd;AAED,eAAO,MAAM,YAAY,MAAM,CAAA;AAE/B;;iEAEiE;AACjE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;EAKjB,CAAA;AAEV,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAA;IACrB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,eAAO,MAAM,qBAAqB,EAAE,cAMnC,CAAA;AAED,wBAAgB,aAAa,IAAI,aAAa,CAE7C;AAED,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,QAAQ,EAAE,aAAa,CAAA;IACvB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAA;IACb,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAA;IAChB,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,8BAA8B;AAC9B,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAMtE;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,6DAA6D;IAC7D,WAAW,EAAE,OAAO,CAAA;IACpB,kDAAkD;IAClD,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAC5B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,cAAsC,GAC7C,eAAe,CAYjB;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,cAAsC,GAC7C,kBAAkB,CA+BpB;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,MAAM,GAAE,cAAsC,GAC7C,aAAa,CAKf"}

package/lib/types/affinity.js

@@ -34,6 +34,20 @@ export function rankOf(points) {
     }
     return rank;
 }
+/** Derive the read-only view of one affinity state at a wall-clock instant. */
+export function affinityViewOf(state, nowMs, config = defaultAffinityConfig) {
+    const rank = rankOf(state.points);
+    return {
+        points: state.points,
+        rank: rank.name,
+        rankEmoji: rank.emoji,
+        pets: state.pets,
+        feeds: state.feeds,
+        turns: state.turns,
+        petCooldown: nowMs - state.lastPetAt < config.petCooldownMs,
+        feedCooldown: nowMs - state.lastFeedAt < config.feedCooldownMs,
+    };
+}
 function clamp(points) {
     return Math.min(AFFINITY_MAX, Math.max(0, points));
 }

package/lib/types/client/PetDockEntry.d.ts

@@ -1,11 +1,13 @@
 /**
  * Global floating pet entry. The pet is host-global (its state, display and
- * interactions live on `/api/pet/*` endpoints with no session dimension), so
+ * interactions live on '/api/pet/*' endpoints with no session dimension), so
  * it must not ride a session-scoped slot — on the new-conversation screen no
  * session exists to scope a slot by, and the pet would vanish (issue #48).
- * The client half therefore mounts this entry straight onto `document.body`
- * (see index.ts): while visible it renders the floating WhalePet (a portal),
- * while hidden it renders a fixed-position summon button.
+ * The client half therefore mounts this entry straight onto 'document.body'
+ * (see index.ts): while visible it renders the floating PetSprite (a
+ * portal), while hidden it renders a fixed-position summon button. Which
+ * sprite renders is decided by the host snapshot's pet id resolved against
+ * the registry list — no per-pet component exists.
  * @module @linxin666/dsh-pet/client/PetDockEntry
  */
 import { type ReactElement } from 'react';
@@ -14,21 +16,21 @@ import type { PetStoreInstance } from './pet-store.ts';
 import { NS } from './locales.ts';
 /** Injected actions handed to the dock entry component. */
 export interface PetInjected {
-    /** The app-wide pet store instance (snapshot + feedback). */
+    /** The app-wide pet store instance (snapshot + registry list + feedback). */
     store: PetStoreInstance;
-    /** Ensure the first snapshot is fetched (called on mount). */
+    /** Ensure the first snapshot (and registry list) is fetched (called on mount). */
     ensure: () => void;
-    /** Pet the whale girl (click). */
+    /** Pet the sprite (click). */
     pet: () => void;
-    /** Feed the whale girl. */
+    /** Feed the sprite. */
     feed: () => void;
-    /** Hide the whale girl. */
+    /** Hide the sprite. */
     hide: () => void;
-    /** Summon the hidden whale girl back. */
+    /** Summon the hidden sprite back. */
     summon: () => void;
     /** Persist a drag position. */
     dragEnd: (right: number, bottom: number) => void;
-    /** Rename the pet (persisted by the host). */
+    /** Rename the selected pet (persisted by the host). */
     rename: (name: string) => void;
     /** Clear the reaction bubble. */
     feedbackDone: () => void;
@@ -36,7 +38,7 @@ export interface PetInjected {
 /** Composed props of the global pet entry (locale + injected; no slot runtime share). */
 export type PetDockEntryProps = PetInjected & PropsLocale<typeof NS>;
 /**
- * Dock entry: while the pet is visible, mount the floating WhalePet (it
+ * Dock entry: while the pet is visible, mount the floating PetSprite (it
  * portals itself onto document.body); while hidden, render the summon
  * button so the pet can always come back. The store is the plugin-owned
  * single instance — the slot system provides none because the pet is

package/lib/types/client/PetDockEntry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PetDockEntry.d.ts","sourceRoot":"","sources":["../../../src/client/PetDockEntry.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAmC,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAEnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAGjC,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,KAAK,EAAE,gBAAgB,CAAA;IACvB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,kCAAkC;IAClC,GAAG,EAAE,MAAM,IAAI,CAAA;IACf,2BAA2B;IAC3B,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,yCAAyC;IACzC,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,+BAA+B;IAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAChD,8CAA8C;IAC9C,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,iCAAiC;IACjC,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB;AAED,yFAAyF;AACzF,MAAM,MAAM,iBAAiB,GAC3B,WAAW,GACT,WAAW,CAAC,OAAO,EAAE,CAAC,CAAA;AAI1B;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CA8CnE"}
+{"version":3,"file":"PetDockEntry.d.ts","sourceRoot":"","sources":["../../../src/client/PetDockEntry.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAmC,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAEnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAGjC,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,KAAK,EAAE,gBAAgB,CAAA;IACvB,kFAAkF;IAClF,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,8BAA8B;IAC9B,GAAG,EAAE,MAAM,IAAI,CAAA;IACf,uBAAuB;IACvB,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,uBAAuB;IACvB,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,qCAAqC;IACrC,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,+BAA+B;IAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAChD,uDAAuD;IACvD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,iCAAiC;IACjC,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB;AAED,yFAAyF;AACzF,MAAM,MAAM,iBAAiB,GAC3B,WAAW,GACT,WAAW,CAAC,OAAO,EAAE,CAAC,CAAA;AAI1B;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAoDnE"}

package/lib/types/client/PetDockEntry.js

@@ -1,20 +1,22 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * Global floating pet entry. The pet is host-global (its state, display and
- * interactions live on `/api/pet/*` endpoints with no session dimension), so
+ * interactions live on '/api/pet/*' endpoints with no session dimension), so
  * it must not ride a session-scoped slot — on the new-conversation screen no
  * session exists to scope a slot by, and the pet would vanish (issue #48).
- * The client half therefore mounts this entry straight onto `document.body`
- * (see index.ts): while visible it renders the floating WhalePet (a portal),
- * while hidden it renders a fixed-position summon button.
+ * The client half therefore mounts this entry straight onto 'document.body'
+ * (see index.ts): while visible it renders the floating PetSprite (a
+ * portal), while hidden it renders a fixed-position summon button. Which
+ * sprite renders is decided by the host snapshot's pet id resolved against
+ * the registry list — no per-pet component exists.
  * @module @linxin666/dsh-pet/client/PetDockEntry
  */
 import { useEffect, useSyncExternalStore } from 'react';
-import { WhalePet } from "./WhalePet.js";
+import { PetSprite } from "./PetSprite.js";
 import styles from './pet.module.css';
 const DEFAULT_DISPLAY = { visible: true, size: 160, right: 24, bottom: 20 };
 /**
- * Dock entry: while the pet is visible, mount the floating WhalePet (it
+ * Dock entry: while the pet is visible, mount the floating PetSprite (it
  * portals itself onto document.body); while hidden, render the summon
  * button so the pet can always come back. The store is the plugin-owned
  * single instance — the slot system provides none because the pet is
@@ -25,12 +27,15 @@ export function PetDockEntry(props) {
     const ui = useSyncExternalStore(store.subscribe, store.getSnapshot);
     const snapshot = ui.snapshot;
     const feedback = ui.feedback;
+    const definition = ui.pets.find(entry => entry.id === snapshot?.pet.id) ?? null;
     const visible = snapshot?.display.visible ?? true;
     useEffect(() => {
         ensure();
     }, [ensure]);
     if (visible) {
-        return (_jsx("span", { "data-pet-dock": true, "data-testid": "pet-dock", children: _jsx(WhalePet, { snapshot: snapshot, display: snapshot?.display ?? DEFAULT_DISPLAY, feedback: feedback, onPet: props.pet, onFeed: props.feed, onHide: props.hide, onDragEnd: props.dragEnd, onRename: props.rename, onFeedbackDone: props.feedbackDone, t: props.t }) }));
+        return (_jsx("span", { "data-pet-dock": true, "data-testid": "pet-dock", children: snapshot === null || definition === null
+                ? null
+                : (_jsx(PetSprite, { snapshot: snapshot, definition: definition, display: snapshot.display, feedback: feedback, onPet: props.pet, onFeed: props.feed, onHide: props.hide, onDragEnd: props.dragEnd, onRename: props.rename, onFeedbackDone: props.feedbackDone, t: props.t })) }));
     }
     const display = snapshot?.display ?? DEFAULT_DISPLAY;
     return (_jsx("button", { type: "button", className: styles.summon, style: {
@@ -38,5 +43,5 @@ export function PetDockEntry(props) {
             right: display.right,
             bottom: display.bottom,
             zIndex: 2147483000,
-        }, onClick: props.summon, "data-testid": "pet-summon", children: props.t('pet.summon', { name: snapshot?.name ?? '鲸鱼娘' }) }));
+        }, onClick: props.summon, "data-testid": "pet-summon", children: props.t('pet.summon', { name: snapshot?.name ?? '' }) }));
 }

package/lib/types/client/PetSettingsCard.d.ts

@@ -1,7 +1,9 @@
 /**
- * The pet settings card: display layout and name, bound to the `pet` settings
- * namespace the host plugin registers. Registered into the
- * `settings.plugin.item` slot the plugin-configuration section renders.
+ * The pet settings card: pet selection plus display layout, bound to the
+ * 'pet' settings namespace the host plugin registers. Registered into the
+ * 'web-ui.plugin.item' slot the plugin-configuration section renders. The
+ * petId choices come from the registry endpoint ('/api/pet/pets') — the same
+ * list the sprite renders from — so the card carries no per-pet knowledge.
  */
 import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import type { SettingsScope, SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
@@ -18,8 +20,8 @@ export interface PetSettings {
     right?: number;
     /** Vertical inset from the viewport bottom edge, px. */
     bottom?: number;
-    /** User-customizable pet display name. */
-    name?: string;
+    /** Selected pet id (a registry entry). */
+    petId?: string;
 }
 /** What the pet settings card renders. */
 export interface PetSettingsCardState extends CardShell {
@@ -33,8 +35,13 @@ export interface PetSettingsCardState extends CardShell {
     right: CardFieldState;
     /** Bottom inset. */
     bottom: CardFieldState;
-    /** Pet name. */
-    name: CardFieldState;
+    /** Selected pet. */
+    petId: CardFieldState;
+    /** Pet choices (registry ids + display names), loaded from the host. */
+    petChoices: readonly {
+        value: string;
+        label: string;
+    }[];
 }
 /** The registration-side face the card's slot entry injects. */
 export interface PetSettingsCardFace extends CardActions {
@@ -43,12 +50,18 @@ export interface PetSettingsCardFace extends CardActions {
         petSettingsCard: SnapshotStore<PetSettingsCardState>;
     };
 }
-/** Bridges the `pet` scope onto the card's staged form. */
+/** Bridges the 'pet' scope onto the card's staged form. */
 export declare class PetSettingsCardController {
     private readonly form;
     private readonly store;
-    /** @param scope - the bound settings scope for the `pet` namespace. */
+    private readonly petChoices;
+    private readonly petLabels;
+    private loaded;
+    private attempts;
+    /** @param scope - the bound settings scope for the 'pet' namespace. */
     constructor(scope: SettingsScope<PetSettings>);
+    /** Resolve the registry choices once (retried a few times on failure). */
+    private loadPets;
     private projection;
     /**
      * Build the face the card's slot registration injects.

package/lib/types/client/PetSettingsCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PetSettingsCard.d.ts","sourceRoot":"","sources":["../../../src/client/PetSettingsCard.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAC7F,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAE1F,OAAO,EAAkD,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,IAAI,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExJ,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qBAAqB;IACrB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,0CAA0C;AAC1C,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,4BAA4B;IAC5B,OAAO,EAAE,cAAc,CAAA;IACvB,qBAAqB;IACrB,OAAO,EAAE,cAAc,CAAA;IACvB,iBAAiB;IACjB,IAAI,EAAE,cAAc,CAAA;IACpB,mBAAmB;IACnB,KAAK,EAAE,cAAc,CAAA;IACrB,oBAAoB;IACpB,MAAM,EAAE,cAAc,CAAA;IACtB,gBAAgB;IAChB,IAAI,EAAE,cAAc,CAAA;CACrB;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,KAAK,EAAE;QACL,iEAAiE;QACjE,eAAe,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAA;KACrD,CAAA;CACF;AAED,2DAA2D;AAC3D,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAE3D,uEAAuE;gBAC3D,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC;IAY7C,OAAO,CAAC,UAAU;IAYlB;;;OAGG;IACH,MAAM,IAAI,mBAAmB;CAG9B;AAED,0DAA0D;AAC1D,MAAM,MAAM,oBAAoB,GAC9B,YAAY,CAAC,oBAAoB,CAAC,GAChC,WAAW,CAAC,KAAK,CAAC,GAClB,UAAU,CAAC,mBAAmB,CAAC,CAAA;AAEnC;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,+BAoF1D"}
+{"version":3,"file":"PetSettingsCard.d.ts","sourceRoot":"","sources":["../../../src/client/PetSettingsCard.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAC7F,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAE1F,OAAO,EAAoD,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,IAAI,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAE1J,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qBAAqB;IACrB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,0CAA0C;AAC1C,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,4BAA4B;IAC5B,OAAO,EAAE,cAAc,CAAA;IACvB,qBAAqB;IACrB,OAAO,EAAE,cAAc,CAAA;IACvB,iBAAiB;IACjB,IAAI,EAAE,cAAc,CAAA;IACpB,mBAAmB;IACnB,KAAK,EAAE,cAAc,CAAA;IACrB,oBAAoB;IACpB,MAAM,EAAE,cAAc,CAAA;IACtB,oBAAoB;IACpB,KAAK,EAAE,cAAc,CAAA;IACrB,wEAAwE;IACxE,UAAU,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CACxD;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,KAAK,EAAE;QACL,iEAAiE;QACjE,eAAe,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAA;KACrD,CAAA;CACF;AAeD,2DAA2D;AAC3D,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAI3D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAI;IAEpB,uEAAuE;gBAC3D,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC;IAa7C,0EAA0E;YAC5D,QAAQ;IAgBtB,OAAO,CAAC,UAAU;IAalB;;;OAGG;IACH,MAAM,IAAI,mBAAmB;CAG9B;AAED,0DAA0D;AAC1D,MAAM,MAAM,oBAAoB,GAC9B,YAAY,CAAC,oBAAoB,CAAC,GAChC,WAAW,CAAC,KAAK,CAAC,GAClB,UAAU,CAAC,mBAAmB,CAAC,CAAA;AAEnC;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,+BAsF1D"}

package/lib/types/client/PetSettingsCard.js

@@ -1,11 +1,25 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { PluginSettingsCard, ValueField, BooleanField } from "./PluginSettingsCard.js";
-import { CardForm, booleanField, numberField, textField } from "./settings-form.js";
-/** Bridges the `pet` scope onto the card's staged form. */
+import { PluginSettingsCard, ValueField, BooleanField, ChoiceField } from "./PluginSettingsCard.js";
+import { CardForm, booleanField, choiceField, numberField } from "./settings-form.js";
+/** Fetch the registry list (the same data the sprite renders from). */
+async function fetchPetChoices() {
+    const response = await fetch('/api/pet/pets');
+    if (!response.ok)
+        throw new Error('pet pets failed: ' + response.status);
+    return (await response.json());
+}
+/** Bridges the 'pet' scope onto the card's staged form. */
 export class PetSettingsCardController {
     form;
     store;
-    /** @param scope - the bound settings scope for the `pet` namespace. */
+    // The choice list rides a mutable array shared with the choiceField spec,
+    // so loading the registry re-validates and re-formats the petId field
+    // without rebuilding the form.
+    petChoices = [];
+    petLabels = new Map();
+    loaded = false;
+    attempts = 0;
+    /** @param scope - the bound settings scope for the 'pet' namespace. */
     constructor(scope) {
         this.form = new CardForm(scope, [
             booleanField('enabled'),
@@ -13,9 +27,29 @@ export class PetSettingsCardController {
             numberField('size'),
             numberField('right'),
             numberField('bottom'),
-            textField('name'),
+            choiceField('petId', this.petChoices),
         ]);
         this.store = this.form.bind(() => this.projection());
+        void this.loadPets();
+    }
+    /** Resolve the registry choices once (retried a few times on failure). */
+    async loadPets() {
+        if (this.loaded)
+            return;
+        try {
+            const list = await fetchPetChoices();
+            this.petChoices.splice(0, this.petChoices.length, ...list.map(choice => choice.id));
+            for (const choice of list)
+                this.petLabels.set(choice.id, choice.displayName);
+            this.loaded = true;
+            this.store.set(this.projection());
+        }
+        catch {
+            this.attempts += 1;
+            if (this.attempts < 3) {
+                window.setTimeout(() => { void this.loadPets(); }, 3000);
+            }
+        }
     }
     projection() {
         return {
@@ -25,7 +59,8 @@ export class PetSettingsCardController {
             size: this.form.field('size'),
             right: this.form.field('right'),
             bottom: this.form.field('bottom'),
-            name: this.form.field('name'),
+            petId: this.form.field('petId'),
+            petChoices: this.petChoices.map(id => ({ value: id, label: this.petLabels.get(id) ?? id })),
         };
     }
     /**
@@ -51,5 +86,5 @@ export function PetSettingsCard(props) {
         invalidLabel: t('settings.invalidNumber'),
         disabled,
     };
-    return (_jsxs(PluginSettingsCard, { t: t, titleKey: "settings.title", descriptionKey: "settings.description", state: state, onSave: props.save, onDiscard: props.discard, children: [_jsx(BooleanField, { id: "settings-pet-enabled", label: t('settings.enabled'), hint: t('settings.enabledHint'), inheritLabel: t('settings.inherit'), onLabel: t('settings.on'), offLabel: t('settings.off'), ...fieldProps, ...state.enabled, onEdit: (text) => { props.edit('enabled', text); }, onReset: () => { props.resetField('enabled'); } }), _jsx(BooleanField, { id: "settings-pet-visible", label: t('settings.visible'), hint: t('settings.visibleHint'), inheritLabel: t('settings.inherit'), onLabel: t('settings.on'), offLabel: t('settings.off'), ...fieldProps, ...state.visible, onEdit: (text) => { props.edit('visible', text); }, onReset: () => { props.resetField('visible'); } }), _jsx(ValueField, { id: "settings-pet-size", label: t('settings.size'), hint: t('settings.sizeHint'), numeric: true, ...fieldProps, ...state.size, onEdit: (text) => { props.edit('size', text); }, onReset: () => { props.resetField('size'); } }), _jsx(ValueField, { id: "settings-pet-right", label: t('settings.right'), hint: t('settings.rightHint'), numeric: true, ...fieldProps, ...state.right, onEdit: (text) => { props.edit('right', text); }, onReset: () => { props.resetField('right'); } }), _jsx(ValueField, { id: "settings-pet-bottom", label: t('settings.bottom'), hint: t('settings.bottomHint'), numeric: true, ...fieldProps, ...state.bottom, onEdit: (text) => { props.edit('bottom', text); }, onReset: () => { props.resetField('bottom'); } }), _jsx(ValueField, { id: "settings-pet-name", label: t('settings.name'), hint: t('settings.nameHint'), ...fieldProps, ...state.name, onEdit: (text) => { props.edit('name', text); }, onReset: () => { props.resetField('name'); } })] }));
+    return (_jsxs(PluginSettingsCard, { t: t, titleKey: "settings.title", descriptionKey: "settings.description", state: state, onSave: props.save, onDiscard: props.discard, children: [_jsx(BooleanField, { id: "settings-pet-enabled", label: t('settings.enabled'), hint: t('settings.enabledHint'), inheritLabel: t('settings.inherit'), onLabel: t('settings.on'), offLabel: t('settings.off'), ...fieldProps, ...state.enabled, onEdit: (text) => { props.edit('enabled', text); }, onReset: () => { props.resetField('enabled'); } }), _jsx(ChoiceField, { id: "settings-pet-pet", label: t('settings.pet'), hint: t('settings.petHint'), inheritLabel: t('settings.inherit'), ...fieldProps, ...state.petId, choices: state.petChoices, onEdit: (text) => { props.edit('petId', text); }, onReset: () => { props.resetField('petId'); } }), _jsx(BooleanField, { id: "settings-pet-visible", label: t('settings.visible'), hint: t('settings.visibleHint'), inheritLabel: t('settings.inherit'), onLabel: t('settings.on'), offLabel: t('settings.off'), ...fieldProps, ...state.visible, onEdit: (text) => { props.edit('visible', text); }, onReset: () => { props.resetField('visible'); } }), _jsx(ValueField, { id: "settings-pet-size", label: t('settings.size'), hint: t('settings.sizeHint'), numeric: true, ...fieldProps, ...state.size, onEdit: (text) => { props.edit('size', text); }, onReset: () => { props.resetField('size'); } }), _jsx(ValueField, { id: "settings-pet-right", label: t('settings.right'), hint: t('settings.rightHint'), numeric: true, ...fieldProps, ...state.right, onEdit: (text) => { props.edit('right', text); }, onReset: () => { props.resetField('right'); } }), _jsx(ValueField, { id: "settings-pet-bottom", label: t('settings.bottom'), hint: t('settings.bottomHint'), numeric: true, ...fieldProps, ...state.bottom, onEdit: (text) => { props.edit('bottom', text); }, onReset: () => { props.resetField('bottom'); } })] }));
 }

package/lib/types/client/{WhalePet.d.ts → PetSprite.d.ts}

@@ -1,38 +1,39 @@
 /**
- * Whale-girl companion component — the browser half's centerpiece. Renders a
+ * Pet sprite companion component — the browser half's centerpiece. Renders a
  * fixed-position floating sprite (React portal onto document.body), plays
- * the spritesheet track matching the host animation snapshot, and exposes
- * the interaction surface: click to pet, hover panel with feed/hide, drag to
- * reposition (persisted via setConfig).
- * @module @linxin666/dsh-pet/client/WhalePet
+ * the track matching the host animation snapshot, and exposes the
+ * interaction surface: click to pet, hover panel with feed/rename/hide, drag
+ * to reposition (persisted via setConfig). Everything visual comes from the
+ * pet definition the host serves ('/api/pet/pets' + the state snapshot's
+ * pet id), so one component renders every registry entry.
+ * @module @linxin666/dsh-pet/client/PetSprite
  */
 import type { ReactPortal } from 'react';
 import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
 import type { PetDisplayConfig } from '../persist.ts';
 import type { PetStateView } from '../service.ts';
+import type { PetDefinition } from '../registry.ts';
 import type { PetFeedback } from './pet-store.ts';
 import { NS } from './locales.ts';
-/** Browser URL of the whale-girl atlas (served by the host half's own route). */
-export declare const PET_SPRITESHEET_URL = "/pet/whale/spritesheet.webp";
-/** Browser URL of the whale-girl manifest (authoritative per-row frame counts). */
-export declare const PET_MANIFEST_URL = "/pet/whale/pet.json";
-/** Props injected by the slot registration (store actions + locale). */
-export interface WhalePetProps {
+/** Props injected by the plugin apply body (store actions + locale). */
+export interface PetSpriteProps {
     /** Latest host snapshot; null while loading. */
     snapshot: PetStateView | null;
+    /** The selected pet's registry definition (atlas URL + geometry + tracks). */
+    definition: PetDefinition;
     /** Display configuration (persisted by the host). */
     display: PetDisplayConfig;
     /** Active reaction bubble, if any. */
     feedback: PetFeedback | null;
-    /** Pet the whale girl (click). */
+    /** Pet the sprite (click). */
     onPet: () => void;
-    /** Feed the whale girl (panel button). */
+    /** Feed the sprite (panel button). */
     onFeed: () => void;
-    /** Hide the whale girl (panel button). */
+    /** Hide the sprite (panel button). */
     onHide: () => void;
     /** Persist a drag position. */
     onDragEnd: (right: number, bottom: number) => void;
-    /** Rename the pet (persisted by the host). */
+    /** Rename the selected pet (persisted by the host). */
     onRename: (name: string) => void;
     /** Clear the reaction bubble (after its CSS animation). */
     onFeedbackDone: () => void;
@@ -41,9 +42,9 @@ export interface WhalePetProps {
 }
 /**
  * The floating pet. The spritesheet frame advances on requestAnimationFrame
- * with per-frame durations from TRACKS; the atlas image is loaded once and
- * the background position is written straight to the sprite element (no
- * per-frame React state).
+ * with per-frame durations from the definition's tracks; the atlas image is
+ * loaded once and the background position is written straight to the sprite
+ * element (no per-frame React state).
  */
-export declare function WhalePet(props: WhalePetProps): ReactPortal;
-//# sourceMappingURL=WhalePet.d.ts.map
+export declare function PetSprite(props: PetSpriteProps): ReactPortal;
+//# sourceMappingURL=PetSprite.d.ts.map

package/lib/types/client/PetSprite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PetSprite.d.ts","sourceRoot":"","sources":["../../../src/client/PetSprite.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAqC,WAAW,EAAE,MAAM,OAAO,CAAA;AAG3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAGjD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAGjC,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;IAC7B,8EAA8E;IAC9E,UAAU,EAAE,aAAa,CAAA;IACzB,qDAAqD;IACrD,OAAO,EAAE,gBAAgB,CAAA;IACzB,sCAAsC;IACtC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAA;IAC5B,8BAA8B;IAC9B,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,sCAAsC;IACtC,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,sCAAsC;IACtC,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,+BAA+B;IAC/B,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAClD,uDAAuD;IACvD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,2DAA2D;IAC3D,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B,+CAA+C;IAC/C,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CAAA;CAC1B;AAOD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,WAAW,CAuS5D"}