@linxin666/dsh-pet 0.1.1

package/lib/client.js

@@ -0,0 +1,1515 @@
+window.__ModuleLoader__.load({
+	id: "@linxin666/dsh-pet",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let _deepseek_ai_dsh_client_runtime_client = require("@deepseek-ai/dsh-client-runtime/client");
+		let react = require("react");
+		let react_dom = require("react-dom");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region src/client/pet-store.ts
+		/**
+		* Browser-side pet store: the pet state snapshot plus transient UI feedback
+		* (reaction bubbles), written only through the store's audit actions. The
+		* RPC polling and interactions live in the plugin apply body; components
+		* only ever read snapshots.
+		* @module @linxin666/dsh-pet/client/pet-store
+		*/
+		/** Create the pet store handle (apply world only; never module-level). */
+		function createPetStore() {
+			return (0, _deepseek_ai_dsh_client_runtime_client.defineStore)({
+				init: () => ({
+					snapshot: null,
+					state: "loading",
+					error: null,
+					feedback: null
+				}),
+				actions: {
+					setSnapshot: (draft, snapshot) => {
+						draft.snapshot = snapshot;
+						draft.state = "ready";
+						draft.error = null;
+					},
+					setState: (draft, state, error) => {
+						draft.state = state;
+						draft.error = error;
+					},
+					setFeedback: (draft, feedback) => {
+						draft.feedback = feedback;
+					}
+				}
+			});
+		}
+		/**
+		* Track definitions for the whale-girl. Durations are tuned for a soft,
+		* slow-healing feel (roughly 2.5× the earlier fast draft — the pet should
+		* breathe, not race); calibrate frame counts against the hatch-pet run when
+		* the asset lands (rows may carry 4–8 frames).
+		*/
+		const TRACKS = {
+			idle: {
+				frames: [
+					0,
+					1,
+					2,
+					3,
+					4,
+					5
+				],
+				durations: [
+					400,
+					400,
+					500,
+					400,
+					400,
+					500
+				],
+				loop: true
+			},
+			"running-right": {
+				frames: [
+					0,
+					1,
+					2,
+					3,
+					4,
+					5,
+					6,
+					7
+				],
+				durations: [
+					225,
+					225,
+					225,
+					225,
+					225,
+					225,
+					225,
+					225
+				],
+				loop: true
+			},
+			"running-left": {
+				frames: [
+					0,
+					1,
+					2,
+					3,
+					4,
+					5,
+					6,
+					7
+				],
+				durations: [
+					225,
+					225,
+					225,
+					225,
+					225,
+					225,
+					225,
+					225
+				],
+				loop: true
+			},
+			waving: {
+				frames: [
+					0,
+					1,
+					2,
+					3
+				],
+				durations: [
+					350,
+					350,
+					350,
+					350
+				],
+				loop: true
+			},
+			jumping: {
+				frames: [
+					0,
+					1,
+					2,
+					3,
+					4
+				],
+				durations: [
+					300,
+					300,
+					300,
+					350,
+					350
+				],
+				loop: false,
+				fallback: "idle"
+			},
+			failed: {
+				frames: [
+					0,
+					1,
+					2,
+					3,
+					4,
+					5,
+					6,
+					7
+				],
+				durations: [
+					450,
+					450,
+					450,
+					500,
+					550,
+					600,
+					450,
+					450
+				],
+				loop: false,
+				fallback: "idle"
+			},
+			waiting: {
+				frames: [
+					0,
+					1,
+					2,
+					3,
+					4,
+					5
+				],
+				durations: [
+					450,
+					450,
+					500,
+					450,
+					450,
+					500
+				],
+				loop: true
+			},
+			running: {
+				frames: [
+					0,
+					1,
+					2,
+					3,
+					4,
+					5
+				],
+				durations: [
+					250,
+					250,
+					250,
+					250,
+					250,
+					250
+				],
+				loop: true
+			},
+			review: {
+				frames: [
+					0,
+					1,
+					2,
+					3,
+					4,
+					5
+				],
+				durations: [
+					550,
+					550,
+					550,
+					550,
+					550,
+					550
+				],
+				loop: true
+			}
+		};
+		/** Row index of one animation track (mirrors state.ts rowOf). */
+		function rowOfTrack(animation) {
+			return {
+				idle: 0,
+				"running-right": 1,
+				"running-left": 2,
+				waving: 3,
+				jumping: 4,
+				failed: 5,
+				waiting: 6,
+				running: 7,
+				review: 8
+			}[animation];
+		}
+		/**
+		* Background-position (px) of one frame cell within the scaled atlas.
+		* The background image is scaled by `scale` (element size ÷ cell size), and
+		* background-position offsets are applied in SCALED coordinates — using raw
+		* atlas coordinates here would drift each frame by the scale factor and
+		* render torn/overlapping frames.
+		*/
+		function framePosition(row, col, scale = 1) {
+			return {
+				x: -col * 192 * scale,
+				y: -row * 208 * scale
+			};
+		}
+		/**
+		* Detect how many frames each row actually carries by scanning the decoded
+		* atlas for non-transparent cells (hatch-pet rows may hold 4–8 frames; the
+		* unused trailing cells are fully transparent). Rows whose every sample is
+		* transparent report 0.
+		* @param image - the fully decoded spritesheet (natural size 1536×1872).
+		* @returns per-row frame counts, length 9.
+		*/
+		function detectFrameCounts(image) {
+			const canvas = document.createElement("canvas");
+			canvas.width = image.naturalWidth;
+			canvas.height = image.naturalHeight;
+			const ctx = canvas.getContext("2d");
+			if (ctx === null) return Array.from({ length: 9 }, () => 8);
+			ctx.drawImage(image, 0, 0);
+			const data = ctx.getImageData(0, 0, canvas.width, canvas.height).data;
+			const counts = [];
+			const stride = 1536;
+			const probeStep = 8;
+			const margin = 12;
+			for (let row = 0; row < 9; row++) {
+				let count = 0;
+				for (let col = 0; col < 8; col++) {
+					let hasContent = false;
+					const x0 = col * 192;
+					const y0 = row * 208;
+					for (let y = y0 + margin; y < y0 + 208 - margin && !hasContent; y += probeStep) for (let x = x0 + margin; x < x0 + 192 - margin && !hasContent; x += probeStep) if ((data[(y * stride + x) * 4 + 3] ?? 0) > 8) hasContent = true;
+					if (hasContent) count += 1;
+				}
+				counts.push(count);
+			}
+			return counts;
+		}
+		/**
+		* Trim a track to the actual frame count of its row. A row with 0 detected
+		* frames degrades to the first frame (the atlas is still loading or corrupt)
+		* so the pet never renders blank.
+		*/
+		function trimTrack(track, frameCount) {
+			const n = Math.max(1, Math.min(frameCount, track.frames.length));
+			return {
+				frames: track.frames.slice(0, n),
+				durations: track.durations.slice(0, n),
+				loop: track.loop,
+				...track.fallback === void 0 ? {} : { fallback: track.fallback }
+			};
+		}
+		//#endregion
+		//#region \0dsh-css:/Users/zcl/code/dsh-web-ui/packages/dsh-pet/src/client/pet.module.css.mjs
+		const css$1 = ".Xhudva_float{pointer-events:auto;-webkit-user-select:none;user-select:none;flex-direction:column;align-items:center;display:flex;position:fixed}.Xhudva_sprite{image-rendering:auto;touch-action:none;position:relative}.Xhudva_bubble{white-space:nowrap;color:#fff;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 Xhudva_pet-bubble-pop;position:absolute;bottom:100%;box-shadow:0 2px 8px #00000040}.Xhudva_bubblePet{background:#f472b6eb}.Xhudva_bubbleFeed{background:#38bdf8eb}@keyframes Xhudva_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)}}.Xhudva_panel{color:#e2e8f0;backdrop-filter:blur(6px);background:#0f172aeb;border:1px solid #94a3b859;border-radius:10px;flex-direction:column;gap:6px;min-width:132px;padding:8px 10px;font-size:12px;display:flex;position:absolute;bottom:calc(100% + 4px);box-shadow:0 4px 16px #00000059}.Xhudva_rankRow{white-space:nowrap;justify-content:space-between;gap:10px;display:flex}.Xhudva_nameCell{font-weight:600}.Xhudva_renameRow{align-items:center;gap:6px;display:flex}.Xhudva_nameInput{color:#e2e8f0;background:#1e293be6;border:1px solid #7dd3fc80;border-radius:6px;outline:none;flex:1;min-width:0;padding:3px 6px;font-size:12px}.Xhudva_nameInput:focus{border-color:#38bdf8;box-shadow:0 0 0 2px #38bdf873}.Xhudva_actions{gap:6px;display:flex}.Xhudva_action{cursor:pointer;color:#0f172a;background:linear-gradient(#7dd3fc,#38bdf8);border:none;border-radius:6px;flex:1;padding:4px 8px;font-size:12px;transition:filter .12s,box-shadow .12s}.Xhudva_action:hover{filter:brightness(1.08)}.Xhudva_action:active{filter:brightness(.94)}.Xhudva_action:focus-visible{outline:none;box-shadow:0 0 0 2px #38bdf8d9}.Xhudva_summon{color:#7dd3fc;cursor:pointer;background:#0f172abf;border:1px dashed #7dd3fc99;border-radius:999px;padding:2px 10px;font-size:11px;transition:border-color .12s,color .12s,background .12s,box-shadow .12s}.Xhudva_summon:hover{color:#bae6fd;background:#0f172ae6;border-color:#7dd3fcf2}.Xhudva_summon:active{color:#7dd3fc;border-color:#7dd3fccc}.Xhudva_summon:focus-visible{outline:none;box-shadow:0 0 0 2px #38bdf8d9}@media (prefers-reduced-motion:reduce){.Xhudva_bubble{opacity:1;animation:none}.Xhudva_action,.Xhudva_summon{transition:none}}";
+		const tagId$1 = "@linxin666/dsh-pet/pet.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$1) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@linxin666/dsh-pet";
+			tag.dataset.pluginCss = tagId$1;
+			tag.textContent = css$1;
+			document.head.appendChild(tag);
+		}
+		var pet_module_css_default = {
+			"action": "Xhudva_action",
+			"actions": "Xhudva_actions",
+			"bubble": "Xhudva_bubble",
+			"bubbleFeed": "Xhudva_bubbleFeed",
+			"bubblePet": "Xhudva_bubblePet",
+			"float": "Xhudva_float",
+			"nameCell": "Xhudva_nameCell",
+			"nameInput": "Xhudva_nameInput",
+			"panel": "Xhudva_panel",
+			"pet-bubble-pop": "Xhudva_pet-bubble-pop",
+			"rankRow": "Xhudva_rankRow",
+			"renameRow": "Xhudva_renameRow",
+			"sprite": "Xhudva_sprite",
+			"summon": "Xhudva_summon"
+		};
+		//#endregion
+		//#region src/client/WhalePet.tsx
+		/**
+		* Whale-girl companion component — the browser half's centerpiece. Renders a
+		* fixed-position floating sprite (React portal onto document.body), plays
+		* the spritesheet track matching the host animation snapshot, and exposes
+		* the interaction surface: click to pet, hover panel with feed/hide, drag to
+		* reposition (persisted via setConfig).
+		* @module @linxin666/dsh-pet/client/WhalePet
+		*/
+		/** Browser URL of the whale-girl atlas (served by the host half's own route). */
+		const PET_SPRITESHEET_URL = "/pet/whale/spritesheet.webp";
+		/** Browser URL of the whale-girl manifest (authoritative per-row frame counts). */
+		const PET_MANIFEST_URL = "/pet/whale/pet.json";
+		/** Clamp a drag offset inside the viewport with a margin. */
+		function clampOffset(value, max) {
+			return Math.max(0, Math.min(max, value));
+		}
+		/**
+		* The floating pet. The spritesheet frame advances on requestAnimationFrame
+		* with per-frame durations from TRACKS; the atlas image is loaded once and
+		* the background position is written straight to the sprite element (no
+		* per-frame React state).
+		*/
+		function WhalePet(props) {
+			const { snapshot, display, feedback } = props;
+			const spriteRef = (0, react.useRef)(null);
+			const floatRef = (0, react.useRef)(null);
+			const [imageReady, setImageReady] = (0, react.useState)(false);
+			const [frameCounts, setFrameCounts] = (0, react.useState)(null);
+			const [hovered, setHovered] = (0, react.useState)(false);
+			const [renaming, setRenaming] = (0, react.useState)(false);
+			const [nameDraft, setNameDraft] = (0, react.useState)("");
+			const [dragPos, setDragPos] = (0, react.useState)(null);
+			const dragRef = (0, react.useRef)(null);
+			const frameRef = (0, react.useRef)({
+				track: null,
+				index: 0,
+				elapsed: 0
+			});
+			(0, react.useEffect)(() => {
+				let cancelled = false;
+				const img = new Image();
+				img.onload = () => {
+					if (cancelled) return;
+					setImageReady(true);
+					fetch(PET_MANIFEST_URL).then((res) => res.ok ? res.json() : Promise.resolve({})).then((manifest) => {
+						if (cancelled) return;
+						const frames = manifest.frames;
+						if (Array.isArray(frames) && frames.length === 9 && frames.every((n) => typeof n === "number")) setFrameCounts(frames);
+						else setFrameCounts(detectFrameCounts(img));
+					}).catch(() => {
+						if (!cancelled) setFrameCounts(detectFrameCounts(img));
+					});
+				};
+				img.src = PET_SPRITESHEET_URL;
+				return () => {
+					cancelled = true;
+					img.onload = null;
+				};
+			}, []);
+			const spriteScale = display.size / 208;
+			const animation = snapshot?.animation ?? "idle";
+			const scaleRef = (0, react.useRef)(spriteScale);
+			scaleRef.current = spriteScale;
+			(0, react.useEffect)(() => {
+				const reduceMotion = typeof window !== "undefined" && window.matchMedia?.("(prefers-reduced-motion: reduce)")?.matches === true;
+				const row = rowOfTrack(animation);
+				const leadCol = (frameCounts === null ? TRACKS[animation] : trimTrack(TRACKS[animation], frameCounts[row] ?? TRACKS[animation].frames.length)).frames[0];
+				const lead = framePosition(row, leadCol, scaleRef.current);
+				if (spriteRef.current !== null) spriteRef.current.style.backgroundPosition = `${lead.x}px ${lead.y}px`;
+				if (reduceMotion) return;
+				let raf = 0;
+				let last = performance.now();
+				const tick = (ts) => {
+					const delta = ts - last;
+					last = ts;
+					const row = rowOfTrack(animation);
+					const track = frameCounts === null ? TRACKS[animation] : trimTrack(TRACKS[animation], frameCounts[row] ?? TRACKS[animation].frames.length);
+					const st = frameRef.current;
+					if (st.track !== animation) {
+						st.track = animation;
+						st.index = 0;
+						st.elapsed = 0;
+					}
+					st.elapsed += delta;
+					const maxIndex = track.frames.length - 1;
+					while (st.elapsed >= (track.durations[st.index] ?? 0) && st.index < maxIndex) {
+						st.elapsed -= track.durations[st.index] ?? 0;
+						st.index += 1;
+					}
+					if (st.elapsed >= (track.durations[st.index] ?? 0)) if (track.loop) {
+						st.elapsed = 0;
+						st.index = 0;
+					} else st.index = maxIndex;
+					const col = track.frames[st.index];
+					const { x, y } = framePosition(row, col, scaleRef.current);
+					if (spriteRef.current !== null) spriteRef.current.style.backgroundPosition = `${x}px ${y}px`;
+					raf = requestAnimationFrame(tick);
+				};
+				raf = requestAnimationFrame(tick);
+				return () => cancelAnimationFrame(raf);
+			}, [animation, frameCounts]);
+			const feedbackDoneRef = (0, react.useRef)(props.onFeedbackDone);
+			feedbackDoneRef.current = props.onFeedbackDone;
+			(0, react.useEffect)(() => {
+				if (feedback === null) return;
+				const timer = window.setTimeout(() => feedbackDoneRef.current(), 2600);
+				return () => window.clearTimeout(timer);
+			}, [feedback]);
+			const draggedRef = (0, react.useRef)(false);
+			const onPointerDown = (e) => {
+				e.preventDefault();
+				e.target.setPointerCapture?.(e.pointerId);
+				const current = dragPos ?? {
+					right: display.right,
+					bottom: display.bottom
+				};
+				dragRef.current = {
+					startX: e.clientX,
+					startY: e.clientY,
+					...current
+				};
+				draggedRef.current = false;
+				setHovered(false);
+			};
+			const onPointerMove = (e) => {
+				const drag = dragRef.current;
+				if (drag === null) return;
+				const dx = e.clientX - drag.startX;
+				const dy = e.clientY - drag.startY;
+				if (Math.abs(dx) > 4 || Math.abs(dy) > 4) draggedRef.current = true;
+				const right = clampOffset(drag.right - dx, window.innerWidth - 40);
+				const bottom = clampOffset(drag.bottom - dy, window.innerHeight - 40);
+				setDragPos({
+					right,
+					bottom
+				});
+			};
+			const onPointerUp = () => {
+				if (dragRef.current === null) return;
+				dragRef.current = null;
+				if (dragPos !== null) props.onDragEnd(dragPos.right, dragPos.bottom);
+			};
+			const pos = dragPos ?? {
+				right: display.right,
+				bottom: display.bottom
+			};
+			const spriteWidth = Math.round(192 * spriteScale);
+			const spriteHeight = Math.round(208 * spriteScale);
+			return (0, react_dom.createPortal)(/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				ref: floatRef,
+				className: pet_module_css_default.float,
+				style: {
+					right: pos.right,
+					bottom: pos.bottom,
+					zIndex: 2147483e3
+				},
+				onPointerEnter: () => setHovered(true),
+				onPointerLeave: (e) => {
+					const next = e.relatedTarget;
+					if (next instanceof Node && floatRef.current?.contains(next)) return;
+					setHovered(false);
+				},
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						ref: spriteRef,
+						className: pet_module_css_default.sprite,
+						style: {
+							width: spriteWidth,
+							height: spriteHeight,
+							backgroundImage: imageReady ? `url(${PET_SPRITESHEET_URL})` : void 0,
+							backgroundSize: `${1536 * spriteScale}px ${1872 * spriteScale}px`,
+							backgroundRepeat: "no-repeat",
+							backgroundPosition: "0 0",
+							cursor: dragRef.current === null ? "grab" : "grabbing"
+						},
+						onPointerDown,
+						onPointerMove,
+						onPointerUp,
+						onClick: () => {
+							if (draggedRef.current) return;
+							props.onPet();
+						},
+						role: "button",
+						"aria-label": "whale girl"
+					}),
+					feedback !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: `${pet_module_css_default.bubble} ${feedback.kind === "feed" ? pet_module_css_default.bubbleFeed : pet_module_css_default.bubblePet}`,
+						children: feedback.text
+					}, feedback.at),
+					hovered && dragRef.current === null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: pet_module_css_default.panel,
+						children: renaming ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: pet_module_css_default.renameRow,
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+								className: pet_module_css_default.nameInput,
+								value: nameDraft,
+								maxLength: 20,
+								placeholder: props.t("pet.namePlaceholder"),
+								autoFocus: true,
+								onChange: (e) => setNameDraft(e.target.value),
+								onKeyDown: (e) => {
+									if (e.key === "Enter") {
+										const trimmed = nameDraft.trim();
+										if (trimmed !== "") {
+											props.onRename(trimmed);
+											setRenaming(false);
+										}
+									} else if (e.key === "Escape") setRenaming(false);
+								}
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: pet_module_css_default.action,
+								onClick: () => {
+									const trimmed = nameDraft.trim();
+									if (trimmed !== "") {
+										props.onRename(trimmed);
+										setRenaming(false);
+									}
+								},
+								children: props.t("pet.confirm")
+							})]
+						}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: pet_module_css_default.rankRow,
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: pet_module_css_default.nameCell,
+									children: snapshot?.name ?? "鲸鱼娘"
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: props.t("pet.rank", { rank: snapshot?.affinity.rank ?? "?" }) })]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: pet_module_css_default.rankRow,
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: props.t("pet.treats", { n: snapshot?.treats.stocked ?? 0 }) }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: props.t("pet.points", { points: snapshot?.affinity.points ?? 0 }) })]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: pet_module_css_default.actions,
+								children: [
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: pet_module_css_default.action,
+										onClick: props.onFeed,
+										children: props.t("pet.feed")
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: pet_module_css_default.action,
+										onClick: () => {
+											setNameDraft(snapshot?.name ?? "");
+											setRenaming(true);
+										},
+										children: props.t("pet.rename")
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: pet_module_css_default.action,
+										onClick: props.onHide,
+										children: props.t("pet.hide")
+									})
+								]
+							})
+						] })
+					})
+				]
+			}), document.body);
+		}
+		//#endregion
+		//#region src/client/PetDockEntry.tsx
+		/**
+		* Dock anchor inside `conversation.input.selector.context`: the input
+		* selector row mounts in EVERY conversation phase (no-session cold start,
+		* the blank-session hero, and the active seat), so the floating pet stays on
+		* screen on the new-conversation screen too. While visible it mounts the
+		* floating WhalePet (portal); while hidden it renders the summon button.
+		* @module @linxin666/dsh-pet/client/PetDockEntry
+		*/
+		const DEFAULT_DISPLAY = {
+			visible: true,
+			size: 160,
+			right: 24,
+			bottom: 20
+		};
+		/**
+		* Dock entry: while the pet is visible, mount the floating WhalePet (it
+		* portals itself onto document.body); while hidden, render the summon
+		* button so the pet can always come back. The store is the plugin-owned
+		* single instance — the slot system provides none because the pet is
+		* host-global, not session-scoped.
+		*/
+		function PetDockEntry(props) {
+			const { store, ensure } = props;
+			const ui = (0, react.useSyncExternalStore)(store.subscribe, store.getSnapshot);
+			const snapshot = ui.snapshot;
+			const feedback = ui.feedback;
+			const visible = snapshot?.display.visible ?? true;
+			(0, react.useEffect)(() => {
+				ensure();
+			}, [ensure]);
+			if (visible) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				"data-pet-dock": true,
+				"data-testid": "pet-dock",
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(WhalePet, {
+					snapshot,
+					display: snapshot?.display ?? DEFAULT_DISPLAY,
+					feedback,
+					onPet: props.pet,
+					onFeed: props.feed,
+					onHide: props.hide,
+					onDragEnd: props.dragEnd,
+					onRename: props.rename,
+					onFeedbackDone: props.feedbackDone,
+					t: props.t
+				})
+			});
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+				type: "button",
+				className: pet_module_css_default.summon,
+				onClick: props.summon,
+				"data-testid": "pet-summon",
+				children: props.t("pet.summon", { name: snapshot?.name ?? "鲸鱼娘" })
+			});
+		}
+		//#endregion
+		//#region \0dsh-css:/Users/zcl/code/dsh-web-ui/packages/dsh-pet/src/client/settings-card.module.css.mjs
+		const css = "._2dHfjG_card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:8px;list-style:none;transition:border-color .16s,background .16s;overflow:hidden}._2dHfjG_cardOpen{background:var(--dsw-alias-bg-layer-2);border-color:var(--dsw-alias-label-dimmed)}._2dHfjG_header{cursor:pointer;text-align:left;width:100%;font:inherit;background:0 0;border:0;align-items:center;gap:8px;padding:10px 14px;transition:background .12s;display:flex}._2dHfjG_header:hover{background:var(--dsw-alias-interactive-bg-hover)}._2dHfjG_header:active{background:var(--dsw-alias-interactive-bg-hover-solid)}._2dHfjG_header:focus-visible{box-shadow:inset 0 0 0 2px var(--dsw-alias-button-info-fill);outline:none}._2dHfjG_headText{flex-direction:column;flex:1;gap:2px;min-width:0;display:flex}._2dHfjG_name{color:var(--dsw-alias-label-primary);font-weight:600}._2dHfjG_description{color:var(--dsw-alias-label-tertiary);font-size:12px}._2dHfjG_pending{color:var(--dsw-alias-state-warn-primary);font-size:12px}._2dHfjG_chevron{color:var(--dsw-alias-label-tertiary);transition:transform .12s}._2dHfjG_chevronOpen{transform:rotate(180deg)}._2dHfjG_body{flex-direction:column;gap:14px;padding:0 14px 14px;display:flex}._2dHfjG_readOnly{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px}._2dHfjG_footer{justify-content:flex-end;align-items:center;gap:8px;display:flex}._2dHfjG_failed{color:var(--dsw-alias-state-error-primary);margin:0 auto 0 0;font-size:12px}._2dHfjG_discard,._2dHfjG_save{font:inherit;cursor:pointer;border-radius:6px;padding:5px 12px;font-size:13px;transition:color .12s,border-color .12s,background .12s,box-shadow .12s}._2dHfjG_discard{border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);background:0 0}._2dHfjG_discard:hover:not(:disabled){color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-label-dimmed)}._2dHfjG_discard:active:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}._2dHfjG_save{border:1px solid var(--dsw-alias-button-info-fill);background:var(--dsw-alias-button-info-fill);color:var(--dsw-alias-label-primary-foreground)}._2dHfjG_save:hover:not(:disabled){border-color:var(--dsw-alias-button-info-hover);background:var(--dsw-alias-button-info-hover)}._2dHfjG_save:active:not(:disabled){filter:brightness(.94)}._2dHfjG_discard:focus-visible:not(:disabled),._2dHfjG_save:focus-visible:not(:disabled){box-shadow:0 0 0 2px var(--dsw-alias-button-info-fill);outline:none}._2dHfjG_discard:disabled,._2dHfjG_save:disabled{opacity:.5;cursor:default}._2dHfjG_field{flex-direction:column;gap:4px;display:flex}._2dHfjG_head{align-items:center;gap:8px;display:flex}._2dHfjG_label{color:var(--dsw-alias-label-primary);font-size:13px;font-weight:500}._2dHfjG_badges{align-items:center;gap:6px;display:flex}._2dHfjG_badge{background:var(--dsw-alias-interactive-bg-hover-accent);color:var(--dsw-alias-state-business-primary);border-radius:999px;padding:1px 6px;font-size:11px}._2dHfjG_reset{color:var(--dsw-alias-state-business-primary);cursor:pointer;background:0 0;border:0;border-radius:3px;padding:0;font-size:11px;transition:color .12s,box-shadow .12s}._2dHfjG_reset:hover:not(:disabled){color:var(--dsw-alias-label-primary-bluish);text-decoration:underline}._2dHfjG_reset:active:not(:disabled){color:var(--dsw-alias-state-business-primary)}._2dHfjG_reset:focus-visible:not(:disabled){box-shadow:0 0 0 2px var(--dsw-alias-button-info-fill);outline:none}._2dHfjG_reset:disabled{opacity:.5;cursor:default}._2dHfjG_input,._2dHfjG_select{border:1px solid var(--dsw-alias-border-l2);font:inherit;color:var(--dsw-alias-label-primary);background:var(--dsw-specific-input-major);border-radius:6px;padding:6px 8px;font-size:13px}._2dHfjG_inputInvalid{border:1px solid var(--dsw-alias-state-error-primary);font:inherit;color:var(--dsw-alias-label-primary);border-radius:6px;padding:6px 8px;font-size:13px}._2dHfjG_input:disabled,._2dHfjG_select:disabled{opacity:.6}._2dHfjG_input:focus,._2dHfjG_select:focus{border-color:var(--dsw-alias-button-info-fill);box-shadow:0 0 0 2px var(--dsw-alias-button-info-fill);outline:none}._2dHfjG_inputInvalid:focus{box-shadow:0 0 0 2px var(--dsw-alias-state-error-primary);outline:none}._2dHfjG_hint{color:var(--dsw-alias-label-secondary);margin:0;font-size:12px}._2dHfjG_invalid{color:var(--dsw-alias-state-error-primary);margin:0;font-size:12px}@media (prefers-reduced-motion:reduce){._2dHfjG_card,._2dHfjG_header,._2dHfjG_chevron,._2dHfjG_chevronOpen,._2dHfjG_reset,._2dHfjG_discard,._2dHfjG_save{transition:none}}";
+		const tagId = "@linxin666/dsh-pet/settings-card.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@linxin666/dsh-pet";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var settings_card_module_css_default = {
+			"badge": "_2dHfjG_badge",
+			"badges": "_2dHfjG_badges",
+			"body": "_2dHfjG_body",
+			"card": "_2dHfjG_card",
+			"cardOpen": "_2dHfjG_cardOpen",
+			"chevron": "_2dHfjG_chevron",
+			"chevronOpen": "_2dHfjG_chevronOpen",
+			"description": "_2dHfjG_description",
+			"discard": "_2dHfjG_discard",
+			"failed": "_2dHfjG_failed",
+			"field": "_2dHfjG_field",
+			"footer": "_2dHfjG_footer",
+			"head": "_2dHfjG_head",
+			"headText": "_2dHfjG_headText",
+			"header": "_2dHfjG_header",
+			"hint": "_2dHfjG_hint",
+			"input": "_2dHfjG_input",
+			"inputInvalid": "_2dHfjG_inputInvalid",
+			"invalid": "_2dHfjG_invalid",
+			"label": "_2dHfjG_label",
+			"name": "_2dHfjG_name",
+			"pending": "_2dHfjG_pending",
+			"readOnly": "_2dHfjG_readOnly",
+			"reset": "_2dHfjG_reset",
+			"save": "_2dHfjG_save",
+			"select": "_2dHfjG_select"
+		};
+		//#endregion
+		//#region src/client/PluginSettingsCard.tsx
+		/**
+		* Shared chrome for the plugin settings card: a disclosure header naming the
+		* plugin and what its settings govern, the controls inside, and the save that
+		* writes them. Renders nothing while the namespace is unavailable — a
+		* deployment that does not compose the owning plugin should show no trace of
+		* it. Mirrors the official ui-plugin-config PluginCard in a self-contained
+		* slice (this package must not depend on a sibling UI package).
+		*/
+		/**
+		* Render one plugin settings card.
+		* @param props - the plugin's copy keys, its form state, and its controls.
+		* @returns the card, or nothing when the namespace is unavailable.
+		*/
+		function PluginSettingsCard(props) {
+			const [open, setOpen] = (0, react.useState)(false);
+			const { state } = props;
+			if (!state.available) return null;
+			const title = props.t(props.titleKey);
+			const blocked = !state.dirty || state.invalid || state.saving;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", {
+				className: settings_card_module_css_default.card,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+					type: "button",
+					className: settings_card_module_css_default.header,
+					"aria-expanded": open,
+					"aria-label": `${props.t(open ? "settings.collapse" : "settings.expand")}: ${title}`,
+					onClick: () => {
+						setOpen(!open);
+					},
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+							className: settings_card_module_css_default.headText,
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: settings_card_module_css_default.name,
+								children: title
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: settings_card_module_css_default.description,
+								children: props.t(props.descriptionKey)
+							})]
+						}),
+						state.dirty ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: settings_card_module_css_default.pending,
+							children: props.t("settings.unsaved")
+						}) : null,
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: open ? settings_card_module_css_default.chevronOpen : settings_card_module_css_default.chevron,
+							children: "▾"
+						})
+					]
+				}), open ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: settings_card_module_css_default.body,
+					children: [
+						!state.writable ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							className: settings_card_module_css_default.readOnly,
+							role: "status",
+							children: props.t("settings.readOnly")
+						}) : null,
+						props.children,
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: settings_card_module_css_default.footer,
+							children: [
+								state.failed ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+									className: settings_card_module_css_default.failed,
+									role: "status",
+									children: props.t("settings.saveFailed")
+								}) : null,
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									className: settings_card_module_css_default.discard,
+									disabled: !state.dirty || state.saving,
+									onClick: props.onDiscard,
+									children: props.t("settings.discard")
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									className: settings_card_module_css_default.save,
+									disabled: blocked,
+									onClick: props.onSave,
+									children: props.t(!state.saving ? "settings.save" : "settings.saving")
+								})
+							]
+						})
+					]
+				}) : null]
+			});
+		}
+		/** A staged value field. `numeric` only hints the keypad: which drafts a field accepts is decided by its spec. */
+		function ValueField(props) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: settings_card_module_css_default.field,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: settings_card_module_css_default.head,
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
+							className: settings_card_module_css_default.label,
+							htmlFor: props.id,
+							children: props.label
+						}), props.overridden ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+							className: settings_card_module_css_default.badges,
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: settings_card_module_css_default.badge,
+								children: props.overriddenLabel
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: settings_card_module_css_default.reset,
+								disabled: props.disabled,
+								onClick: props.onReset,
+								children: props.resetLabel
+							})]
+						}) : null]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+						id: props.id,
+						className: props.invalid ? settings_card_module_css_default.inputInvalid : settings_card_module_css_default.input,
+						type: "text",
+						...props.numeric === true ? { inputMode: "numeric" } : {},
+						...props.invalid ? { "aria-invalid": true } : {},
+						value: props.text,
+						placeholder: props.placeholder ?? "",
+						disabled: props.disabled,
+						onChange: (event) => {
+							props.onEdit(event.target.value);
+						}
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: props.invalid ? settings_card_module_css_default.invalid : settings_card_module_css_default.hint,
+						children: props.invalid ? props.invalidLabel : props.hint
+					})
+				]
+			});
+		}
+		/** A staged boolean field: 继承 / 开 / 关. */
+		function BooleanField(props) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: settings_card_module_css_default.field,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: settings_card_module_css_default.head,
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
+							className: settings_card_module_css_default.label,
+							htmlFor: props.id,
+							children: props.label
+						}), props.overridden ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+							className: settings_card_module_css_default.badges,
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: settings_card_module_css_default.badge,
+								children: props.overriddenLabel
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: settings_card_module_css_default.reset,
+								disabled: props.disabled,
+								onClick: props.onReset,
+								children: props.resetLabel
+							})]
+						}) : null]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
+						id: props.id,
+						className: settings_card_module_css_default.select,
+						value: props.text,
+						disabled: props.disabled,
+						onChange: (event) => {
+							props.onEdit(event.target.value);
+						},
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+								value: "",
+								children: props.inheritLabel
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+								value: "true",
+								children: props.onLabel
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+								value: "false",
+								children: props.offLabel
+							})
+						]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: settings_card_module_css_default.hint,
+						children: props.hint
+					})
+				]
+			});
+		}
+		//#endregion
+		//#region src/client/settings-form.ts
+		/** A whole-number field. An empty draft clears the field; any other draft that is not a finite number blocks the save. */
+		function numberField(field) {
+			return {
+				field,
+				format: (value) => typeof value === "number" ? String(value) : "",
+				parse: (text) => {
+					const trimmed = text.trim();
+					if (trimmed === "") return { kind: "clear" };
+					const parsed = Number(trimmed);
+					return Number.isFinite(parsed) ? {
+						kind: "set",
+						value: parsed
+					} : void 0;
+				}
+			};
+		}
+		/** A free-text field. An empty draft clears the field. */
+		function textField(field) {
+			return {
+				field,
+				format: (value) => typeof value === "string" ? value : "",
+				parse: (text) => {
+					const trimmed = text.trim();
+					return trimmed === "" ? { kind: "clear" } : {
+						kind: "set",
+						value: trimmed
+					};
+				}
+			};
+		}
+		/** A boolean field, edited through true/false draft text. */
+		function booleanField(field) {
+			return {
+				field,
+				format: (value) => typeof value === "boolean" ? String(value) : "",
+				parse: (text) => {
+					if (text === "true") return {
+						kind: "set",
+						value: true
+					};
+					if (text === "false") return {
+						kind: "set",
+						value: false
+					};
+				}
+			};
+		}
+		/**
+		* Stages one card's edits over one settings namespace and writes them on save.
+		*
+		* The Host is the only authority on whether a value was accepted — its
+		* validators own the constraints no schema can express — so the outcome is
+		* read back from the section rather than predicted here. A save that did not
+		* land keeps its drafts, so the user can correct them instead of retyping.
+		*/
+		var CardForm = class {
+			scope;
+			specs;
+			staged = /* @__PURE__ */ new Map();
+			listeners = /* @__PURE__ */ new Set();
+			saving = false;
+			failed = false;
+			/** @param scope - the bound settings scope for this card's namespace. */
+			constructor(scope, specs) {
+				this.scope = scope;
+				this.specs = new Map(specs.map((spec) => [spec.field, spec]));
+				scope.subscribe(() => {
+					this.publish();
+				});
+			}
+			/** 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());
+				this.listeners.add(() => {
+					store.set(project());
+				});
+				return store;
+			}
+			/** Read the card-level state: what the Host serves, and what a save would do. */
+			shell() {
+				const snapshot = this.scope.getSnapshot();
+				const plan = this.plan();
+				return {
+					available: snapshot.status === "ready",
+					writable: snapshot.writable,
+					dirty: plan.length > 0,
+					invalid: plan.some((item) => item.run === void 0),
+					saving: this.saving,
+					failed: this.failed
+				};
+			}
+			/** Read one field's state from the effective section and its staged draft. */
+			field(field) {
+				const spec = this.specOf(field);
+				const staged = this.staged.get(field);
+				if (staged === void 0) return {
+					text: spec.format(this.sectionValue(field)),
+					overridden: this.stored(field),
+					invalid: false
+				};
+				const write = staged.clear ? { kind: "clear" } : spec.parse(staged.text);
+				return {
+					text: staged.text,
+					overridden: write?.kind === "set",
+					invalid: write === void 0
+				};
+			}
+			/** The actions the card's slot registration injects. */
+			actions() {
+				return {
+					edit: (field, text) => {
+						this.stage(field, {
+							text,
+							clear: false
+						});
+					},
+					resetField: (field) => {
+						this.stage(field, {
+							text: this.specOf(field).format(this.baseValue(field)),
+							clear: true
+						});
+					},
+					save: () => {
+						this.save();
+					},
+					discard: () => {
+						if (this.staged.size === 0 && !this.failed) return;
+						this.staged.clear();
+						this.failed = false;
+						this.publish();
+					}
+				};
+			}
+			/**
+			* Write every staged edit, then re-seed from what the Host accepted.
+			* @returns settlement after every write and the read-back.
+			*/
+			async save() {
+				const plan = this.plan();
+				const writes = plan.flatMap((item) => item.run === void 0 ? [] : [item.run]);
+				if (plan.length === 0 || this.saving || writes.length !== plan.length) return;
+				this.saving = true;
+				this.failed = false;
+				this.publish();
+				let landed = true;
+				for (const write of writes) landed = await write() && landed;
+				if (landed) this.staged.clear();
+				this.saving = false;
+				this.failed = !landed;
+				this.publish();
+			}
+			/**
+			* 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
+			* refuses rather than dropping the edit. A staged edit that matches the
+			* effective section is not a write at all.
+			* @returns the planned writes, in the order the fields were staged.
+			*/
+			plan() {
+				const plan = [];
+				for (const [field, staged] of this.staged) {
+					const spec = this.specOf(field);
+					if (staged.clear) {
+						if (this.stored(field)) plan.push({
+							field,
+							run: () => this.clear(field)
+						});
+						continue;
+					}
+					if (staged.text === spec.format(this.sectionValue(field))) continue;
+					const write = spec.parse(staged.text);
+					if (write === void 0) plan.push({
+						field,
+						run: void 0
+					});
+					else if (write.kind === "clear") plan.push({
+						field,
+						run: () => this.clear(field)
+					});
+					else plan.push({
+						field,
+						run: () => this.store(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);
+				return this.userLayer()?.[field] === value;
+			}
+			stage(field, edit) {
+				this.staged.set(field, edit);
+				this.failed = false;
+				this.publish();
+			}
+			specOf(field) {
+				const spec = this.specs.get(field);
+				if (spec === void 0) throw new Error(`settings card has no field ${field}`);
+				return spec;
+			}
+			snapshotOf() {
+				return this.scope.getSnapshot();
+			}
+			sectionValue(field) {
+				return this.snapshotOf().value?.[field];
+			}
+			baseValue(field) {
+				return this.snapshotOf().base?.[field];
+			}
+			userLayer() {
+				return this.snapshotOf().user;
+			}
+			stored(field) {
+				const user = this.userLayer();
+				return user !== void 0 && Object.hasOwn(user, field);
+			}
+			publish() {
+				for (const listener of this.listeners) listener();
+			}
+		};
+		//#endregion
+		//#region src/client/PetSettingsCard.tsx
+		/** Bridges the `pet` scope onto the card's staged form. */
+		var PetSettingsCardController = class {
+			form;
+			store;
+			/** @param scope - the bound settings scope for the `pet` namespace. */
+			constructor(scope) {
+				this.form = new CardForm(scope, [
+					booleanField("enabled"),
+					booleanField("visible"),
+					numberField("size"),
+					numberField("right"),
+					numberField("bottom"),
+					textField("name")
+				]);
+				this.store = this.form.bind(() => this.projection());
+			}
+			projection() {
+				return {
+					...this.form.shell(),
+					enabled: this.form.field("enabled"),
+					visible: this.form.field("visible"),
+					size: this.form.field("size"),
+					right: this.form.field("right"),
+					bottom: this.form.field("bottom"),
+					name: this.form.field("name")
+				};
+			}
+			/**
+			* Build the face the card's slot registration injects.
+			* @returns the card's snapshot and its form actions.
+			*/
+			inject() {
+				return {
+					hooks: { petSettingsCard: this.store },
+					...this.form.actions()
+				};
+			}
+		};
+		/**
+		* Render the pet settings card.
+		* @param props - locale copy, the card snapshot, and its form actions.
+		* @returns the card.
+		*/
+		function PetSettingsCard(props) {
+			const { t } = props;
+			const state = props.usePetSettingsCard((snapshot) => snapshot);
+			const disabled = !state.writable;
+			const fieldProps = {
+				overriddenLabel: t("settings.overridden"),
+				resetLabel: t("settings.reset"),
+				invalidLabel: t("settings.invalidNumber"),
+				disabled
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(PluginSettingsCard, {
+				t,
+				titleKey: "settings.title",
+				descriptionKey: "settings.description",
+				state,
+				onSave: props.save,
+				onDiscard: props.discard,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(BooleanField, {
+						id: "settings-pet-enabled",
+						label: t("settings.enabled"),
+						hint: t("settings.enabledHint"),
+						inheritLabel: t("settings.inherit"),
+						onLabel: t("settings.on"),
+						offLabel: t("settings.off"),
+						...fieldProps,
+						...state.enabled,
+						onEdit: (text) => {
+							props.edit("enabled", text);
+						},
+						onReset: () => {
+							props.resetField("enabled");
+						}
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(BooleanField, {
+						id: "settings-pet-visible",
+						label: t("settings.visible"),
+						hint: t("settings.visibleHint"),
+						inheritLabel: t("settings.inherit"),
+						onLabel: t("settings.on"),
+						offLabel: t("settings.off"),
+						...fieldProps,
+						...state.visible,
+						onEdit: (text) => {
+							props.edit("visible", text);
+						},
+						onReset: () => {
+							props.resetField("visible");
+						}
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ValueField, {
+						id: "settings-pet-size",
+						label: t("settings.size"),
+						hint: t("settings.sizeHint"),
+						numeric: true,
+						...fieldProps,
+						...state.size,
+						onEdit: (text) => {
+							props.edit("size", text);
+						},
+						onReset: () => {
+							props.resetField("size");
+						}
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ValueField, {
+						id: "settings-pet-right",
+						label: t("settings.right"),
+						hint: t("settings.rightHint"),
+						numeric: true,
+						...fieldProps,
+						...state.right,
+						onEdit: (text) => {
+							props.edit("right", text);
+						},
+						onReset: () => {
+							props.resetField("right");
+						}
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ValueField, {
+						id: "settings-pet-bottom",
+						label: t("settings.bottom"),
+						hint: t("settings.bottomHint"),
+						numeric: true,
+						...fieldProps,
+						...state.bottom,
+						onEdit: (text) => {
+							props.edit("bottom", text);
+						},
+						onReset: () => {
+							props.resetField("bottom");
+						}
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ValueField, {
+						id: "settings-pet-name",
+						label: t("settings.name"),
+						hint: t("settings.nameHint"),
+						...fieldProps,
+						...state.name,
+						onEdit: (text) => {
+							props.edit("name", text);
+						},
+						onReset: () => {
+							props.resetField("name");
+						}
+					})
+				]
+			});
+		}
+		//#endregion
+		//#region src/client/locales.ts
+		/** Chinese copy. */
+		const zh = {
+			"pet.feed": "喂食",
+			"pet.hide": "隐藏",
+			"pet.rename": "改名",
+			"pet.confirm": "确定",
+			"pet.namePlaceholder": "输入新名字",
+			"pet.summon": "召唤{name}",
+			"pet.rank": "亲密度 {rank}",
+			"pet.points": "{points} 点",
+			"pet.treats": "小鱼干 ×{n}",
+			"pet.state.loading": "鲸鱼娘正在赶来…",
+			"pet.state.error": "鲸鱼娘迷路了（连接失败）",
+			"settings.title": "宠物",
+			"settings.description": "鲸鱼娘的显示布局与名字。",
+			"settings.enabled": "启用宠物",
+			"settings.enabledHint": "关闭后隐藏宠物并停止轮询，可在设置里重新启用。",
+			"settings.visible": "显示宠物",
+			"settings.visibleHint": "关闭后宠物隐藏，可从聊天输入区重新召唤。",
+			"settings.size": "大小（px）",
+			"settings.sizeHint": "精灵单元高度，范围 32–512。",
+			"settings.right": "距右侧（px）",
+			"settings.rightHint": "距视口右边缘的水平内缩距离。",
+			"settings.bottom": "距底部（px）",
+			"settings.bottomHint": "距视口底边的垂直内缩距离。",
+			"settings.name": "名字",
+			"settings.nameHint": "宠物显示名，1–20 个字符。",
+			"settings.inherit": "继承",
+			"settings.on": "开",
+			"settings.off": "关",
+			"settings.overridden": "已覆盖",
+			"settings.reset": "恢复默认",
+			"settings.readOnly": "当前部署的设置只读。",
+			"settings.expand": "展开设置",
+			"settings.collapse": "收起设置",
+			"settings.save": "保存",
+			"settings.saving": "保存中…",
+			"settings.discard": "放弃",
+			"settings.unsaved": "未保存",
+			"settings.saveFailed": "部署未接受这些值，已保留供你修改。",
+			"settings.invalidNumber": "请输入数字，留空则使用默认值。"
+		};
+		/** English copy. */
+		const en = {
+			"pet.feed": "Feed",
+			"pet.hide": "Hide",
+			"pet.rename": "Rename",
+			"pet.confirm": "OK",
+			"pet.namePlaceholder": "Enter a new name",
+			"pet.summon": "Summon {name}",
+			"pet.rank": "Affinity {rank}",
+			"pet.points": "{points} pts",
+			"pet.treats": "Treats ×{n}",
+			"pet.state.loading": "The whale girl is on her way…",
+			"pet.state.error": "The whale girl is lost (connection failed)",
+			"settings.title": "Pet",
+			"settings.description": "The whale girl’s display layout and name.",
+			"settings.enabled": "Enable the pet",
+			"settings.enabledHint": "When off, the pet hides and polling stops; re-enable it here.",
+			"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–512.",
+			"settings.right": "Right inset (px)",
+			"settings.rightHint": "Horizontal inset from the viewport right edge.",
+			"settings.bottom": "Bottom inset (px)",
+			"settings.bottomHint": "Vertical inset from the viewport bottom edge.",
+			"settings.name": "Name",
+			"settings.nameHint": "The pet’s display name, 1–20 characters.",
+			"settings.inherit": "Inherit",
+			"settings.on": "On",
+			"settings.off": "Off",
+			"settings.overridden": "Overridden",
+			"settings.reset": "Reset to default",
+			"settings.readOnly": "This deployment stores settings read-only.",
+			"settings.expand": "Show settings",
+			"settings.collapse": "Hide settings",
+			"settings.save": "Save",
+			"settings.saving": "Saving…",
+			"settings.discard": "Discard",
+			"settings.unsaved": "Unsaved",
+			"settings.saveFailed": "The deployment did not accept these values; they were left for you to correct.",
+			"settings.invalidNumber": "Enter a number, or leave blank to use the default."
+		};
+		//#endregion
+		//#region src/client/index.ts
+		/** Same-origin JSON fetch helper (GET without body, POST with JSON body). */
+		async function petFetch(path, body) {
+			const response = await fetch(path, body === void 0 ? {} : {
+				method: "POST",
+				headers: { "content-type": "application/json" },
+				body: JSON.stringify(body)
+			});
+			if (!response.ok) throw new Error(`pet ${path} failed: ${response.status}`);
+			return await response.json();
+		}
+		/** The live host API instance (always defined; failures surface per call). */
+		const petApi = {
+			state: () => petFetch("/api/pet/state"),
+			interact: (kind) => petFetch("/api/pet/interact", { kind }),
+			setVisible: (visible) => petFetch("/api/pet/set-visible", { visible }),
+			setConfig: (patch) => petFetch("/api/pet/set-config", patch),
+			setName: (name) => petFetch("/api/pet/set-name", { name })
+		};
+		/** Poll interval for the host snapshot. */
+		const POLL_MS = 800;
+		/** Settings namespace the pet settings card edits (the Host plugin registers it). */
+		const PET_SETTINGS_NS = "pet";
+		/** Required services. */
+		const inject = [
+			"slots",
+			"locale",
+			"connection",
+			"settingsScope",
+			"remote"
+		];
+		/**
+		* Client plugin body: register dictionaries, mount the dock entry and poll
+		* loop while the plugin is enabled, and seat the settings card in the Web UI
+		* plugin group.
+		* @param ctx - client root context.
+		*/
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register("pet", {
+				zh,
+				en
+			}), "pet: dictionaries");
+			const settingsScope = ctx.settingsScope.bind({ namespace: PET_SETTINGS_NS });
+			const enabled = () => {
+				const snapshot = settingsScope.getSnapshot();
+				return snapshot.status === "ready" ? snapshot.value?.enabled ?? true : snapshot.status === "unavailable";
+			};
+			const petSettings = new PetSettingsCardController(settingsScope);
+			ctx.slots.inject("web-ui.plugin.item", () => ctx.slots.register({
+				name: "web-ui.plugin.item",
+				id: "pet-settings",
+				order: 140,
+				locale: "pet",
+				inject: () => petSettings.inject()
+			}, PetSettingsCard));
+			let disposeUi;
+			const syncUi = () => {
+				if (enabled() && disposeUi === void 0) {
+					const petStore = createPetStore().create();
+					const setSnapshot = petStore.actions.setSnapshot;
+					const setState = petStore.actions.setState;
+					const setFeedback = petStore.actions.setFeedback;
+					const pollNow = () => {
+						petApi.state().then((snapshot) => {
+							setSnapshot(snapshot);
+						}, () => {
+							setState("error", "pet.state transport error");
+						});
+					};
+					const disposePoll = ctx.effect(() => {
+						let timer;
+						const stop = () => {
+							if (timer !== void 0) {
+								window.clearInterval(timer);
+								timer = void 0;
+							}
+						};
+						const start = () => {
+							if (timer === void 0 && document.visibilityState === "visible") timer = window.setInterval(pollNow, POLL_MS);
+						};
+						const onVisibility = () => {
+							if (document.visibilityState === "visible") {
+								pollNow();
+								start();
+							} else stop();
+						};
+						start();
+						document.addEventListener("visibilitychange", onVisibility);
+						return () => {
+							stop();
+							document.removeEventListener("visibilitychange", onVisibility);
+						};
+					}, "pet: poll");
+					const injected = () => ({
+						store: petStore,
+						ensure: pollNow,
+						pet: () => {
+							petApi.interact("pet").then((result) => {
+								setFeedback({
+									text: result.reaction,
+									kind: "pet",
+									at: Date.now()
+								});
+							}, () => {});
+						},
+						feed: () => {
+							petApi.interact("feed").then((result) => {
+								setFeedback({
+									text: result.reaction,
+									kind: "feed",
+									at: Date.now()
+								});
+							}, () => {});
+						},
+						hide: () => {
+							petApi.setVisible(false).then(() => {
+								pollNow();
+							}, () => {});
+						},
+						summon: () => {
+							petApi.setVisible(true).then(() => {
+								pollNow();
+							}, () => {});
+						},
+						dragEnd: (right, bottom) => {
+							petApi.setConfig({
+								right,
+								bottom
+							}).then(() => {
+								pollNow();
+							}, () => {});
+						},
+						rename: (name) => {
+							petApi.setName(name).then((result) => {
+								if (result.ok) pollNow();
+							}, () => {});
+						},
+						feedbackDone: () => {
+							setFeedback(null);
+						}
+					});
+					const disposeDock = ctx.slots.inject("conversation.input.selector.context", () => ctx.slots.register({
+						name: "conversation.input.selector.context",
+						id: "pet",
+						order: 110,
+						inject: injected,
+						locale: "pet"
+					}, PetDockEntry));
+					disposeUi = () => {
+						disposeDock();
+						disposePoll();
+						disposeUi = void 0;
+					};
+				} else if (!enabled() && disposeUi !== void 0) {
+					disposeUi();
+					disposeUi = void 0;
+				}
+			};
+			settingsScope.subscribe(syncUi);
+			syncUi();
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map