@linxin666/dsh-pet 0.3.3 → 0.3.5

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

@@ -0,0 +1,274 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * Gameplay HUD — the client half of the manifest 'gameplay' block (miku-pet
+ * generalization). One component owns everything the block needs: the stat
+ * bars and shop card (menu / shop pages), the touch-zone tap
+ * handling, the idle director rolls, the work and sleep loops, and the
+ * float-text toasts. It talks to the host through the injected verb API,
+ * writes results straight back into the store (the 2 s poll stays the
+ * backstop), and steers the frames2d renderer through the per-pet bus.
+ * @module @linxin666/dsh-pet/client/GameplayHud
+ */
+import { useEffect, useLayoutEffect, useRef, useState, useSyncExternalStore } from 'react';
+import { touchZoneAt } from "../gameplay.js";
+import styles from './pet.module.css';
+let floatSeq = 0;
+/** The gameplay overlay for one frames2d pet that declares 'gameplay'. */
+export function GameplayHud(props) {
+    const { definition, store, api, bus } = props;
+    const ui = useSyncExternalStore(store.subscribe, store.getSnapshot);
+    const def = definition.gameplay;
+    const view = ui.snapshot?.gameplay;
+    const phase = ui.snapshot?.phase ?? 'idle';
+    const [open, setOpen] = useState(false);
+    const [page, setPage] = useState('root');
+    const hudRef = useRef(null);
+    const cardRef = useRef(null);
+    const [floats, setFloats] = useState([]);
+    // Mutable driver state (refs so intervals never re-arm on a poll tick).
+    const modeRef = useRef(view?.mode ?? null);
+    modeRef.current = view?.mode ?? null;
+    const phaseRef = useRef(phase);
+    phaseRef.current = phase;
+    const draggingRef = useRef(false);
+    const touchLockUntilRef = useRef(0);
+    const missRef = useRef(0);
+    const busyRef = useRef(false);
+    // Dynamic-key lookups (stat ids / currency ids are manifest data).
+    const tr = props.t;
+    const statLabel = (name) => tr('pet.gameplay.stat.' + name);
+    const currencyLabel = (name) => tr('pet.gameplay.currency.' + name);
+    const pushFloat = (text) => {
+        const id = ++floatSeq;
+        setFloats(list => [...list.slice(-3), { id, text }]);
+        window.setTimeout(() => {
+            setFloats(list => list.filter(entry => entry.id !== id));
+        }, 1100);
+    };
+    const applyResult = (result) => {
+        if (result.view !== undefined)
+            store.actions.setGameplayView(result.view);
+    };
+    // Tap handling (registered on the bus; PetSprite reports sprite-box
+    // fractions). Sleep wakes on tap; work blocks taps; a held touch
+    // animation turns taps into the plain-click boost.
+    useEffect(() => {
+        if (def === undefined)
+            return undefined;
+        bus.tap = (fx, fy) => {
+            if (modeRef.current === 'sleep') {
+                void api.setMode(null).then(applyResult, () => undefined);
+                return;
+            }
+            if (modeRef.current === 'work')
+                return;
+            const box = def.hitBox ?? { x0: 0, y0: 0, x1: 1, y1: 1 };
+            const hx = (fx - box.x0) / (box.x1 - box.x0);
+            const hy = (fy - box.y0) / (box.y1 - box.y0);
+            if (hx < 0 || hx > 1 || hy < 0 || hy > 1)
+                return;
+            if (Date.now() < touchLockUntilRef.current) {
+                void api.touch().then(applyResult, () => undefined);
+                return;
+            }
+            const zone = def.touch === undefined ? undefined : touchZoneAt(def.touch, hy);
+            if (zone === undefined)
+                return;
+            void api.touch(zone.name).then((result) => {
+                applyResult(result);
+                if (result.hit !== true)
+                    return;
+                if (result.state !== undefined) {
+                    bus.setTrack?.(result.state);
+                    const holdMs = result.stateMs ?? 3000;
+                    touchLockUntilRef.current = Date.now() + holdMs;
+                    window.setTimeout(() => {
+                        if (Date.now() >= touchLockUntilRef.current)
+                            bus.setTrack?.(undefined);
+                    }, holdMs);
+                }
+                if (result.phrase !== undefined) {
+                    store.actions.setFeedback({ text: result.phrase, kind: 'none', at: Date.now() });
+                }
+            }, () => undefined);
+        };
+        return () => { bus.tap = undefined; };
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- one registration per pet definition
+    }, [definition.id, def]);
+    // Panel entry (chrome -> HUD): the hover panel's 玩法 button drives the
+    // card through this channel so the chrome never needs the card's state.
+    useEffect(() => {
+        bus.openCard = (next) => {
+            setOpen(prev => next ?? !prev);
+            setPage('root');
+        };
+        return () => { bus.openCard = undefined; };
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- one registration per bus
+    }, [bus]);
+    // Card placement: the card must not enter the bubble band above the sprite
+    // or the hover-panel band below it, so it opens beside the sprite instead
+    // of growing upward from the pet's feet. It is vertically centered on the
+    // sprite box, clamped to the sprite's height, and the side is chosen by
+    // the space available to each side (right first; a pet parked near the
+    // right viewport edge flips the card to the left).
+    useLayoutEffect(() => {
+        if (!open)
+            return undefined;
+        const hud = hudRef.current;
+        const card = cardRef.current;
+        if (hud === null || card === null)
+            return undefined;
+        const place = () => {
+            const box = hud.parentElement?.getBoundingClientRect();
+            if (box === undefined)
+                return;
+            const gap = 8;
+            const width = card.getBoundingClientRect().width;
+            const toRight = window.innerWidth - box.right;
+            const x = toRight >= width + gap ? box.width + gap : -(width + gap);
+            card.style.transform = 'translate(' + Math.round(x) + 'px, ' + Math.round(-box.height / 2) + 'px) translateY(50%)';
+            card.style.maxHeight = Math.round(box.height) + 'px';
+        };
+        place();
+        window.addEventListener('resize', place);
+        return () => { window.removeEventListener('resize', place); };
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- one placement per open/page change
+    }, [open, page]);
+    // Drag gestures wake a sleeping pet (miku behavior); the drag stream also
+    // feeds the idle director's suppression check.
+    useEffect(() => {
+        return props.drag.subscribe((dragging) => {
+            draggingRef.current = dragging;
+            if (dragging && modeRef.current === 'sleep') {
+                void api.setMode(null).then(applyResult, () => undefined);
+            }
+        });
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- one subscription per drag stream
+    }, [props.drag]);
+    // Idle director: weighted rolls between staying idle and playing an act.
+    // Runs only while the phase mapping owns the visual (idle phase, no mode,
+    // no drag, no held touch animation); maxMiss forces an act after too many
+    // idle rolls in a row.
+    useEffect(() => {
+        const director = def?.idleDirector;
+        if (def === undefined || director === undefined)
+            return undefined;
+        const total = director.idleWeight + director.acts.reduce((sum, act) => sum + act.weight, 0);
+        if (total <= 0)
+            return undefined;
+        const timer = window.setInterval(() => {
+            if (phaseRef.current !== 'idle')
+                return;
+            if (modeRef.current !== null || draggingRef.current)
+                return;
+            if (Date.now() < touchLockUntilRef.current)
+                return;
+            let pickedAct;
+            if (missRef.current >= director.maxMiss) {
+                // Forced act: pick among the acts only.
+                const actTotal = director.acts.reduce((sum, act) => sum + act.weight, 0);
+                let actRoll = Math.random() * actTotal;
+                for (const act of director.acts) {
+                    actRoll -= act.weight;
+                    if (actRoll < 0) {
+                        pickedAct = act;
+                        break;
+                    }
+                }
+            }
+            else {
+                let roll = Math.random() * total;
+                for (const act of director.acts) {
+                    roll -= act.weight;
+                    if (roll < 0) {
+                        pickedAct = act;
+                        break;
+                    }
+                }
+            }
+            if (pickedAct === undefined) {
+                missRef.current += 1;
+                return;
+            }
+            missRef.current = 0;
+            bus.setTrack?.(pickedAct.track);
+            // Acts with a phrase pool speak one line while they play (miku parity).
+            if (pickedAct.phrases !== undefined && pickedAct.phrases.length > 0) {
+                const phrase = pickedAct.phrases[Math.floor(Math.random() * pickedAct.phrases.length)];
+                store.actions.setFeedback({ text: phrase, kind: 'none', at: Date.now() });
+            }
+        }, director.intervalMs);
+        return () => window.clearInterval(timer);
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- one director per pet definition
+    }, [definition.id, def]);
+    // Work loop: hold the work track, adjudicate one round per tick, play the
+    // result track for its hold window, then resume. Leaving the mode
+    // releases the override so the phase mapping takes over.
+    useEffect(() => {
+        const work = def?.work;
+        if (def === undefined || work === undefined || view?.mode !== 'work')
+            return undefined;
+        bus.setTrack?.(work.state);
+        let resultTimer = 0;
+        const timer = window.setInterval(() => {
+            if (busyRef.current)
+                return;
+            busyRef.current = true;
+            void api.workTick().then((result) => {
+                busyRef.current = false;
+                applyResult(result);
+                if (result.ok !== true || result.outcome === undefined)
+                    return;
+                const resultTrack = result.outcome === 'success' ? work.successState : work.failState;
+                const hold = result.outcome === 'success' ? work.resultMs?.success ?? 1300 : work.resultMs?.fail ?? 1900;
+                bus.setTrack?.(resultTrack);
+                resultTimer = window.setTimeout(() => {
+                    if (modeRef.current === 'work')
+                        bus.setTrack?.(work.state);
+                }, hold);
+            }, () => { busyRef.current = false; });
+        }, work.tickMs);
+        return () => {
+            window.clearInterval(timer);
+            window.clearTimeout(resultTimer);
+            bus.setTrack?.(undefined);
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- the loop keys on the mode value
+    }, [definition.id, def, view?.mode]);
+    // Sleep loop: hold the sleep track; restore is host-side (lazy settle).
+    useEffect(() => {
+        const sleep = def?.sleep;
+        if (def === undefined || sleep === undefined || view?.mode !== 'sleep')
+            return undefined;
+        bus.setTrack?.(sleep.state);
+        return () => bus.setTrack?.(undefined);
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- the loop keys on the mode value
+    }, [definition.id, def, view?.mode]);
+    if (def === undefined || view === undefined)
+        return null;
+    const mode = view.mode;
+    const stats = def.stats ?? {};
+    const shop = def.shop;
+    const buy = (itemId) => {
+        void api.buy(itemId).then((result) => {
+            applyResult(result);
+            if (result.ok !== true) {
+                if (result.error === 'insufficient-funds') {
+                    const item = shop?.items.find(entry => entry.id === itemId);
+                    pushFloat(tr('pet.gameplay.insufficient', { currency: currencyLabel(item?.currency ?? 'treats') }));
+                }
+                return;
+            }
+            if (result.prize !== undefined) {
+                pushFloat(tr('pet.gameplay.prize', { amount: result.prize.amount, currency: currencyLabel(result.prize.currency) }));
+            }
+        }, () => undefined);
+    };
+    const setMode = (next) => {
+        void api.setMode(next).then(applyResult, () => undefined);
+    };
+    return (_jsxs("div", { ref: hudRef, className: styles.gameplayHud, "data-dsh-pet-gameplay": definition.id, children: [floats.map(entry => (_jsx("div", { className: styles.gameplayFloat, children: entry.text }, entry.id))), mode !== null && (_jsx("div", { className: styles.gameplayModeChip, children: tr(mode === 'work' ? 'pet.gameplay.working' : 'pet.gameplay.sleeping') })), open && (_jsxs("div", { ref: cardRef, className: styles.gameplayCard, "data-page": page, children: [page === 'root' && (_jsxs(_Fragment, { children: [_jsx("div", { className: styles.gameplayBars, children: Object.entries(stats).map(([name, stat]) => {
+                                    const value = view.stats[name] ?? 0;
+                                    return (_jsxs("div", { className: styles.gameplayBarRow, title: statLabel(name) + ' ' + String(value) + '/' + String(stat.max), children: [_jsx("span", { className: styles.gameplayBarLabel, children: statLabel(name) }), _jsx("span", { className: styles.gameplayBarTrack, children: _jsx("span", { className: styles.gameplayBarFill, style: { width: Math.round((value / stat.max) * 100) + '%' } }) })] }, name));
+                                }) }), _jsxs("div", { className: styles.gameplayActions, children: [def.work !== undefined && (_jsx("button", { type: "button", className: styles.action, onClick: () => setMode(mode === 'work' ? null : 'work'), children: tr(mode === 'work' ? 'pet.gameplay.stopWork' : 'pet.gameplay.work') })), def.sleep !== undefined && (_jsx("button", { type: "button", className: styles.action, onClick: () => setMode(mode === 'sleep' ? null : 'sleep'), children: tr(mode === 'sleep' ? 'pet.gameplay.wake' : 'pet.gameplay.sleep') })), shop !== undefined && (_jsx("button", { type: "button", className: styles.action, onClick: () => setPage('shop'), children: tr('pet.gameplay.shop') }))] })] })), page === 'shop' && shop !== undefined && (_jsxs(_Fragment, { children: [_jsx("div", { className: styles.gameplayShopItems, children: shop.items.map(item => (_jsxs("button", { type: "button", className: styles.gameplayShopItem, onClick: () => buy(item.id), title: item.label + ' — ' + String(item.price) + ' ' + currencyLabel(item.currency), children: [item.image !== undefined && (_jsx("img", { className: styles.gameplayShopItemImage, src: item.image, alt: "", draggable: false })), _jsx("span", { className: styles.gameplayShopItemLabel, children: item.label }), _jsxs("span", { className: styles.gameplayShopItemPrice, children: [item.price, " ", currencyLabel(item.currency)] })] }, item.id))) }), _jsx("div", { className: styles.gameplayActions, children: _jsx("button", { type: "button", className: styles.action, onClick: () => setPage('root'), children: tr('pet.gameplay.back') }) })] })), _jsx("button", { type: "button", className: styles.gameplayClose, "aria-label": tr('pet.gameplay.back'), onClick: () => setOpen(false), children: "\u00D7" })] }))] }));
+}

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;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAwB,aAAa,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAiEnI,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,CAwR9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAwB,aAAa,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AA4EnI,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,CAgT9C"}

package/lib/types/client/index.js

@@ -16,6 +16,7 @@ import { createPetStore } from "./pet-store.js";
 import { PetDockEntry } from "./PetDockEntry.js";
 import { defaultPetRendererRegistry } from "./renderers/registry.js";
 import { live2dRenderer } from "./renderers/live2d.js";
+import { frames2dRenderer } from "./renderers/frames2d.js";
 import { registerPetUiTeardown, takeoverPetUiTeardown } from "./ui-teardown.js";
 import { PetSettingsSection, PetSettingsCardController } from "./PetSettingsCard.js";
 import { NS, en, zh, t } from "./locales.js";
@@ -36,13 +37,18 @@ async function petFetch(path, body) {
 }
 /** The live host API instance (always defined; failures surface per call). */
 const petApi = {
-    state: () => petFetch('/api/pet/state'),
+    state: (currentSessionId) => petFetch('/api/pet/state'
+        + (currentSessionId === undefined ? '' : '?current=' + encodeURIComponent(currentSessionId))),
     pets: () => petFetch('/api/pet/pets'),
     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 }),
     setPet: (petId) => petFetch('/api/pet/set-pet', { petId }),
+    gameplayTouch: (zone) => petFetch('/api/pet/gameplay/touch', zone === undefined ? {} : { zone }),
+    gameplaySetMode: (mode) => petFetch('/api/pet/gameplay/mode', { mode }),
+    gameplayWorkTick: () => petFetch('/api/pet/gameplay/work-tick', {}),
+    gameplayBuy: (item) => petFetch('/api/pet/gameplay/buy', { item }),
 };
 /** Poll interval for the host snapshot. */
 const POLL_MS = 2000;
@@ -71,6 +77,7 @@ export function apply(ctx) {
     // Built-in renderers dispatch through the plugin-wide registry (pet-center
     // M3). Registration is idempotent (id wins), so re-applies stay clean.
     defaultPetRendererRegistry.register(live2dRenderer);
+    defaultPetRendererRegistry.register(frames2dRenderer);
     const binder = ctx.get('webUiSettings') ?? ctx.settingsScope;
     const settingsScope = binder.bind({ namespace: PET_SETTINGS_NS });
     const enabled = () => {
@@ -136,6 +143,19 @@ export function apply(ctx) {
             const setPets = petStore.actions.setPets;
             const setState = petStore.actions.setState;
             const setFeedback = petStore.actions.setFeedback;
+            // Clicking a session bubble jumps the GUI to that session; the same
+            // sessions face reports which session the user is currently on, so the
+            // host can lead the bubble stack with it. A bubble can outlive its
+            // disposed session by one poll tick, and the sessions service fails
+            // loud on unknown ids, so consult the live list first. The pet's type
+            // program also loads the host-side dsh-session package through the
+            // service types, whose Context merge declares a different 'sessions'
+            // face; pin the browser runtime's outward face here.
+            const sessions = ctx.sessions;
+            const currentSessionId = () => {
+                const current = sessions.list.getSnapshot().current;
+                return current === undefined ? undefined : String(current);
+            };
             // The registry list is fetched lazily with retries baked into the poll
             // cycle: until it lands, the dock entry renders nothing and every 2s
             // tick tries again. After it lands, one list feeds both the sprite and
@@ -157,7 +177,7 @@ export function apply(ctx) {
                 }
                 const seq = stateSeq + 1;
                 stateSeq = seq;
-                petApi.state().then((snapshot) => {
+                petApi.state(currentSessionId()).then((snapshot) => {
                     if (seq !== stateSeq)
                         return;
                     setSnapshot(snapshot);
@@ -201,13 +221,16 @@ export function apply(ctx) {
                     document.removeEventListener('visibilitychange', onVisibility);
                 };
             }, 'pet: poll');
-            // Clicking a session bubble jumps the GUI to that session. A bubble
-            // can outlive its disposed session by one poll tick, and the sessions
-            // service fails loud on unknown ids, so consult the live list first.
-            // The pet's type program also loads the host-side dsh-session package
-            // through the service types, whose Context merge declares a different
-            // 'sessions' face; pin the browser runtime's outward face here.
-            const sessions = ctx.sessions;
+            // A current-session switch should re-order the bubble stack right away,
+            // not on the next 2s tick. Poll only while the tab is visible, as the
+            // poll loop itself does.
+            const disposeSessionWatch = ctx.effect(() => {
+                const unsubscribe = sessions.list.subscribe(() => {
+                    if (document.visibilityState === 'visible')
+                        pollNow();
+                });
+                return unsubscribe;
+            }, 'pet: current-session watch');
             const openSession = (sessionId) => {
                 const list = sessions.list.getSnapshot();
                 if (list.byId[sessionId] === undefined)
@@ -272,6 +295,12 @@ export function apply(ctx) {
                 feedbackDone: () => {
                     setFeedback(null);
                 },
+                gameplay: {
+                    touch: (zone) => petApi.gameplayTouch(zone),
+                    setMode: (mode) => petApi.gameplaySetMode(mode),
+                    workTick: () => petApi.gameplayWorkTick(),
+                    buy: (item) => petApi.gameplayBuy(item),
+                },
             });
             // The pet is host-global (its state/display/interactions have no session
             // dimension), and the official rc.6 shell declares no root-scoped slot

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

@@ -22,6 +22,23 @@ export declare const zh: {
     readonly 'pet.live2d.vendor-missing': "Live2D 组件缺失，请升级宠物插件。";
     readonly 'pet.live2d.load-failed': "Live2D 模型加载失败，请检查该宠物目录的完整性。";
     readonly 'pet.openSessionHint': "点击跳转到对应会话";
+    readonly 'pet.gameplay.menu': "玩法";
+    readonly 'pet.gameplay.work': "打工";
+    readonly 'pet.gameplay.stopWork': "收工";
+    readonly 'pet.gameplay.sleep': "睡觉";
+    readonly 'pet.gameplay.wake': "起床";
+    readonly 'pet.gameplay.shop': "商店";
+    readonly 'pet.gameplay.back': "返回";
+    readonly 'pet.gameplay.buy': "购买";
+    readonly 'pet.gameplay.insufficient': "{currency}不足";
+    readonly 'pet.gameplay.prize': "中奖 +{amount} {currency}";
+    readonly 'pet.gameplay.working': "打工中";
+    readonly 'pet.gameplay.sleeping': "睡觉中";
+    readonly 'pet.gameplay.stat.hunger': "饱食";
+    readonly 'pet.gameplay.stat.mood': "心情";
+    readonly 'pet.gameplay.stat.energy': "精力";
+    readonly 'pet.gameplay.stat.affection': "好感";
+    readonly 'pet.gameplay.currency.treats': "小鱼干";
     readonly 'pet.moreSessions': "展开其余 {n} 个会话的气泡";
     readonly 'pet.collapseSessions': "收起会话气泡";
     readonly 'settings.title': "宠物";
@@ -75,6 +92,23 @@ export declare const en: {
     readonly 'pet.live2d.vendor-missing': "The Live2D component is missing; please update the pet plugin.";
     readonly 'pet.live2d.load-failed': "The Live2D model failed to load; check the pet directory is complete.";
     readonly 'pet.openSessionHint': "Click to jump to this session";
+    readonly 'pet.gameplay.menu': "Play";
+    readonly 'pet.gameplay.work': "Work";
+    readonly 'pet.gameplay.stopWork': "Stop work";
+    readonly 'pet.gameplay.sleep': "Sleep";
+    readonly 'pet.gameplay.wake': "Wake up";
+    readonly 'pet.gameplay.shop': "Shop";
+    readonly 'pet.gameplay.back': "Back";
+    readonly 'pet.gameplay.buy': "Buy";
+    readonly 'pet.gameplay.insufficient': "Not enough {currency}";
+    readonly 'pet.gameplay.prize': "Prize +{amount} {currency}";
+    readonly 'pet.gameplay.working': "Working";
+    readonly 'pet.gameplay.sleeping': "Sleeping";
+    readonly 'pet.gameplay.stat.hunger': "Hunger";
+    readonly 'pet.gameplay.stat.mood': "Mood";
+    readonly 'pet.gameplay.stat.energy': "Energy";
+    readonly 'pet.gameplay.stat.affection': "Affection";
+    readonly 'pet.gameplay.currency.treats': "Treats";
     readonly 'pet.moreSessions': "Expand {n} more session bubbles";
     readonly 'pet.collapseSessions': "Collapse session bubbles";
     readonly 'settings.title': "Pet";

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

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

package/lib/types/client/locales.js

@@ -22,6 +22,24 @@ export const zh = {
     'pet.live2d.vendor-missing': 'Live2D 组件缺失，请升级宠物插件。',
     'pet.live2d.load-failed': 'Live2D 模型加载失败，请检查该宠物目录的完整性。',
     'pet.openSessionHint': '点击跳转到对应会话',
+    // 玩法 HUD（miku-pet 泛化：属性条 / 打工 / 睡觉 / 商店；统一小鱼干经济）。
+    'pet.gameplay.menu': '玩法',
+    'pet.gameplay.work': '打工',
+    'pet.gameplay.stopWork': '收工',
+    'pet.gameplay.sleep': '睡觉',
+    'pet.gameplay.wake': '起床',
+    'pet.gameplay.shop': '商店',
+    'pet.gameplay.back': '返回',
+    'pet.gameplay.buy': '购买',
+    'pet.gameplay.insufficient': '{currency}不足',
+    'pet.gameplay.prize': '中奖 +{amount} {currency}',
+    'pet.gameplay.working': '打工中',
+    'pet.gameplay.sleeping': '睡觉中',
+    'pet.gameplay.stat.hunger': '饱食',
+    'pet.gameplay.stat.mood': '心情',
+    'pet.gameplay.stat.energy': '精力',
+    'pet.gameplay.stat.affection': '好感',
+    'pet.gameplay.currency.treats': '小鱼干',
     'pet.moreSessions': '展开其余 {n} 个会话的气泡',
     'pet.collapseSessions': '收起会话气泡',
     // 一级设置页（settings.section 席位）。
@@ -76,6 +94,24 @@ export const en = {
     'pet.live2d.vendor-missing': 'The Live2D component is missing; please update the pet plugin.',
     'pet.live2d.load-failed': 'The Live2D model failed to load; check the pet directory is complete.',
     'pet.openSessionHint': 'Click to jump to this session',
+    // Gameplay HUD (miku-pet generalization: stat bars / work / sleep / shop; unified treats economy).
+    'pet.gameplay.menu': 'Play',
+    'pet.gameplay.work': 'Work',
+    'pet.gameplay.stopWork': 'Stop work',
+    'pet.gameplay.sleep': 'Sleep',
+    'pet.gameplay.wake': 'Wake up',
+    'pet.gameplay.shop': 'Shop',
+    'pet.gameplay.back': 'Back',
+    'pet.gameplay.buy': 'Buy',
+    'pet.gameplay.insufficient': 'Not enough {currency}',
+    'pet.gameplay.prize': 'Prize +{amount} {currency}',
+    'pet.gameplay.working': 'Working',
+    'pet.gameplay.sleeping': 'Sleeping',
+    'pet.gameplay.stat.hunger': 'Hunger',
+    'pet.gameplay.stat.mood': 'Mood',
+    'pet.gameplay.stat.energy': 'Energy',
+    'pet.gameplay.stat.affection': 'Affection',
+    'pet.gameplay.currency.treats': 'Treats',
     'pet.moreSessions': 'Expand {n} more session bubbles',
     'pet.collapseSessions': 'Collapse session bubbles',
     // First-level settings section (the `settings.section` seat).

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

@@ -6,7 +6,7 @@
  * @module @linxin666/dsh-pet/client/pet-store
  */
 import type { EngineStoreHandle, EngineStoreInstance } from '@deepseek-ai/dsh-client-runtime/client';
-import type { PetStateView } from '../service.ts';
+import type { PetGameplayStateView, PetStateView } from '../service.ts';
 import type { PetInteraction } from '../affinity.ts';
 import type { PetDefinition } from '../registry.ts';
 /** One transient reaction bubble on the pet. */
@@ -41,6 +41,12 @@ export type PetUiActions = {
     setState: (draft: PetUiState, state: PetUiState['state'], error: string | null) => void;
     /** Show a reaction bubble. */
     setFeedback: (draft: PetUiState, feedback: PetFeedback | null) => void;
+    /**
+     * Patch the gameplay slice of the snapshot (verb write-back), so the HUD
+     * reflects a touch/mode/buy result immediately instead of waiting one
+     * poll tick (2 s).
+     */
+    setGameplayView: (draft: PetUiState, view: PetGameplayStateView) => void;
 };
 /** Create the pet store handle (apply world only; never module-level). */
 export declare function createPetStore(): EngineStoreHandle<PetUiState, PetUiActions>;

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,wCAAwC,CAAA;AACpG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjD,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;CACvE,CAAA;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,IAAI,iBAAiB,CAAC,UAAU,EAAE,YAAY,CAAC,CA2B5E;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,wCAAwC,CAAA;AACpG,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"}

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

@@ -32,6 +32,10 @@ export function createPetStore() {
             setFeedback: (draft, feedback) => {
                 draft.feedback = feedback;
             },
+            setGameplayView: (draft, view) => {
+                if (draft.snapshot !== null)
+                    draft.snapshot = { ...draft.snapshot, gameplay: view };
+            },
         },
     });
 }

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

@@ -0,0 +1,29 @@
+/**
+ * Frames2d visual mount — the React bridge between the pet center chrome
+ * and the imperative frames2d renderer, mirroring the live2d mount. The
+ * bridge owns the contract context (asset base, phase stream, interaction
+ * write-back, activation cleanups), feeds the polled phase into the stream,
+ * forwards the chrome's drag gesture onto the conventional 'drag' track
+ * (when the pet declares one), and renders the localized fallback card when
+ * the served config is invalid.
+ * @module @linxin666/dsh-pet/client/renderers/Frames2dVisualMount
+ */
+import { type ReactElement } from 'react';
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { PetDefinition } from '../../registry.ts';
+import type { ActivityPhase } from '../../state.ts';
+import type { DragStream } from '../drag-stream.ts';
+import type { GameplayBus } from '../gameplay-hud.tsx';
+import type { NS } from '../locales.ts';
+/** Mount the frames2d renderer as the sprite's visual (inside the chrome). */
+export declare function Frames2dVisualMount(props: {
+    definition: PetDefinition;
+    phase: ActivityPhase;
+    onPet: () => void;
+    /** Chrome drag gesture stream (the renderer switch owns it). */
+    drag: DragStream;
+    /** Gameplay coordination bus; the mount registers its track override. */
+    bus?: GameplayBus;
+    t: PropsLocale<typeof NS>['t'];
+}): ReactElement;
+//# sourceMappingURL=Frames2dVisualMount.d.ts.map

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

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