@linxin666/dsh-pet 0.3.5 → 0.3.6

package/lib/index.js

@@ -1,4 +1,4 @@
-import { _ as RemarkPicker, a as AFFINITY_MAX, c as applyInteraction, d as emptyAffinity, f as rankOf, g as REMARK_LINE_MAX, h as REMARK_LINES_MAX, i as rowOf, l as applyTurnReward, m as REMARK_KINDS, n as animationForPhase, o as AFFINITY_RANKS, p as BUILTIN_REMARKS, r as defaultPetStateConfig, s as affinityViewOf, t as PetStateMachine, u as defaultAffinityConfig, v as builtinRemark, y as normalizePetRemarks } from "./state-DrMX22GL.js";
+import { _ as RemarkPicker, a as AFFINITY_MAX, c as applyInteraction, d as emptyAffinity, f as rankOf, g as REMARK_LINE_MAX, h as REMARK_LINES_MAX, i as rowOf, l as applyTurnReward, m as REMARK_KINDS, n as animationForPhase, o as AFFINITY_RANKS, p as BUILTIN_REMARKS, r as defaultPetStateConfig, s as affinityViewOf, t as PetStateMachine, u as defaultAffinityConfig, v as builtinRemark, y as normalizePetRemarks } from "./state-NvDEoCln.js";
 import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 import z from "schemastery";
 import { Service } from "@deepseek-ai/cordis";
@@ -1037,7 +1037,7 @@ var PetLedger = class {
 			...defaultTreatConfig,
 			...config.treats ?? {}
 		};
-		this.picker = new RemarkPicker(config.remarks);
+		this.picker = new RemarkPicker(config.remarks, config.voiceRemarks);
 		this.current = persist;
 	}
 	/** Affinity cooldown/rank tuning (read-only). */
@@ -1106,10 +1106,10 @@ var PetLedger = class {
 	}
 	/**
 	* Swap the reaction pools to another pet's custom remarks (called on pet
-	* selection). Slots the pet does not declare fall back to built-ins.
+	* selection). Slots the pet does not declare fall back to voice packs or built-ins.
 	*/
-	setRemarks(remarks) {
-		this.picker = new RemarkPicker(remarks);
+	setRemarks(remarks, voiceRemarks) {
+		this.picker = new RemarkPicker(remarks, voiceRemarks);
 	}
 	/**
 	* Settle the treat economy (work + time output since the last settlement).
@@ -1600,7 +1600,9 @@ const VOICE_PACK_KEYS = /* @__PURE__ */ new Set([
 	"tools",
 	"toolRemaining",
 	"whispers",
-	"panel"
+	"panel",
+	"remarks",
+	"ranks"
 ]);
 /** Allowed whisper-section fields (drift-locked in tests). */
 const WHISPER_KEYS = /* @__PURE__ */ new Set(["categories", "results"]);
@@ -1663,10 +1665,22 @@ function normalizeVoicePack(raw, onWarning = () => {}) {
 		};
 	}
 	const panel = raw.panel === void 0 ? void 0 : normalizePanel(raw.panel, onWarning);
-	if (overrides.status === void 0 && overrides.tools === void 0 && overrides.toolRemaining === void 0 && overrides.whispers === void 0 && panel === void 0) return;
+	const remarks = raw.remarks === void 0 ? void 0 : normalizePetRemarks(raw.remarks, onWarning);
+	const ranksRaw = raw.ranks;
+	let ranks;
+	if (ranksRaw !== void 0) if (!isRecord$3(ranksRaw)) onWarning("ranks must be an object");
+	else {
+		const out = {};
+		for (const [key, value] of Object.entries(ranksRaw)) if (typeof value === "string" && value.trim() !== "") out[key] = value.trim().slice(0, 80);
+		else onWarning("invalid rank name for " + key);
+		if (Object.keys(out).length > 0) ranks = out;
+	}
+	if (overrides.status === void 0 && overrides.tools === void 0 && overrides.toolRemaining === void 0 && overrides.whispers === void 0 && panel === void 0 && remarks === void 0 && ranks === void 0) return;
 	return {
 		overrides,
-		...panel === void 0 ? {} : { panel }
+		...panel === void 0 ? {} : { panel },
+		...remarks === void 0 ? {} : { remarks },
+		...ranks === void 0 ? {} : { ranks }
 	};
 }
 /**
@@ -1679,6 +1693,8 @@ function mergeVoicePacks(...layers) {
 	const overrides = {};
 	const labels = {};
 	const stats = {};
+	let remarks;
+	let ranks;
 	let actions;
 	let panelSeen = false;
 	let any = false;
@@ -1704,6 +1720,14 @@ function mergeVoicePacks(...layers) {
 			if (layer.panel.stats !== void 0) Object.assign(stats, layer.panel.stats);
 			if (layer.panel.actions !== void 0) actions = layer.panel.actions;
 		}
+		if (layer.remarks !== void 0) remarks = {
+			...remarks ?? {},
+			...layer.remarks
+		};
+		if (layer.ranks !== void 0) ranks = {
+			...ranks ?? {},
+			...layer.ranks
+		};
 	}
 	if (!any) return void 0;
 	const panel = {
@@ -1714,7 +1738,9 @@ function mergeVoicePacks(...layers) {
 	const panelEmpty = panel.labels === void 0 && panel.stats === void 0 && panel.actions === void 0;
 	return {
 		overrides,
-		...panelSeen && !panelEmpty ? { panel } : {}
+		...panelSeen && !panelEmpty ? { panel } : {},
+		...remarks !== void 0 ? { remarks } : {},
+		...ranks !== void 0 ? { ranks } : {}
 	};
 }
 //#endregion
@@ -4099,10 +4125,12 @@ var PetService = class extends Service {
 			petId: this.registry.defaultEntry().id
 		};
 		const selected = this.registry.byId(persist.petId) ?? this.registry.defaultEntry();
+		const voiceRemarks = mergeVoicePacks(this.registry.globalVoice, selected.voice)?.remarks;
 		const ledgerConfig = {
 			affinity: config.affinity,
 			treats: config.treats,
-			remarks: selected.remarks
+			remarks: selected.remarks,
+			voiceRemarks
 		};
 		this.ledger = new PetLedger(persist, ledgerConfig);
 		this.stateConfig = {
@@ -4186,7 +4214,8 @@ var PetService = class extends Service {
 			error: "unknown-pet"
 		};
 		this.ledger.setPetId(entry.id);
-		this.ledger.setRemarks(entry.remarks);
+		const voiceRemarks = mergeVoicePacks(this.registry.globalVoice, entry.voice)?.remarks;
+		this.ledger.setRemarks(entry.remarks, voiceRemarks);
 		this.flush();
 		this.syncSettingsFromPet();
 		return {
@@ -4691,23 +4720,33 @@ function isLoopbackRequest(request) {
 	}
 }
 //#endregion
-//#region src/access.ts
+//#region src/pair-access.ts
 /**
-* Whether this request may enter any /api/pet or /pet asset route.
+* Whether this request may enter the plugin's host routes.
 * @param ctx - host context; may expose remoteWebUiPairing.
 * @param request - the incoming HTTP request.
 * @returns true for loopback, or a live paired-device cookie.
 */
-function isPetAllowed(ctx, request) {
+function isPairedOrLoopbackAllowed(ctx, request) {
 	if (isLoopbackRequest(request)) return true;
-	const bag = ctx;
-	const fromGet = typeof bag.get === "function" ? bag.get("remoteWebUiPairing", false) : void 0;
-	return (isPairingAccess(fromGet) ? fromGet : bag.remoteWebUiPairing)?.isPairedDevice(request) === true;
+	const fromGet = typeof ctx.get === "function" ? ctx.get("remoteWebUiPairing", false) : void 0;
+	return (isPairingAccess(fromGet) ? fromGet : ctx.remoteWebUiPairing)?.isPairedDevice(request) === true;
 }
 function isPairingAccess(value) {
 	return value !== void 0 && value !== null && typeof value.isPairedDevice === "function";
 }
 //#endregion
+//#region src/access.ts
+/**
+* Whether this request may enter any /api/pet or /pet asset route.
+* @param ctx - host context; may expose remoteWebUiPairing.
+* @param request - the incoming HTTP request.
+* @returns true for loopback, or a live paired-device cookie.
+*/
+function isPetAllowed(ctx, request) {
+	return isPairedOrLoopbackAllowed(ctx, request);
+}
+//#endregion
 //#region src/http.ts
 /** Default body cap for readJsonBody: 64 KiB. */
 const DEFAULT_JSON_BODY_MAX_BYTES = 64 * 1024;

package/lib/invariant.js

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

package/lib/{state-DrMX22GL.js → state-NvDEoCln.js}

@@ -149,11 +149,14 @@ function normalizePetRemarks(raw, onWarning = () => {}) {
 var RemarkPicker = class {
 	counters = /* @__PURE__ */ new Map();
 	pools;
-	constructor(overrides) {
+	constructor(overrides, voiceOverrides) {
 		this.pools = {};
 		for (const kind of REMARK_KINDS) {
 			const custom = overrides?.[kind];
-			this.pools[kind] = custom !== void 0 && custom.length > 0 ? custom : BUILTIN_REMARKS[kind];
+			const voice = voiceOverrides?.[kind];
+			if (custom !== void 0 && custom.length > 0) this.pools[kind] = custom;
+			else if (voice !== void 0 && voice.length > 0) this.pools[kind] = voice;
+			else this.pools[kind] = BUILTIN_REMARKS[kind];
 		}
 	}
 	/** The effective pool for one slot (custom override or built-in). */

package/lib/types/access.d.ts

@@ -1,8 +1,9 @@
 /**
- * Pet trust fence: loopback (the desktop) always passes; a live paired-device
- * cookie is an additional allow path when remote-web-ui is loaded. The pet
- * never depends on that plugin — without the service the fence stays
- * loopback-only (same pattern as skill-explorer / aionui-panel).
+ * Pet trust fence: loopback (the desktop) always passes; a live
+ * paired-device cookie is an additional allow path when remote-web-ui is
+ * loaded. The pet never depends on that plugin — without the service the
+ * fence stays loopback-only. The decision logic lives in the generated
+ * pair-access.ts copy (shared by git-graph / pet / skill-explorer).
  */
 import type { IncomingMessage } from 'node:http';
 import type { Context } from '@deepseek-ai/cordis';

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

@@ -1 +1 @@
-{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../src/access.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAclD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAM5E"}
+{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../src/access.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGlD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAE5E"}

package/lib/types/access.js

@@ -1,4 +1,4 @@
-import { isLoopbackRequest } from "./loopback.js";
+import { isPairedOrLoopbackAllowed } from "./pair-access.js";
 /**
  * Whether this request may enter any /api/pet or /pet asset route.
  * @param ctx - host context; may expose remoteWebUiPairing.
@@ -6,15 +6,5 @@ import { isLoopbackRequest } from "./loopback.js";
  * @returns true for loopback, or a live paired-device cookie.
  */
 export function isPetAllowed(ctx, request) {
-    if (isLoopbackRequest(request))
-        return true;
-    const bag = ctx;
-    const fromGet = typeof bag.get === 'function' ? bag.get('remoteWebUiPairing', false) : undefined;
-    const pairing = (isPairingAccess(fromGet) ? fromGet : bag.remoteWebUiPairing);
-    return pairing?.isPairedDevice(request) === true;
-}
-function isPairingAccess(value) {
-    return value !== undefined
-        && value !== null
-        && typeof value.isPairedDevice === 'function';
+    return isPairedOrLoopbackAllowed(ctx, request);
 }

package/lib/types/affinity.d.ts

@@ -75,6 +75,8 @@ export declare const AFFINITY_RANKS: readonly [{
     readonly name: "鲸生共渡";
     readonly emoji: "*********";
 }];
+/** English translations for the 9 built-in affinity rank names (#1226). */
+export declare const AFFINITY_RANKS_EN: Readonly<Record<string, string>>;
 /** Interaction tuning (all in points / ms). */
 export interface AffinityConfig {
     /** Points per completed turn. */

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

@@ -1 +1 @@
-{"version":3,"file":"affinity.d.ts","sourceRoot":"","sources":["../../src/affinity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,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,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAA;IAClB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAA;IACnB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,YAAc,CAAA;AAEvC;;;;8EAI8E;AAC9E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUjB,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,CAW7C;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;AAYD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,cAAsC,GAC7C,kBAAkB,CA2CpB;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;;;;;;;;GAQG;AAIH,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,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAA;IAClB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAA;IACnB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,YAAc,CAAA;AAEvC;;;;8EAI8E;AAC9E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUjB,CAAA;AAEV,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAU9D,CAAA;AAED,+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,CAW7C;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;AAYD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,cAAsC,GAC7C,kBAAkB,CA2CpB;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,MAAM,GAAE,cAAsC,GAC7C,aAAa,CAKf"}

package/lib/types/affinity.js

@@ -29,6 +29,18 @@ export const AFFINITY_RANKS = [
     { min: 10_000, name: '永恒之契', emoji: '********' },
     { min: 100_000, name: '鲸生共渡', emoji: '*********' },
 ];
+/** English translations for the 9 built-in affinity rank names (#1226). */
+export const AFFINITY_RANKS_EN = {
+    '幼鲸': 'Baby Whale',
+    '伙伴': 'Companion',
+    '挚友': 'Close Friend',
+    '深海羁绊': 'Deep Sea Bond',
+    '心有灵犀': 'Kindred Spirit',
+    '传说羁绊': 'Legendary Bond',
+    '神话羁绊': 'Mythic Bond',
+    '永恒之契': 'Eternal Covenant',
+    '鲸生共渡': 'Lifelong Companion',
+};
 export const defaultAffinityConfig = {
     turnReward: 1,
     petReward: 1,

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

@@ -1 +1 @@
-{"version":3,"file":"PetSprite.d.ts","sourceRoot":"","sources":["../../../src/client/PetSprite.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAkE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAGnH,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;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAIjD,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,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;IAC9C,uDAAuD;IACvD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,4DAA4D;IAC5D,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,2DAA2D;IAC3D,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB;;;;OAIG;IACH,GAAG,CAAC,EAAE,SAAS,CAAA;IACf;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9D;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;IAC3B,qEAAqE;IACrE,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,+CAA+C;IAC/C,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CAAA;CAC1B;AAgGD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,WAAW,CAqiB5D"}
+{"version":3,"file":"PetSprite.d.ts","sourceRoot":"","sources":["../../../src/client/PetSprite.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAkE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAGnH,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;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAIjD,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,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;IAC9C,uDAAuD;IACvD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,4DAA4D;IAC5D,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,2DAA2D;IAC3D,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB;;;;OAIG;IACH,GAAG,CAAC,EAAE,SAAS,CAAA;IACf;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9D;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;IAC3B,qEAAqE;IACrE,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,+CAA+C;IAC/C,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CAAA;CAC1B;AAgGD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,WAAW,CA6iB5D"}

package/lib/types/client/PetSprite.js

@@ -498,7 +498,13 @@ export function PetSprite(props) {
                                     props.onRename(trimmed);
                                     setRenaming(false);
                                 }
-                            }, children: panelLabel('confirm', props.t('pet.confirm')) })] })) : (_jsxs(_Fragment, { children: [_jsxs("div", { className: styles.rankRow, children: [_jsx("span", { className: styles.nameCell, children: displayName }), _jsx("span", { className: styles.statRank, children: panelStat('rank', 'pet.rank', { rank: snapshot?.affinity.rank ?? '?' }) })] }), _jsxs("div", { className: styles.rankRow, children: [_jsx("span", { className: styles.statTreats, children: panelStat('treats', 'pet.treats', { n: snapshot?.treats.stocked ?? 0 }) }), _jsx("span", { className: styles.statPoints, children: panelStat('points', 'pet.points', { points: snapshot?.affinity.points ?? 0 }) })] }), _jsxs("div", { className: styles.actions, children: [panelShows('feed') && (_jsx("button", { type: "button", className: styles.action, onClick: props.onFeed, children: panelLabel('feed', props.t('pet.feed')) })), panelShows('rename') && (_jsx("button", { type: "button", className: styles.action, onClick: () => {
+                            }, children: panelLabel('confirm', props.t('pet.confirm')) })] })) : (_jsxs(_Fragment, { children: [_jsxs("div", { className: styles.rankRow, children: [_jsx("span", { className: styles.nameCell, children: displayName }), _jsx("span", { className: styles.statRank, children: (() => {
+                                        const rawRank = snapshot?.affinity.rank ?? '?';
+                                        const rankKey = `pet.rank.name.${rawRank}`;
+                                        const localized = props.t(rankKey);
+                                        const rankName = localized !== rankKey ? localized : rawRank;
+                                        return panelStat('rank', 'pet.rank', { rank: rankName });
+                                    })() })] }), _jsxs("div", { className: styles.rankRow, children: [_jsx("span", { className: styles.statTreats, children: panelStat('treats', 'pet.treats', { n: snapshot?.treats.stocked ?? 0 }) }), _jsx("span", { className: styles.statPoints, children: panelStat('points', 'pet.points', { points: snapshot?.affinity.points ?? 0 }) })] }), _jsxs("div", { className: styles.actions, children: [panelShows('feed') && (_jsx("button", { type: "button", className: styles.action, onClick: props.onFeed, children: panelLabel('feed', props.t('pet.feed')) })), panelShows('rename') && (_jsx("button", { type: "button", className: styles.action, onClick: () => {
                                         // Cancel any pending hide so the rename box cannot
                                         // unmount right as the user starts typing (#303).
                                         clearHideTimer();

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

@@ -13,6 +13,15 @@ export declare const zh: {
     readonly 'pet.namePlaceholder': "输入新名字";
     readonly 'pet.summon': "召唤{name}";
     readonly 'pet.rank': "亲密度 {rank}";
+    readonly 'pet.rank.name.\u5E7C\u9CB8': "幼鲸";
+    readonly 'pet.rank.name.\u4F19\u4F34': "伙伴";
+    readonly 'pet.rank.name.\u631A\u53CB': "挚友";
+    readonly 'pet.rank.name.\u6DF1\u6D77\u7F81\u7ECA': "深海羁绊";
+    readonly 'pet.rank.name.\u5FC3\u6709\u7075\u7280': "心有灵犀";
+    readonly 'pet.rank.name.\u4F20\u8BF4\u7F81\u7ECA': "传说羁绊";
+    readonly 'pet.rank.name.\u795E\u8BDD\u7F81\u7ECA': "神话羁绊";
+    readonly 'pet.rank.name.\u6C38\u6052\u4E4B\u5951': "永恒之契";
+    readonly 'pet.rank.name.\u9CB8\u751F\u5171\u6E21': "鲸生共渡";
     readonly 'pet.points': "{points} 点";
     readonly 'pet.treats': "小鱼干 ×{n}";
     readonly 'pet.state.loading': "宠物正在赶来…";
@@ -83,6 +92,15 @@ export declare const en: {
     readonly 'pet.namePlaceholder': "Enter a new name";
     readonly 'pet.summon': "Summon {name}";
     readonly 'pet.rank': "Affinity {rank}";
+    readonly 'pet.rank.name.\u5E7C\u9CB8': "Baby Whale";
+    readonly 'pet.rank.name.\u4F19\u4F34': "Companion";
+    readonly 'pet.rank.name.\u631A\u53CB': "Close Friend";
+    readonly 'pet.rank.name.\u6DF1\u6D77\u7F81\u7ECA': "Deep Sea Bond";
+    readonly 'pet.rank.name.\u5FC3\u6709\u7075\u7280': "Kindred Spirit";
+    readonly 'pet.rank.name.\u4F20\u8BF4\u7F81\u7ECA': "Legendary Bond";
+    readonly 'pet.rank.name.\u795E\u8BDD\u7F81\u7ECA': "Mythic Bond";
+    readonly 'pet.rank.name.\u6C38\u6052\u4E4B\u5951': "Eternal Covenant";
+    readonly 'pet.rank.name.\u9CB8\u751F\u5171\u6E21': "Lifelong Companion";
     readonly 'pet.points': "{points} pts";
     readonly 'pet.treats': "Treats ×{n}";
     readonly 'pet.state.loading': "The pet is on its way…";

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsEL,CAAA;AAEV,oBAAoB;AACpB,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsEL,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}

package/lib/types/client/locales.js

@@ -13,6 +13,15 @@ export const zh = {
     'pet.namePlaceholder': '输入新名字',
     'pet.summon': '召唤{name}',
     'pet.rank': '亲密度 {rank}',
+    'pet.rank.name.幼鲸': '幼鲸',
+    'pet.rank.name.伙伴': '伙伴',
+    'pet.rank.name.挚友': '挚友',
+    'pet.rank.name.深海羁绊': '深海羁绊',
+    'pet.rank.name.心有灵犀': '心有灵犀',
+    'pet.rank.name.传说羁绊': '传说羁绊',
+    'pet.rank.name.神话羁绊': '神话羁绊',
+    'pet.rank.name.永恒之契': '永恒之契',
+    'pet.rank.name.鲸生共渡': '鲸生共渡',
     'pet.points': '{points} 点',
     'pet.treats': '小鱼干 ×{n}',
     'pet.state.loading': '宠物正在赶来…',
@@ -85,6 +94,15 @@ export const en = {
     'pet.namePlaceholder': 'Enter a new name',
     'pet.summon': 'Summon {name}',
     'pet.rank': 'Affinity {rank}',
+    'pet.rank.name.幼鲸': 'Baby Whale',
+    'pet.rank.name.伙伴': 'Companion',
+    'pet.rank.name.挚友': 'Close Friend',
+    'pet.rank.name.深海羁绊': 'Deep Sea Bond',
+    'pet.rank.name.心有灵犀': 'Kindred Spirit',
+    'pet.rank.name.传说羁绊': 'Legendary Bond',
+    'pet.rank.name.神话羁绊': 'Mythic Bond',
+    'pet.rank.name.永恒之契': 'Eternal Covenant',
+    'pet.rank.name.鲸生共渡': 'Lifelong Companion',
     'pet.points': '{points} pts',
     'pet.treats': 'Treats ×{n}',
     'pet.state.loading': 'The pet is on its way…',

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

@@ -8,6 +8,18 @@
  * phase-mapped track. Rendering never throws: a broken track list degrades
  * to the first decodable frame, and the 1.2 s stall watchdog re-kicks the
  * playback chain after timer throttling.
+ *
+ * Frame presentation has two modes picked once at mount by capability
+ * probing:
+ * - Canvas bitmap buffer (default where createImageBitmap/fetch/2D context
+ *   exist): every frame is decoded exactly once into an ImageBitmap during
+ *   the warm pass and drawn onto one <canvas> - steady-state playback issues
+ *   zero DOM mutations and zero re-decodes (measured hotspot: swapping
+ *   <img>.src per frame drove image decode + invalidation every tick).
+ * - Classic <img> fallback (jsdom/tests or missing APIs): identical to the
+ *   historical behavior - cache-warm Image elements plus guarded src swaps,
+ *   so environments without modern decoding keep working unchanged.
+ *
  * @module @linxin666/dsh-pet/client/renderers/frames2d
  */
 import { type PetRenderer, type PetRendererHandle } from '../../contracts/renderer.ts';

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;;;;;;;;;;;GAWG;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;AAoCD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,iBAAiB,CAgJ3D,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;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"}

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

@@ -8,6 +8,18 @@
  * phase-mapped track. Rendering never throws: a broken track list degrades
  * to the first decodable frame, and the 1.2 s stall watchdog re-kicks the
  * playback chain after timer throttling.
+ *
+ * Frame presentation has two modes picked once at mount by capability
+ * probing:
+ * - Canvas bitmap buffer (default where createImageBitmap/fetch/2D context
+ *   exist): every frame is decoded exactly once into an ImageBitmap during
+ *   the warm pass and drawn onto one <canvas> - steady-state playback issues
+ *   zero DOM mutations and zero re-decodes (measured hotspot: swapping
+ *   <img>.src per frame drove image decode + invalidation every tick).
+ * - Classic <img> fallback (jsdom/tests or missing APIs): identical to the
+ *   historical behavior - cache-warm Image elements plus guarded src swaps,
+ *   so environments without modern decoding keep working unchanged.
+ *
  * @module @linxin666/dsh-pet/client/renderers/frames2d
  */
 import { PET_RENDERER_API_VERSION } from "../../contracts/renderer.js";
@@ -50,23 +62,83 @@ export const frames2dRenderer = {
         const reducedMotion = typeof window !== 'undefined'
             && typeof window.matchMedia === 'function'
             && window.matchMedia('(prefers-reduced-motion: reduce)').matches;
-        const img = document.createElement('img');
-        img.dataset.dshPetFrames2d = ctx.petId;
-        img.alt = '';
-        img.draggable = false;
-        img.style.width = '100%';
-        img.style.height = '100%';
-        img.style.objectFit = 'contain';
-        img.style.pointerEvents = 'none';
-        ctx.container.appendChild(img);
-        // Warm the browser cache for every frame up front (same-origin, small
-        // webp files); playback itself swaps img.src without React state.
-        for (const track of Object.values(config.tracks)) {
-            for (const url of track.frames) {
-                const pre = new Image();
-                pre.src = url;
+        // Capability probe: the canvas path needs decode-to-bitmap, same-origin
+        // fetch, and a real 2D context (jsdom returns null and falls back below).
+        let canvas = null;
+        let context2d = null;
+        let img = null;
+        try {
+            if (typeof createImageBitmap === 'function' && typeof fetch === 'function') {
+                const probe = document.createElement('canvas');
+                const c2d = probe.getContext('2d');
+                if (c2d !== null) {
+                    canvas = probe;
+                    context2d = c2d;
+                }
             }
         }
+        catch {
+            canvas = null;
+            context2d = null;
+        }
+        if (canvas !== null && context2d !== null) {
+            canvas.dataset.dshPetFrames2d = ctx.petId;
+            canvas.draggable = false;
+            canvas.style.width = '100%';
+            canvas.style.height = '100%';
+            canvas.style.objectFit = 'contain';
+            canvas.style.pointerEvents = 'none';
+            ctx.container.appendChild(canvas);
+        }
+        else {
+            img = document.createElement('img');
+            img.dataset.dshPetFrames2d = ctx.petId;
+            img.alt = '';
+            img.draggable = false;
+            img.style.width = '100%';
+            img.style.height = '100%';
+            img.style.objectFit = 'contain';
+            img.style.pointerEvents = 'none';
+            ctx.container.appendChild(img);
+        }
+        // Decode cache: one concurrent decode per URL, memoized forever (frames
+        // are tiny same-origin webp files; failures resolve undefined and keep
+        // the last painted frame instead of breaking playback).
+        const decoding = new Map();
+        const decodedAll = [];
+        const loadFrame = (url) => {
+            const cached = decoding.get(url);
+            if (cached !== undefined)
+                return cached;
+            const job = (async () => {
+                try {
+                    const response = await fetch(url);
+                    if (!response.ok)
+                        throw new Error('http ' + response.status);
+                    const bitmap = await createImageBitmap(await response.blob());
+                    return { source: bitmap, width: bitmap.width, height: bitmap.height };
+                }
+                catch {
+                    // Fail-open: classic Image decode keeps non-modern runtimes alive.
+                    return await new Promise((resolve) => {
+                        try {
+                            const pre = new Image();
+                            pre.onload = () => {
+                                resolve(pre.naturalWidth > 0 ? { source: pre, width: pre.naturalWidth, height: pre.naturalHeight } : undefined);
+                            };
+                            pre.onerror = () => resolve(undefined);
+                            pre.src = url;
+                        }
+                        catch {
+                            resolve(undefined);
+                        }
+                    });
+                }
+            })();
+            decoding.set(url, job);
+            decodedAll.push(job.then(() => undefined, () => undefined));
+            return job;
+        };
         let disposed = false;
         let timer;
         let watchdog;
@@ -74,15 +146,45 @@ export const frames2dRenderer = {
         let frameIndex = 0;
         let lastAdvance = Date.now();
         let override;
+        let drawToken = 0;
+        let lastDrawnUrl;
         const trackForPhase = (phase) => {
             const mapped = config.phases[phase];
             return mapped !== undefined && config.tracks[mapped] !== undefined ? mapped : config.phases.idle;
         };
+        /** Canvas path: paints the newest requested frame; stale draws drop out. */
+        const paintCanvas = (url) => {
+            if (context2d === null || canvas === null)
+                return;
+            const myToken = ++drawToken;
+            void loadFrame(url).then((frame) => {
+                if (disposed || frame === undefined || myToken !== drawToken)
+                    return;
+                if (lastDrawnUrl === url)
+                    return;
+                lastDrawnUrl = url;
+                // Resizing clears the canvas, so size only when it actually differs.
+                if (canvas.width !== frame.width || canvas.height !== frame.height) {
+                    canvas.width = frame.width;
+                    canvas.height = frame.height;
+                }
+                else {
+                    context2d.clearRect(0, 0, canvas.width, canvas.height);
+                }
+                context2d.drawImage(frame.source, 0, 0);
+            }).catch(() => { });
+        };
         const show = (trackId, index) => {
             const def = config.tracks[trackId];
             const url = def?.frames[index];
-            if (url !== undefined && img.getAttribute('src') !== url)
-                img.src = url;
+            if (url === undefined)
+                return;
+            if (img !== null) {
+                if (img.getAttribute('src') !== url)
+                    img.src = url;
+                return;
+            }
+            paintCanvas(url);
         };
         const schedule = (ms) => {
             if (disposed)
@@ -155,6 +257,13 @@ export const frames2dRenderer = {
                     tick();
             }, WATCHDOG_MS);
         }
+        // Warm pass: decode every frame up front (tiny same-origin webp files)
+        // so loops and phase switches never wait on a first decode - same intent
+        // as the historical Image-cache warm loop, now feeding the decode cache.
+        for (const warmTrack of Object.values(config.tracks)) {
+            for (const warmUrl of warmTrack.frames)
+                void loadFrame(warmUrl);
+        }
         play(track);
         let disposedOnce = false;
         const dispose = () => {
@@ -167,7 +276,23 @@ export const frames2dRenderer = {
                 clearTimeout(timer);
             if (watchdog !== undefined)
                 clearInterval(watchdog);
-            img.remove();
+            // Release decoded bitmaps after pending decodes settle; close() is
+            // browser-only, so guard it for exotic hosts.
+            void Promise.allSettled(decodedAll).then(() => {
+                for (const job of decoding.values()) {
+                    void job.then((frame) => {
+                        try {
+                            const maybeClose = frame?.source?.close;
+                            if (typeof maybeClose === 'function' && frame !== undefined)
+                                maybeClose.call(frame.source);
+                        }
+                        catch { /* already released */ }
+                    }).catch(() => { });
+                }
+                decoding.clear();
+            });
+            canvas?.remove();
+            img?.remove();
         };
         ctx.onCleanup(dispose);
         return {

package/lib/types/ledger.d.ts

@@ -17,6 +17,8 @@ export interface LedgerConfig {
     treats?: Partial<TreatConfig>;
     /** Per-pet remark pools for the selected pet (custom slots override built-ins). */
     remarks?: PetRemarks;
+    /** Voice-pack fallback remark pools (global or pet voice pack). */
+    voiceRemarks?: PetRemarks;
 }
 /** Result of one ledger interaction (the shape the pet RPC returns). */
 export interface LedgerInteractionResult {
@@ -66,9 +68,9 @@ export declare class PetLedger {
     setPetName(petId: string, name: string): void;
     /**
      * Swap the reaction pools to another pet's custom remarks (called on pet
-     * selection). Slots the pet does not declare fall back to built-ins.
+     * selection). Slots the pet does not declare fall back to voice packs or built-ins.
      */
-    setRemarks(remarks?: PetRemarks): void;
+    setRemarks(remarks?: PetRemarks, voiceRemarks?: PetRemarks): void;
     /**
      * Settle the treat economy (work + time output since the last settlement).
      * A zero-gain first settlement still starts the time clock (anchor write),

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

@@ -1 +1 @@
-{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../src/ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,eAAe,CAAA;AACtB,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAErD,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;IAC7B,mFAAmF;IACnF,OAAO,CAAC,EAAE,UAAU,CAAA;CACrB;AAED,wEAAwE;AACxE,MAAM,WAAW,uBAAuB;IACtC,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;IACb,6DAA6D;IAC7D,QAAQ,EAAE,eAAe,CAAA;CAC1B;AAED;;;;GAIG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,0EAA0E;IAC1E,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAY;IAC3B,oFAAoF;IACpF,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,sBAAsB,CAAI;IAClC,OAAO,CAAC,KAAK,CAAQ;gBAET,OAAO,EAAE,UAAU,EAAE,MAAM,GAAE,YAAiB;IAO1D,iDAAiD;IACjD,IAAI,QAAQ,IAAI,cAAc,CAE7B;IAED,qEAAqE;IACrE,IAAI,QAAQ,IAAI,UAAU,CAEzB;IAED,qCAAqC;IACrC,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,+DAA+D;IAC/D,SAAS,IAAI,OAAO;IAMpB;;;OAGG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAItC,mEAAmE;IACnE,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAK3C,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM7B,qFAAqF;IACrF,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAK5D,0EAA0E;IAC1E,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAK7C;;;OAGG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAItC;;;;;OAKG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAapC;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IASpC,8EAA8E;IAC9E,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE;IAQ5C;;;;OAIG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IASnE,8EAA8E;IAC9E,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IASxC,OAAO,CAAC,eAAe;IASvB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,uBAAuB;IAwCtE,kDAAkD;IAClD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe;CAG7C"}
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../src/ledger.ts"],"names":[],"mappings":"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"}