@linxin666/dsh-pet 0.1.7 → 0.1.8

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

@@ -1,12 +1,12 @@
 /**
- * dsh-pet browser half — registers the whale-girl into the conversation
- * input selector row (the same every-phase row the git branch chip uses) and
- * drives it from the host's same-origin `/api/pet/*` JSON endpoints: poll the
- * host snapshot (~800 ms), forward interactions, persist drag positions. The
- * row anchor mounts the floating pet via portal; when the pet is hidden the
- * anchor becomes the summon button. Anchoring in the selector row (rather
- * than the session-only composer dock band) keeps the pet floating on the
- * new-conversation screen too, where no session exists to scope a slot by.
+ * dsh-pet browser half — mounts the whale-girl as a global floating surface
+ * and drives it from the host's same-origin `/api/pet/*` JSON endpoints: poll
+ * the host snapshot (~800 ms), forward interactions, persist drag positions.
+ * The pet is host-global (no session dimension), so it mounts directly onto
+ * `document.body` via a single React root rather than a session-scoped slot —
+ * on the new-conversation screen no session exists, and a dock-mounted pet
+ * would vanish there (issue #48). When the pet is hidden the entry becomes a
+ * fixed-position summon button.
  * @module @linxin666/dsh-pet/client
  */
 import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
@@ -37,9 +37,9 @@ export interface SettingsPluginItemOwnerProps {
     children?: never;
 }
 /**
- * Client plugin body: register dictionaries, mount the dock entry and poll
- * loop while the plugin is enabled, and seat the settings card in the Web UI
- * plugin group.
+ * Client plugin body: register dictionaries, mount the global pet entry and
+ * poll loop while the plugin is enabled, and seat the settings card in the
+ * Web UI plugin group.
  * @param ctx - client root context.
  */
 export declare function apply(ctx: ClientContext): void;

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;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAsD3E,yBAAyB;AACzB,eAAO,MAAM,MAAM,UAA+D,CAAA;AAElF,qEAAqE;AACrE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACxE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC7D,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAEtF,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,OAAO;QACf;;;;;WAKG;QACH,oBAAoB,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,4BAA4B,CAAA;SAAE,CAAA;KAC3F;CACF;AAED,sEAAsE;AACtE,MAAM,WAAW,4BAA4B;IAC3C,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,KAAK,CAAA;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAmK9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAwD3E,yBAAyB;AACzB,eAAO,MAAM,MAAM,UAA+D,CAAA;AAElF,qEAAqE;AACrE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACxE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC7D,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAEtF,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,OAAO;QACf;;;;;WAKG;QACH,oBAAoB,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,4BAA4B,CAAA;SAAE,CAAA;KAC3F;CACF;AAED,sEAAsE;AACtE,MAAM,WAAW,4BAA4B;IAC3C,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,KAAK,CAAA;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAmK9C"}

package/lib/types/client/index.js

@@ -1,18 +1,20 @@
 /**
- * dsh-pet browser half — registers the whale-girl into the conversation
- * input selector row (the same every-phase row the git branch chip uses) and
- * drives it from the host's same-origin `/api/pet/*` JSON endpoints: poll the
- * host snapshot (~800 ms), forward interactions, persist drag positions. The
- * row anchor mounts the floating pet via portal; when the pet is hidden the
- * anchor becomes the summon button. Anchoring in the selector row (rather
- * than the session-only composer dock band) keeps the pet floating on the
- * new-conversation screen too, where no session exists to scope a slot by.
+ * dsh-pet browser half — mounts the whale-girl as a global floating surface
+ * and drives it from the host's same-origin `/api/pet/*` JSON endpoints: poll
+ * the host snapshot (~800 ms), forward interactions, persist drag positions.
+ * The pet is host-global (no session dimension), so it mounts directly onto
+ * `document.body` via a single React root rather than a session-scoped slot —
+ * on the new-conversation screen no session exists, and a dock-mounted pet
+ * would vanish there (issue #48). When the pet is hidden the entry becomes a
+ * fixed-position summon button.
  * @module @linxin666/dsh-pet/client
  */
+import { createElement } from 'react';
+import { createRoot } from 'react-dom/client';
 import { createPetStore } from "./pet-store.js";
 import { PetDockEntry } from "./PetDockEntry.js";
 import { PetSettingsCard, PetSettingsCardController } from "./PetSettingsCard.js";
-import { NS, en, zh } from "./locales.js";
+import { NS, en, zh, t } from "./locales.js";
 /** Same-origin JSON fetch helper (GET without body, POST with JSON body). */
 async function petFetch(path, body) {
     const response = await fetch(path, body === undefined
@@ -42,9 +44,9 @@ const PET_SETTINGS_NS = 'pet';
 /** Required services. */
 export const inject = ['slots', 'locale', 'connection', 'settingsScope', 'remote'];
 /**
- * Client plugin body: register dictionaries, mount the dock entry and poll
- * loop while the plugin is enabled, and seat the settings card in the Web UI
- * plugin group.
+ * Client plugin body: register dictionaries, mount the global pet entry and
+ * poll loop while the plugin is enabled, and seat the settings card in the
+ * Web UI plugin group.
  * @param ctx - client root context.
  */
 export function apply(ctx) {
@@ -66,8 +68,8 @@ export function apply(ctx) {
         locale: NS,
         inject: () => petSettings.inject(),
     }, PetSettingsCard));
-    // The dock entry, its store, and the poll loop live while the plugin is
-    // enabled; toggling the setting off hides the pet and stops polling.
+    // The global pet entry, its store, and the poll loop live while the plugin
+    // is enabled; toggling the setting off hides the pet and stops polling.
     let disposeUi;
     const syncUi = () => {
         if (enabled() && disposeUi === undefined) {
@@ -179,20 +181,21 @@ export function apply(ctx) {
                     setFeedback(null);
                 },
             });
-            // The legacy selector-context hole (conversation.input.selector.context)
-            // is no longer declared by newer shells (rc.6 dropped it), so the pet
-            // mounts on the composer dock band instead. The dock is session-scoped,
-            // so the pet appears once a session is active (accepted downgrade, see
-            // PR #17).
-            const disposeDock = ctx.slots.inject('conversation.input.dock', () => ctx.slots.register({
-                name: 'conversation.input.dock',
-                id: 'pet',
-                order: 110,
-                inject: injected,
-                locale: NS,
-            }, PetDockEntry));
+            // The pet is host-global (its state/display/interactions have no session
+            // dimension), and the official rc.6 shell declares no root-scoped slot
+            // for a global floating surface — the dock is session-scoped, so a pet
+            // mounted there would vanish on the new-conversation screen (issue #48).
+            // The entry therefore mounts straight onto document.body via a single
+            // React root for the page lifetime: WhalePet portals itself to body when
+            // visible, and the hidden-state summon button is fixed-positioned.
+            const container = document.createElement('div');
+            container.dataset.dshPetRoot = '';
+            document.body.appendChild(container);
+            const petRoot = createRoot(container);
+            petRoot.render(createElement(PetDockEntry, { ...injected(), t }));
             disposeUi = () => {
-                disposeDock();
+                petRoot.unmount();
+                container.remove();
                 disposePoll();
                 disposeUi = undefined;
             };

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

@@ -92,6 +92,22 @@ export declare const en: {
 export type PetKey = keyof typeof zh;
 /** The settings-card slice of the pet dictionary. */
 export type SettingsCardKey = PetKey;
+/**
+ * Active dictionary, picked by the document language at call time. The pet
+ * mounts as a global floating surface (not a session-scoped slot), so it has
+ * no framework locale seat and resolves its copy the same tiny way the
+ * task-board's DOM-injected surface does.
+ */
+export declare function dictionary(): Record<PetKey, string>;
+/**
+ * Translate a key with optional `{name}` template params. Mirrors the slot
+ * `Translate` contract `(key, params?) => string` so it can be handed to the
+ * same components that used to receive the framework-injected `t` seat. The
+ * key is typed loosely (`string`) so the function is assignable to the slot's
+ * `TranslateNS<'pet'>` (whose key domain also spans the shared common
+ * vocabulary); a missing key degrades to the key itself rather than throwing.
+ */
+export declare function t(key: string, params?: Record<string, unknown>): string;
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface LocaleNamespaceMap {
         /** dsh-pet UI copy. */

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

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

package/lib/types/client/locales.js

@@ -90,3 +90,30 @@ export const en = {
     'settings.saveFailed': 'The deployment did not accept these values; they were left for you to correct.',
     'settings.invalidNumber': 'Enter a number, or leave blank to use the default.',
 };
+/**
+ * Active dictionary, picked by the document language at call time. The pet
+ * mounts as a global floating surface (not a session-scoped slot), so it has
+ * no framework locale seat and resolves its copy the same tiny way the
+ * task-board's DOM-injected surface does.
+ */
+export function dictionary() {
+    const lang = typeof document !== 'undefined' ? document.documentElement.lang : 'zh';
+    return lang.toLowerCase().startsWith('en') ? en : zh;
+}
+/**
+ * Translate a key with optional `{name}` template params. Mirrors the slot
+ * `Translate` contract `(key, params?) => string` so it can be handed to the
+ * same components that used to receive the framework-injected `t` seat. The
+ * key is typed loosely (`string`) so the function is assignable to the slot's
+ * `TranslateNS<'pet'>` (whose key domain also spans the shared common
+ * vocabulary); a missing key degrades to the key itself rather than throwing.
+ */
+export function t(key, params) {
+    let text = dictionary()[key] ?? key;
+    if (params !== undefined) {
+        for (const [name, value] of Object.entries(params)) {
+            text = text.replaceAll(`{${name}}`, String(value));
+        }
+    }
+    return text;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@linxin666/dsh-pet",
   "description": "鲸鱼娘宠物插件 for the dsh web GUI: a soft healing whale-girl companion that reacts to model activity (idle/waiting/thinking/tool/done), with petting/feeding interactions and an affinity score",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"

package/src/client/PetDockEntry.tsx

@@ -1,14 +1,16 @@
 /**
- * Dock anchor inside the official SDK's `conversation.input.dock` seat
- * (the ambient readout band above the composer card, listed so several
- * additions can stack). While visible it mounts the floating WhalePet
- * (portal); while hidden it renders the summon button.
+ * Global floating pet entry. The pet is host-global (its state, display and
+ * interactions live on `/api/pet/*` endpoints with no session dimension), so
+ * it must not ride a session-scoped slot — on the new-conversation screen no
+ * session exists to scope a slot by, and the pet would vanish (issue #48).
+ * The client half therefore mounts this entry straight onto `document.body`
+ * (see index.ts): while visible it renders the floating WhalePet (a portal),
+ * while hidden it renders a fixed-position summon button.
  * @module @linxin666/dsh-pet/client/PetDockEntry
  */
 
 import { useEffect, useSyncExternalStore, type ReactElement } from 'react'
-import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots'
-import type {} from '@deepseek-ai/dsh-client-ui-conversation/client'
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots'
 import type { PetDisplayConfig } from '../persist.ts'
 import type { PetStoreInstance } from './pet-store.ts'
 import { WhalePet } from './WhalePet.tsx'
@@ -37,10 +39,9 @@ export interface PetInjected {
   feedbackDone: () => void
 }
 
-/** Composed props of the dock entry (runtime + locale + injected). */
+/** Composed props of the global pet entry (locale + injected; no slot runtime share). */
 export type PetDockEntryProps =
-  PropsRuntime<'conversation.input.dock'>
-  & PetInjected
+  PetInjected
   & PropsLocale<typeof NS>
 
 const DEFAULT_DISPLAY: PetDisplayConfig = { visible: true, size: 160, right: 24, bottom: 20 }
@@ -81,10 +82,17 @@ export function PetDockEntry(props: PetDockEntryProps): ReactElement {
       </span>
     )
   }
+  const display = snapshot?.display ?? DEFAULT_DISPLAY
   return (
     <button
       type="button"
       className={styles.summon}
+      style={{
+        position: 'fixed',
+        right: display.right,
+        bottom: display.bottom,
+        zIndex: 2147483000,
+      }}
       onClick={props.summon}
       data-testid="pet-summon"
     >

package/src/client/WhalePet.tsx

@@ -243,11 +243,13 @@ export function WhalePet(props: WhalePetProps): ReactPortal {
         // above the sprite), so moving onto them fires pointerleave on the
         // container. Treat a target still inside the container's DOM (the
         // overflowed panel) as "still hovering"; otherwise give the pointer a
-        // short grace period to reach the panel across the gap above it.
+        // short grace period to reach the panel across the gap above it. The
+        // bridge (`.panel::after`) keeps the pointer inside the hit area, and
+        // the grace period covers a slow mouse crossing the remaining sliver.
         const next = e.relatedTarget
         if (next instanceof Node && floatRef.current?.contains(next)) return
         clearHideTimer()
-        hideTimerRef.current = window.setTimeout(() => setHovered(false), 200)
+        hideTimerRef.current = window.setTimeout(() => setHovered(false), 300)
       }}
     >
       <div
@@ -280,7 +282,15 @@ export function WhalePet(props: WhalePetProps): ReactPortal {
         </div>
       )}
       {hovered && dragRef.current === null && (
-        <div className={styles.panel}>
+        <div
+          className={styles.panel}
+          onPointerEnter={() => {
+            // Reaching the panel (or its bridge) must cancel any hide timer
+            // the container's pointerleave may have armed while the pointer
+            // crossed the sliver between the sprite and the panel.
+            clearHideTimer()
+          }}
+        >
           {renaming ? (
             <div className={styles.renameRow}>
               <input

package/src/client/index.ts

@@ -1,12 +1,12 @@
 /**
- * dsh-pet browser half — registers the whale-girl into the conversation
- * input selector row (the same every-phase row the git branch chip uses) and
- * drives it from the host's same-origin `/api/pet/*` JSON endpoints: poll the
- * host snapshot (~800 ms), forward interactions, persist drag positions. The
- * row anchor mounts the floating pet via portal; when the pet is hidden the
- * anchor becomes the summon button. Anchoring in the selector row (rather
- * than the session-only composer dock band) keeps the pet floating on the
- * new-conversation screen too, where no session exists to scope a slot by.
+ * dsh-pet browser half — mounts the whale-girl as a global floating surface
+ * and drives it from the host's same-origin `/api/pet/*` JSON endpoints: poll
+ * the host snapshot (~800 ms), forward interactions, persist drag positions.
+ * The pet is host-global (no session dimension), so it mounts directly onto
+ * `document.body` via a single React root rather than a session-scoped slot —
+ * on the new-conversation screen no session exists, and a dock-mounted pet
+ * would vanish there (issue #48). When the pet is hidden the entry becomes a
+ * fixed-position summon button.
  * @module @linxin666/dsh-pet/client
  */
 
@@ -20,10 +20,12 @@ import type {} from '@deepseek-ai/dsh-client-ui-conversation/client'
 import type { PetDisplayConfig } from '../persist.ts'
 import type { PetInteractResult, PetStateView } from '../service.ts'
 import type { PetInteraction } from '../affinity.ts'
+import { createElement } from 'react'
+import { createRoot } from 'react-dom/client'
 import { createPetStore, type PetStoreInstance } from './pet-store.ts'
 import { PetDockEntry, type PetInjected } from './PetDockEntry.tsx'
 import { PetSettingsCard, PetSettingsCardController, type PetSettings } from './PetSettingsCard.tsx'
-import { NS, en, zh } from './locales.ts'
+import { NS, en, zh, t } from './locales.ts'
 
 /** The host pet API as the browser sees it (same-origin JSON endpoints). */
 interface PetHttpApi {
@@ -91,9 +93,9 @@ export interface SettingsPluginItemOwnerProps {
 }
 
 /**
- * Client plugin body: register dictionaries, mount the dock entry and poll
- * loop while the plugin is enabled, and seat the settings card in the Web UI
- * plugin group.
+ * Client plugin body: register dictionaries, mount the global pet entry and
+ * poll loop while the plugin is enabled, and seat the settings card in the
+ * Web UI plugin group.
  * @param ctx - client root context.
  */
 export function apply(ctx: ClientContext): void {
@@ -118,8 +120,8 @@ export function apply(ctx: ClientContext): void {
     inject: () => petSettings.inject(),
   }, PetSettingsCard))
 
-  // The dock entry, its store, and the poll loop live while the plugin is
-  // enabled; toggling the setting off hides the pet and stops polling.
+  // The global pet entry, its store, and the poll loop live while the plugin
+  // is enabled; toggling the setting off hides the pet and stops polling.
   let disposeUi: (() => void) | undefined
   const syncUi = (): void => {
     if (enabled() && disposeUi === undefined) {
@@ -233,22 +235,22 @@ export function apply(ctx: ClientContext): void {
         },
       })
 
-      // The legacy selector-context hole (conversation.input.selector.context)
-      // is no longer declared by newer shells (rc.6 dropped it), so the pet
-      // mounts on the composer dock band instead. The dock is session-scoped,
-      // so the pet appears once a session is active (accepted downgrade, see
-      // PR #17).
-      const disposeDock = ctx.slots.inject('conversation.input.dock', () =>
-        ctx.slots.register({
-          name: 'conversation.input.dock',
-          id: 'pet',
-          order: 110,
-          inject: injected,
-          locale: NS,
-        }, PetDockEntry))
+      // The pet is host-global (its state/display/interactions have no session
+      // dimension), and the official rc.6 shell declares no root-scoped slot
+      // for a global floating surface — the dock is session-scoped, so a pet
+      // mounted there would vanish on the new-conversation screen (issue #48).
+      // The entry therefore mounts straight onto document.body via a single
+      // React root for the page lifetime: WhalePet portals itself to body when
+      // visible, and the hidden-state summon button is fixed-positioned.
+      const container = document.createElement('div')
+      container.dataset.dshPetRoot = ''
+      document.body.appendChild(container)
+      const petRoot = createRoot(container)
+      petRoot.render(createElement(PetDockEntry, { ...injected(), t }))
 
       disposeUi = () => {
-        disposeDock()
+        petRoot.unmount()
+        container.remove()
         disposePoll()
         disposeUi = undefined
       }

package/src/client/locales.ts

@@ -100,6 +100,35 @@ export type PetKey = keyof typeof zh
 /** The settings-card slice of the pet dictionary. */
 export type SettingsCardKey = PetKey
 
+/**
+ * Active dictionary, picked by the document language at call time. The pet
+ * mounts as a global floating surface (not a session-scoped slot), so it has
+ * no framework locale seat and resolves its copy the same tiny way the
+ * task-board's DOM-injected surface does.
+ */
+export function dictionary(): Record<PetKey, string> {
+  const lang = typeof document !== 'undefined' ? document.documentElement.lang : 'zh'
+  return lang.toLowerCase().startsWith('en') ? en : zh
+}
+
+/**
+ * Translate a key with optional `{name}` template params. Mirrors the slot
+ * `Translate` contract `(key, params?) => string` so it can be handed to the
+ * same components that used to receive the framework-injected `t` seat. The
+ * key is typed loosely (`string`) so the function is assignable to the slot's
+ * `TranslateNS<'pet'>` (whose key domain also spans the shared common
+ * vocabulary); a missing key degrades to the key itself rather than throwing.
+ */
+export function t(key: string, params?: Record<string, unknown>): string {
+  let text: string = (dictionary() as Record<string, string>)[key] ?? key
+  if (params !== undefined) {
+    for (const [name, value] of Object.entries(params)) {
+      text = text.replaceAll(`{${name}}`, String(value))
+    }
+  }
+  return text
+}
+
 declare module '@deepseek-ai/dsh-client-ui-slots' {
   interface LocaleNamespaceMap {
     /** dsh-pet UI copy. */

package/src/client/pet.module.css

@@ -75,6 +75,20 @@
   min-width: 132px;
 }
 
+/* 面板底边与图标顶边之间的 hover 桥接（issue #49）：
+   面板绝对定位在图标上方（bottom: 100%），若两者之间存在哪怕几个
+   像素的间隙，指针滑过间隙时会触发容器的 pointerleave，面板在指针
+   抵达按钮前就收起。这段透明伪元素把命中区向下延伸、覆盖图标顶部，
+   使指针在图标与按钮之间始终停留在 hover 区域内。 */
+.panel::after {
+  content: '';
+  position: absolute;
+  top: 100%;
+  left: 0;
+  right: 0;
+  height: 14px;
+}
+
 .rankRow {
   display: flex;
   justify-content: space-between;