@linxin666/dsh-pet 0.2.2 → 0.2.3

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

@@ -1 +1 @@
-{"version":3,"file":"PetDockEntry.d.ts","sourceRoot":"","sources":["../../../src/client/PetDockEntry.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAmC,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAEnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAGjC,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,KAAK,EAAE,gBAAgB,CAAA;IACvB,kFAAkF;IAClF,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,8BAA8B;IAC9B,GAAG,EAAE,MAAM,IAAI,CAAA;IACf,uBAAuB;IACvB,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,uBAAuB;IACvB,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,qCAAqC;IACrC,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,+BAA+B;IAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAChD,uDAAuD;IACvD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,2DAA2D;IAC3D,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,iCAAiC;IACjC,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB;AAED,yFAAyF;AACzF,MAAM,MAAM,iBAAiB,GAC3B,WAAW,GACT,WAAW,CAAC,OAAO,EAAE,CAAC,CAAA;AAI1B;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAsDnE"}
+{"version":3,"file":"PetDockEntry.d.ts","sourceRoot":"","sources":["../../../src/client/PetDockEntry.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAmC,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAEnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAGtD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAGjC,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,KAAK,EAAE,gBAAgB,CAAA;IACvB,kFAAkF;IAClF,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,8BAA8B;IAC9B,GAAG,EAAE,MAAM,IAAI,CAAA;IACf,uBAAuB;IACvB,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,uBAAuB;IACvB,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,qCAAqC;IACrC,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,+BAA+B;IAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAChD,uDAAuD;IACvD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,2DAA2D;IAC3D,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,iCAAiC;IACjC,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB;AAED,yFAAyF;AACzF,MAAM,MAAM,iBAAiB,GAC3B,WAAW,GACT,WAAW,CAAC,OAAO,EAAE,CAAC,CAAA;AAI1B;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CA6DnE"}

package/lib/types/client/PetDockEntry.js

@@ -13,6 +13,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
  */
 import { useEffect, useSyncExternalStore } from 'react';
 import { PetSprite } from './PetSprite.js';
+import { PetRendererSwitch } from './renderers/PetRendererSwitch.js';
 import styles from './pet.module.css';
 const DEFAULT_DISPLAY = { visible: true, size: 160, right: 24, bottom: 20 };
 /**
@@ -35,7 +36,7 @@ export function PetDockEntry(props) {
     if (visible) {
         return (_jsx("span", { "data-pet-dock": true, "data-testid": "pet-dock", children: snapshot === null || definition === null
                 ? null
-                : (_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, 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 }) })) }));
     }
     const display = snapshot?.display ?? DEFAULT_DISPLAY;
     return (_jsx("button", { type: "button", className: styles.summon, style: {

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

@@ -44,6 +44,8 @@ export interface PetSettingsCardState extends CardShell {
         value: string;
         label: string;
     }[];
+    /** Registry diagnostics (v1 migration hints, invalid entries), host-served. */
+    petDiagnostics: readonly PetDiagnosticView[];
 }
 /** The registration-side face the card's slot entry injects. */
 export interface PetSettingsCardFace extends CardActions {
@@ -52,16 +54,24 @@ export interface PetSettingsCardFace extends CardActions {
         petSettingsCard: SnapshotStore<PetSettingsCardState>;
     };
 }
+/** One registry diagnostic as served by '/api/pet/diagnostics' (#623). */
+export interface PetDiagnosticView {
+    level: 'error' | 'warning';
+    message: string;
+}
 /** Bridges the 'pet' scope onto the card's staged form. */
 export declare class PetSettingsCardController {
     private readonly form;
     private readonly store;
     private readonly petChoices;
     private readonly petLabels;
+    private diagnostics;
     private loaded;
     private attempts;
     /** @param scope - the bound settings scope for the 'pet' namespace. */
     constructor(scope: SettingsScope<PetSettings>);
+    /** Fetch registry diagnostics once (soft-fail: an empty list on error). */
+    private loadDiagnostics;
     /** Resolve the registry choices once (retried a few times on failure). */
     private loadPets;
     private projection;

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

@@ -1 +1 @@
-{"version":3,"file":"PetSettingsCard.d.ts","sourceRoot":"","sources":["../../../src/client/PetSettingsCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAC7F,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAI1F,OAAO,EAAoD,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,IAAI,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAG1J,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qBAAqB;IACrB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,0CAA0C;AAC1C,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,4BAA4B;IAC5B,OAAO,EAAE,cAAc,CAAA;IACvB,qBAAqB;IACrB,OAAO,EAAE,cAAc,CAAA;IACvB,iBAAiB;IACjB,IAAI,EAAE,cAAc,CAAA;IACpB,mBAAmB;IACnB,KAAK,EAAE,cAAc,CAAA;IACrB,oBAAoB;IACpB,MAAM,EAAE,cAAc,CAAA;IACtB,oBAAoB;IACpB,KAAK,EAAE,cAAc,CAAA;IACrB,wEAAwE;IACxE,UAAU,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CACxD;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,KAAK,EAAE;QACL,iEAAiE;QACjE,eAAe,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAA;KACrD,CAAA;CACF;AAeD,2DAA2D;AAC3D,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAI3D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAI;IAEpB,uEAAuE;IACvE,YAAY,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,EAW5C;IAED,0EAA0E;YAC5D,QAAQ;IAgBtB,OAAO,CAAC,UAAU;IAalB;;;OAGG;IACH,MAAM,IAAI,mBAAmB,CAE5B;IAED;;;OAGG;IACH,OAAO,IAAI,IAAI,CAEd;CACF;AAED,0DAA0D;AAC1D,MAAM,MAAM,oBAAoB,GAC9B,WAAW,CAAC,KAAK,CAAC,GAChB,UAAU,CAAC,mBAAmB,CAAC,CAAA;AAEnC;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,+BAuF1D;AAED,8DAA8D;AAC9D,MAAM,MAAM,uBAAuB,GACjC,YAAY,CAAC,kBAAkB,CAAC,GAC9B,WAAW,CAAC,KAAK,CAAC,GAClB,UAAU,CAAC,mBAAmB,CAAC,CAAA;AAEnC,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,SAAS,CAO5E"}
+{"version":3,"file":"PetSettingsCard.d.ts","sourceRoot":"","sources":["../../../src/client/PetSettingsCard.tsx"],"names":[],"mappings":"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"}

package/lib/types/client/PetSettingsCard.js

@@ -9,6 +9,14 @@ async function fetchPetChoices() {
         throw new Error('pet pets failed: ' + response.status);
     return (await response.json());
 }
+/** Fetch the registry diagnostics (v1 migration hints, invalid entries). */
+async function fetchPetDiagnostics() {
+    const response = await fetch('/api/pet/diagnostics');
+    if (!response.ok)
+        throw new Error('pet diagnostics failed: ' + response.status);
+    const body = (await response.json());
+    return body.diagnostics ?? [];
+}
 /** Bridges the 'pet' scope onto the card's staged form. */
 export class PetSettingsCardController {
     form;
@@ -18,6 +26,7 @@ export class PetSettingsCardController {
     // without rebuilding the form.
     petChoices = [];
     petLabels = new Map();
+    diagnostics = [];
     loaded = false;
     attempts = 0;
     /** @param scope - the bound settings scope for the 'pet' namespace. */
@@ -32,6 +41,17 @@ export class PetSettingsCardController {
         ]);
         this.store = this.form.bind(() => this.projection());
         void this.loadPets();
+        void this.loadDiagnostics();
+    }
+    /** Fetch registry diagnostics once (soft-fail: an empty list on error). */
+    async loadDiagnostics() {
+        try {
+            this.diagnostics = await fetchPetDiagnostics();
+            this.store.set(this.projection());
+        }
+        catch {
+            this.diagnostics = [];
+        }
     }
     /** Resolve the registry choices once (retried a few times on failure). */
     async loadPets() {
@@ -62,6 +82,7 @@ export class PetSettingsCardController {
             bottom: this.form.field('bottom'),
             petId: this.form.field('petId'),
             petChoices: this.petChoices.map(id => ({ value: id, label: this.petLabels.get(id) ?? id })),
+            petDiagnostics: this.diagnostics,
         };
     }
     /**
@@ -94,7 +115,7 @@ export function PetSettingsCard(props) {
         invalidLabel: t('settings.invalidNumber'),
         disabled,
     };
-    return (_jsxs(PluginSettingsCard, { t: t, titleKey: "settings.title", descriptionKey: "settings.description", state: state, onSave: props.save, onDiscard: props.discard, alwaysOpen: true, children: [_jsx(BooleanField, { id: "settings-pet-enabled", label: t('settings.enabled'), hint: t('settings.enabledHint'), inheritLabel: t('settings.inherit'), onLabel: t('settings.on'), offLabel: t('settings.off'), ...fieldProps, ...state.enabled, onEdit: (text) => { props.edit('enabled', text); }, onReset: () => { props.resetField('enabled'); } }), _jsx(ChoiceField, { id: "settings-pet-pet", label: t('settings.pet'), hint: t('settings.petHint'), inheritLabel: t('settings.inherit'), ...fieldProps, ...state.petId, choices: state.petChoices, onEdit: (text) => { props.edit('petId', text); }, onReset: () => { props.resetField('petId'); } }), _jsx(BooleanField, { id: "settings-pet-visible", label: t('settings.visible'), hint: t('settings.visibleHint'), inheritLabel: t('settings.inherit'), onLabel: t('settings.on'), offLabel: t('settings.off'), ...fieldProps, ...state.visible, onEdit: (text) => { props.edit('visible', text); }, onReset: () => { props.resetField('visible'); } }), _jsx(ValueField, { id: "settings-pet-size", label: t('settings.size'), hint: t('settings.sizeHint'), numeric: true, ...fieldProps, ...state.size, onEdit: (text) => { props.edit('size', text); }, onReset: () => { props.resetField('size'); } }), _jsx(ValueField, { id: "settings-pet-right", label: t('settings.right'), hint: t('settings.rightHint'), numeric: true, ...fieldProps, ...state.right, onEdit: (text) => { props.edit('right', text); }, onReset: () => { props.resetField('right'); } }), _jsx(ValueField, { id: "settings-pet-bottom", label: t('settings.bottom'), hint: t('settings.bottomHint'), numeric: true, ...fieldProps, ...state.bottom, onEdit: (text) => { props.edit('bottom', text); }, onReset: () => { props.resetField('bottom'); } })] }));
+    return (_jsxs(PluginSettingsCard, { t: t, titleKey: "settings.title", descriptionKey: "settings.description", state: state, onSave: props.save, onDiscard: props.discard, alwaysOpen: true, children: [_jsx(BooleanField, { id: "settings-pet-enabled", label: t('settings.enabled'), hint: t('settings.enabledHint'), inheritLabel: t('settings.inherit'), onLabel: t('settings.on'), offLabel: t('settings.off'), ...fieldProps, ...state.enabled, onEdit: (text) => { props.edit('enabled', text); }, onReset: () => { props.resetField('enabled'); } }), _jsx(ChoiceField, { id: "settings-pet-pet", label: t('settings.pet'), hint: t('settings.petHint'), inheritLabel: t('settings.inherit'), ...fieldProps, ...state.petId, choices: state.petChoices, onEdit: (text) => { props.edit('petId', text); }, onReset: () => { props.resetField('petId'); } }), state.petDiagnostics.length === 0 ? null : (_jsxs("li", { className: sectionCss.diagnostics, "data-dsh-part": "diagnostics", children: [_jsx("span", { className: sectionCss.diagnosticsTitle, children: t('settings.diagnosticsTitle') }), _jsx("ul", { children: state.petDiagnostics.map((diagnostic, index) => (_jsx("li", { "data-level": diagnostic.level, children: diagnostic.message }, index))) })] })), _jsx(BooleanField, { id: "settings-pet-visible", label: t('settings.visible'), hint: t('settings.visibleHint'), inheritLabel: t('settings.inherit'), onLabel: t('settings.on'), offLabel: t('settings.off'), ...fieldProps, ...state.visible, onEdit: (text) => { props.edit('visible', text); }, onReset: () => { props.resetField('visible'); } }), _jsx(ValueField, { id: "settings-pet-size", label: t('settings.size'), hint: t('settings.sizeHint'), numeric: true, ...fieldProps, ...state.size, onEdit: (text) => { props.edit('size', text); }, onReset: () => { props.resetField('size'); } }), _jsx(ValueField, { id: "settings-pet-right", label: t('settings.right'), hint: t('settings.rightHint'), numeric: true, ...fieldProps, ...state.right, onEdit: (text) => { props.edit('right', text); }, onReset: () => { props.resetField('right'); } }), _jsx(ValueField, { id: "settings-pet-bottom", label: t('settings.bottom'), hint: t('settings.bottomHint'), numeric: true, ...fieldProps, ...state.bottom, onEdit: (text) => { props.edit('bottom', text); }, onReset: () => { props.resetField('bottom'); } })] }));
 }
 /** Render the pet settings card as a first-level settings page. */
 export function PetSettingsSection(props) {

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

@@ -8,7 +8,7 @@
  * pet id), so one component renders every registry entry.
  * @module @linxin666/dsh-pet/client/PetSprite
  */
-import type { ReactPortal } from 'react';
+import type { ReactNode, ReactPortal } from 'react';
 import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
 import type { PetDisplayConfig } from '../persist.ts';
 import type { PetStateView } from '../service.ts';
@@ -39,6 +39,12 @@ export interface PetSpriteProps {
     onOpenSession: (sessionId: string) => void;
     /** Clear the reaction bubble (after its CSS animation). */
     onFeedbackDone: () => void;
+    /**
+     * Custom visual replacing the sprite2d atlas animation (pet-center M3).
+     * The chrome (drag, bubbles, panel, tap economy) is untouched: the visual
+     * renders inside the sprite box, and the atlas load + frame loop skip.
+     */
+    visual?: ReactNode;
     /** 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,EAAoD,WAAW,EAAE,MAAM,OAAO,CAAA;AAG1F,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;AACnD,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,+CAA+C;IAC/C,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CAAA;CAC1B;AAOD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,WAAW,CAud5D"}
+{"version":3,"file":"PetSprite.d.ts","sourceRoot":"","sources":["../../../src/client/PetSprite.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAoD,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAGrG,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;AACnD,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;AAOD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,WAAW,CAge5D"}

package/lib/types/client/PetSprite.js

@@ -67,8 +67,11 @@ export function PetSprite(props) {
     const tracks = definition.tracks;
     const sequences = definition.sequences;
     // 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 +83,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 +96,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 +165,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.
@@ -292,10 +297,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,7 +312,7 @@ 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).

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,10 +17,15 @@ 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': '选择显示哪只宠物；每只宠物独立命名，可在宠物悬浮面板改名。';
@@ -63,10 +68,15 @@ 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.';

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,11 +17,16 @@ 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': '选择显示哪只宠物；每只宠物独立命名，可在宠物悬浮面板改名。',
@@ -64,11 +69,16 @@ 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.',

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') })) }));
+}