@linxin666/dsh-pet 0.3.17 → 0.3.19

package/lib/index.js

@@ -1356,6 +1356,7 @@ const defaultDisplayConfig = {
 	right: 24,
 	bottom: 120
 };
+const DISPLAY_SIZE_MAX = 1024;
 const DISPLAY_INSET_MAX = 1e4;
 /** Name constraints. */
 const PET_NAME_MAX_LENGTH = 20;
@@ -1452,7 +1453,7 @@ function loadPetPersist(dir = petHomeDir()) {
 		const rawDisplay = parsed.display ?? {};
 		const display = {
 			visible: typeof rawDisplay.visible === "boolean" ? rawDisplay.visible : base.display.visible,
-			size: Math.round(Math.min(512, Math.max(32, finiteNum(rawDisplay.size, base.display.size)))),
+			size: Math.round(Math.min(DISPLAY_SIZE_MAX, Math.max(32, finiteNum(rawDisplay.size, base.display.size)))),
 			right: Math.round(clamp(finiteNum(rawDisplay.right, base.display.right), DISPLAY_INSET_MAX)),
 			bottom: Math.round(clamp(finiteNum(rawDisplay.bottom, base.display.bottom), DISPLAY_INSET_MAX))
 		};
@@ -2442,7 +2443,8 @@ const KNOWN_FRAMES2D = /* @__PURE__ */ new Set([
 	"dir",
 	"defaultFrameMs",
 	"tracks",
-	"phases"
+	"phases",
+	"skins"
 ]);
 /** frames2d track field allow-list (drift-locked to the schema file). */
 const KNOWN_FRAMES2D_TRACK = /* @__PURE__ */ new Set([
@@ -2451,6 +2453,33 @@ const KNOWN_FRAMES2D_TRACK = /* @__PURE__ */ new Set([
 	"loop",
 	"fallback"
 ]);
+/** frames2d skin entry field allow-list (drift-locked to the schema file). */
+const KNOWN_SKIN = /* @__PURE__ */ new Set([
+	"id",
+	"label",
+	"idleTrack",
+	"clickActions",
+	"gameplayTracks"
+]);
+/** frames2d skin click-action field allow-list (drift-locked to the schema file). */
+const KNOWN_SKIN_CLICK = /* @__PURE__ */ new Set([
+	"track",
+	"probability",
+	"phrases"
+]);
+/** Max spoken lines one skin click action may declare. */
+const SKIN_CLICK_MAX_PHRASES = 5;
+/** Max length of one spoken line. */
+const SKIN_CLICK_PHRASE_MAX_LENGTH = 120;
+/** Validate a skin click action's optional phrase pool (same spirit as gameplay phrases). */
+function parseSkinPhrases(raw, field, diag) {
+	if (raw === void 0) return void 0;
+	if (!Array.isArray(raw) || raw.length === 0 || raw.length > SKIN_CLICK_MAX_PHRASES || raw.some((line) => typeof line !== "string" || line.trim() === "" || line.length > SKIN_CLICK_PHRASE_MAX_LENGTH)) {
+		diag.error(field + " must be 1..5 non-empty lines of at most 120 chars");
+		return;
+	}
+	return raw;
+}
 var Diagnostics$1 = class {
 	list = [];
 	source;
@@ -2695,6 +2724,100 @@ function parseFrames2dBlock(raw, diag) {
 		for (const [phase, target] of Object.entries(block.phases)) if (target !== void 0 && tracks[target] === void 0) diag.error("frames2d.phases." + phase + " references unknown track " + JSON.stringify(target));
 	}
 	for (const [name, track] of Object.entries(tracks)) if (track.fallback !== void 0 && tracks[track.fallback] === void 0) diag.error("frames2d.tracks." + name + ".fallback references unknown track " + JSON.stringify(track.fallback));
+	if (raw.skins !== void 0) if (!Array.isArray(raw.skins) || raw.skins.length === 0 || raw.skins.length > 16) diag.error("frames2d.skins must be an array of 1..16 skins");
+	else {
+		const skins = [];
+		const seen = /* @__PURE__ */ new Set();
+		for (const [index, entry] of raw.skins.entries()) {
+			const field = "frames2d.skins[" + index + "]";
+			if (!isRecord$1(entry)) {
+				diag.error(field + " must be an object");
+				continue;
+			}
+			const extra = unknownKeys$1(entry, KNOWN_SKIN);
+			if (extra.length > 0) diag.error(field + ": unknown field(s) " + extra.map((k) => JSON.stringify(k)).join(", "));
+			const id = typeof entry.id === "string" ? entry.id.trim() : "";
+			if (id === "" || id.length > 24 || !FRAMES2D_TRACK_NAME.test(id)) {
+				diag.error(field + ".id must be a lowercase kebab id of at most 24 chars");
+				continue;
+			}
+			if (seen.has(id)) {
+				diag.error(field + ": duplicate skin id " + JSON.stringify(id));
+				continue;
+			}
+			seen.add(id);
+			const label = typeof entry.label === "string" ? entry.label.trim() : "";
+			if (label === "" || label.length > 40) {
+				diag.error(field + ".label must be a non-empty string of at most 40 chars");
+				continue;
+			}
+			const idleTrack = typeof entry.idleTrack === "string" ? entry.idleTrack : "";
+			if (!validTrackName(idleTrack) || tracks[idleTrack] === void 0) {
+				diag.error(field + ".idleTrack must name a declared frames2d track");
+				continue;
+			}
+			let clickActions;
+			if (entry.clickActions !== void 0) if (!Array.isArray(entry.clickActions) || entry.clickActions.length === 0 || entry.clickActions.length > 8) diag.error(field + ".clickActions must be an array of 1..8 actions");
+			else {
+				const resolved = [];
+				for (const [cIndex, action] of entry.clickActions.entries()) {
+					const cField = field + ".clickActions[" + cIndex + "]";
+					if (!isRecord$1(action)) {
+						diag.error(cField + " must be an object");
+						continue;
+					}
+					const cExtra = unknownKeys$1(action, KNOWN_SKIN_CLICK);
+					if (cExtra.length > 0) diag.error(cField + ": unknown field(s) " + cExtra.map((k) => JSON.stringify(k)).join(", "));
+					const trackName = typeof action.track === "string" ? action.track : "";
+					if (!validTrackName(trackName) || tracks[trackName] === void 0) {
+						diag.error(cField + ".track must name a declared frames2d track");
+						continue;
+					}
+					if (typeof action.probability !== "number" || !Number.isFinite(action.probability) || action.probability <= 0 || action.probability > 1) {
+						diag.error(cField + ".probability must be a number in (0, 1]");
+						continue;
+					}
+					const phrases = parseSkinPhrases(action.phrases, cField + ".phrases", diag);
+					resolved.push({
+						track: trackName,
+						probability: action.probability,
+						...phrases === void 0 ? {} : { phrases }
+					});
+				}
+				if (resolved.length > 0) clickActions = resolved;
+			}
+			let gameplayTracks;
+			if (entry.gameplayTracks !== void 0) if (!isRecord$1(entry.gameplayTracks)) diag.error(field + ".gameplayTracks must be an object mapping gameplay state names to tracks");
+			else {
+				const states = Object.keys(entry.gameplayTracks);
+				if (states.length === 0 || states.length > 8) diag.error(field + ".gameplayTracks must map 1..8 gameplay states");
+				else {
+					const resolvedTracks = {};
+					for (const state of states) {
+						if (!/^[a-z0-9][a-z0-9-]*$/.test(state)) {
+							diag.error(field + ".gameplayTracks key " + JSON.stringify(state) + " must be a lowercase kebab state name");
+							continue;
+						}
+						const gTrack = entry.gameplayTracks[state];
+						if (typeof gTrack !== "string" || !validTrackName(gTrack) || tracks[gTrack] === void 0) {
+							diag.error(field + ".gameplayTracks[" + JSON.stringify(state) + "] must name a declared frames2d track");
+							continue;
+						}
+						resolvedTracks[state] = gTrack;
+					}
+					if (Object.keys(resolvedTracks).length > 0) gameplayTracks = resolvedTracks;
+				}
+			}
+			skins.push({
+				id,
+				label,
+				idleTrack,
+				...clickActions === void 0 ? {} : { clickActions },
+				...gameplayTracks === void 0 ? {} : { gameplayTracks }
+			});
+		}
+		if (skins.length > 0) block.skins = skins;
+	}
 	return diag.hasErrors ? void 0 : block;
 }
 /** v1 compat read: map the legacy flat manifest onto the v2 sprite2d shape. */
@@ -3685,6 +3808,46 @@ function resolveFrames2dEntry(manifest, dir, options) {
 		record("warning", "pet " + manifest.id + ": frames2d phase " + phase + " maps to dropped track " + JSON.stringify(target) + "; using idle");
 		phases[phase] = idleTrack;
 	}
+	let skins;
+	if (block.skins !== void 0) {
+		const resolved = [];
+		for (const skin of block.skins) {
+			if (tracks[skin.idleTrack] === void 0) {
+				record("warning", "pet " + manifest.id + ": frames2d skin " + JSON.stringify(skin.id) + " idleTrack dropped; skipping");
+				continue;
+			}
+			let clickActions;
+			if (skin.clickActions !== void 0) {
+				const kept = [];
+				for (const action of skin.clickActions) {
+					if (tracks[action.track] === void 0) {
+						record("warning", "pet " + manifest.id + ": frames2d skin " + JSON.stringify(skin.id) + " click action track " + JSON.stringify(action.track) + " dropped");
+						continue;
+					}
+					kept.push(action);
+				}
+				if (kept.length > 0) clickActions = kept;
+			}
+			let gameplayTracks;
+			if (skin.gameplayTracks !== void 0) {
+				const kept = {};
+				for (const [state, gTrack] of Object.entries(skin.gameplayTracks)) {
+					if (tracks[gTrack] === void 0) {
+						record("warning", "pet " + manifest.id + ": frames2d skin " + JSON.stringify(skin.id) + " gameplay track override " + JSON.stringify(state) + " -> " + JSON.stringify(gTrack) + " dropped");
+						continue;
+					}
+					kept[state] = gTrack;
+				}
+				if (Object.keys(kept).length > 0) gameplayTracks = kept;
+			}
+			resolved.push({
+				...skin,
+				...clickActions === void 0 ? {} : { clickActions },
+				...gameplayTracks === void 0 ? {} : { gameplayTracks }
+			});
+		}
+		if (resolved.length > 0) skins = resolved;
+	}
 	const remarks = normalizePetRemarks(manifest.remarks, (message) => record("warning", "pet " + manifest.id + ": " + message));
 	let gameplay;
 	if (manifest.gameplay !== void 0) {
@@ -3729,7 +3892,8 @@ function resolveFrames2dEntry(manifest, dir, options) {
 		renderer: "frames2d",
 		frames2d: {
 			tracks,
-			phases
+			phases,
+			...skins === void 0 ? {} : { skins }
 		},
 		...gameplay === void 0 ? {} : { gameplay },
 		cell,
@@ -4618,7 +4782,7 @@ var PetService = class extends Service {
 			...this.ledger.snapshot.display,
 			...patch
 		};
-		next.size = Math.round(Math.min(512, Math.max(32, next.size)));
+		next.size = Math.round(Math.min(DISPLAY_SIZE_MAX, Math.max(32, next.size)));
 		next.right = Math.round(Math.min(DISPLAY_INSET_MAX, Math.max(0, next.right)));
 		next.bottom = Math.round(Math.min(DISPLAY_INSET_MAX, Math.max(0, next.bottom)));
 		this.ledger.setDisplay(next);
@@ -4662,7 +4826,7 @@ var PetService = class extends Service {
 		} else if (section.petId !== void 0) this.syncSettingsFromPet();
 		const next = { ...this.ledger.snapshot.display };
 		next.visible = section.visible && (section.enabled ?? true);
-		next.size = Math.round(Math.min(512, Math.max(32, section.size)));
+		next.size = Math.round(Math.min(DISPLAY_SIZE_MAX, Math.max(32, section.size)));
 		next.right = Math.round(Math.min(DISPLAY_INSET_MAX, Math.max(0, section.right)));
 		next.bottom = Math.round(Math.min(DISPLAY_INSET_MAX, Math.max(0, section.bottom)));
 		this.ledger.setDisplay(next);
@@ -5528,7 +5692,7 @@ const inject = ["webServer"];
 function makePetSettingsSchema(fallbackPetId) {
 	return z.object({
 		visible: z.boolean().default(true),
-		size: z.number().step(1).min(32).max(512).default(160),
+		size: z.number().step(1).min(32).max(DISPLAY_SIZE_MAX).default(160),
 		right: z.number().step(1).min(0).max(DISPLAY_INSET_MAX).default(24),
 		bottom: z.number().step(1).min(0).max(DISPLAY_INSET_MAX).default(20),
 		petId: z.string().default(fallbackPetId),

package/lib/types/client/gameplay-hud.d.ts

@@ -30,6 +30,8 @@ export interface GameplayApi {
  */
 export interface GameplayBus {
     setTrack?: (track?: string) => void;
+    /** Swap the pet's base idle track (skin switch); undefined restores default. */
+    setIdleTrack?: (track?: string) => void;
     tap?: (fx: number, fy: number) => void;
     /**
      * Card open/close request from the chrome (the hover panel's 玩法 action):

package/lib/types/client/gameplay-hud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gameplay-hud.d.ts","sourceRoot":"","sources":["../../../src/client/gameplay-hud.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAsE,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AAC7G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAE1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAGtC,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;IACxD,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAC1E,QAAQ,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAC9C,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;CACtD;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CACpC;AAYD,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,UAAU,EAAE,aAAa,CAAA;IACzB,KAAK,EAAE,gBAAgB,CAAA;IACvB,GAAG,EAAE,WAAW,CAAA;IAChB,GAAG,EAAE,WAAW,CAAA;IAChB,IAAI,EAAE,UAAU,CAAA;IAChB,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;CAC/B,GAAG,YAAY,GAAG,IAAI,CAkVtB"}
+{"version":3,"file":"gameplay-hud.d.ts","sourceRoot":"","sources":["../../../src/client/gameplay-hud.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAsE,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AAC7G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,KAAK,EAAE,aAAa,EAAqB,MAAM,gBAAgB,CAAA;AACtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAE1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAGtC,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;IACxD,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAC1E,QAAQ,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAC9C,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;CACtD;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,gFAAgF;IAChF,YAAY,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CACpC;AAYD,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,UAAU,EAAE,aAAa,CAAA;IACzB,KAAK,EAAE,gBAAgB,CAAA;IACvB,GAAG,EAAE,WAAW,CAAA;IAChB,GAAG,EAAE,WAAW,CAAA;IAChB,IAAI,EAAE,UAAU,CAAA;IAChB,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;CAC/B,GAAG,YAAY,GAAG,IAAI,CAwatB"}

package/lib/types/client/gameplay-hud.js

@@ -22,6 +22,10 @@ export function GameplayHud(props) {
     const phase = ui.snapshot?.phase ?? 'idle';
     const [open, setOpen] = useState(false);
     const [page, setPage] = useState('root');
+    // Currently selected skin id (base idle swap); undefined = default look.
+    const [skinId, setSkinId] = useState(undefined);
+    const skinIdRef = useRef(undefined);
+    skinIdRef.current = skinId;
     const hudRef = useRef(null);
     const cardRef = useRef(null);
     const [floats, setFloats] = useState([]);
@@ -52,9 +56,33 @@ export function GameplayHud(props) {
     // Tap handling (registered on the bus; PetSprite reports sprite-box
     // fractions). Sleep wakes on tap; work blocks taps; a held touch
     // animation turns taps into the plain-click boost.
+    // Skin contract: while a skin is selected, taps only ever play that
+    // skin's own click actions — a miss resolves to the plain click boost,
+    // never the default touch zones (so a skinned pet cannot trigger the
+    // default pet's shy/work reactions).
     useEffect(() => {
         if (def === undefined)
             return undefined;
+        // Play a one-shot override track and lock tap input for its duration so
+        // consecutive taps cannot retrigger mid-play (skin click actions and
+        // default touch-zone reactions share this path).
+        const holdTrack = (track, holdMs) => {
+            bus.setTrack?.(track);
+            touchLockUntilRef.current = Date.now() + holdMs;
+            window.setTimeout(() => {
+                if (Date.now() >= touchLockUntilRef.current)
+                    bus.setTrack?.(undefined);
+            }, holdMs);
+        };
+        const speak = (phrases) => {
+            if (phrases !== undefined && phrases.length > 0) {
+                const phrase = phrases[Math.floor(Math.random() * phrases.length)];
+                store.actions.setFeedback({ text: phrase, kind: 'none', at: Date.now() });
+            }
+        };
+        // Total play time of a track in ms (its fallback lands back in the skin
+        // base idle, so holding the lock for the full loop is unnecessary).
+        const trackDuration = (track) => definition.frames2d?.tracks[track]?.durations.reduce((sum, ms) => sum + ms, 0) ?? 0;
         bus.tap = (fx, fy) => {
             if (modeRef.current === 'sleep') {
                 void api.setMode(null).then(applyResult, () => undefined);
@@ -71,6 +99,29 @@ export function GameplayHud(props) {
                 void api.touch().then(applyResult, () => undefined);
                 return;
             }
+            const activeSkin = definition.frames2d?.skins?.find(skin => skin.id === skinIdRef.current);
+            if (activeSkin !== undefined) {
+                // Skin click actions roll first (declared order, cumulative
+                // probabilities); on a hit play the action's track once. A miss
+                // stays on the plain click boost — never the default touch zones.
+                const actions = activeSkin.clickActions ?? [];
+                if (actions.length > 0) {
+                    let roll = Math.random();
+                    const fired = actions.find(action => {
+                        if (roll < action.probability)
+                            return true;
+                        roll -= action.probability;
+                        return false;
+                    });
+                    if (fired !== undefined) {
+                        holdTrack(fired.track, trackDuration(fired.track) || 3000);
+                        speak(fired.phrases);
+                        return;
+                    }
+                }
+                void api.touch().then(applyResult, () => undefined);
+                return;
+            }
             const zone = def.touch === undefined ? undefined : touchZoneAt(def.touch, hy);
             if (zone === undefined)
                 return;
@@ -78,15 +129,8 @@ export function GameplayHud(props) {
                 applyResult(result);
                 if (result.hit !== true)
                     return;
-                if (result.state !== undefined) {
-                    bus.setTrack?.(result.state);
-                    const holdMs = result.stateMs ?? 3000;
-                    touchLockUntilRef.current = Date.now() + holdMs;
-                    window.setTimeout(() => {
-                        if (Date.now() >= touchLockUntilRef.current)
-                            bus.setTrack?.(undefined);
-                    }, holdMs);
-                }
+                if (result.state !== undefined)
+                    holdTrack(result.state, result.stateMs ?? 3000);
                 if (result.phrase !== undefined) {
                     store.actions.setFeedback({ text: result.phrase, kind: 'none', at: Date.now() });
                 }
@@ -236,14 +280,18 @@ export function GameplayHud(props) {
         // eslint-disable-next-line react-hooks/exhaustive-deps -- the loop keys on the mode value
     }, [definition.id, def, view?.mode]);
     // Sleep loop: hold the sleep track; restore is host-side (lazy settle).
+    // While a skin with a gameplayTracks.sleep override is selected, the skin's
+    // own track replaces the default sleep track (e.g. a skin-specific doze).
     useEffect(() => {
         const sleep = def?.sleep;
         if (def === undefined || sleep === undefined || view?.mode !== 'sleep')
             return undefined;
-        bus.setTrack?.(sleep.state);
+        const skinGameplay = definition.frames2d?.skins?.find(skin => skin.id === skinIdRef.current)?.gameplayTracks;
+        const hold = skinGameplay?.['sleep'] ?? sleep.state;
+        bus.setTrack?.(hold);
         return () => bus.setTrack?.(undefined);
         // eslint-disable-next-line react-hooks/exhaustive-deps -- the loop keys on the mode value
-    }, [definition.id, def, view?.mode]);
+    }, [definition.id, def, view?.mode, skinId]);
     if (def === undefined || view === undefined)
         return null;
     const mode = view.mode;
@@ -267,8 +315,13 @@ export function GameplayHud(props) {
     const setMode = (next) => {
         void api.setMode(next).then(applyResult, () => undefined);
     };
+    const skins = definition.frames2d?.skins;
+    const selectSkin = (skin) => {
+        setSkinId(skin?.id);
+        bus.setIdleTrack?.(skin?.idleTrack);
+    };
     return (_jsxs("div", { ref: hudRef, className: styles.gameplayHud, "data-dsh-pet-gameplay": definition.id, children: [floats.map(entry => (_jsx("div", { className: styles.gameplayFloat, children: entry.text }, entry.id))), mode !== null && (_jsx("div", { className: styles.gameplayModeChip, children: tr(mode === 'work' ? 'pet.gameplay.working' : 'pet.gameplay.sleeping') })), open && (_jsxs("div", { ref: cardRef, className: styles.gameplayCard, "data-page": page, children: [page === 'root' && (_jsxs(_Fragment, { children: [_jsx("div", { className: styles.gameplayBars, children: Object.entries(stats).map(([name, stat]) => {
                                     const value = view.stats[name] ?? 0;
                                     return (_jsxs("div", { className: styles.gameplayBarRow, title: statLabel(name) + ' ' + String(value) + '/' + String(stat.max), children: [_jsx("span", { className: styles.gameplayBarLabel, children: statLabel(name) }), _jsx("span", { className: styles.gameplayBarTrack, children: _jsx("span", { className: styles.gameplayBarFill, style: { width: Math.round((value / stat.max) * 100) + '%' } }) })] }, name));
-                                }) }), _jsxs("div", { className: styles.gameplayActions, children: [def.work !== undefined && (_jsx("button", { type: "button", className: styles.action, onClick: () => setMode(mode === 'work' ? null : 'work'), children: tr(mode === 'work' ? 'pet.gameplay.stopWork' : 'pet.gameplay.work') })), def.sleep !== undefined && (_jsx("button", { type: "button", className: styles.action, onClick: () => setMode(mode === 'sleep' ? null : 'sleep'), children: tr(mode === 'sleep' ? 'pet.gameplay.wake' : 'pet.gameplay.sleep') })), shop !== undefined && (_jsx("button", { type: "button", className: styles.action, onClick: () => setPage('shop'), children: tr('pet.gameplay.shop') }))] })] })), page === 'shop' && shop !== undefined && (_jsxs(_Fragment, { children: [_jsx("div", { className: styles.gameplayShopItems, children: shop.items.map(item => (_jsxs("button", { type: "button", className: styles.gameplayShopItem, onClick: () => buy(item.id), title: item.label + ' — ' + String(item.price) + ' ' + currencyLabel(item.currency), children: [item.image !== undefined && (_jsx("img", { className: styles.gameplayShopItemImage, src: item.image, alt: "", draggable: false })), _jsx("span", { className: styles.gameplayShopItemLabel, children: item.label }), _jsxs("span", { className: styles.gameplayShopItemPrice, children: [item.price, " ", currencyLabel(item.currency)] })] }, item.id))) }), _jsx("div", { className: styles.gameplayActions, children: _jsx("button", { type: "button", className: styles.action, onClick: () => setPage('root'), children: tr('pet.gameplay.back') }) })] })), _jsx("button", { type: "button", className: styles.gameplayClose, "aria-label": tr('pet.gameplay.back'), onClick: () => setOpen(false), children: "\u00D7" })] }))] }));
+                                }) }), _jsxs("div", { className: styles.gameplayActions, children: [def.sleep !== undefined && (_jsx("button", { type: "button", className: styles.action, onClick: () => setMode(mode === 'sleep' ? null : 'sleep'), children: tr(mode === 'sleep' ? 'pet.gameplay.wake' : 'pet.gameplay.sleep') })), shop !== undefined && (_jsx("button", { type: "button", className: styles.action, onClick: () => setPage('shop'), children: tr('pet.gameplay.shop') })), skins !== undefined && skins.length > 0 && (_jsx("button", { type: "button", className: styles.action, onClick: () => setPage('skins'), children: tr('pet.gameplay.skin') })), def.work !== undefined && (_jsx("button", { type: "button", className: styles.action, onClick: () => setMode(mode === 'work' ? null : 'work'), children: tr(mode === 'work' ? 'pet.gameplay.stopWork' : 'pet.gameplay.work') }))] })] })), page === 'shop' && shop !== undefined && (_jsxs(_Fragment, { children: [_jsx("div", { className: styles.gameplayShopItems, children: shop.items.map(item => (_jsxs("button", { type: "button", className: styles.gameplayShopItem, onClick: () => buy(item.id), title: item.label + ' — ' + String(item.price) + ' ' + currencyLabel(item.currency), children: [item.image !== undefined && (_jsx("img", { className: styles.gameplayShopItemImage, src: item.image, alt: "", draggable: false })), _jsx("span", { className: styles.gameplayShopItemLabel, children: item.label }), _jsxs("span", { className: styles.gameplayShopItemPrice, children: [item.price, " ", currencyLabel(item.currency)] })] }, item.id))) }), _jsx("div", { className: styles.gameplayActions, children: _jsx("button", { type: "button", className: styles.action, onClick: () => setPage('root'), children: tr('pet.gameplay.back') }) })] })), page === 'skins' && skins !== undefined && (_jsxs(_Fragment, { children: [_jsxs("div", { className: styles.gameplaySkinItems, children: [_jsx("button", { type: "button", className: skinId === undefined ? styles.gameplaySkinItem + ' ' + styles.gameplaySkinItemActive : styles.gameplaySkinItem, onClick: () => selectSkin(undefined), children: tr('pet.gameplay.skinDefault') }), skins.map(skin => (_jsx("button", { type: "button", className: skinId === skin.id ? styles.gameplaySkinItem + ' ' + styles.gameplaySkinItemActive : styles.gameplaySkinItem, onClick: () => selectSkin(skin), children: skin.label }, skin.id)))] }), _jsx("div", { className: styles.gameplayActions, children: _jsx("button", { type: "button", className: styles.action, onClick: () => setPage('root'), children: tr('pet.gameplay.back') }) })] })), _jsx("button", { type: "button", className: styles.gameplayClose, "aria-label": tr('pet.gameplay.back'), onClick: () => setOpen(false), children: "\u00D7" })] }))] }));
 }

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

@@ -35,11 +35,5 @@ declare module '@deepseek-ai/cordis' {
         };
     }
 }
-/**
- * Client plugin body: register dictionaries, mount the global pet entry and
- * poll loop while the plugin is enabled, and seat the settings card as a
- * first-level settings section.
- * @param ctx - client root context.
- */
 export declare function apply(ctx: ClientContext): void;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGnE,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAA;AA8ElG,wEAAwE;AACxE,eAAO,MAAM,MAAM,UAA2E,CAAA;AAE9F,qEAAqE;AACrE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACxE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC7D,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACtF,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACpE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf;;;;WAIG;QACH,aAAa,CAAC,EAAE;YAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAA;SAAE,CAAA;KAC1E;CACF;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAqT9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGnE,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAA;AA8ElG,wEAAwE;AACxE,eAAO,MAAM,MAAM,UAA2E,CAAA;AAE9F,qEAAqE;AACrE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACxE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC7D,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACtF,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACpE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf;;;;WAIG;QACH,aAAa,CAAC,EAAE;YAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAA;SAAE,CAAA;KAC1E;CACF;AAoBD,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAiU9C"}

package/lib/types/client/index.js

@@ -64,6 +64,16 @@ export const inject = ['slots', 'locale', 'connection', 'settingsScope', 'remote
  * first-level settings section.
  * @param ctx - client root context.
  */
+/**
+ * Module-wide work-tick throttle (ms). Hot reloads can leave several
+ * GameplayHud instances alive, each running its own 10s work interval;
+ * without a shared gate every interval would call workTick and each stale
+ * call re-rolls, re-grants treats and re-plays the success/fail track, so
+ * the outcome appears to play several times per window. This shared marker
+ * accepts the first adjudication of a window and silently suppresses the
+ * duplicates that follow. Reset when (re-)entering work mode.
+ */
+let lastWorkTickAt = 0;
 export function apply(ctx) {
     // Anonymous install heartbeat (docs/telemetry.md): one beat per browser per
     // UTC day, package name only, silent failure.
@@ -299,8 +309,21 @@ export function apply(ctx) {
                 },
                 gameplay: {
                     touch: (zone) => petApi.gameplayTouch(zone),
-                    setMode: (mode) => petApi.gameplaySetMode(mode),
-                    workTick: () => petApi.gameplayWorkTick(),
+                    setMode: async (mode) => {
+                        if (mode === 'work')
+                            lastWorkTickAt = 0;
+                        return petApi.gameplaySetMode(mode);
+                    },
+                    workTick: async () => {
+                        // One adjudication per tick window, page-wide: suppress stale
+                        // duplicate intervals (HMR) re-playing the result track.
+                        const now = Date.now();
+                        if (now - lastWorkTickAt < 8500) {
+                            return { ok: true };
+                        }
+                        lastWorkTickAt = now;
+                        return petApi.gameplayWorkTick();
+                    },
                     buy: (item) => petApi.gameplayBuy(item),
                 },
             });

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

@@ -34,9 +34,11 @@ export declare const zh: {
     readonly 'pet.gameplay.menu': "玩法";
     readonly 'pet.gameplay.work': "打工";
     readonly 'pet.gameplay.stopWork': "收工";
-    readonly 'pet.gameplay.sleep': "睡觉";
+    readonly 'pet.gameplay.sleep': "休息";
     readonly 'pet.gameplay.wake': "起床";
     readonly 'pet.gameplay.shop': "商店";
+    readonly 'pet.gameplay.skin': "皮肤";
+    readonly 'pet.gameplay.skinDefault': "默认";
     readonly 'pet.gameplay.back': "返回";
     readonly 'pet.gameplay.buy': "购买";
     readonly 'pet.gameplay.insufficient': "{currency}不足";
@@ -62,7 +64,7 @@ export declare const zh: {
     readonly 'settings.visible': "显示宠物";
     readonly 'settings.visibleHint': "关闭后宠物隐藏，可从聊天输入区重新召唤。";
     readonly 'settings.size': "大小（px）";
-    readonly 'settings.sizeHint': "精灵单元高度，范围 32–512。";
+    readonly 'settings.sizeHint': "精灵单元高度，范围 32–1024。";
     readonly 'settings.right': "距右侧（px）";
     readonly 'settings.rightHint': "距视口右边缘的水平内缩距离。";
     readonly 'settings.bottom': "距底部（px）";
@@ -116,6 +118,8 @@ export declare const en: {
     readonly 'pet.gameplay.sleep': "Sleep";
     readonly 'pet.gameplay.wake': "Wake up";
     readonly 'pet.gameplay.shop': "Shop";
+    readonly 'pet.gameplay.skin': "Skin";
+    readonly 'pet.gameplay.skinDefault': "Default";
     readonly 'pet.gameplay.back': "Back";
     readonly 'pet.gameplay.buy': "Buy";
     readonly 'pet.gameplay.insufficient': "Not enough {currency}";
@@ -141,7 +145,7 @@ export declare const en: {
     readonly 'settings.visible': "Show the pet";
     readonly 'settings.visibleHint': "When off, the pet hides; summon it again from the input row.";
     readonly 'settings.size': "Size (px)";
-    readonly 'settings.sizeHint': "Sprite cell height, 32–512.";
+    readonly 'settings.sizeHint': "Sprite cell height, 32–1024.";
     readonly 'settings.right': "Right inset (px)";
     readonly 'settings.rightHint': "Horizontal inset from the viewport right edge.";
     readonly 'settings.bottom': "Bottom inset (px)";

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

@@ -1 +1 @@
-{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mDAAmD;AACnD,eAAO,MAAM,EAAE,QAAQ,CAAA;AAEvB,oBAAoB;AACpB,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+EL,CAAA;AAEV,oBAAoB;AACpB,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+EL,CAAA;AAEV,oCAAoC;AACpC,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAA;AAEpC,qDAAqD;AACrD,MAAM,MAAM,eAAe,GAAG,MAAM,CAAA;AAEpC;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGnD;AAED;;;;;;;GAOG;AACH,wBAAgB,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAQvE;AAED,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,kBAAkB;QAC1B,uBAAuB;QACvB,GAAG,EAAE,MAAM,CAAA;KACZ;CACF"}
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mDAAmD;AACnD,eAAO,MAAM,EAAE,QAAQ,CAAA;AAEvB,oBAAoB;AACpB,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiFL,CAAA;AAEV,oBAAoB;AACpB,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiFL,CAAA;AAEV,oCAAoC;AACpC,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAA;AAEpC,qDAAqD;AACrD,MAAM,MAAM,eAAe,GAAG,MAAM,CAAA;AAEpC;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGnD;AAED;;;;;;;GAOG;AACH,wBAAgB,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAQvE;AAED,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,kBAAkB;QAC1B,uBAAuB;QACvB,GAAG,EAAE,MAAM,CAAA;KACZ;CACF"}

package/lib/types/client/locales.js

@@ -35,9 +35,11 @@ export const zh = {
     'pet.gameplay.menu': '玩法',
     'pet.gameplay.work': '打工',
     'pet.gameplay.stopWork': '收工',
-    'pet.gameplay.sleep': '睡觉',
+    'pet.gameplay.sleep': '休息',
     'pet.gameplay.wake': '起床',
     'pet.gameplay.shop': '商店',
+    'pet.gameplay.skin': '皮肤',
+    'pet.gameplay.skinDefault': '默认',
     'pet.gameplay.back': '返回',
     'pet.gameplay.buy': '购买',
     'pet.gameplay.insufficient': '{currency}不足',
@@ -64,7 +66,7 @@ export const zh = {
     'settings.visible': '显示宠物',
     'settings.visibleHint': '关闭后宠物隐藏，可从聊天输入区重新召唤。',
     'settings.size': '大小（px）',
-    'settings.sizeHint': '精灵单元高度，范围 32–512。',
+    'settings.sizeHint': '精灵单元高度，范围 32–1024。',
     'settings.right': '距右侧（px）',
     'settings.rightHint': '距视口右边缘的水平内缩距离。',
     'settings.bottom': '距底部（px）',
@@ -119,6 +121,8 @@ export const en = {
     'pet.gameplay.sleep': 'Sleep',
     'pet.gameplay.wake': 'Wake up',
     'pet.gameplay.shop': 'Shop',
+    'pet.gameplay.skin': 'Skin',
+    'pet.gameplay.skinDefault': 'Default',
     'pet.gameplay.back': 'Back',
     'pet.gameplay.buy': 'Buy',
     'pet.gameplay.insufficient': 'Not enough {currency}',
@@ -145,7 +149,7 @@ export const en = {
     'settings.visible': 'Show the pet',
     'settings.visibleHint': 'When off, the pet hides; summon it again from the input row.',
     'settings.size': 'Size (px)',
-    'settings.sizeHint': 'Sprite cell height, 32\u2013512.',
+    'settings.sizeHint': 'Sprite cell height, 32\u20131024.',
     'settings.right': 'Right inset (px)',
     'settings.rightHint': 'Horizontal inset from the viewport right edge.',
     'settings.bottom': 'Bottom inset (px)',

package/lib/types/client/renderers/Frames2dVisualMount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Frames2dVisualMount.d.ts","sourceRoot":"","sources":["../../../../src/client/renderers/Frames2dVisualMount.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAInD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAEvC,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,UAAU,EAAE,aAAa,CAAA;IACzB,KAAK,EAAE,aAAa,CAAA;IACpB,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,gEAAgE;IAChE,IAAI,EAAE,UAAU,CAAA;IAChB,yEAAyE;IACzE,GAAG,CAAC,EAAE,WAAW,CAAA;IACjB,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;CAC/B,GAAG,YAAY,CA6Ef"}
+{"version":3,"file":"Frames2dVisualMount.d.ts","sourceRoot":"","sources":["../../../../src/client/renderers/Frames2dVisualMount.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAInD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAEvC,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,UAAU,EAAE,aAAa,CAAA;IACzB,KAAK,EAAE,aAAa,CAAA;IACpB,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,gEAAgE;IAChE,IAAI,EAAE,UAAU,CAAA;IAChB,yEAAyE;IACzE,GAAG,CAAC,EAAE,WAAW,CAAA;IACjB,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;CAC/B,GAAG,YAAY,CAiFf"}

package/lib/types/client/renderers/Frames2dVisualMount.js

@@ -51,7 +51,11 @@ export function Frames2dVisualMount(props) {
         if (props.bus !== undefined) {
             const gameplayBus = props.bus;
             gameplayBus.setTrack = (track) => { handleRef.current?.setState(track); };
-            cleanups.push(() => { gameplayBus.setTrack = undefined; });
+            gameplayBus.setIdleTrack = (track) => { handleRef.current?.setIdleTrack(track); };
+            cleanups.push(() => {
+                gameplayBus.setTrack = undefined;
+                gameplayBus.setIdleTrack = undefined;
+            });
         }
         // The drag gesture drives the conventional 'drag' track when declared.
         // On release, a declared gameplay.dragEndState (miku: standup) plays

package/lib/types/client/renderers/frames2d.d.ts

@@ -37,10 +37,35 @@ export interface PetFrames2dConfig {
     phases: Partial<Record<ActivityPhase, string>> & {
         idle: string;
     };
+    /** Selectable skins; each swaps the base idle target while selected. */
+    skins?: Frames2dSkinConfig[];
+}
+/** One selectable skins entry as served inside the pet definition. */
+export interface Frames2dSkinConfig {
+    id: string;
+    label: string;
+    /** A declared looping track that becomes the base idle while selected. */
+    idleTrack: string;
+    /** Click actions exclusive to this skin (roll by probability; miss → touch zones). */
+    clickActions?: Frames2dSkinClickActionConfig[];
+    /** Gameplay-state overrides (state -> track) swapped in while selected. */
+    gameplayTracks?: Record<string, string>;
+}
+/** One probability-rolled tap action a skin may declare. */
+export interface Frames2dSkinClickActionConfig {
+    track: string;
+    probability: number;
+    phrases?: string[];
 }
 export interface Frames2dRendererHandle extends PetRendererHandle {
     /** Force a track id (gameplay override); undefined returns to phase mapping. */
     setState(track: string | undefined): void;
+    /**
+     * Swap the base idle target (idle phase, unmapped phases and every
+     * fallback back to idle) to a declared looping track — a skin. undefined
+     * restores the manifest idle track.
+     */
+    setIdleTrack(track: string | undefined): void;
     /** The track currently playing (diagnostics and tests). */
     currentTrack(): string;
 }

package/lib/types/client/renderers/frames2d.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frames2d.d.ts","sourceRoot":"","sources":["../../../../src/client/renderers/frames2d.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAA4B,KAAK,WAAW,EAA2B,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACzI,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,oEAAoE;AACpE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;IAC3C,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAClE;AAED,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAA;IACzC,2DAA2D;IAC3D,YAAY,IAAI,MAAM,CAAA;CACvB;AA0CD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,iBAAiB,CAsP3D,CAAA"}
+{"version":3,"file":"frames2d.d.ts","sourceRoot":"","sources":["../../../../src/client/renderers/frames2d.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAA4B,KAAK,WAAW,EAA2B,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACzI,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,oEAAoE;AACpE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;IAC3C,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACjE,wEAAwE;IACxE,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAA;CAC7B;AAED,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAA;IACjB,sFAAsF;IACtF,YAAY,CAAC,EAAE,6BAA6B,EAAE,CAAA;IAC9C,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxC;AAED,4DAA4D;AAC5D,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAA;IACzC;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAA;IAC7C,2DAA2D;IAC3D,YAAY,IAAI,MAAM,CAAA;CACvB;AAuFD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,iBAAiB,CA2Q3D,CAAA"}