@linxin666/dsh-pet 0.3.5 → 0.3.9

package/lib/client.js

@@ -6,9 +6,21 @@ window.__ModuleLoader__.load({
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 		let react = require("react");
 		let react_dom_client = require("react-dom/client");
-		let _deepseek_ai_dsh_client_runtime_client = require("@deepseek-ai/dsh-client-runtime/client");
 		let react_dom = require("react-dom");
 		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region \0dsh-store-engine
+		const platform = ["@deepseek-ai/dsh-client", "-store"].join("");
+		const legacy = ["@deepseek-ai/dsh-client-runtime", "/client"].join("");
+		let engine;
+		try {
+			engine = require(platform);
+		} catch {
+			engine = require(legacy);
+		}
+		const createSnapshotStore = engine.createSnapshotStore;
+		const defineStore = engine.defineStore;
+		engine.shallowEqual;
+		//#endregion
 		//#region src/client/pet-store.ts
 		/**
 		* Browser-side pet store: the pet state snapshot plus transient UI feedback
@@ -19,7 +31,7 @@ window.__ModuleLoader__.load({
 		*/
 		/** Create the pet store handle (apply world only; never module-level). */
 		function createPetStore() {
-			return (0, _deepseek_ai_dsh_client_runtime_client.defineStore)({
+			return defineStore({
 				init: () => ({
 					snapshot: null,
 					pets: [],
@@ -68,6 +80,12 @@ window.__ModuleLoader__.load({
 			return n;
 		}
 		//#endregion
+		//#region src/announce.ts
+		/** Whether an announcement is still fresh at `now`. */
+		function announcementFresh(announcement, now) {
+			return now - announcement.at < announcement.ttlMs;
+		}
+		//#endregion
 		//#region src/state.ts
 		/**
 		* Map one activity phase onto the animation contract.
@@ -171,7 +189,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-css:packages/dsh-pet/src/client/pet.module.css.mjs
-		const css$2 = ".kz2Bea_float{pointer-events:auto;-webkit-user-select:none;user-select:none;will-change:transform;contain:layout style;flex-direction:column;align-items:center;display:flex;position:fixed}.kz2Bea_sprite{image-rendering:auto;touch-action:none;contain:paint}.kz2Bea_spriteWrap{flex:none;position:relative}.kz2Bea_bubble{white-space:nowrap;color:#f4f7ff;pointer-events:none;border-radius:999px;margin-bottom:6px;padding:4px 10px;font-size:12px;line-height:1.4;animation:2.6s ease-out forwards kz2Bea_pet-bubble-pop;position:absolute;bottom:100%;box-shadow:0 2px 8px #00000040}.kz2Bea_bubblePet{background:#4d6bfef2}.kz2Bea_bubbleFeed{background:#0369a1f2}.kz2Bea_bubbleStatus{text-overflow:ellipsis;backdrop-filter:blur(8px);letter-spacing:.02em;background:linear-gradient(160deg,#131c36e6,#070b1af0);border:1px solid #7e98ff73;max-width:min(280px,100vw - 24px);padding:5px 12px;animation:.24s ease-out kz2Bea_pet-bubble-in;overflow:hidden;box-shadow:0 4px 12px #02061759,inset 0 1px #e2e8ff1a,0 0 12px #4d6bfe2e}.kz2Bea_bubbleWhisper{letter-spacing:.03em;animation:.32s cubic-bezier(.22,1,.36,1) kz2Bea_pet-whisper-in}.kz2Bea_bubbleWhisper:before{content:\"「\";opacity:.7;margin-right:2px}.kz2Bea_bubbleWhisper:after{content:\"」\";opacity:.7;margin-left:2px}.kz2Bea_bubbleStack{pointer-events:auto;flex-direction:column-reverse;align-items:center;gap:4px;display:flex;position:absolute;bottom:100%}.kz2Bea_bubbleAnchor{display:inline-flex;position:relative}.kz2Bea_bubbleMore{z-index:1;color:#eef2ff;cursor:pointer;background:linear-gradient(160deg,#4a68f5f2,#2f44b8f2);border:1px solid #7e98ff8c;border-radius:999px;justify-content:center;align-items:center;min-width:18px;height:18px;padding:0 5px;font-size:10px;font-weight:600;line-height:1;transition:filter .12s;display:inline-flex;position:absolute;top:-9px;right:-10px;box-shadow:0 2px 6px #02061766}.kz2Bea_bubbleMore:hover{filter:brightness(1.15)}.kz2Bea_bubbleMore:focus-visible{outline:none;box-shadow:0 0 0 2px #7e98ffe6}.kz2Bea_bubbleStack .kz2Bea_bubble{pointer-events:auto;margin-bottom:0;position:relative;bottom:auto}.kz2Bea_bubbleClickable{cursor:pointer;font:inherit;text-align:center;appearance:none;transition:filter .12s,box-shadow .12s}.kz2Bea_bubbleClickable:hover{filter:brightness(1.12)}.kz2Bea_bubbleClickable:focus-visible{outline:none;box-shadow:0 0 0 2px #7e98ffe6}@keyframes kz2Bea_pet-bubble-in{0%{opacity:0;transform:translateY(6px)scale(.96)}to{opacity:1;transform:translateY(0)scale(1)}}@keyframes kz2Bea_pet-whisper-in{0%{opacity:0;transform:translateY(8px)scale(.9)}60%{transform:translateY(-1px)scale(1.02)}to{opacity:1;transform:translateY(0)scale(1)}}@keyframes kz2Bea_pet-panel-in{0%{opacity:0;transform:translateY(4px)scale(.97)}to{opacity:1;transform:translateY(0)scale(1)}}@keyframes kz2Bea_pet-bubble-pop{0%{opacity:0;transform:translateY(6px)scale(.85)}15%{opacity:1;transform:translateY(0)scale(1.05)}25%{transform:translateY(0)scale(1)}75%{opacity:1}to{opacity:0;transform:translateY(-8px)scale(.95)}}.kz2Bea_panel{color:#e6ebf8;backdrop-filter:blur(10px);transform-origin:50% 0;background:linear-gradient(165deg,#131c36f2,#070b1af7);border:1px solid #7e98ff4d;border-radius:12px;flex-direction:column;gap:7px;min-width:148px;margin-top:8px;padding:10px 12px;font-size:12px;animation:.2s cubic-bezier(.22,1,.36,1) kz2Bea_pet-panel-in;display:flex;position:absolute;top:100%;box-shadow:0 8px 24px #02061773,0 0 0 1px #4d6bfe1a,inset 0 1px #e2e8ff14}.kz2Bea_panel:after{content:\"\";height:14px;position:absolute;bottom:100%;left:0;right:0}.kz2Bea_panelAbove{transform-origin:50% 100%;margin-top:0;margin-bottom:8px;top:auto;bottom:100%}.kz2Bea_panelAbove:after{top:100%;bottom:auto}.kz2Bea_rankRow{white-space:nowrap;justify-content:space-between;gap:10px;display:flex}.kz2Bea_nameCell{letter-spacing:.02em;background:linear-gradient(90deg,#a9c1ff,#6c8bff 60%,#4d6bfe);color:#0000;-webkit-background-clip:text;background-clip:text;font-weight:600}.kz2Bea_statRank{color:#9db4ff;font-weight:600}.kz2Bea_statTreats{color:#7dd3fc;font-weight:600}.kz2Bea_statPoints{color:#fcd34d;font-weight:600}.kz2Bea_renameRow{align-items:center;gap:6px;display:flex}.kz2Bea_nameInput{color:#e6ebf8;background:#131c36e6;border:1px solid #7e98ff80;border-radius:6px;outline:none;flex:1;min-width:0;padding:3px 6px;font-size:12px}.kz2Bea_nameInput:focus{border-color:#4d6bfe;box-shadow:0 0 0 2px #4d6bfe73}.kz2Bea_actions{gap:6px;display:flex}.kz2Bea_action{cursor:pointer;color:#fff;background:linear-gradient(#4a68f5,#3a55e0);border:none;border-radius:6px;flex:1;padding:4px 8px;font-size:12px;font-weight:600;transition:filter .12s,box-shadow .12s,transform .12s;box-shadow:0 2px 6px #4d6bfe4d}.kz2Bea_action:hover{filter:brightness(1.08);transform:translateY(-1px);box-shadow:0 4px 10px #4d6bfe66}.kz2Bea_action:active{filter:brightness(.94);transform:translateY(0);box-shadow:0 1px 4px #4d6bfe4d}.kz2Bea_action:focus-visible{outline:none;box-shadow:0 0 0 2px #7e98ffe6}.kz2Bea_summon{color:#8ea6ff;cursor:pointer;background:#070b1abf;border:1px dashed #7e98ff99;border-radius:999px;padding:2px 10px;font-size:11px;transition:border-color .12s,color .12s,background .12s,box-shadow .12s}.kz2Bea_summon:hover{color:#c3d3ff;background:#070b1ae6;border-color:#7e98fff2}.kz2Bea_summon:active{color:#8ea6ff;border-color:#7e98ffcc}.kz2Bea_summon:focus-visible{outline:none;box-shadow:0 0 0 2px #7e98ffe6}@media (prefers-reduced-motion:reduce){.kz2Bea_bubble,.kz2Bea_bubbleStatus,.kz2Bea_bubbleWhisper,.kz2Bea_panel{opacity:1;animation:none}.kz2Bea_action,.kz2Bea_summon,.kz2Bea_bubbleMore{transition:none}}.kz2Bea_gameplayHud{width:0;height:0;position:absolute;bottom:0;left:0}.kz2Bea_gameplayModeChip{color:#cdd7ff;white-space:nowrap;pointer-events:none;background:#7e98ff2e;border-radius:999px;padding:1px 8px;font-size:10px;position:absolute;top:0;left:0;transform:translateY(-100%)translateY(-4px)}.kz2Bea_gameplayCard{color:#dfe6ff;background:#070b1aeb;border:1px solid #7e98ff40;border-radius:10px;min-width:180px;max-height:340px;padding:10px 12px;font-size:12px;position:absolute;bottom:0;left:0;overflow-y:auto;transform:none;box-shadow:0 8px 24px #0006}.kz2Bea_gameplayBars{flex-direction:column;gap:4px;margin-bottom:8px;display:flex}.kz2Bea_gameplayBarRow{align-items:center;gap:6px;display:flex}.kz2Bea_gameplayBarLabel{color:#9aa8d8;flex-shrink:0;width:34px}.kz2Bea_gameplayBarTrack{background:#7e98ff26;border-radius:3px;flex:1;height:6px;overflow:hidden}.kz2Bea_gameplayBarFill{background:linear-gradient(90deg,#7e98ff,#9db4ff);border-radius:3px;height:100%;transition:width .3s;display:block}.kz2Bea_gameplayActions{flex-wrap:wrap;gap:6px;display:flex}.kz2Bea_gameplayShopItems{grid-template-columns:repeat(2,minmax(0,1fr));gap:8px;margin-bottom:8px;display:grid}.kz2Bea_gameplayShopItem{color:inherit;cursor:pointer;background:#7e98ff14;border:1px solid #7e98ff40;border-radius:8px;flex-direction:column;align-items:center;gap:4px;padding:8px 6px;display:flex}.kz2Bea_gameplayShopItem:hover{background:#7e98ff29;border-color:#7e98ffb3}.kz2Bea_gameplayShopItemImage{object-fit:contain;width:36px;height:36px;image-rendering:pixelated;pointer-events:none}.kz2Bea_gameplayShopItemLabel{text-align:center;font-size:11px}.kz2Bea_gameplayShopItemPrice{color:#ffd27e;font-size:10px}.kz2Bea_gameplayClose{color:#9aa8d8;cursor:pointer;background:0 0;border:none;padding:0 2px;font-size:14px;position:absolute;top:4px;right:8px}.kz2Bea_gameplayClose:hover{color:#fff}.kz2Bea_gameplayFloat{color:#3a2a00;white-space:nowrap;pointer-events:none;background:#ffd27eeb;border-radius:999px;padding:2px 10px;font-size:11px;animation:1.1s ease-out forwards kz2Bea_pet-gameplay-float;position:absolute;top:-8px;left:50%;transform:translate(-50%)}@keyframes kz2Bea_pet-gameplay-float{0%{opacity:0;transform:translate(-50%)translateY(6px)}20%{opacity:1}to{opacity:0;transform:translate(-50%)translateY(-18px)}}@media (prefers-reduced-motion:reduce){.kz2Bea_gameplayFloat{opacity:1;animation:none}.kz2Bea_gameplayBarFill{transition:none}}";
+		const css$2 = ".kz2Bea_float{pointer-events:auto;-webkit-user-select:none;user-select:none;will-change:transform;contain:layout style;flex-direction:column;align-items:center;display:flex;position:fixed}.kz2Bea_sprite{image-rendering:auto;touch-action:none;contain:paint}.kz2Bea_spriteWrap{flex:none;position:relative}.kz2Bea_bubble{white-space:nowrap;color:#f4f7ff;pointer-events:none;border-radius:999px;margin-bottom:6px;padding:4px 10px;font-size:12px;line-height:1.4;animation:2.6s ease-out forwards kz2Bea_pet-bubble-pop;position:absolute;bottom:100%;box-shadow:0 2px 8px #00000040}.kz2Bea_bubblePet{background:#4d6bfef2}.kz2Bea_bubbleFeed{background:#0369a1f2}.kz2Bea_bubbleStatus{text-overflow:ellipsis;backdrop-filter:blur(8px);letter-spacing:.02em;background:linear-gradient(160deg,#131c36e6,#070b1af0);border:1px solid #7e98ff73;max-width:min(280px,100vw - 24px);padding:5px 12px;animation:.24s ease-out kz2Bea_pet-bubble-in;overflow:hidden;box-shadow:0 4px 12px #02061759,inset 0 1px #e2e8ff1a,0 0 12px #4d6bfe2e}.kz2Bea_bubbleWhisper{letter-spacing:.03em;animation:.32s cubic-bezier(.22,1,.36,1) kz2Bea_pet-whisper-in}.kz2Bea_bubbleWhisper:before{content:\"「\";opacity:.7;margin-right:2px}.kz2Bea_bubbleWhisper:after{content:\"」\";opacity:.7;margin-left:2px}.kz2Bea_bubbleStack{pointer-events:auto;flex-direction:column-reverse;align-items:center;gap:4px;display:flex;position:absolute;bottom:100%}.kz2Bea_bubbleAnchor{display:inline-flex;position:relative}.kz2Bea_bubbleMore{z-index:1;color:#eef2ff;cursor:pointer;background:linear-gradient(160deg,#4a68f5f2,#2f44b8f2);border:1px solid #7e98ff8c;border-radius:999px;justify-content:center;align-items:center;min-width:18px;height:18px;padding:0 5px;font-size:10px;font-weight:600;line-height:1;transition:filter .12s;display:inline-flex;position:absolute;top:-9px;right:-10px;box-shadow:0 2px 6px #02061766}.kz2Bea_bubbleMore:hover{filter:brightness(1.15)}.kz2Bea_bubbleMore:focus-visible{outline:none;box-shadow:0 0 0 2px #7e98ffe6}.kz2Bea_bubbleStack .kz2Bea_bubble{pointer-events:auto;margin-bottom:0;position:relative;bottom:auto}.kz2Bea_bubbleClickable{cursor:pointer;font:inherit;text-align:center;appearance:none;transition:filter .12s,box-shadow .12s}.kz2Bea_bubbleClickable:hover{filter:brightness(1.12)}.kz2Bea_bubbleClickable:focus-visible{outline:none;box-shadow:0 0 0 2px #7e98ffe6}@keyframes kz2Bea_pet-bubble-in{0%{opacity:0;transform:translateY(6px)scale(.96)}to{opacity:1;transform:translateY(0)scale(1)}}@keyframes kz2Bea_pet-whisper-in{0%{opacity:0;transform:translateY(8px)scale(.9)}60%{transform:translateY(-1px)scale(1.02)}to{opacity:1;transform:translateY(0)scale(1)}}@keyframes kz2Bea_pet-panel-in{0%{opacity:0;transform:translateY(4px)scale(.97)}to{opacity:1;transform:translateY(0)scale(1)}}@keyframes kz2Bea_pet-bubble-pop{0%{opacity:0;transform:translateY(6px)scale(.85)}15%{opacity:1;transform:translateY(0)scale(1.05)}25%{transform:translateY(0)scale(1)}75%{opacity:1}to{opacity:0;transform:translateY(-8px)scale(.95)}}.kz2Bea_panel{color:#e6ebf8;backdrop-filter:blur(10px);transform-origin:50% 0;background:linear-gradient(165deg,#131c36f2,#070b1af7);border:1px solid #7e98ff4d;border-radius:12px;flex-direction:column;gap:7px;min-width:148px;margin-top:8px;padding:10px 12px;font-size:12px;animation:.2s cubic-bezier(.22,1,.36,1) kz2Bea_pet-panel-in;display:flex;position:absolute;top:100%;box-shadow:0 8px 24px #02061773,0 0 0 1px #4d6bfe1a,inset 0 1px #e2e8ff14}.kz2Bea_panel:after{content:\"\";height:14px;position:absolute;bottom:100%;left:0;right:0}.kz2Bea_panelAbove{transform-origin:50% 100%;margin-top:0;margin-bottom:8px;top:auto;bottom:100%}.kz2Bea_panelAbove:after{top:100%;bottom:auto}.kz2Bea_rankRow{white-space:nowrap;justify-content:space-between;gap:10px;display:flex}.kz2Bea_nameCell{letter-spacing:.02em;background:linear-gradient(90deg,#a9c1ff,#6c8bff 60%,#4d6bfe);color:#0000;-webkit-background-clip:text;background-clip:text;font-weight:600}.kz2Bea_statRank{color:#9db4ff;font-weight:600}.kz2Bea_statTreats{color:#7dd3fc;font-weight:600}.kz2Bea_statPoints{color:#fcd34d;font-weight:600}.kz2Bea_renameRow{align-items:center;gap:6px;display:flex}.kz2Bea_nameInput{color:#e6ebf8;background:#131c36e6;border:1px solid #7e98ff80;border-radius:6px;outline:none;flex:1;min-width:0;padding:3px 6px;font-size:12px}.kz2Bea_nameInput:focus{border-color:#4d6bfe;box-shadow:0 0 0 2px #4d6bfe73}.kz2Bea_actions{gap:6px;display:flex}.kz2Bea_action{cursor:pointer;color:#fff;background:linear-gradient(#4a68f5,#3a55e0);border:none;border-radius:6px;flex:1;padding:4px 8px;font-size:12px;font-weight:600;transition:filter .12s,box-shadow .12s,transform .12s;box-shadow:0 2px 6px #4d6bfe4d}.kz2Bea_action:hover{filter:brightness(1.08);transform:translateY(-1px);box-shadow:0 4px 10px #4d6bfe66}.kz2Bea_action:active{filter:brightness(.94);transform:translateY(0);box-shadow:0 1px 4px #4d6bfe4d}.kz2Bea_action:focus-visible{outline:none;box-shadow:0 0 0 2px #7e98ffe6}.kz2Bea_summon{color:#8ea6ff;cursor:pointer;background:#070b1abf;border:1px dashed #7e98ff99;border-radius:999px;padding:2px 10px;font-size:11px;transition:border-color .12s,color .12s,background .12s,box-shadow .12s}.kz2Bea_summon:hover{color:#c3d3ff;background:#070b1ae6;border-color:#7e98fff2}.kz2Bea_summon:active{color:#8ea6ff;border-color:#7e98ffcc}.kz2Bea_summon:focus-visible{outline:none;box-shadow:0 0 0 2px #7e98ffe6}@media (prefers-reduced-motion:reduce){.kz2Bea_bubble,.kz2Bea_bubbleStatus,.kz2Bea_bubbleWhisper,.kz2Bea_panel{opacity:1;animation:none}.kz2Bea_action,.kz2Bea_summon,.kz2Bea_bubbleMore{transition:none}}.kz2Bea_gameplayHud{width:0;height:0;position:absolute;bottom:0;left:0}.kz2Bea_gameplayModeChip{color:#cdd7ff;white-space:nowrap;pointer-events:none;background:#7e98ff2e;border-radius:999px;padding:1px 8px;font-size:10px;position:absolute;top:0;left:0;transform:translateY(-100%)translateY(-4px)}.kz2Bea_gameplayCard{color:#dfe6ff;background:#070b1aeb;border:1px solid #7e98ff40;border-radius:10px;min-width:180px;max-height:340px;padding:10px 12px;font-size:12px;position:absolute;bottom:0;left:0;overflow-y:auto;transform:none;box-shadow:0 8px 24px #0006}.kz2Bea_gameplayBars{flex-direction:column;gap:4px;margin-bottom:8px;display:flex}.kz2Bea_gameplayBarRow{align-items:center;gap:6px;display:flex}.kz2Bea_gameplayBarLabel{color:#9aa8d8;flex-shrink:0;width:34px}.kz2Bea_gameplayBarTrack{background:#7e98ff26;border-radius:3px;flex:1;height:6px;overflow:hidden}.kz2Bea_gameplayBarFill{background:linear-gradient(90deg,#7e98ff,#9db4ff);border-radius:3px;height:100%;transition:width .3s;display:block}.kz2Bea_gameplayActions{flex-wrap:wrap;gap:6px;display:flex}.kz2Bea_gameplayShopItems{grid-template-columns:repeat(2,minmax(0,1fr));gap:8px;margin-bottom:8px;display:grid}.kz2Bea_gameplayShopItem{color:inherit;cursor:pointer;background:#7e98ff14;border:1px solid #7e98ff40;border-radius:8px;flex-direction:column;align-items:center;gap:4px;padding:8px 6px;display:flex}.kz2Bea_gameplayShopItem:hover{background:#7e98ff29;border-color:#7e98ffb3}.kz2Bea_gameplayShopItemImage{object-fit:contain;width:36px;height:36px;image-rendering:pixelated;pointer-events:none}.kz2Bea_gameplayShopItemLabel{text-align:center;font-size:11px}.kz2Bea_gameplayShopItemPrice{color:#ffd27e;font-size:10px}.kz2Bea_gameplayClose{color:#9aa8d8;cursor:pointer;background:0 0;border:none;padding:0 2px;font-size:14px;position:absolute;top:4px;right:8px}.kz2Bea_gameplayClose:hover{color:#fff}.kz2Bea_gameplayFloat{color:#3a2a00;white-space:nowrap;pointer-events:none;background:#ffd27eeb;border-radius:999px;padding:2px 10px;font-size:11px;animation:1.1s ease-out forwards kz2Bea_pet-gameplay-float;position:absolute;top:-8px;left:50%;transform:translate(-50%)}@keyframes kz2Bea_pet-gameplay-float{0%{opacity:0;transform:translate(-50%)translateY(6px)}20%{opacity:1}to{opacity:0;transform:translate(-50%)translateY(-18px)}}@media (prefers-reduced-motion:reduce){.kz2Bea_gameplayFloat{opacity:1;animation:none}.kz2Bea_gameplayBarFill{transition:none}}.kz2Bea_bubbleUsage{white-space:nowrap;backdrop-filter:blur(8px);letter-spacing:.02em;background:linear-gradient(160deg,#131c36eb,#070b1af2);border:1px solid #7e98ff73;flex-direction:column;align-items:stretch;gap:3px;min-width:128px;max-width:min(280px,100vw - 24px);padding:6px 12px;animation:.28s cubic-bezier(.22,1,.36,1) kz2Bea_pet-usage-in;display:flex;box-shadow:0 4px 12px #02061759,inset 0 1px #e2e8ff1a,0 0 12px #4d6bfe2e}.kz2Bea_bubbleUsageHead{justify-content:space-between;align-items:baseline;gap:10px;display:flex}.kz2Bea_bubbleUsageTitle{text-overflow:ellipsis;opacity:.85;overflow:hidden}.kz2Bea_bubbleUsageValue{font-variant-numeric:tabular-nums;flex-shrink:0;font-weight:600}.kz2Bea_bubbleUsageNote{text-overflow:ellipsis;opacity:.55;font-size:10px;overflow:hidden}.kz2Bea_bubbleUsageMeter{background:#e2e8ff24;border-radius:999px;height:4px;display:block;overflow:hidden}.kz2Bea_bubbleUsageMeterFill{background:#6ee7b7;border-radius:999px;height:100%;transition:width .3s;display:block}.kz2Bea_bubbleUsageOk{border-color:#7e98ff73}.kz2Bea_bubbleUsageWarn{border-color:#fbbf248c}.kz2Bea_bubbleUsageWarn .kz2Bea_bubbleUsageMeterFill{background:#fbbf24}.kz2Bea_bubbleUsageLow{border-color:#f8717199}.kz2Bea_bubbleUsageLow .kz2Bea_bubbleUsageMeterFill{background:#f87171}@keyframes kz2Bea_pet-usage-in{0%{opacity:0;transform:translateY(6px)scale(.96)}to{opacity:1;transform:translateY(0)scale(1)}}@media (prefers-reduced-motion:reduce){.kz2Bea_bubbleUsage{animation:none}}";
 		const tagId$2 = "@linxin666/dsh-pet/pet.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$2) + "]") === null) {
 			const tag = document.createElement("style");
@@ -191,6 +209,16 @@ window.__ModuleLoader__.load({
 			"bubblePet": "kz2Bea_bubblePet",
 			"bubbleStack": "kz2Bea_bubbleStack",
 			"bubbleStatus": "kz2Bea_bubbleStatus",
+			"bubbleUsage": "kz2Bea_bubbleUsage",
+			"bubbleUsageHead": "kz2Bea_bubbleUsageHead",
+			"bubbleUsageLow": "kz2Bea_bubbleUsageLow",
+			"bubbleUsageMeter": "kz2Bea_bubbleUsageMeter",
+			"bubbleUsageMeterFill": "kz2Bea_bubbleUsageMeterFill",
+			"bubbleUsageNote": "kz2Bea_bubbleUsageNote",
+			"bubbleUsageOk": "kz2Bea_bubbleUsageOk",
+			"bubbleUsageTitle": "kz2Bea_bubbleUsageTitle",
+			"bubbleUsageValue": "kz2Bea_bubbleUsageValue",
+			"bubbleUsageWarn": "kz2Bea_bubbleUsageWarn",
 			"bubbleWhisper": "kz2Bea_bubbleWhisper",
 			"float": "kz2Bea_float",
 			"gameplayActions": "kz2Bea_gameplayActions",
@@ -217,6 +245,7 @@ window.__ModuleLoader__.load({
 			"pet-bubble-pop": "kz2Bea_pet-bubble-pop",
 			"pet-gameplay-float": "kz2Bea_pet-gameplay-float",
 			"pet-panel-in": "kz2Bea_pet-panel-in",
+			"pet-usage-in": "kz2Bea_pet-usage-in",
 			"pet-whisper-in": "kz2Bea_pet-whisper-in",
 			"rankRow": "kz2Bea_rankRow",
 			"renameRow": "kz2Bea_renameRow",
@@ -319,6 +348,54 @@ window.__ModuleLoader__.load({
 			});
 		}
 		/**
+		* The announcement bubble (dsh-usage linkage): a dedicated, specially
+		* designed surface for sibling-plugin facts — a balance or today-spend pill,
+		* or a plan-quota card with a tone-tinted accent, a mini meter for percent
+		* windows, and the reset instant. It rides the top of the session bubble
+		* stack (column-reverse puts the DOM-last child farthest from the sprite)
+		* and persists for its TTL instead of the short feedback pop.
+		*/
+		function UsageAnnouncementBubble(props) {
+			const { announcement } = props;
+			const tone = announcement.tone === "low" ? pet_module_css_default.bubbleUsageLow : announcement.tone === "warn" ? pet_module_css_default.bubbleUsageWarn : pet_module_css_default.bubbleUsageOk;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: clsx(pet_module_css_default.bubble, pet_module_css_default.bubbleUsage, tone),
+				role: "status",
+				"aria-live": "polite",
+				"data-dsh-pet-announcement": announcement.source,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+						className: pet_module_css_default.bubbleUsageHead,
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: pet_module_css_default.bubbleUsageTitle,
+								children: announcement.title
+							}),
+							(announcement.kind === "balance" || announcement.kind === "cost") && announcement.amount !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: pet_module_css_default.bubbleUsageValue,
+								children: announcement.amount
+							}),
+							announcement.kind === "plan" && announcement.percent !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: pet_module_css_default.bubbleUsageValue,
+								children: Math.round(announcement.percent) + "%"
+							})
+						]
+					}),
+					announcement.kind === "plan" && announcement.percent !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: pet_module_css_default.bubbleUsageMeter,
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: pet_module_css_default.bubbleUsageMeterFill,
+							style: { width: Math.min(100, Math.max(0, announcement.percent)) + "%" }
+						})
+					}),
+					announcement.note !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: pet_module_css_default.bubbleUsageNote,
+						children: announcement.note
+					})
+				]
+			});
+		}
+		/**
 		* The floating pet. The spritesheet frame advances on requestAnimationFrame
 		* 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
@@ -517,7 +594,9 @@ window.__ModuleLoader__.load({
 			const stackOpen = stackPeek || stackPinned;
 			const visibleSessions = !stackOpen && sessionBubbles.length > 1 ? sessionBubbles.slice(0, 1) : sessionBubbles;
 			const statusBubble = feedback === null && sessionBubbles.length === 0 ? snapshot?.bubble : void 0;
-			const bubblePresent = feedback !== null || sessionBubbles.length > 0 || statusBubble !== void 0;
+			const announcement = snapshot?.announcement;
+			const usageAnnouncement = feedback === null && announcement !== void 0 && announcementFresh(announcement, Date.now()) ? announcement : void 0;
+			const bubblePresent = feedback !== null || sessionBubbles.length > 0 || statusBubble !== void 0 || usageAnnouncement !== void 0;
 			const displayName = snapshot?.name ?? definition.displayName;
 			const decoration = snapshot?.decoration;
 			(0, react.useEffect)(() => {
@@ -614,50 +693,54 @@ window.__ModuleLoader__.load({
 						className: clsx(pet_module_css_default.bubble, feedback.kind === "feed" ? pet_module_css_default.bubbleFeed : pet_module_css_default.bubblePet),
 						children: feedback.text
 					}, feedback.at),
-					feedback === null && (sessionBubbles.length > 0 || statusBubble !== void 0) && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					feedback === null && (sessionBubbles.length > 0 || statusBubble !== void 0 || usageAnnouncement !== void 0) && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						ref: bubbleRef,
 						className: pet_module_css_default.bubbleStack,
 						onPointerEnter: () => setStackPeek(true),
 						onPointerLeave: () => setStackPeek(false),
-						children: [visibleSessions.map((session, index) => {
-							const speaksWhisper = session.whisper !== void 0;
-							const bubble = /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
-								type: "button",
-								className: clsx(pet_module_css_default.bubble, pet_module_css_default.bubbleStatus, pet_module_css_default.bubbleClickable, speaksWhisper && pet_module_css_default.bubbleWhisper),
-								title: props.t("pet.openSessionHint"),
-								onClick: () => {
-									props.onOpenSession(session.sessionId);
-								},
-								children: [index === 0 && !speaksWhisper && decoration !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(StatusOrnament, {
-									decoration,
-									phase
-								}), session.whisper ?? session.bubble]
-							}, speaksWhisper ? "whisper:" + session.whisper : session.sessionId);
-							if (index !== 0 || sessionBubbles.length <= 1) return bubble;
-							return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
-								className: pet_module_css_default.bubbleAnchor,
-								children: [bubble, /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						children: [
+							visibleSessions.map((session, index) => {
+								const speaksWhisper = session.whisper !== void 0;
+								const bubble = /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 									type: "button",
-									className: pet_module_css_default.bubbleMore,
-									title: stackOpen ? props.t("pet.collapseSessions") : props.t("pet.moreSessions", { n: sessionBubbles.length - 1 }),
-									"aria-label": stackOpen ? props.t("pet.collapseSessions") : props.t("pet.moreSessions", { n: sessionBubbles.length - 1 }),
-									"aria-expanded": stackOpen,
-									onClick: (e) => {
-										e.stopPropagation();
-										setStackPinned((open) => !open);
+									className: clsx(pet_module_css_default.bubble, pet_module_css_default.bubbleStatus, pet_module_css_default.bubbleClickable, speaksWhisper && pet_module_css_default.bubbleWhisper),
+									title: props.t("pet.openSessionHint"),
+									onClick: () => {
+										props.onOpenSession(session.sessionId);
 									},
-									children: stackOpen ? "×" : "+" + String(sessionBubbles.length - 1)
-								})]
-							}, "primary");
-						}), sessionBubbles.length === 0 && statusBubble !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-							className: clsx(pet_module_css_default.bubble, pet_module_css_default.bubbleStatus),
-							role: "status",
-							"aria-live": "polite",
-							children: [decoration !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(StatusOrnament, {
-								decoration,
-								phase
-							}), statusBubble]
-						}, "status")]
+									children: [index === 0 && !speaksWhisper && decoration !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(StatusOrnament, {
+										decoration,
+										phase
+									}), session.whisper ?? session.bubble]
+								}, speaksWhisper ? "whisper:" + session.whisper : session.sessionId);
+								if (index !== 0 || sessionBubbles.length <= 1) return bubble;
+								return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+									className: pet_module_css_default.bubbleAnchor,
+									children: [bubble, /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: pet_module_css_default.bubbleMore,
+										title: stackOpen ? props.t("pet.collapseSessions") : props.t("pet.moreSessions", { n: sessionBubbles.length - 1 }),
+										"aria-label": stackOpen ? props.t("pet.collapseSessions") : props.t("pet.moreSessions", { n: sessionBubbles.length - 1 }),
+										"aria-expanded": stackOpen,
+										onClick: (e) => {
+											e.stopPropagation();
+											setStackPinned((open) => !open);
+										},
+										children: stackOpen ? "×" : "+" + String(sessionBubbles.length - 1)
+									})]
+								}, "primary");
+							}),
+							sessionBubbles.length === 0 && statusBubble !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: clsx(pet_module_css_default.bubble, pet_module_css_default.bubbleStatus),
+								role: "status",
+								"aria-live": "polite",
+								children: [decoration !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(StatusOrnament, {
+									decoration,
+									phase
+								}), statusBubble]
+							}, "status"),
+							usageAnnouncement !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(UsageAnnouncementBubble, { announcement: usageAnnouncement })
+						]
 					}),
 					hovered && dragRef.current === null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						ref: panelRef,
@@ -712,7 +795,12 @@ window.__ModuleLoader__.load({
 									children: displayName
 								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 									className: pet_module_css_default.statRank,
-									children: panelStat("rank", "pet.rank", { rank: snapshot?.affinity.rank ?? "?" })
+									children: (() => {
+										const rawRank = snapshot?.affinity.rank ?? "?";
+										const rankKey = `pet.rank.name.${rawRank}`;
+										const localized = props.t(rankKey);
+										return panelStat("rank", "pet.rank", { rank: localized !== rankKey ? localized : rawRank });
+									})()
 								})]
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -761,7 +849,7 @@ window.__ModuleLoader__.load({
 						] })
 					})
 				]
-			}), document.body);
+			}), props.portalTarget ?? document.body);
 		}
 		//#endregion
 		//#region src/client/drag-stream.ts
@@ -1431,10 +1519,11 @@ window.__ModuleLoader__.load({
 		* 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 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.
+		* (see index.ts): while visible it renders the floating PetSprite (a portal
+		* into the plugin root, so the root owns the whole surface), 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
 		*/
 		const DEFAULT_DISPLAY = {
@@ -1492,6 +1581,7 @@ window.__ModuleLoader__.load({
 						onRename: props.rename,
 						onOpenSession: props.openSession,
 						onFeedbackDone: props.feedbackDone,
+						portalTarget: props.portalTarget,
 						dragDisabled: snapshot.gameplay?.mode === "work",
 						...gameplay === void 0 || aux === null ? {} : {
 							onGameplayTap: (fx, fy) => aux.bus.tap?.(fx, fy),
@@ -1811,6 +1901,18 @@ window.__ModuleLoader__.load({
 		* 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
 		*/
 		/** Stall watchdog period: a looping track stuck longer re-kicks its chain. */
@@ -1844,19 +1946,79 @@ window.__ModuleLoader__.load({
 			validateConfig: validateFrames2dConfig,
 			mount(ctx, config) {
 				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);
-				for (const track of Object.values(config.tracks)) for (const url of track.frames) {
-					const pre = new Image();
-					pre.src = url;
+				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);
+				}
+				const decoding = /* @__PURE__ */ new Map();
+				const decodedAll = [];
+				const loadFrame = (url) => {
+					const cached = decoding.get(url);
+					if (cached !== void 0) 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 {
+							return await new Promise((resolve) => {
+								try {
+									const pre = new Image();
+									pre.onload = () => {
+										resolve(pre.naturalWidth > 0 ? {
+											source: pre,
+											width: pre.naturalWidth,
+											height: pre.naturalHeight
+										} : void 0);
+									};
+									pre.onerror = () => resolve(void 0);
+									pre.src = url;
+								} catch {
+									resolve(void 0);
+								}
+							});
+						}
+					})();
+					decoding.set(url, job);
+					decodedAll.push(job.then(() => void 0, () => void 0));
+					return job;
+				};
 				let disposed = false;
 				let timer;
 				let watchdog;
@@ -1864,13 +2026,35 @@ window.__ModuleLoader__.load({
 				let frameIndex = 0;
 				let lastAdvance = Date.now();
 				let override;
+				let drawToken = 0;
+				let lastDrawnUrl;
 				const trackForPhase = (phase) => {
 					const mapped = config.phases[phase];
 					return mapped !== void 0 && config.tracks[mapped] !== void 0 ? 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;
+					loadFrame(url).then((frame) => {
+						if (disposed || frame === void 0 || myToken !== drawToken) return;
+						if (lastDrawnUrl === url) return;
+						lastDrawnUrl = url;
+						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 url = config.tracks[trackId]?.frames[index];
-					if (url !== void 0 && img.getAttribute("src") !== url) img.src = url;
+					if (url === void 0) return;
+					if (img !== null) {
+						if (img.getAttribute("src") !== url) img.src = url;
+						return;
+					}
+					paintCanvas(url);
 				};
 				const schedule = (ms) => {
 					if (disposed) return;
@@ -1922,6 +2106,7 @@ window.__ModuleLoader__.load({
 					const expected = (def.durations[frameIndex] ?? 200) + WATCHDOG_MS;
 					if (Date.now() - lastAdvance > expected) tick();
 				}, WATCHDOG_MS);
+				for (const warmTrack of Object.values(config.tracks)) for (const warmUrl of warmTrack.frames) loadFrame(warmUrl);
 				play(track);
 				let disposedOnce = false;
 				const dispose = () => {
@@ -1931,7 +2116,17 @@ window.__ModuleLoader__.load({
 					unsubscribe();
 					if (timer !== void 0) clearTimeout(timer);
 					if (watchdog !== void 0) clearInterval(watchdog);
-					img.remove();
+					Promise.allSettled(decodedAll).then(() => {
+						for (const job of decoding.values()) job.then((frame) => {
+							try {
+								const maybeClose = (frame?.source)?.close;
+								if (typeof maybeClose === "function" && frame !== void 0) maybeClose.call(frame.source);
+							} catch {}
+						}).catch(() => {});
+						decoding.clear();
+					});
+					canvas?.remove();
+					img?.remove();
 				};
 				ctx.onCleanup(dispose);
 				return {
@@ -2584,7 +2779,7 @@ window.__ModuleLoader__.load({
 			}
 			/** Publish a projection of this form, rebuilt whenever the scope or a draft changes. */
 			bind(project) {
-				const store = (0, _deepseek_ai_dsh_client_runtime_client.createSnapshotStore)(project());
+				const store = createSnapshotStore(project());
 				this.listeners.add(() => {
 					store.set(project());
 				});
@@ -2599,7 +2794,7 @@ window.__ModuleLoader__.load({
 					exposed: snapshot.status === "ready",
 					writable: snapshot.writable,
 					dirty: plan.length > 0,
-					invalid: plan.some((item) => item.run === void 0),
+					invalid: plan.some((item) => item.judge === void 0),
 					saving: this.saving,
 					failed: this.failed,
 					...this.failedReason === void 0 ? {} : { failedReason: this.failedReason }
@@ -2649,45 +2844,52 @@ window.__ModuleLoader__.load({
 				};
 			}
 			/**
-			* Write every staged edit, then re-seed from what the Host accepted.
+			* Write every staged edit in one atomic scope mutation, then re-seed from
+			* what the Host accepted.
 			*
-			* When the scope carries the optional batch surface (the dsh-web
-			* bridge scope), every planned write rides one mutation so cross-field
-			* validate hooks (baseURL+model) judge the batch as a unit instead of
-			* deadlocking on per-field writes. Otherwise the per-field loop runs.
-			* A field lands only when the Host reports it held the staged value; a
-			* landed field's draft is dropped, a failed one stays staged for the user.
-			* @returns settlement after every write and the read-back.
+			* The whole batch rides one mutate, so cross-field validate hooks
+			* (baseURL+model) judge it as a unit: the Host either applies every write
+			* or refuses the batch. The 0.1.2 scope contract never rejects a refused
+			* mutation — the scope recovers with a fresh Host view and resolves — so
+			* resolution alone proves nothing: the outcome is judged by reading the
+			* settled snapshot back, one planned write at a time, and one missed write
+			* fails the whole save. A scope that still rejects on refusal (the dsh-web
+			* bridge scope) reports through the same failure path with its rejection
+			* message. A save that did not land keeps its drafts, so the user can
+			* correct them instead of retyping.
+			* @returns settlement after the mutation and the read-back.
 			*/
 			async save() {
 				const plan = this.plan();
-				const valid = plan.filter((item) => item.run !== void 0);
+				const valid = plan.filter((item) => item.judge !== void 0);
 				if (plan.length === 0 || this.saving || valid.length !== plan.length) return;
-				const plannedWrites = valid.map((item) => item.op);
 				const pending = /* @__PURE__ */ new Map();
 				for (const item of plan) pending.set(item.field, this.staged.get(item.field));
 				this.saving = true;
 				this.failed = false;
 				this.failedReason = void 0;
 				this.publish();
-				const landed = /* @__PURE__ */ new Set();
-				const batch = this.batchedScope();
-				if (batch !== void 0) {
-					const result = await batch.mutate(plannedWrites);
-					if (result.ok) {
-						for (const field of result.fields) if (field.landed) landed.add(field.field);
-					} else this.failedReason = result.message;
-				} else for (const item of valid) if (await item.run()) landed.add(item.field);
-				for (const [field, before] of pending) if (landed.has(field) && this.staged.get(field) === before) this.staged.delete(field);
+				const ops = valid.map((item) => item.op.op === "set" ? {
+					op: "set",
+					path: [item.field],
+					value: item.op.value
+				} : {
+					op: "unset",
+					path: [item.field]
+				});
+				let failedReason;
+				try {
+					await this.scope.mutate(ops);
+				} catch (error) {
+					failedReason = error instanceof Error ? error.message : String(error);
+				}
+				const landed = failedReason === void 0 && valid.every((item) => item.judge());
+				for (const [field, before] of pending) if (landed && this.staged.get(field) === before) this.staged.delete(field);
 				this.saving = false;
-				this.failed = landed.size !== pending.size;
+				this.failed = !landed;
+				this.failedReason = failedReason;
 				this.publish();
 			}
-			/** The scope's batch surface when it supports one; undefined conservatively otherwise. */
-			batchedScope() {
-				const candidate = this.scope;
-				return typeof candidate?.mutate === "function" ? candidate : void 0;
-			}
 			/**
 			* Every staged edit a save would write. An entry whose draft is not a value
 			* its field accepts carries no write: the form is still dirty, and the save
@@ -2706,7 +2908,7 @@ window.__ModuleLoader__.load({
 								field,
 								op: "unset"
 							},
-							run: () => this.clear(field)
+							judge: () => this.landedUnset(field)
 						});
 						continue;
 					}
@@ -2718,7 +2920,7 @@ window.__ModuleLoader__.load({
 							field,
 							op: "unset"
 						},
-						run: void 0
+						judge: void 0
 					});
 					else if (write.kind === "clear") plan.push({
 						field,
@@ -2726,7 +2928,7 @@ window.__ModuleLoader__.load({
 							field,
 							op: "unset"
 						},
-						run: () => this.clear(field)
+						judge: () => this.landedUnset(field)
 					});
 					else plan.push({
 						field,
@@ -2735,20 +2937,26 @@ window.__ModuleLoader__.load({
 							op: "set",
 							value: write.value
 						},
-						run: () => this.store(field, write.value)
+						judge: () => this.landedSet(field, write.value)
 					});
 				}
 				return plan;
 			}
-			async clear(field) {
-				await this.scope.unset(field);
-				return !this.stored(field);
-			}
-			async store(field, value) {
-				await this.scope.set(field, value);
+			/**
+			* Read-back judgment for a planned set: the user layer must hold the
+			* intended value once the mutation has settled.
+			*/
+			landedSet(field, value) {
 				if (this.specOf(field).secret) return true;
 				return this.userLayer()?.[field] === value;
 			}
+			/**
+			* Read-back judgment for a planned unset: the field must be gone from the
+			* user layer once the mutation has settled.
+			*/
+			landedUnset(field) {
+				return !this.stored(field);
+			}
 			stage(field, edit) {
 				this.staged.set(field, edit);
 				this.failed = false;
@@ -3081,6 +3289,15 @@ window.__ModuleLoader__.load({
 			"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": "宠物正在赶来…",
@@ -3131,7 +3348,7 @@ window.__ModuleLoader__.load({
 			"settings.off": "关",
 			"settings.overridden": "已覆盖",
 			"settings.reset": "恢复默认",
-			"settings.notExposed": "当前 DSH 版本未向设置页暴露本插件的配置命名空间，表单不可用。可编辑 ~/.dsh/settings.yaml 直接配置，或为 dsh-host-apiproxy 的 WEB_SETTINGS_NAMESPACES 白名单补充本命名空间后重启。",
+			"settings.notExposed": "当前 DSH 版本未向设置页暴露本插件的配置命名空间，表单不可用。可编辑 $DSH_HOME/settings.yaml 直接配置，或确认提供该命名空间的插件已挂载其设置域并重启。",
 			"settings.readOnly": "当前部署的设置只读。",
 			"settings.expand": "展开设置",
 			"settings.collapse": "收起设置",
@@ -3151,6 +3368,15 @@ window.__ModuleLoader__.load({
 			"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…",
@@ -3201,7 +3427,7 @@ window.__ModuleLoader__.load({
 			"settings.off": "Off",
 			"settings.overridden": "Overridden",
 			"settings.reset": "Reset to default",
-			"settings.notExposed": "This DSH version does not expose this plugin's settings namespace to the configuration page, so the form is unavailable. Edit ~/.dsh/settings.yaml directly, or add the namespace to dsh-host-apiproxy's WEB_SETTINGS_NAMESPACES allowlist and restart.",
+			"settings.notExposed": "This DSH version does not expose this plugin's settings namespace to the configuration page, so the form is unavailable. Edit $DSH_HOME/settings.yaml directly, or confirm that the plugin owning the namespace is mounted with its settings domain and restart.",
 			"settings.readOnly": "This deployment stores settings read-only.",
 			"settings.expand": "Show settings",
 			"settings.collapse": "Hide settings",
@@ -3242,7 +3468,7 @@ window.__ModuleLoader__.load({
 		/** The building package's version, when the bundle carries it. */
 		function bakedVersion() {
 			try {
-				return "0.3.5";
+				return "0.3.9";
 			} catch {
 				return;
 			}
@@ -3524,7 +3750,8 @@ window.__ModuleLoader__.load({
 					const petRoot = (0, react_dom_client.createRoot)(container);
 					petRoot.render((0, react.createElement)(PetDockEntry, {
 						...injected(),
-						t
+						t,
+						portalTarget: container
 					}));
 					let uiGone = false;
 					disposeUi = () => {