@linxin666/dsh-pet 0.3.3 → 0.3.5

package/lib/types/client/PetDockEntry.js

@@ -11,9 +11,11 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * the registry list — no per-pet component exists.
  * @module @linxin666/dsh-pet/client/PetDockEntry
  */
-import { useEffect, useSyncExternalStore } from 'react';
+import { useEffect, useRef, useSyncExternalStore } from 'react';
 import { PetSprite } from "./PetSprite.js";
 import { PetRendererSwitch } from "./renderers/PetRendererSwitch.js";
+import { createDragStream } from "./drag-stream.js";
+import { GameplayHud } from "./gameplay-hud.js";
 import styles from './pet.module.css';
 const DEFAULT_DISPLAY = { visible: true, size: 160, right: 24, bottom: 20 };
 /**
@@ -33,10 +35,24 @@ export function PetDockEntry(props) {
     useEffect(() => {
         ensure();
     }, [ensure]);
+    // Per-pet gameplay wiring: the coordination bus (HUD taps <-> chrome,
+    // HUD track overrides <-> frames2d mount) and the shared drag stream.
+    const auxRef = useRef(null);
+    if (definition !== null && (auxRef.current === null || auxRef.current.id !== definition.id)) {
+        auxRef.current = { id: definition.id, bus: {}, drag: createDragStream() };
+    }
+    const aux = auxRef.current;
+    const gameplay = definition?.gameplay;
     if (visible) {
         return (_jsx("span", { "data-pet-dock": true, "data-testid": "pet-dock", children: snapshot === null || definition === null
                 ? null
-                : (_jsx(PetRendererSwitch, { definition: definition, phase: snapshot?.phase ?? 'idle', onPet: props.pet, t: props.t, children: _jsx(PetSprite, { snapshot: snapshot, definition: definition, display: snapshot.display, feedback: feedback, onPet: props.pet, onFeed: props.feed, onHide: props.hide, onDragEnd: props.dragEnd, onRename: props.rename, onOpenSession: props.openSession, onFeedbackDone: props.feedbackDone, t: props.t }) })) }));
+                : (_jsx(PetRendererSwitch, { definition: definition, phase: snapshot?.phase ?? 'idle', onPet: props.pet, ...(aux === null ? {} : { drag: aux.drag, bus: aux.bus }), t: props.t, children: _jsx(PetSprite, { snapshot: snapshot, definition: definition, display: snapshot.display, feedback: feedback, onPet: props.pet, onFeed: props.feed, onHide: props.hide, onDragEnd: props.dragEnd, onRename: props.rename, onOpenSession: props.openSession, onFeedbackDone: props.feedbackDone, dragDisabled: snapshot.gameplay?.mode === 'work', ...(gameplay === undefined || aux === null
+                            ? {}
+                            : {
+                                onGameplayTap: (fx, fy) => aux.bus.tap?.(fx, fy),
+                                onGameplayMenu: () => aux.bus.openCard?.(),
+                                hud: (_jsx(GameplayHud, { definition: definition, store: store, api: props.gameplay, bus: aux.bus, drag: aux.drag, t: props.t })),
+                            }), t: props.t }) })) }));
     }
     const display = snapshot?.display ?? DEFAULT_DISPLAY;
     return (_jsx("button", { type: "button", className: styles.summon, style: {

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

@@ -33,6 +33,8 @@ export interface PetSpriteProps {
     onHide: () => void;
     /** Persist a drag position. */
     onDragEnd: (right: number, bottom: number) => void;
+    /** Drag gesture notifications for renderers with a drag track (frames2d). */
+    onDraggingChange?: (dragging: boolean) => void;
     /** Rename the selected pet (persisted by the host). */
     onRename: (name: string) => void;
     /** Navigate to the session one status bubble reports on. */
@@ -45,6 +47,27 @@ export interface PetSpriteProps {
      * renders inside the sprite box, and the atlas load + frame loop skip.
      */
     visual?: ReactNode;
+    /**
+     * Gameplay overlay (miku-pet generalization): rendered inside the float
+     * container so hover containment and stacking work unchanged. Absent for
+     * pets without a gameplay block.
+     */
+    hud?: ReactNode;
+    /**
+     * Gameplay tap sink: receives the tap point as sprite-box fractions
+     * (0..1). When present the chrome reports the tap IN ADDITION to the
+     * affinity pet; the HUD decides zones/no-ops.
+     */
+    onGameplayTap?: (fractionX: number, fractionY: number) => void;
+    /**
+     * Gameplay entry (miku-pet generalization): when present the hover panel
+     * renders a 玩法 action that opens/closes the gameplay card. The chrome
+     * wires it to the HUD through the per-pet bus (openCard), mirroring the
+     * onGameplayTap sink. Absent for pets without a gameplay block.
+     */
+    onGameplayMenu?: () => void;
+    /** Disable the drag gesture (gameplay work mode blocks dragging). */
+    dragDisabled?: boolean;
     /** Locale translate seat (namespace-bound). */
     t: TranslateNS<typeof NS>;
 }

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

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

package/lib/types/client/PetSprite.js

@@ -312,6 +312,8 @@ export function PetSprite(props) {
     // "window is not defined" (slow-runner timing, PetSprite.test.tsx).
     useEffect(() => () => clearHideTimer(), []);
     const onPointerDown = (e) => {
+        if (props.dragDisabled === true)
+            return;
         e.preventDefault();
         e.target.setPointerCapture?.(e.pointerId);
         const current = dragPos ?? { right: display.right, bottom: display.bottom };
@@ -325,8 +327,11 @@ export function PetSprite(props) {
             return;
         const dx = e.clientX - drag.startX;
         const dy = e.clientY - drag.startY;
-        if (Math.abs(dx) > 4 || Math.abs(dy) > 4)
+        if (Math.abs(dx) > 4 || Math.abs(dy) > 4) {
+            if (!draggedRef.current)
+                props.onDraggingChange?.(true);
             draggedRef.current = true;
+        }
         const right = clampOffset(drag.right - dx, window.innerWidth - 40);
         const bottom = clampOffset(drag.bottom - dy, window.innerHeight - 40);
         setDragPos({ right, bottom });
@@ -335,6 +340,8 @@ export function PetSprite(props) {
         if (dragRef.current === null)
             return;
         dragRef.current = null;
+        if (draggedRef.current)
+            props.onDraggingChange?.(false);
         if (dragPos !== null)
             props.onDragEnd(dragPos.right, dragPos.bottom);
     };
@@ -353,14 +360,14 @@ export function PetSprite(props) {
     const statusBubble = feedback === null && sessionBubbles.length === 0
         ? snapshot?.bubble
         : undefined;
-    // The display session's inner whisper (碎碎念) — short inner-voice copy
-    // woken by the model's output. Instead of a second bubble of its own, a
-    // fresh whisper takes over the display session's bubble (the stack top, or
-    // the single status bubble) and re-tints it, so the pet never wears two
-    // voices at once. Interaction feedback takes over the whole bubble area
-    // while it plays, so whispers yield to it like status copy.
-    const whisper = feedback === null ? snapshot?.whisper : undefined;
-    const bubblePresent = feedback !== null || sessionBubbles.length > 0 || statusBubble !== undefined || whisper !== undefined;
+    // Each session's inner whisper (碎碎念) rides its own bubble — short
+    // inner-voice copy woken by that session's activity, never the model's or
+    // another session's. Instead of a second bubble of its own, a fresh
+    // whisper takes over its session's bubble and re-tints it, so the pet
+    // never wears two voices at once. Interaction feedback takes over the
+    // whole bubble area while it plays, so whispers yield to it like status
+    // copy.
+    const bubblePresent = feedback !== null || sessionBubbles.length > 0 || statusBubble !== undefined;
     const displayName = snapshot?.name ?? definition.displayName;
     // The host-served status decoration (M5, #567); absent = text-only bubbles.
     const decoration = snapshot?.decoration;
@@ -416,40 +423,37 @@ export function PetSprite(props) {
                 return;
             clearHideTimer();
             hideTimerRef.current = window.setTimeout(() => setHovered(false), 300);
-        }, children: [_jsxs("div", { className: styles.spriteWrap, style: { width: spriteWidth, height: spriteHeight }, children: [_jsx("div", { ref: spriteRef, className: styles.sprite, style: {
-                            width: spriteWidth,
-                            height: spriteHeight,
-                            ...(props.visual === undefined
-                                ? {
-                                    backgroundImage: imageReady ? 'url(' + definition.atlasUrl + ')' : undefined,
-                                    backgroundSize: (cell.width * columns * spriteScale) + 'px ' + (cell.height * (definition.atlasRows ?? rows.length) * spriteScale) + 'px',
-                                    backgroundRepeat: 'no-repeat',
-                                    backgroundPosition: '0 0',
-                                }
-                                : {}),
-                            cursor: dragRef.current === null ? 'grab' : 'grabbing',
-                        }, onPointerDown: onPointerDown, onPointerMove: onPointerMove, onPointerUp: onPointerUp, onClick: () => {
-                            // A pointer sequence that moved (dragged) still fires a trailing
-                            // click; skip the pet when that happened.
-                            if (draggedRef.current)
-                                return;
-                            props.onPet();
-                        }, role: "button", "aria-label": definition.displayName, children: props.visual }), _jsx("button", { type: "button", className: styles.closeButton, "aria-label": panelLabel('hide', props.t('pet.hide')), title: panelLabel('hide', props.t('pet.hide')), "data-testid": "pet-close", onPointerDown: (e) => {
-                            // Keep the close control from starting a drag on the sprite.
-                            e.stopPropagation();
-                        }, onClick: (e) => {
-                            // The close control sits beside the pet button; do not pet as a
-                            // side effect of closing the overlay.
-                            e.stopPropagation();
-                            props.onHide();
-                        }, children: "\u00D7" })] }), feedback !== null && (_jsx("div", { ref: bubbleRef, className: clsx(styles.bubble, feedback.kind === 'feed' ? styles.bubbleFeed : styles.bubblePet), children: feedback.text }, feedback.at)), feedback === null && (sessionBubbles.length > 0 || statusBubble !== undefined || whisper !== undefined) && (_jsxs("div", { ref: bubbleRef, className: styles.bubbleStack, onPointerEnter: () => setStackPeek(true), onPointerLeave: () => setStackPeek(false), children: [visibleSessions.map((session, index) => {
-                        // The whisper rides the display session's bubble — the stack's
-                        // primary entry (DOM-first, rendered bottom-most by the reversed
-                        // column so it stays glued to the sprite when extras open above).
-                        // The key swap restarts the entrance animation so the mood change
-                        // reads as the bubble re-speaking.
-                        const speaksWhisper = index === 0 && whisper !== undefined;
-                        const bubble = (_jsxs("button", { type: "button", className: clsx(styles.bubble, styles.bubbleStatus, styles.bubbleClickable, speaksWhisper && styles.bubbleWhisper), title: props.t('pet.openSessionHint'), onClick: () => { props.onOpenSession(session.sessionId); }, children: [index === 0 && !speaksWhisper && decoration !== undefined && (_jsx(StatusOrnament, { decoration: decoration, phase: phase })), speaksWhisper ? whisper : session.bubble] }, speaksWhisper ? 'whisper:' + whisper : session.sessionId));
+        }, children: [_jsx("div", { className: styles.spriteWrap, style: { width: spriteWidth, height: spriteHeight }, children: _jsx("div", { ref: spriteRef, className: styles.sprite, style: {
+                        width: spriteWidth,
+                        height: spriteHeight,
+                        ...(props.visual === undefined
+                            ? {
+                                backgroundImage: imageReady ? 'url(' + definition.atlasUrl + ')' : undefined,
+                                backgroundSize: (cell.width * columns * spriteScale) + 'px ' + (cell.height * (definition.atlasRows ?? rows.length) * spriteScale) + 'px',
+                                backgroundRepeat: 'no-repeat',
+                                backgroundPosition: '0 0',
+                            }
+                            : {}),
+                        cursor: dragRef.current === null ? 'grab' : 'grabbing',
+                    }, onPointerDown: onPointerDown, onPointerMove: onPointerMove, onPointerUp: onPointerUp, onClick: (e) => {
+                        // A pointer sequence that moved (dragged) still fires a trailing
+                        // click; skip the pet when that happened.
+                        if (draggedRef.current)
+                            return;
+                        if (props.onGameplayTap !== undefined && spriteRef.current !== null) {
+                            const rect = spriteRef.current.getBoundingClientRect();
+                            if (rect.width > 0 && rect.height > 0) {
+                                props.onGameplayTap((e.clientX - rect.left) / rect.width, (e.clientY - rect.top) / rect.height);
+                            }
+                        }
+                        props.onPet();
+                    }, role: "button", "aria-label": definition.displayName, children: props.visual }) }), props.hud, feedback !== null && (_jsx("div", { ref: bubbleRef, className: clsx(styles.bubble, feedback.kind === 'feed' ? styles.bubbleFeed : styles.bubblePet), children: feedback.text }, feedback.at)), feedback === null && (sessionBubbles.length > 0 || statusBubble !== undefined) && (_jsxs("div", { ref: bubbleRef, className: styles.bubbleStack, onPointerEnter: () => setStackPeek(true), onPointerLeave: () => setStackPeek(false), children: [visibleSessions.map((session, index) => {
+                        // A session's whisper rides ITS OWN bubble (the stack lead when
+                        // the current session has one, any bubble when the stack is
+                        // expanded). The key swap restarts the entrance animation so the
+                        // mood change reads as the bubble re-speaking.
+                        const speaksWhisper = session.whisper !== undefined;
+                        const bubble = (_jsxs("button", { type: "button", className: clsx(styles.bubble, styles.bubbleStatus, styles.bubbleClickable, speaksWhisper && styles.bubbleWhisper), title: props.t('pet.openSessionHint'), onClick: () => { props.onOpenSession(session.sessionId); }, children: [index === 0 && !speaksWhisper && decoration !== undefined && (_jsx(StatusOrnament, { decoration: decoration, phase: phase })), session.whisper ?? session.bubble] }, speaksWhisper ? 'whisper:' + session.whisper : session.sessionId));
                         // The primary bubble carries the '+N' badge while other sessions
                         // hide behind it; the badge toggles the pinned (touch) expansion.
                         if (index !== 0 || sessionBubbles.length <= 1)
@@ -462,7 +466,7 @@ export function PetSprite(props) {
                                         e.stopPropagation();
                                         setStackPinned(open => !open);
                                     }, children: stackOpen ? '×' : '+' + String(sessionBubbles.length - 1) })] }, "primary"));
-                    }), sessionBubbles.length === 0 && (statusBubble !== undefined || whisper !== undefined) && (_jsxs("div", { className: clsx(styles.bubble, styles.bubbleStatus, whisper !== undefined && styles.bubbleWhisper), role: "status", "aria-live": "polite", children: [whisper === undefined && decoration !== undefined && (_jsx(StatusOrnament, { decoration: decoration, phase: phase })), whisper ?? statusBubble] }, whisper === undefined ? 'status' : 'whisper:' + whisper))] })), hovered && dragRef.current === null && (_jsx("div", { ref: panelRef, className: clsx(styles.panel, panelAbove && styles.panelAbove), "data-placement": panelAbove ? 'above' : 'below', style: panelAbove && panelLift > 0
+                    }), sessionBubbles.length === 0 && statusBubble !== undefined && (_jsxs("div", { className: clsx(styles.bubble, styles.bubbleStatus), role: "status", "aria-live": "polite", children: [decoration !== undefined && (_jsx(StatusOrnament, { decoration: decoration, phase: phase })), statusBubble] }, "status"))] })), hovered && dragRef.current === null && (_jsx("div", { ref: panelRef, className: clsx(styles.panel, panelAbove && styles.panelAbove), "data-placement": panelAbove ? 'above' : 'below', style: panelAbove && panelLift > 0
                     ? { marginBottom: panelLift }
                     : undefined, onPointerEnter: () => {
                     // Reaching the panel (or its bridge) must cancel any hide timer
@@ -500,6 +504,6 @@ export function PetSprite(props) {
                                         clearHideTimer();
                                         setNameDraft(displayName);
                                         setRenaming(true);
-                                    }, children: panelLabel('rename', props.t('pet.rename')) })), panelShows('hide') && (_jsx("button", { type: "button", className: styles.action, onClick: props.onHide, children: panelLabel('hide', props.t('pet.hide')) }))] })] })) }))] }));
+                                    }, children: panelLabel('rename', props.t('pet.rename')) })), panelShows('hide') && (_jsx("button", { type: "button", className: styles.action, onClick: props.onHide, children: panelLabel('hide', props.t('pet.hide')) })), props.onGameplayMenu !== undefined && (_jsx("button", { type: "button", className: styles.action, onClick: props.onGameplayMenu, children: props.t('pet.gameplay.menu') }))] })] })) }))] }));
     return createPortal(float, document.body);
 }

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

@@ -22,6 +22,8 @@ export interface PluginSettingsCardProps<TKey extends string = string> {
     titleKey: TKey;
     /** Locale key of the line describing what this plugin's settings govern. */
     descriptionKey: TKey;
+    /** Optional rich header description rendered instead of the plain t(descriptionKey) text (the plain text stays as the tooltip). */
+    descriptionNode?: ReactNode;
     /** The card's form state: availability, writability, and what a save would do. */
     state: CardShell;
     /** Write every staged edit. */

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

@@ -1 +1 @@
-{"version":3,"file":"PluginSettingsCard.d.ts","sourceRoot":"","sources":["../../../src/client/PluginSettingsCard.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"PluginSettingsCard.d.ts","sourceRoot":"","sources":["../../../src/client/PluginSettingsCard.tsx"],"names":[],"mappings":"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"}

package/lib/types/client/PluginSettingsCard.js

@@ -40,8 +40,8 @@ export function PluginSettingsCard(props) {
     // With alwaysOpen the nav entry already provides the selection, so the
     // header is a static title row instead of a disclosure button.
     const header = alwaysOpen === true
-        ? (_jsxs("div", { className: css.headerStatic, children: [_jsxs("span", { className: css.headText, children: [_jsx("span", { className: css.name, title: title, children: title }), _jsx("span", { className: css.description, title: description, children: description })] }), state.dirty ? _jsx("span", { className: css.pending, title: props.t('settings.unsaved'), children: props.t('settings.unsaved') }) : null] }))
-        : (_jsxs("button", { type: "button", className: css.header, "aria-expanded": open, "aria-label": `${props.t(open ? 'settings.collapse' : 'settings.expand')}: ${title}`, onClick: () => { setOpen(!open); }, children: [_jsxs("span", { className: css.headText, children: [_jsx("span", { className: css.name, title: title, children: title }), _jsx("span", { className: css.description, title: description, children: description })] }), state.dirty ? _jsx("span", { className: css.pending, title: props.t('settings.unsaved'), children: props.t('settings.unsaved') }) : null, _jsx("svg", { width: "14", height: "14", viewBox: "0 0 14 14", fill: "none", xmlns: "http://www.w3.org/2000/svg", className: open ? `${css.chevron} ${css.chevronOpen}` : css.chevron, children: _jsx("path", { d: "M11.8486 5.5L11.4238 5.92383L8.69727 8.65137C8.44157 8.90706 8.21562 9.13382 8.01172 9.29785C7.79912 9.46883 7.55595 9.61756 7.25 9.66602C7.08435 9.69222 6.91565 9.69222 6.75 9.66602C6.44405 9.61756 6.20088 9.46883 5.98828 9.29785C5.78438 9.13382 5.55843 8.90706 5.30273 8.65137L2.57617 5.92383L2.15137 5.5L3 4.65137L3.42383 5.07617L6.15137 7.80273C6.42595 8.07732 6.59876 8.24849 6.74023 8.3623C6.87291 8.46904 6.92272 8.47813 6.9375 8.48047C6.97895 8.48703 7.02105 8.48703 7.0625 8.48047C7.07728 8.47813 7.12709 8.46904 7.25977 8.3623C7.40124 8.24849 7.57405 8.07732 7.84863 7.80273L10.5762 5.07617L11 4.65137L11.8486 5.5Z", fill: "currentColor" }) })] }));
+        ? (_jsxs("div", { className: css.headerStatic, children: [_jsxs("span", { className: css.headText, children: [_jsx("span", { className: css.name, title: title, children: title }), _jsx("span", { className: css.description, title: description, children: props.descriptionNode ?? description })] }), state.dirty ? _jsx("span", { className: css.pending, title: props.t('settings.unsaved'), children: props.t('settings.unsaved') }) : null] }))
+        : (_jsxs("button", { type: "button", className: css.header, "aria-expanded": open, "aria-label": `${props.t(open ? 'settings.collapse' : 'settings.expand')}: ${title}`, onClick: () => { setOpen(!open); }, children: [_jsxs("span", { className: css.headText, children: [_jsx("span", { className: css.name, title: title, children: title }), _jsx("span", { className: css.description, title: description, children: props.descriptionNode ?? description })] }), state.dirty ? _jsx("span", { className: css.pending, title: props.t('settings.unsaved'), children: props.t('settings.unsaved') }) : null, _jsx("svg", { width: "14", height: "14", viewBox: "0 0 14 14", fill: "none", xmlns: "http://www.w3.org/2000/svg", className: open ? `${css.chevron} ${css.chevronOpen}` : css.chevron, children: _jsx("path", { d: "M11.8486 5.5L11.4238 5.92383L8.69727 8.65137C8.44157 8.90706 8.21562 9.13382 8.01172 9.29785C7.79912 9.46883 7.55595 9.61756 7.25 9.66602C7.08435 9.69222 6.91565 9.69222 6.75 9.66602C6.44405 9.61756 6.20088 9.46883 5.98828 9.29785C5.78438 9.13382 5.55843 8.90706 5.30273 8.65137L2.57617 5.92383L2.15137 5.5L3 4.65137L3.42383 5.07617L6.15137 7.80273C6.42595 8.07732 6.59876 8.24849 6.74023 8.3623C6.87291 8.46904 6.92272 8.47813 6.9375 8.48047C6.97895 8.48703 7.02105 8.48703 7.0625 8.48047C7.07728 8.47813 7.12709 8.46904 7.25977 8.3623C7.40124 8.24849 7.57405 8.07732 7.84863 7.80273L10.5762 5.07617L11 4.65137L11.8486 5.5Z", fill: "currentColor" }) })] }));
     // The namespace exists but the Host does not serve it to this client (the
     // official settings allowlist omits third-party namespaces): show a card
     // that explains the gap instead of vanishing, so a missing card never

package/lib/types/client/drag-stream.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Drag stream — bridges the chrome's pointer drag state onto the renderer
+ * contract's { get, subscribe } shape, so renderers with a dedicated drag
+ * track (frames2d) can follow the chrome-owned drag gesture. Dispatch is
+ * change-only, mirroring the phase stream.
+ * @module @linxin666/dsh-pet/client/drag-stream
+ */
+/** The renderer-facing drag stream. */
+export interface DragStream {
+    /** Whether the chrome reports an active drag gesture. */
+    get(): boolean;
+    /** Subscribe to drag state changes; returns the unsubscribe. */
+    subscribe(listener: (dragging: boolean) => void): () => void;
+    /** Feed a fresh drag state; no-op when unchanged. */
+    push(dragging: boolean): void;
+}
+/** Create the stream (one per pet activation, owned by the renderer switch). */
+export declare function createDragStream(): DragStream;
+//# sourceMappingURL=drag-stream.d.ts.map

package/lib/types/client/drag-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag-stream.d.ts","sourceRoot":"","sources":["../../../src/client/drag-stream.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uCAAuC;AACvC,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,GAAG,IAAI,OAAO,CAAA;IACd,gEAAgE;IAChE,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IAC5D,qDAAqD;IACrD,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAA;CAC9B;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,IAAI,UAAU,CAe7C"}

package/lib/types/client/drag-stream.js

@@ -0,0 +1,26 @@
+/**
+ * Drag stream — bridges the chrome's pointer drag state onto the renderer
+ * contract's { get, subscribe } shape, so renderers with a dedicated drag
+ * track (frames2d) can follow the chrome-owned drag gesture. Dispatch is
+ * change-only, mirroring the phase stream.
+ * @module @linxin666/dsh-pet/client/drag-stream
+ */
+/** Create the stream (one per pet activation, owned by the renderer switch). */
+export function createDragStream() {
+    let current = false;
+    const listeners = new Set();
+    return {
+        get: () => current,
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => { listeners.delete(listener); };
+        },
+        push(dragging) {
+            if (dragging === current)
+                return;
+            current = dragging;
+            for (const listener of [...listeners])
+                listener(dragging);
+        },
+    };
+}

package/lib/types/client/gameplay-hud.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 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 { type ReactElement } from 'react';
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { PetDefinition } from '../registry.ts';
+import type { PetGameplayVerbResult } from '../service.ts';
+import type { PetStoreInstance } from './pet-store.ts';
+import type { DragStream } from './drag-stream.ts';
+import type { NS } from './locales.ts';
+/** The gameplay verb API the plugin apply body injects (host-authoritative). */
+export interface GameplayApi {
+    touch: (zone?: string) => Promise<PetGameplayVerbResult>;
+    setMode: (mode: 'work' | 'sleep' | null) => Promise<PetGameplayVerbResult>;
+    workTick: () => Promise<PetGameplayVerbResult>;
+    buy: (item: string) => Promise<PetGameplayVerbResult>;
+}
+/**
+ * The per-pet coordination bus. The frames2d visual mount registers the
+ * track override (setTrack); the HUD registers the sprite tap handler; the
+ * chrome calls into whatever is registered. Optional chaining everywhere —
+ * either side may be mid-remount during a hot reload.
+ */
+export interface GameplayBus {
+    setTrack?: (track?: string) => void;
+    tap?: (fx: number, fy: number) => void;
+    /**
+     * Card open/close request from the chrome (the hover panel's 玩法 action):
+     * the HUD registers this, and calling it with no argument toggles the card
+     * while a boolean pins the state (same chrome -> HUD direction as tap).
+     */
+    openCard?: (open?: boolean) => void;
+}
+/** The gameplay overlay for one frames2d pet that declares 'gameplay'. */
+export declare function GameplayHud(props: {
+    definition: PetDefinition;
+    store: PetStoreInstance;
+    api: GameplayApi;
+    bus: GameplayBus;
+    drag: DragStream;
+    t: PropsLocale<typeof NS>['t'];
+}): ReactElement | null;
+//# sourceMappingURL=gameplay-hud.d.ts.map

package/lib/types/client/gameplay-hud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gameplay-hud.d.ts","sourceRoot":"","sources":["../../../src/client/gameplay-hud.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAsE,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AAC7G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAE1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAGtC,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;IACxD,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAC1E,QAAQ,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAC9C,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;CACtD;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CACpC;AAYD,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,UAAU,EAAE,aAAa,CAAA;IACzB,KAAK,EAAE,gBAAgB,CAAA;IACvB,GAAG,EAAE,WAAW,CAAA;IAChB,GAAG,EAAE,WAAW,CAAA;IAChB,IAAI,EAAE,UAAU,CAAA;IAChB,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;CAC/B,GAAG,YAAY,GAAG,IAAI,CAkVtB"}