@linxin666/dsh-pet 0.3.13 → 0.3.15

package/lib/index.js

@@ -4928,13 +4928,28 @@ function extensionOf(file) {
 	return dot < 0 ? "" : file.slice(dot).toLowerCase();
 }
 /**
+* Realpaths of containment bases, resolved once per base instead of once per
+* request: every asset/runtime/decoration request used to pay a base
+* realpathSync on the hot path. Bases are registry entry directories and the
+* runtime roots — an immutable, registry-bounded set. Only successes are
+* cached (a missing base keeps failing per request), and a symlinked base
+* re-pointed mid-process fails containment until restart, which is the
+* deny-safe direction.
+*/
+const REAL_BASE_CACHE = /* @__PURE__ */ new Map();
+/**
 * realpath containment: resolve both sides and require the candidate to stay
 * inside the base directory. A pet directory (or an atlas/preview inside it)
-* that is a symlink escaping its root is rejected, never followed.
+* that is a symlink escaping its root is rejected, never followed. The
+* candidate is realpath'ed live on every call; only the base side is cached.
 */
 function containedRealpath(base, candidate) {
 	try {
-		const realBase = realpathSync(base);
+		let realBase = REAL_BASE_CACHE.get(base);
+		if (realBase === void 0) {
+			realBase = realpathSync(base);
+			REAL_BASE_CACHE.set(base, realBase);
+		}
 		const realCandidate = realpathSync(candidate);
 		return realCandidate === realBase || realCandidate.startsWith(realBase + sep) ? realCandidate : void 0;
 	} catch {
@@ -4955,6 +4970,20 @@ function mimeFor(file) {
 	if (dot < 0) return "application/octet-stream";
 	return MIME_BY_EXT[file.slice(dot).toLowerCase()] ?? "application/octet-stream";
 }
+/** Weak validator from size + mtime, shared by the three file routes. */
+function weakEtag(stat) {
+	return "\"" + stat.size.toString(16) + "-" + Math.round(stat.mtimeMs).toString(16) + "\"";
+}
+/** Answer 304 when If-None-Match matches the etag; true when handled. */
+function revalidated(req, res, etag) {
+	if (req.headers["if-none-match"] !== etag) return false;
+	res.writeHead(304, {
+		etag,
+		"cache-control": "no-cache"
+	});
+	res.end();
+	return true;
+}
 /** Require the method or answer 405. */
 function requireMethod(req, res, method) {
 	if (req.method === method) return true;
@@ -5036,6 +5065,7 @@ function dirAliases(registry) {
 */
 function assetHandler(ctx, registry, caps) {
 	const aliases = dirAliases(registry);
+	const servableById = new Map(registry.entries.map((entry) => [entry.id, new Set(entry.servable)]));
 	return ((req, res) => {
 		if (!guard(ctx, req, res)) return;
 		if (req.method !== "GET" && req.method !== "HEAD") {
@@ -5090,7 +5120,7 @@ function assetHandler(ctx, registry, caps) {
 			const manifestFile = join(entry.dir, MANIFEST_FILE);
 			file = existsSync(manifestFile) ? manifestFile : void 0;
 			if (file === void 0) synthesized = true;
-		} else if (rest.length > 0 && entry.servable.includes(rel)) file = join(entry.dir, rel);
+		} else if (rest.length > 0 && servableById.get(entry.id)?.has(rel)) file = join(entry.dir, rel);
 		else if (rest.length === 2 && rest[0] === PREVIEW_DIR && PREVIEW_PATTERN.test(rest[1])) {
 			const preview = join(entry.dir, PREVIEW_DIR, rest[1]);
 			file = existsSync(preview) ? preview : void 0;
@@ -5121,8 +5151,10 @@ function assetHandler(ctx, registry, caps) {
 			return;
 		}
 		const cap = rest.length === 1 && rest[0] === MANIFEST_FILE ? caps.manifest : IMAGE_EXTENSIONS.has(extensionOf(rel)) ? caps.image : caps.model;
+		let stat;
 		try {
-			if (statSync(resolved).size > cap) {
+			stat = statSync(resolved);
+			if (stat.size > cap) {
 				res.writeHead(413);
 				res.end();
 				return;
@@ -5132,11 +5164,14 @@ function assetHandler(ctx, registry, caps) {
 			res.end();
 			return;
 		}
+		const etag = weakEtag(stat);
+		if (revalidated(req, res, etag)) return;
 		return readFile(resolved).then((body) => {
 			res.writeHead(200, {
 				"content-type": mimeFor(resolved),
 				"content-length": String(body.byteLength),
-				"cache-control": "no-cache"
+				"cache-control": "no-cache",
+				etag
 			});
 			if (req.method === "HEAD") {
 				res.end();
@@ -5216,8 +5251,10 @@ function runtimeHandler(ctx, roots) {
 			res.end();
 			return;
 		}
+		let stat;
 		try {
-			if (statSync(resolved).size > 16777216) {
+			stat = statSync(resolved);
+			if (stat.size > 16777216) {
 				res.writeHead(413);
 				res.end();
 				return;
@@ -5227,11 +5264,14 @@ function runtimeHandler(ctx, roots) {
 			res.end();
 			return;
 		}
+		const etag = weakEtag(stat);
+		if (revalidated(req, res, etag)) return;
 		return readFile(resolved).then((body) => {
 			res.writeHead(200, {
 				"content-type": name.endsWith(".map") ? "application/json" : "application/javascript; charset=utf-8",
 				"content-length": String(body.byteLength),
-				"cache-control": "no-cache"
+				"cache-control": "no-cache",
+				etag
 			});
 			if (req.method === "HEAD") {
 				res.end();
@@ -5332,15 +5372,8 @@ function decorationHandler(ctx, registry, caps) {
 			res.end();
 			return;
 		}
-		const etag = "\"" + stat.size.toString(16) + "-" + Math.round(stat.mtimeMs).toString(16) + "\"";
-		if (req.headers["if-none-match"] === etag) {
-			res.writeHead(304, {
-				etag,
-				"cache-control": "no-cache"
-			});
-			res.end();
-			return;
-		}
+		const etag = weakEtag(stat);
+		if (revalidated(req, res, etag)) return;
 		readFile(resolved).then((body) => {
 			res.writeHead(200, {
 				"content-type": mimeFor(resolved),
@@ -5543,17 +5576,30 @@ function applyImpl(ctx, config = {}) {
 		}
 	};
 	ctx.inject(["settings"], (settingsCtx) => {
-		settingsCtx.settings.installSection(ctx, "pet", makePetSettingsSchema(service.selectedPetId()), base, {
-			setSource: (source) => {
-				current = source;
-			},
-			onChange: () => {
-				const section = current();
-				service.applySettingsSection(section);
-				service.setEnabled(section.enabled ?? true);
-				syncRoutes();
+		try {
+			const schema = makePetSettingsSchema(service.selectedPetId());
+			if (typeof settingsCtx.settings?.installSection === "function") settingsCtx.settings.installSection(ctx, "pet", schema, base, {
+				setSource: (source) => {
+					current = source;
+				},
+				onChange: () => {
+					const section = current();
+					service.applySettingsSection(section);
+					service.setEnabled(section.enabled ?? true);
+					syncRoutes();
+				}
+			});
+			else if (typeof settingsCtx.settings?.register === "function") {
+				const scope = settingsCtx.settings.register("pet", schema, { base });
+				current = () => scope?.get?.() ?? base;
+				scope?.watch?.(() => {
+					const section = current();
+					service.applySettingsSection(section);
+					service.setEnabled(section.enabled ?? true);
+					syncRoutes();
+				});
 			}
-		});
+		} catch {}
 	});
 	syncRoutes();
 }

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

@@ -1 +1 @@
-{"version":3,"file":"PetSprite.d.ts","sourceRoot":"","sources":["../../../src/client/PetSprite.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAkE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAGnH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAIjD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAGjC,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;IAC7B,8EAA8E;IAC9E,UAAU,EAAE,aAAa,CAAA;IACzB,qDAAqD;IACrD,OAAO,EAAE,gBAAgB,CAAA;IACzB,sCAAsC;IACtC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAA;IAC5B,8BAA8B;IAC9B,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,sCAAsC;IACtC,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,sCAAsC;IACtC,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,+BAA+B;IAC/B,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAClD,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;IAC9C,uDAAuD;IACvD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,4DAA4D;IAC5D,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,2DAA2D;IAC3D,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB;;;;OAIG;IACH,GAAG,CAAC,EAAE,SAAS,CAAA;IACf;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9D;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;IAC3B,qEAAqE;IACrE,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,+CAA+C;IAC/C,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CAAA;CAC1B;AA8ID;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,WAAW,CAqjB5D"}
+{"version":3,"file":"PetSprite.d.ts","sourceRoot":"","sources":["../../../src/client/PetSprite.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAkE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAGnH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAIjD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAGjC,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;IAC7B,8EAA8E;IAC9E,UAAU,EAAE,aAAa,CAAA;IACzB,qDAAqD;IACrD,OAAO,EAAE,gBAAgB,CAAA;IACzB,sCAAsC;IACtC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAA;IAC5B,8BAA8B;IAC9B,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,sCAAsC;IACtC,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,sCAAsC;IACtC,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,+BAA+B;IAC/B,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAClD,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;IAC9C,uDAAuD;IACvD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,4DAA4D;IAC5D,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,2DAA2D;IAC3D,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB;;;;OAIG;IACH,GAAG,CAAC,EAAE,SAAS,CAAA;IACf;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9D;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;IAC3B,qEAAqE;IACrE,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,+CAA+C;IAC/C,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CAAA;CAC1B;AA8ID;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,WAAW,CA+jB5D"}

package/lib/types/client/PetSprite.js

@@ -14,7 +14,7 @@ import { createPortal } from 'react-dom';
 import clsx from 'clsx';
 import { announcementFresh } from "../announce.js";
 import { framePosition, rowOfTrack, trimTrack } from "./spritesheet.js";
-import { sequenceFrameAt } from "./sequences.js";
+import { createSequenceTimeline } from "./sequences.js";
 import { animationForPhase } from "../state.js";
 import styles from './pet.module.css';
 /** Clamp a drag offset inside the viewport with a margin. */
@@ -230,6 +230,18 @@ export function PetSprite(props) {
         const reduceMotion = typeof window !== 'undefined'
             && window.matchMedia?.('(prefers-reduced-motion: reduce)')?.matches === true;
         const sequence = animation === animationForPhase(phase) ? sequences?.[phase] : undefined;
+        // Sequence state hoisted into the effect scope: the cumulative duration
+        // table and each item's trimmed track would otherwise be recomputed every
+        // tick (map/reduce plus two slices per frame), the same waste the
+        // single-track branch below avoids.
+        const timeline = sequence === undefined ? undefined : createSequenceTimeline(sequence, tracks);
+        const sequenceItems = sequence === undefined ? undefined : new Map(sequence.map(itemAnimation => {
+            const itemRow = rowOfTrack(itemAnimation);
+            return [itemAnimation, {
+                    row: itemRow,
+                    track: trimTrack(tracks[itemAnimation], rows[itemRow] ?? tracks[itemAnimation].frames.length),
+                }];
+        }));
         const leadAnimation = sequence?.[0] ?? animation;
         const row = rowOfTrack(leadAnimation);
         const track = trimTrack(tracks[leadAnimation], rows[row] ?? tracks[leadAnimation].frames.length);
@@ -249,13 +261,12 @@ export function PetSprite(props) {
         const tick = (ts) => {
             const delta = ts - last;
             last = ts;
-            if (sequence !== undefined) {
+            if (timeline !== undefined && sequenceItems !== undefined) {
                 sequenceElapsed += delta;
-                const current = sequenceFrameAt(sequence, tracks, sequenceElapsed);
-                const currentRow = rowOfTrack(current.animation);
-                const currentTrack = trimTrack(tracks[current.animation], rows[currentRow] ?? tracks[current.animation].frames.length);
-                const col = currentTrack.frames[current.frameIndex];
-                const pos = framePosition(cell, currentRow, col, scaleRef.current);
+                const current = timeline.frameAt(sequenceElapsed);
+                const item = sequenceItems.get(current.animation);
+                const col = item.track.frames[current.frameIndex];
+                const pos = framePosition(cell, item.row, col, scaleRef.current);
                 const posStr = pos.x + 'px ' + pos.y + 'px';
                 if (posStr !== lastPosStr) {
                     lastPosStr = posStr;

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

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

package/lib/types/client/index.js

@@ -342,6 +342,7 @@ export function apply(ctx) {
                 petRoot.unmount();
                 container.remove();
                 disposePoll();
+                disposeSessionWatch();
                 disposeUi = undefined;
             };
             // The slot teardown is the takeover hook a later apply body runs; it

package/lib/types/client/pet-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pet-store.d.ts","sourceRoot":"","sources":["../../../src/client/pet-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAC3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,uDAAuD;IACvD,IAAI,EAAE,cAAc,GAAG,MAAM,CAAA;IAC7B,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAA;CACX;AAED,wCAAwC;AACxC,MAAM,WAAW,UAAU;IACzB,oEAAoE;IACpE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;IAC7B,0EAA0E;IAC1E,IAAI,EAAE,aAAa,EAAE,CAAA;IACrB,uBAAuB;IACvB,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;IACpC,iEAAiE;IACjE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,sCAAsC;IACtC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAA;CAC7B;AAED,uBAAuB;AACvB,MAAM,MAAM,YAAY,GAAG;IACzB,+CAA+C;IAC/C,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAA;IAChE,iCAAiC;IACjC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,IAAI,CAAA;IAC3D,gCAAgC;IAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACvF,8BAA8B;IAC9B,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;IACtE;;;;OAIG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAA;CACzE,CAAA;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,IAAI,iBAAiB,CAAC,UAAU,EAAE,YAAY,CAAC,CA8B5E;AAED,YAAY,EAAE,cAAc,EAAE,CAAA;AAE9B;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA"}
+{"version":3,"file":"pet-store.d.ts","sourceRoot":"","sources":["../../../src/client/pet-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAC3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,uDAAuD;IACvD,IAAI,EAAE,cAAc,GAAG,MAAM,CAAA;IAC7B,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAA;CACX;AAED,wCAAwC;AACxC,MAAM,WAAW,UAAU;IACzB,oEAAoE;IACpE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;IAC7B,0EAA0E;IAC1E,IAAI,EAAE,aAAa,EAAE,CAAA;IACrB,uBAAuB;IACvB,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;IACpC,iEAAiE;IACjE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,sCAAsC;IACtC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAA;CAC7B;AAED,uBAAuB;AACvB,MAAM,MAAM,YAAY,GAAG;IACzB,+CAA+C;IAC/C,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAA;IAChE,iCAAiC;IACjC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,IAAI,CAAA;IAC3D,gCAAgC;IAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACvF,8BAA8B;IAC9B,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;IACtE;;;;OAIG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAA;CACzE,CAAA;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,IAAI,iBAAiB,CAAC,UAAU,EAAE,YAAY,CAAC,CAsC5E;AAED,YAAY,EAAE,cAAc,EAAE,CAAA;AAY9B;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA"}

package/lib/types/client/pet-store.js

@@ -18,6 +18,15 @@ export function createPetStore() {
         }),
         actions: {
             setSnapshot: (draft, snapshot) => {
+                // The 2 s poll republishes the full snapshot even while the pet is
+                // idle. Skipping an unchanged payload keeps immer's produce at zero
+                // modifications, so zustand never notifies and the whole sprite tree
+                // skips the re-render. Equality is JSON-based and skip-only: both
+                // sides come from the same host serializer, and any mismatch falls
+                // through to the normal publish — the failure mode is one extra
+                // render, never a stale pet.
+                if (draft.state === 'ready' && draft.error === null && sameSnapshot(draft.snapshot, snapshot))
+                    return;
                 draft.snapshot = snapshot;
                 draft.state = 'ready';
                 draft.error = null;
@@ -39,3 +48,12 @@ export function createPetStore() {
         },
     });
 }
+/**
+ * Content equality for consecutive poll snapshots. JSON compare, not field
+ * enumeration: an exact string match is the only way to skip the publish, so
+ * a missed field can never freeze the UI — it can only cost the render the
+ * optimization exists to save.
+ */
+function sameSnapshot(previous, next) {
+    return previous !== null && JSON.stringify(previous) === JSON.stringify(next);
+}

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

@@ -5,6 +5,16 @@ export interface SequenceFrame {
     animation: PetAnimation;
     frameIndex: number;
 }
+/**
+ * Precomputed timeline for one looping sequence: the per-item duration table
+ * is built once instead of per query. The sprite frame loop asks at
+ * animation rate (~60 Hz), where the per-call map/reduce is pure waste.
+ */
+export interface SequenceTimeline {
+    frameAt(elapsedMs: number): SequenceFrame;
+}
+/** Build a {@link SequenceTimeline} over one manifest sequence. */
+export declare function createSequenceTimeline(sequence: readonly PetAnimation[], tracks: Record<PetAnimation, PetTrackDef>): SequenceTimeline;
 /** Resolve the active track and frame after elapsed milliseconds of a looping sequence. */
 export declare function sequenceFrameAt(sequence: readonly PetAnimation[], tracks: Record<PetAnimation, PetTrackDef>, elapsedMs: number): SequenceFrame;
 //# sourceMappingURL=sequences.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sequences.d.ts","sourceRoot":"","sources":["../../../src/client/sequences.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,YAAY,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,WAAW,CAAC,EACzC,SAAS,EAAE,MAAM,GAChB,aAAa,CAiBf"}
+{"version":3,"file":"sequences.d.ts","sourceRoot":"","sources":["../../../src/client/sequences.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,YAAY,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAA;CAC1C;AAED,mEAAmE;AACnE,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,WAAW,CAAC,GACxC,gBAAgB,CAqBlB;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,WAAW,CAAC,EACzC,SAAS,EAAE,MAAM,GAChB,aAAa,CAEf"}

package/lib/types/client/sequences.js

@@ -1,20 +1,28 @@
 /** Pure timing helpers for manifest-defined scene animation sequences. */
-/** Resolve the active track and frame after elapsed milliseconds of a looping sequence. */
-export function sequenceFrameAt(sequence, tracks, elapsedMs) {
+/** Build a {@link SequenceTimeline} over one manifest sequence. */
+export function createSequenceTimeline(sequence, tracks) {
     const itemDurations = sequence.map(animation => tracks[animation].durations.reduce((sum, value) => sum + value, 0));
     const sequenceDuration = itemDurations.reduce((sum, value) => sum + value, 0);
-    let offset = Math.max(0, elapsedMs) % sequenceDuration;
-    let itemIndex = 0;
-    while (itemIndex < sequence.length - 1 && offset >= itemDurations[itemIndex]) {
-        offset -= itemDurations[itemIndex];
-        itemIndex += 1;
-    }
-    const animation = sequence[itemIndex];
-    const track = tracks[animation];
-    let frameIndex = 0;
-    while (frameIndex < track.frames.length - 1 && offset >= track.durations[frameIndex]) {
-        offset -= track.durations[frameIndex];
-        frameIndex += 1;
-    }
-    return { animation, frameIndex };
+    return {
+        frameAt(elapsedMs) {
+            let offset = Math.max(0, elapsedMs) % sequenceDuration;
+            let itemIndex = 0;
+            while (itemIndex < sequence.length - 1 && offset >= itemDurations[itemIndex]) {
+                offset -= itemDurations[itemIndex];
+                itemIndex += 1;
+            }
+            const animation = sequence[itemIndex];
+            const track = tracks[animation];
+            let frameIndex = 0;
+            while (frameIndex < track.frames.length - 1 && offset >= track.durations[frameIndex]) {
+                offset -= track.durations[frameIndex];
+                frameIndex += 1;
+            }
+            return { animation, frameIndex };
+        },
+    };
+}
+/** Resolve the active track and frame after elapsed milliseconds of a looping sequence. */
+export function sequenceFrameAt(sequence, tracks, elapsedMs) {
+    return createSequenceTimeline(sequence, tracks).frameAt(elapsedMs);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAG7C,OAAO,CAAC,MAAM,aAAa,CAAA;AAC3B,OAAO,EAAsC,KAAK,SAAS,EAA2B,MAAM,cAAc,CAAA;AAM1G,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAC9D,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,YAAY,GACb,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,MAAM,GACP,MAAM,eAAe,CAAA;AACtB,YAAY,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,cAAc,GACf,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,KAAK,GACN,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,aAAa,EACb,YAAY,EACZ,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC5E,OAAO,EACL,eAAe,EACf,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,mBAAmB,GACpB,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9E,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,cAAc,GACf,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,cAAc,EACd,kBAAkB,GACnB,MAAM,eAAe,CAAA;AACtB,YAAY,EACV,aAAa,EACb,QAAQ,EACR,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,gBAAgB,GACjB,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,aAAa,CAAA;AAEpB,sEAAsE;AACtE,eAAO,MAAM,IAAI,QAAQ,CAAA;AAEzB,+DAA+D;AAC/D,eAAO,MAAM,MAAM,UAAgB,CAAA;AAEnC;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM;;;;;;;;;;;;;;;;IAU1D;AAED,0EAA0E;AAC1E,eAAO,MAAM,KAAK,kBAA6C,CAAA;AAE/D,iBAAS,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,SAAc,GAAG,IAAI,CAkE7D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAG7C,OAAO,CAAC,MAAM,aAAa,CAAA;AAC3B,OAAO,EAAsC,KAAK,SAAS,EAA2B,MAAM,cAAc,CAAA;AAM1G,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAC9D,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,YAAY,GACb,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,MAAM,GACP,MAAM,eAAe,CAAA;AACtB,YAAY,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,cAAc,GACf,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,KAAK,GACN,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,aAAa,EACb,YAAY,EACZ,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC5E,OAAO,EACL,eAAe,EACf,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,mBAAmB,GACpB,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9E,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,cAAc,GACf,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,cAAc,EACd,kBAAkB,GACnB,MAAM,eAAe,CAAA;AACtB,YAAY,EACV,aAAa,EACb,QAAQ,EACR,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,gBAAgB,GACjB,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,aAAa,CAAA;AAEpB,sEAAsE;AACtE,eAAO,MAAM,IAAI,QAAQ,CAAA;AAEzB,+DAA+D;AAC/D,eAAO,MAAM,MAAM,UAAgB,CAAA;AAEnC;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM;;;;;;;;;;;;;;;;IAU1D;AAED,0EAA0E;AAC1E,eAAO,MAAM,KAAK,kBAA6C,CAAA;AAE/D,iBAAS,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,SAAc,GAAG,IAAI,CAkF7D"}

package/lib/types/index.js

@@ -96,15 +96,33 @@ function applyImpl(ctx, config = {}) {
         }
     };
     ctx.inject(['settings'], (settingsCtx) => {
-        settingsCtx.settings.installSection(ctx, PET_SETTINGS_NAMESPACE, makePetSettingsSchema(service.selectedPetId()), base, {
-            setSource: (source) => { current = source; },
-            onChange: () => {
-                const section = current();
-                service.applySettingsSection(section);
-                service.setEnabled(section.enabled ?? true);
-                syncRoutes();
-            },
-        });
+        try {
+            const schema = makePetSettingsSchema(service.selectedPetId());
+            if (typeof settingsCtx.settings?.installSection === 'function') {
+                settingsCtx.settings.installSection(ctx, PET_SETTINGS_NAMESPACE, schema, base, {
+                    setSource: (source) => { current = source; },
+                    onChange: () => {
+                        const section = current();
+                        service.applySettingsSection(section);
+                        service.setEnabled(section.enabled ?? true);
+                        syncRoutes();
+                    },
+                });
+            }
+            else if (typeof settingsCtx.settings?.register === 'function') {
+                const scope = settingsCtx.settings.register(PET_SETTINGS_NAMESPACE, schema, { base });
+                current = () => scope?.get?.() ?? base;
+                scope?.watch?.(() => {
+                    const section = current();
+                    service.applySettingsSection(section);
+                    service.setEnabled(section.enabled ?? true);
+                    syncRoutes();
+                });
+            }
+        }
+        catch {
+            // Defensive fallback against settings registration differences
+        }
     });
     syncRoutes();
 }

package/lib/types/routes.d.ts

@@ -40,7 +40,8 @@ export interface PetAssetCaps {
 /**
  * realpath containment: resolve both sides and require the candidate to stay
  * inside the base directory. A pet directory (or an atlas/preview inside it)
- * that is a symlink escaping its root is rejected, never followed.
+ * that is a symlink escaping its root is rejected, never followed. The
+ * candidate is realpath'ed live on every call; only the base side is cached.
  */
 export declare function containedRealpath(base: string, candidate: string): string | undefined;
 /** Browser-facing base path of the plugin runtime files (pet-center M3). */

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

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAO9C,+CAA+C;AAC/C,eAAO,MAAM,cAAc,aAAa,CAAA;AAExC,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,SAAS,CAAA;AAMtC;;;;GAIG;AACH,eAAO,MAAM,cAAc;IACzB,yBAAyB;;IAEzB,iDAAiD;;IAEjD,8EAA8E;;CAEtE,CAAA;AAEV,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAWD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUrF;AAwND,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,QAA8B,CAAA;AAe7D,4EAA4E;AAC5E,eAAO,MAAM,eAAe,QAAmB,CAAA;AAE/C,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAwMD,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,YAAY,CAAA;CAAE,GAAG,eAAe,GAAG,QAAQ,EAAE,CAgFjI;AAGD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAO9C,+CAA+C;AAC/C,eAAO,MAAM,cAAc,aAAa,CAAA;AAExC,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,SAAS,CAAA;AAMtC;;;;GAIG;AACH,eAAO,MAAM,cAAc;IACzB,yBAAyB;;IAEzB,iDAAiD;;IAEjD,8EAA8E;;CAEtE,CAAA;AAEV,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAsBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAcrF;AAqPD,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,QAA8B,CAAA;AAe7D,4EAA4E;AAC5E,eAAO,MAAM,eAAe,QAAmB,CAAA;AAE/C,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AA4MD,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,YAAY,CAAA;CAAE,GAAG,eAAe,GAAG,QAAQ,EAAE,CAgFjI;AAGD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA"}

package/lib/types/routes.js

@@ -45,14 +45,29 @@ function extensionOf(file) {
     const dot = file.lastIndexOf('.');
     return dot < 0 ? '' : file.slice(dot).toLowerCase();
 }
+/**
+ * Realpaths of containment bases, resolved once per base instead of once per
+ * request: every asset/runtime/decoration request used to pay a base
+ * realpathSync on the hot path. Bases are registry entry directories and the
+ * runtime roots — an immutable, registry-bounded set. Only successes are
+ * cached (a missing base keeps failing per request), and a symlinked base
+ * re-pointed mid-process fails containment until restart, which is the
+ * deny-safe direction.
+ */
+const REAL_BASE_CACHE = new Map();
 /**
  * realpath containment: resolve both sides and require the candidate to stay
  * inside the base directory. A pet directory (or an atlas/preview inside it)
- * that is a symlink escaping its root is rejected, never followed.
+ * that is a symlink escaping its root is rejected, never followed. The
+ * candidate is realpath'ed live on every call; only the base side is cached.
  */
 export function containedRealpath(base, candidate) {
     try {
-        const realBase = realpathSync(base);
+        let realBase = REAL_BASE_CACHE.get(base);
+        if (realBase === undefined) {
+            realBase = realpathSync(base);
+            REAL_BASE_CACHE.set(base, realBase);
+        }
         const realCandidate = realpathSync(candidate);
         return realCandidate === realBase || realCandidate.startsWith(realBase + sep)
             ? realCandidate
@@ -77,6 +92,18 @@ function mimeFor(file) {
         return 'application/octet-stream';
     return MIME_BY_EXT[file.slice(dot).toLowerCase()] ?? 'application/octet-stream';
 }
+/** Weak validator from size + mtime, shared by the three file routes. */
+function weakEtag(stat) {
+    return '"' + stat.size.toString(16) + '-' + Math.round(stat.mtimeMs).toString(16) + '"';
+}
+/** Answer 304 when If-None-Match matches the etag; true when handled. */
+function revalidated(req, res, etag) {
+    if (req.headers['if-none-match'] !== etag)
+        return false;
+    res.writeHead(304, { etag, 'cache-control': 'no-cache' });
+    res.end();
+    return true;
+}
 /** Require the method or answer 405. */
 function requireMethod(req, res, method) {
     if (req.method === method)
@@ -155,6 +182,11 @@ function dirAliases(registry) {
  */
 function assetHandler(ctx, registry, caps) {
     const aliases = dirAliases(registry);
+    // The servable match is a Set probe instead of a linear scan: a full live2d
+    // closure routinely exceeds a hundred files, each fetched through this
+    // handler per mount. The registry is an immutable snapshot, so the sets are
+    // built once per handler.
+    const servableById = new Map(registry.entries.map(entry => [entry.id, new Set(entry.servable)]));
     return ((req, res) => {
         if (!guard(ctx, req, res))
             return;
@@ -215,7 +247,7 @@ function assetHandler(ctx, registry, caps) {
             if (file === undefined)
                 synthesized = true;
         }
-        else if (rest.length > 0 && entry.servable.includes(rel)) {
+        else if (rest.length > 0 && servableById.get(entry.id)?.has(rel)) {
             file = join(entry.dir, rel);
         }
         else if (rest.length === 2 && rest[0] === PREVIEW_DIR && PREVIEW_PATTERN.test(rest[1])) {
@@ -252,8 +284,10 @@ function assetHandler(ctx, registry, caps) {
         const cap = rest.length === 1 && rest[0] === MANIFEST_FILE
             ? caps.manifest
             : IMAGE_EXTENSIONS.has(extensionOf(rel)) ? caps.image : caps.model;
+        let stat;
         try {
-            if (statSync(resolved).size > cap) {
+            stat = statSync(resolved);
+            if (stat.size > cap) {
                 res.writeHead(413);
                 res.end();
                 return;
@@ -264,11 +298,19 @@ function assetHandler(ctx, registry, caps) {
             res.end();
             return;
         }
+        // 'no-cache' forces revalidation before every reuse, and the validator
+        // lets repeat requests settle as 304 — atlases and frames are the largest
+        // payloads the plugin serves (up to the 20 MB image cap), and without a
+        // validator every remount or page load would re-download them in full.
+        const etag = weakEtag(stat);
+        if (revalidated(req, res, etag))
+            return;
         return readFile(resolved).then((body) => {
             res.writeHead(200, {
                 'content-type': mimeFor(resolved),
                 'content-length': String(body.byteLength),
                 'cache-control': 'no-cache',
+                etag,
             });
             if (req.method === 'HEAD') {
                 res.end();
@@ -350,8 +392,10 @@ function runtimeHandler(ctx, roots) {
             res.end();
             return;
         }
+        let stat;
         try {
-            if (statSync(resolved).size > PET_RUNTIME_CAP) {
+            stat = statSync(resolved);
+            if (stat.size > PET_RUNTIME_CAP) {
                 res.writeHead(413);
                 res.end();
                 return;
@@ -362,11 +406,18 @@ function runtimeHandler(ctx, roots) {
             res.end();
             return;
         }
+        // Same validator as the asset routes: the Cubism Core and vendor bundle
+        // ride every page load of a live2d pet, so revalidation should settle as
+        // 304 instead of re-downloading the full bodies.
+        const etag = weakEtag(stat);
+        if (revalidated(req, res, etag))
+            return;
         return readFile(resolved).then((body) => {
             res.writeHead(200, {
                 'content-type': name.endsWith('.map') ? 'application/json' : 'application/javascript; charset=utf-8',
                 'content-length': String(body.byteLength),
                 'cache-control': 'no-cache',
+                etag,
             });
             if (req.method === 'HEAD') {
                 res.end();
@@ -478,12 +529,9 @@ function decorationHandler(ctx, registry, caps) {
         // validator lets repeat requests settle as 304 — the ornament remounts
         // on whisper and display-session flips, and without a validator each
         // remount would re-download the full strip body.
-        const etag = '"' + stat.size.toString(16) + '-' + Math.round(stat.mtimeMs).toString(16) + '"';
-        if (req.headers['if-none-match'] === etag) {
-            res.writeHead(304, { etag, 'cache-control': 'no-cache' });
-            res.end();
+        const etag = weakEtag(stat);
+        if (revalidated(req, res, etag))
             return;
-        }
         readFile(resolved).then((body) => {
             res.writeHead(200, {
                 'content-type': mimeFor(resolved),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@linxin666/dsh-pet",
   "description": "Multi-pet companion plugin for the dsh web GUI: a registry-driven floating pet that reacts to model activity, with per-pet naming, petting/feeding interactions and an affinity score",
-  "version": "0.3.13",
+  "version": "0.3.15",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
@@ -40,7 +40,7 @@
   "license": "Apache-2.0",
   "dsh": {
     "engines": {
-      "dsh": ">=0.1.2-alpha.4"
+      "dsh": ">=0.1.2-rc.1"
     },
     "bundle": {
       "patch": "./cordis.patch.yml"
@@ -65,18 +65,18 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.2-rc.1",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@types/node": "^22.20.0",