@linxin666/dsh-pet 0.2.2 → 0.2.4

package/lib/types/client/PetSprite.js

@@ -20,6 +20,80 @@ import styles from './pet.module.css';
 function clampOffset(value, max) {
     return Math.max(0, Math.min(max, value));
 }
+/**
+ * The status decoration ornament (pet-center M5, #567). Renders the active
+ * phase's frame segment as a CSS-background strip at a compact bubble
+ * height; prefers-reduced-motion holds the segment's first frame, and a
+ * missing or undecodable asset simply paints nothing (CSS background
+ * failure) — the bubble text is never disturbed. The span is aria-hidden;
+ * the bubble keeps its own semantics untouched.
+ */
+function StatusOrnament(props) {
+    const { decoration, phase } = props;
+    const segment = decoration.phases[phase];
+    const shown = segment !== undefined && segment !== 'hide';
+    const segmentKey = segment !== undefined && segment !== 'hide' ? segment.from + ':' + segment.to : 'none';
+    const spanRef = useRef(null);
+    const scale = 18 / decoration.cell.height;
+    const frameWidth = Math.round(decoration.cell.width * scale);
+    const stripWidth = decoration.columns * frameWidth;
+    // Value-stable dependency key: the host serves a fresh DecorationView
+    // object on every state poll (2 s), so the effect must not depend on the
+    // object identity — otherwise each poll would cancel and restart the
+    // frame loop and the animation would jump back to its first frame.
+    const durationsKey = decoration.durations.join(',');
+    useEffect(() => {
+        if (segment === undefined || segment === 'hide')
+            return;
+        const el = spanRef.current;
+        if (el === null)
+            return;
+        const position = (index) => (-index * frameWidth) + 'px 0px';
+        const reduceMotion = window.matchMedia?.('(prefers-reduced-motion: reduce)')?.matches === true;
+        el.style.backgroundPosition = position(segment.from);
+        if (reduceMotion)
+            return;
+        let raf = 0;
+        let index = segment.from;
+        let elapsed = 0;
+        let last = performance.now();
+        const tick = (ts) => {
+            const delta = ts - last;
+            last = ts;
+            elapsed += delta;
+            const duration = decoration.durations[index] ?? 160;
+            if (elapsed >= duration) {
+                elapsed = 0;
+                if (index < segment.to)
+                    index += 1;
+                else if (decoration.loop)
+                    index = segment.from;
+            }
+            el.style.backgroundPosition = position(index);
+            // A non-looping segment settles on its last frame; stop scheduling
+            // instead of repainting the same position every frame.
+            if (!decoration.loop && index === segment.to)
+                return;
+            raf = requestAnimationFrame(tick);
+        };
+        raf = requestAnimationFrame(tick);
+        return () => cancelAnimationFrame(raf);
+    }, [shown, segmentKey, frameWidth, decoration.loop, durationsKey]);
+    if (!shown)
+        return null;
+    return (_jsx("span", { ref: spanRef, "aria-hidden": "true", "data-dsh-pet-decoration": decoration.id, style: {
+            display: 'inline-block',
+            width: frameWidth,
+            height: 18,
+            marginRight: 6,
+            verticalAlign: 'middle',
+            flexShrink: 0,
+            backgroundImage: 'url(' + decoration.entryUrl + ')',
+            backgroundSize: stripWidth + 'px 18px',
+            backgroundRepeat: 'no-repeat',
+            backgroundPosition: '0px 0px',
+        } }));
+}
 /**
  * The floating pet. The spritesheet frame advances on requestAnimationFrame
  * with per-frame durations from the definition's tracks; the atlas image is
@@ -66,9 +140,35 @@ export function PetSprite(props) {
     const rows = definition.rows;
     const tracks = definition.tracks;
     const sequences = definition.sequences;
+    // Hover-panel chrome from the pet's voice pack (pet-center M4, issue
+    // #677): every slot falls back to the i18n dictionary when unset. Stat
+    // formats carry {rank}/{n}/{points} placeholders the host validated.
+    const panel = definition.panel;
+    const panelLabel = (slot, i18n) => panel?.labels?.[slot] ?? i18n;
+    const panelStat = (slot, i18nKey, values) => {
+        const format = panel?.stats?.[slot] ?? props.t(i18nKey, values);
+        if (panel?.stats?.[slot] === undefined)
+            return format;
+        // The host whitelists {rank}/{n}/{points} in every stat slot, so a pack
+        // format may reference any of them; substitute all three live values
+        // (the slot's own value plus the siblings) instead of only the slot's.
+        const all = {
+            rank: snapshot?.affinity.rank ?? '?',
+            n: snapshot?.treats.stocked ?? 0,
+            points: snapshot?.affinity.points ?? 0,
+        };
+        let text = format;
+        for (const [name, value] of Object.entries(all))
+            text = text.replaceAll('{' + name + '}', String(value));
+        return text;
+    };
+    const panelShows = (action) => panel?.actions === undefined || panel.actions.includes(action);
     // Load the atlas once; the definition carries the authoritative per-row
-    // frame counts and per-track durations, so nothing else is fetched.
+    // frame counts and per-track durations, so nothing else is fetched. A
+    // custom visual (pet-center M3) replaces the atlas entirely.
     useEffect(() => {
+        if (props.visual !== undefined)
+            return;
         let cancelled = false;
         const img = new Image();
         img.onload = () => {
@@ -80,7 +180,7 @@ export function PetSprite(props) {
             cancelled = true;
             img.onload = null;
         };
-    }, [definition.atlasUrl]);
+    }, [definition.atlasUrl, props.visual]);
     // Frame loop: advance the current track and write background-position.
     // Offsets must be in SCALED coordinates (background-position applies to the
     // scaled background image), so the current sprite scale rides a ref that
@@ -93,6 +193,8 @@ export function PetSprite(props) {
     const scaleRef = useRef(spriteScale);
     scaleRef.current = spriteScale;
     useEffect(() => {
+        if (props.visual !== undefined)
+            return;
         const reduceMotion = typeof window !== 'undefined'
             && window.matchMedia?.('(prefers-reduced-motion: reduce)')?.matches === true;
         const sequence = animation === animationForPhase(phase) ? sequences?.[phase] : undefined;
@@ -160,7 +262,7 @@ export function PetSprite(props) {
         };
         raf = requestAnimationFrame(tick);
         return () => cancelAnimationFrame(raf);
-    }, [animation, phase, cell, columns, rows, tracks, sequences]);
+    }, [animation, phase, cell, columns, rows, tracks, sequences, props.visual]);
     // Auto-clear the feedback bubble after its CSS animation. The callback
     // rides a ref so re-renders never reset the timer: the 2s poll rebuilds
     // `props` every tick, and depending on it would starve the timeout.
@@ -237,6 +339,8 @@ export function PetSprite(props) {
     const whisper = feedback === null ? snapshot?.whisper : undefined;
     const bubblePresent = feedback !== null || sessionBubbles.length > 0 || statusBubble !== undefined || whisper !== undefined;
     const displayName = snapshot?.name ?? definition.displayName;
+    // The host-served status decoration (M5, #567); absent = text-only bubbles.
+    const decoration = snapshot?.decoration;
     // A settled session list can no longer stay pinned open.
     useEffect(() => {
         if (sessionBubbles.length <= 1)
@@ -292,10 +396,14 @@ export function PetSprite(props) {
         }, children: [_jsx("div", { ref: spriteRef, className: styles.sprite, style: {
                     width: spriteWidth,
                     height: spriteHeight,
-                    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',
+                    ...(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
@@ -303,14 +411,14 @@ export function PetSprite(props) {
                     if (draggedRef.current)
                         return;
                     props.onPet();
-                }, role: "button", "aria-label": definition.displayName }), 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) => {
+                }, role: "button", "aria-label": definition.displayName, children: props.visual }), 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 = (_jsx("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: speaksWhisper ? whisper : session.bubble }, speaksWhisper ? 'whisper:' + whisper : session.sessionId));
+                        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));
                         // 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)
@@ -323,7 +431,7 @@ export function PetSprite(props) {
                                         e.stopPropagation();
                                         setStackPinned(open => !open);
                                     }, children: stackOpen ? '×' : '+' + String(sessionBubbles.length - 1) })] }, "primary"));
-                    }), sessionBubbles.length === 0 && (statusBubble !== undefined || whisper !== undefined) && (_jsx("div", { className: clsx(styles.bubble, styles.bubbleStatus, whisper !== undefined && styles.bubbleWhisper), role: "status", "aria-live": "polite", children: 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 || 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
                     ? { marginBottom: panelLift }
                     : undefined, onPointerEnter: () => {
                     // Reaching the panel (or its bridge) must cancel any hide timer
@@ -355,12 +463,12 @@ export function PetSprite(props) {
                                     props.onRename(trimmed);
                                     setRenaming(false);
                                 }
-                            }, children: props.t('pet.confirm') })] })) : (_jsxs(_Fragment, { children: [_jsxs("div", { className: styles.rankRow, children: [_jsx("span", { className: styles.nameCell, children: displayName }), _jsx("span", { className: styles.statRank, children: props.t('pet.rank', { rank: snapshot?.affinity.rank ?? '?' }) })] }), _jsxs("div", { className: styles.rankRow, children: [_jsx("span", { className: styles.statTreats, children: props.t('pet.treats', { n: snapshot?.treats.stocked ?? 0 }) }), _jsx("span", { className: styles.statPoints, children: props.t('pet.points', { points: snapshot?.affinity.points ?? 0 }) })] }), _jsxs("div", { className: styles.actions, children: [_jsx("button", { type: "button", className: styles.action, onClick: props.onFeed, children: props.t('pet.feed') }), _jsx("button", { type: "button", className: styles.action, onClick: () => {
+                            }, children: panelLabel('confirm', props.t('pet.confirm')) })] })) : (_jsxs(_Fragment, { children: [_jsxs("div", { className: styles.rankRow, children: [_jsx("span", { className: styles.nameCell, children: displayName }), _jsx("span", { className: styles.statRank, children: panelStat('rank', 'pet.rank', { rank: snapshot?.affinity.rank ?? '?' }) })] }), _jsxs("div", { className: styles.rankRow, children: [_jsx("span", { className: styles.statTreats, children: panelStat('treats', 'pet.treats', { n: snapshot?.treats.stocked ?? 0 }) }), _jsx("span", { className: styles.statPoints, children: panelStat('points', 'pet.points', { points: snapshot?.affinity.points ?? 0 }) })] }), _jsxs("div", { className: styles.actions, children: [panelShows('feed') && (_jsx("button", { type: "button", className: styles.action, onClick: props.onFeed, children: panelLabel('feed', props.t('pet.feed')) })), panelShows('rename') && (_jsx("button", { type: "button", className: styles.action, onClick: () => {
                                         // Cancel any pending hide so the rename box cannot
                                         // unmount right as the user starts typing (#303).
                                         clearHideTimer();
                                         setNameDraft(displayName);
                                         setRenaming(true);
-                                    }, children: props.t('pet.rename') }), _jsx("button", { type: "button", className: styles.action, onClick: props.onHide, children: 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')) }))] })] })) }))] }));
     return createPortal(float, document.body);
 }

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;AA6DnI,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,CAkN9C"}
+{"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;AA+DnI,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,CAsN9C"}

package/lib/types/client/index.js

@@ -14,6 +14,8 @@ import { createElement } from 'react';
 import { createRoot } from 'react-dom/client';
 import { createPetStore } from './pet-store.js';
 import { PetDockEntry } from './PetDockEntry.js';
+import { defaultPetRendererRegistry } from './renderers/registry.js';
+import { live2dRenderer } from './renderers/live2d.js';
 import { PetSettingsSection, PetSettingsCardController } from './PetSettingsCard.js';
 import { NS, en, zh, t } from './locales.js';
 /** Same-origin JSON fetch helper (GET without body, POST with JSON body). */
@@ -54,6 +56,9 @@ export const inject = ['slots', 'locale', 'connection', 'settingsScope', 'remote
  */
 export function apply(ctx) {
     ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'pet: dictionaries');
+    // 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);
     const binder = ctx.get('webUiSettings') ?? ctx.settingsScope;
     const settingsScope = binder.bind({ namespace: PET_SETTINGS_NS });
     const enabled = () => {

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

@@ -17,15 +17,22 @@ export declare const zh: {
     readonly 'pet.treats': '小鱼干 ×{n}';
     readonly 'pet.state.loading': '宠物正在赶来…';
     readonly 'pet.state.error': '宠物迷路了（连接失败）';
+    readonly 'pet.renderer.unavailable': '这只宠物需要的渲染器（{renderer}）在当前版本不可用。';
+    readonly 'pet.live2d.core-missing': 'Live2D 核心未安装：请把官方 live2dcubismcore.min.js 放入 $DSH_HOME/pets/.runtime/ 后刷新（步骤见宠物插件 README）。';
+    readonly 'pet.live2d.vendor-missing': 'Live2D 组件缺失，请升级宠物插件。';
+    readonly 'pet.live2d.load-failed': 'Live2D 模型加载失败，请检查该宠物目录的完整性。';
     readonly 'pet.openSessionHint': '点击跳转到对应会话';
     readonly 'pet.moreSessions': '展开其余 {n} 个会话的气泡';
     readonly 'pet.collapseSessions': '收起会话气泡';
     readonly 'settings.title': '宠物';
+    readonly 'settings.diagnosticsTitle': '宠物目录诊断';
     readonly 'settings.description': '选择宠物并调整它的显示布局。';
     readonly 'settings.pet': '宠物';
     readonly 'settings.petHint': '选择显示哪只宠物；每只宠物独立命名，可在宠物悬浮面板改名。';
     readonly 'settings.enabled': '启用宠物';
     readonly 'settings.enabledHint': '关闭后隐藏宠物并停止轮询，可在设置里重新启用。';
+    readonly 'settings.decoration': '状态装饰';
+    readonly 'settings.decorationHint': '在宠物状态气泡里显示喷水鲸鱼等状态装饰；关闭后气泡只剩文字。';
     readonly 'settings.visible': '显示宠物';
     readonly 'settings.visibleHint': '关闭后宠物隐藏，可从聊天输入区重新召唤。';
     readonly 'settings.size': '大小（px）';
@@ -63,15 +70,22 @@ export declare const en: {
     readonly 'pet.treats': 'Treats ×{n}';
     readonly 'pet.state.loading': 'The pet is on its way…';
     readonly 'pet.state.error': 'The pet is lost (connection failed)';
+    readonly 'pet.renderer.unavailable': 'This pet needs a renderer ({renderer}) that is not available in this build.';
+    readonly 'pet.live2d.core-missing': 'Live2D Cubism Core is not installed: place the official live2dcubismcore.min.js under $DSH_HOME/pets/.runtime/ and refresh (see the pet plugin README).';
+    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.moreSessions': 'Expand {n} more session bubbles';
     readonly 'pet.collapseSessions': 'Collapse session bubbles';
     readonly 'settings.title': 'Pet';
+    readonly 'settings.diagnosticsTitle': 'Pet directory diagnostics';
     readonly 'settings.description': 'Pick a pet and tune its display layout.';
     readonly 'settings.pet': 'Pet';
     readonly 'settings.petHint': 'Choose which pet shows. Names are stored per pet; rename from the pet hover panel.';
     readonly 'settings.enabled': 'Enable the pet';
     readonly 'settings.enabledHint': 'When off, the pet hides and polling stops; re-enable it here.';
+    readonly 'settings.decoration': 'Status decoration';
+    readonly 'settings.decorationHint': 'Show ornaments like the spouting whale inside the pet status bubbles; when off, bubbles stay text-only.';
     readonly 'settings.visible': 'Show the pet';
     readonly 'settings.visibleHint': 'When off, the pet hides; summon it again from the input row.';
     readonly 'settings.size': 'Size (px)';

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

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

package/lib/types/client/locales.js

@@ -17,16 +17,23 @@ export const zh = {
     'pet.treats': '小鱼干 ×{n}',
     'pet.state.loading': '宠物正在赶来…',
     'pet.state.error': '宠物迷路了（连接失败）',
+    'pet.renderer.unavailable': '这只宠物需要的渲染器（{renderer}）在当前版本不可用。',
+    'pet.live2d.core-missing': 'Live2D 核心未安装：请把官方 live2dcubismcore.min.js 放入 $DSH_HOME/pets/.runtime/ 后刷新（步骤见宠物插件 README）。',
+    'pet.live2d.vendor-missing': 'Live2D 组件缺失，请升级宠物插件。',
+    'pet.live2d.load-failed': 'Live2D 模型加载失败，请检查该宠物目录的完整性。',
     'pet.openSessionHint': '点击跳转到对应会话',
     'pet.moreSessions': '展开其余 {n} 个会话的气泡',
     'pet.collapseSessions': '收起会话气泡',
     // 一级设置页（settings.section 席位）。
     'settings.title': '宠物',
+    'settings.diagnosticsTitle': '宠物目录诊断',
     'settings.description': '选择宠物并调整它的显示布局。',
     'settings.pet': '宠物',
     'settings.petHint': '选择显示哪只宠物；每只宠物独立命名，可在宠物悬浮面板改名。',
     'settings.enabled': '启用宠物',
     'settings.enabledHint': '关闭后隐藏宠物并停止轮询，可在设置里重新启用。',
+    'settings.decoration': '状态装饰',
+    'settings.decorationHint': '在宠物状态气泡里显示喷水鲸鱼等状态装饰；关闭后气泡只剩文字。',
     'settings.visible': '显示宠物',
     'settings.visibleHint': '关闭后宠物隐藏，可从聊天输入区重新召唤。',
     'settings.size': '大小（px）',
@@ -64,16 +71,23 @@ export const en = {
     'pet.treats': 'Treats ×{n}',
     'pet.state.loading': 'The pet is on its way…',
     'pet.state.error': 'The pet is lost (connection failed)',
+    'pet.renderer.unavailable': 'This pet needs a renderer ({renderer}) that is not available in this build.',
+    'pet.live2d.core-missing': 'Live2D Cubism Core is not installed: place the official live2dcubismcore.min.js under $DSH_HOME/pets/.runtime/ and refresh (see the pet plugin README).',
+    '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',
     'pet.moreSessions': 'Expand {n} more session bubbles',
     'pet.collapseSessions': 'Collapse session bubbles',
     // First-level settings section (the `settings.section` seat).
     'settings.title': 'Pet',
+    'settings.diagnosticsTitle': 'Pet directory diagnostics',
     'settings.description': 'Pick a pet and tune its display layout.',
     'settings.pet': 'Pet',
     'settings.petHint': 'Choose which pet shows. Names are stored per pet; rename from the pet hover panel.',
     'settings.enabled': 'Enable the pet',
     'settings.enabledHint': 'When off, the pet hides and polling stops; re-enable it here.',
+    'settings.decoration': 'Status decoration',
+    'settings.decorationHint': 'Show ornaments like the spouting whale inside the pet status bubbles; when off, bubbles stay text-only.',
     'settings.visible': 'Show the pet',
     'settings.visibleHint': 'When off, the pet hides; summon it again from the input row.',
     'settings.size': 'Size (px)',

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

@@ -0,0 +1,22 @@
+/**
+ * Phase stream — bridges the polled host snapshots onto the renderer
+ * contract's { get, subscribe } shape (pet-center M2 P4, issue #623). The
+ * existing poll loop pushes each snapshot's ActivityPhase; subscribers are
+ * dispatched on CHANGE only (phase transitions are sparse — done/failed hold
+ * a timed window before falling back to idle — and renderers like Live2D pay
+ * per transition, not per tick).
+ * @module @linxin666/dsh-pet/client/phase-stream
+ */
+import type { ActivityPhase } from '../state.ts';
+/** The renderer-facing phase stream. */
+export interface PhaseStream {
+    /** The latest pushed phase. */
+    get(): ActivityPhase;
+    /** Subscribe to phase changes; returns the unsubscribe. */
+    subscribe(listener: (phase: ActivityPhase) => void): () => void;
+    /** Feed a fresh snapshot phase; no-op when unchanged. */
+    push(phase: ActivityPhase): void;
+}
+/** Create the stream (one per pet entry lifetime, owned by the plugin body). */
+export declare function createPhaseStream(initial?: ActivityPhase): PhaseStream;
+//# sourceMappingURL=phase-stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"phase-stream.d.ts","sourceRoot":"","sources":["../../../src/client/phase-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,GAAG,IAAI,aAAa,CAAA;IACpB,2DAA2D;IAC3D,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IAC/D,yDAAyD;IACzD,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAA;CACjC;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,aAAsB,GAAG,WAAW,CAe9E"}

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

@@ -0,0 +1,28 @@
+/**
+ * Phase stream — bridges the polled host snapshots onto the renderer
+ * contract's { get, subscribe } shape (pet-center M2 P4, issue #623). The
+ * existing poll loop pushes each snapshot's ActivityPhase; subscribers are
+ * dispatched on CHANGE only (phase transitions are sparse — done/failed hold
+ * a timed window before falling back to idle — and renderers like Live2D pay
+ * per transition, not per tick).
+ * @module @linxin666/dsh-pet/client/phase-stream
+ */
+/** Create the stream (one per pet entry lifetime, owned by the plugin body). */
+export function createPhaseStream(initial = 'idle') {
+    let current = initial;
+    const listeners = new Set();
+    return {
+        get: () => current,
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => { listeners.delete(listener); };
+        },
+        push(phase) {
+            if (phase === current)
+                return;
+            current = phase;
+            for (const listener of [...listeners])
+                listener(phase);
+        },
+    };
+}

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

@@ -0,0 +1,25 @@
+/**
+ * Renderer switch — the client dispatch seam of the pet center (issue #623,
+ * milestone M2 P5 / M3). The pet's manifest picks the renderer: sprite2d
+ * hands straight through to the sprite; live2d injects its visual INTO the
+ * sprite chrome (the dock, bubbles and panel belong to the pet center, not
+ * the renderer); a renderer this build cannot serve renders a clear
+ * diagnostic card instead of blanking.
+ * @module @linxin666/dsh-pet/client/renderers/PetRendererSwitch
+ */
+import { type ReactElement, type ReactNode } 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 { NS } from '../locales.ts';
+/** Dispatch one pet definition to its renderer; unknown kinds get a card. */
+export declare function PetRendererSwitch(props: {
+    definition: PetDefinition;
+    /** Current activity phase (fed to renderer visuals). */
+    phase: ActivityPhase;
+    /** The chrome's pet interaction (affinity write-back owner). */
+    onPet: () => void;
+    t: PropsLocale<typeof NS>['t'];
+    children?: ReactNode;
+}): ReactElement;
+//# sourceMappingURL=PetRendererSwitch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PetRendererSwitch.d.ts","sourceRoot":"","sources":["../../../../src/client/renderers/PetRendererSwitch.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAgC,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACvF,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;AAInD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAEvC,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,UAAU,EAAE,aAAa,CAAA;IACzB,wDAAwD;IACxD,KAAK,EAAE,aAAa,CAAA;IACpB,gEAAgE;IAChE,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;IAC9B,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB,GAAG,YAAY,CAmBf"}

package/lib/types/client/renderers/PetRendererSwitch.js

@@ -0,0 +1,24 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Renderer switch — the client dispatch seam of the pet center (issue #623,
+ * milestone M2 P5 / M3). The pet's manifest picks the renderer: sprite2d
+ * hands straight through to the sprite; live2d injects its visual INTO the
+ * sprite chrome (the dock, bubbles and panel belong to the pet center, not
+ * the renderer); a renderer this build cannot serve renders a clear
+ * diagnostic card instead of blanking.
+ * @module @linxin666/dsh-pet/client/renderers/PetRendererSwitch
+ */
+import { cloneElement, isValidElement } from 'react';
+import { defaultPetRendererRegistry } from './registry.js';
+import { Live2dVisualMount } from './live2d/Live2dVisualMount.js';
+/** Dispatch one pet definition to its renderer; unknown kinds get a card. */
+export function PetRendererSwitch(props) {
+    const renderer = props.definition.renderer ?? 'sprite2d';
+    if (renderer === 'sprite2d')
+        return _jsx(_Fragment, { children: props.children });
+    if (renderer === 'live2d' && defaultPetRendererRegistry.has('live2d') && isValidElement(props.children)) {
+        const visual = (_jsx(Live2dVisualMount, { definition: props.definition, phase: props.phase, onPet: props.onPet, t: props.t }));
+        return cloneElement(props.children, { visual });
+    }
+    return (_jsx("span", { "data-dsh-pet-renderer-fallback": renderer, children: props.t('pet.renderer.unavailable', { renderer }) }));
+}

package/lib/types/client/renderers/live2d/Live2dVisualMount.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Live2D visual mount (pet-center M3) — the React bridge between the pet
+ * center chrome and the imperative live2d renderer. The bridge owns the
+ * contract context (asset base, phase stream, interaction write-back,
+ * activation cleanups), feeds the polled phase into the stream, forwards
+ * sub-4px taps as hit-test coordinates, and renders the localized error
+ * card when the renderer reports a fatal boot failure.
+ * @module @linxin666/dsh-pet/client/renderers/live2d/Live2dVisualMount
+ */
+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 { NS } from '../../locales.ts';
+/** Mount the live2d renderer as the sprite's visual (inside the chrome). */
+export declare function Live2dVisualMount(props: {
+    definition: PetDefinition;
+    phase: ActivityPhase;
+    onPet: () => void;
+    t: PropsLocale<typeof NS>['t'];
+}): ReactElement;
+//# sourceMappingURL=Live2dVisualMount.d.ts.map

package/lib/types/client/renderers/live2d/Live2dVisualMount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Live2dVisualMount.d.ts","sourceRoot":"","sources":["../../../../../src/client/renderers/live2d/Live2dVisualMount.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;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,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAKtD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAA;AAE1C,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,UAAU,EAAE,aAAa,CAAA;IACzB,KAAK,EAAE,aAAa,CAAA;IACpB,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;CAC/B,GAAG,YAAY,CAuEf"}

package/lib/types/client/renderers/live2d/Live2dVisualMount.js

@@ -0,0 +1,75 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Live2D visual mount (pet-center M3) — the React bridge between the pet
+ * center chrome and the imperative live2d renderer. The bridge owns the
+ * contract context (asset base, phase stream, interaction write-back,
+ * activation cleanups), feeds the polled phase into the stream, forwards
+ * sub-4px taps as hit-test coordinates, and renders the localized error
+ * card when the renderer reports a fatal boot failure.
+ * @module @linxin666/dsh-pet/client/renderers/live2d/Live2dVisualMount
+ */
+import { useEffect, useRef, useState } from 'react';
+import { createPhaseStream } from '../../phase-stream.js';
+import { defaultPetRendererRegistry } from '../registry.js';
+/** Mount the live2d renderer as the sprite's visual (inside the chrome). */
+export function Live2dVisualMount(props) {
+    const containerRef = useRef(null);
+    const streamRef = useRef(null);
+    const handleRef = useRef(null);
+    const downRef = useRef(null);
+    const [error, setError] = useState(null);
+    // One activation per pet definition: build the contract context and mount.
+    useEffect(() => {
+        const container = containerRef.current;
+        const live2d = props.definition.live2d;
+        if (container === null || live2d === undefined)
+            return undefined;
+        streamRef.current ??= createPhaseStream(props.phase);
+        const cleanups = [];
+        const ctx = {
+            petId: props.definition.id,
+            assetBase: '/pet/' + encodeURIComponent(props.definition.id),
+            container,
+            phase: streamRef.current,
+            interact: props.onPet,
+            onCleanup: (fn) => { cleanups.push(fn); },
+        };
+        let handle;
+        try {
+            handle = defaultPetRendererRegistry.mount('live2d', ctx, live2d);
+        }
+        catch {
+            setError('load-failed');
+            return () => { for (const fn of cleanups.splice(0))
+                fn(); };
+        }
+        handleRef.current = handle;
+        handle.onError?.(setError);
+        return () => {
+            handleRef.current = null;
+            for (const fn of cleanups.splice(0))
+                fn();
+            handle.dispose();
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- one activation per pet identity
+    }, [props.definition]);
+    // Feed the polled phase into the activation's stream (change-only).
+    useEffect(() => {
+        streamRef.current?.push(props.phase);
+    }, [props.phase]);
+    return (_jsx("div", { ref: containerRef, "data-dsh-pet-live2d": props.definition.id, style: { width: '100%', height: '100%' }, onPointerDown: (e) => { downRef.current = { x: e.clientX, y: e.clientY }; }, onPointerUp: (e) => {
+            const down = downRef.current;
+            downRef.current = null;
+            if (down === null)
+                return;
+            // A moved pointer is a drag (the chrome owns it), not a tap.
+            if (Math.abs(e.clientX - down.x) > 4 || Math.abs(e.clientY - down.y) > 4)
+                return;
+            const rect = e.currentTarget.getBoundingClientRect();
+            handleRef.current?.tap(e.clientX - rect.left, e.clientY - rect.top);
+        }, children: error !== null && (_jsx("span", { "data-dsh-pet-live2d-error": error, children: error === 'core-missing'
+                ? props.t('pet.live2d.core-missing')
+                : error === 'vendor-missing'
+                    ? props.t('pet.live2d.vendor-missing')
+                    : props.t('pet.live2d.load-failed') })) }));
+}