@linxin666/dsh-pet 0.1.1

package/lib/types/affinity.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Affinity score — pure, clock-injected. The pet grows closer the more you
+ * work together and care for it: every completed turn earns a small reward,
+ * petting earns a tiny one (cooldown-gated), feeding earns the most.
+ * Persistence lives in the service; this module only computes transitions.
+ * @module @linxin666/dsh-pet/affinity
+ */
+/** One interaction the user can perform on the pet. */
+export type PetInteraction = 'pet' | 'feed';
+/** Affinity state as persisted. */
+export interface AffinityState {
+    /** Total affinity points, capped at AFFINITY_MAX. */
+    points: number;
+    /** Epoch ms of the last pet interaction. */
+    lastPetAt: number;
+    /** Epoch ms of the last feed. */
+    lastFeedAt: number;
+    /** Total pet count (lifetime). */
+    pets: number;
+    /** Total feed count (lifetime). */
+    feeds: number;
+    /** Total completed turns witnessed (lifetime). */
+    turns: number;
+}
+export declare const AFFINITY_MAX = 100;
+/** Affinity ranks by points; the pet visibly grows with its rank.
+ *  Marker glyphs are plain ASCII (the repo bans all emoji characters);
+ *  they read as a growing star trail alongside the rank name. */
+export declare const AFFINITY_RANKS: readonly [{
+    readonly min: 0;
+    readonly name: "幼鲸";
+    readonly emoji: "*";
+}, {
+    readonly min: 25;
+    readonly name: "伙伴";
+    readonly emoji: "**";
+}, {
+    readonly min: 50;
+    readonly name: "挚友";
+    readonly emoji: "***";
+}, {
+    readonly min: 80;
+    readonly name: "深海羁绊";
+    readonly emoji: "****";
+}];
+/** Interaction tuning (all in points / ms). */
+export interface AffinityConfig {
+    /** Points per completed turn. */
+    turnReward: number;
+    /** Points per pet; applied only outside the pet cooldown. */
+    petReward: number;
+    /** Cooldown between pets, ms. */
+    petCooldownMs: number;
+    /** Points per feed. */
+    feedReward: number;
+    /** Cooldown between feeds, ms. */
+    feedCooldownMs: number;
+}
+export declare const defaultAffinityConfig: AffinityConfig;
+export declare function emptyAffinity(): AffinityState;
+/** Outcome of one interaction. */
+export interface InteractionOutcome {
+    /** Mutated affinity state (caller persists it). */
+    affinity: AffinityState;
+    /** Points actually gained (0 when inside the cooldown). */
+    delta: number;
+    /** Human-readable reaction copy the UI shows as a bubble. */
+    reaction: string;
+    /** True when the interaction was accepted (outside cooldown). */
+    accepted: boolean;
+}
+/** Rank for a point total. */
+export declare function rankOf(points: number): (typeof AFFINITY_RANKS)[number];
+/**
+ * Apply one interaction to a copy of the state (immutable style: returns a
+ * new object; the caller replaces the persisted state). Cooldowns only
+ * apply once the pet has been interacted with at least once (last*At === 0
+ * means "never", so the first pet/feed always lands).
+ */
+export declare function applyInteraction(state: AffinityState, kind: PetInteraction, nowMs: number, config?: AffinityConfig): InteractionOutcome;
+/** Reward one completed turn (called by the host on `done`). */
+export declare function applyTurnReward(state: AffinityState, config?: AffinityConfig): AffinityState;
+//# sourceMappingURL=affinity.d.ts.map

package/lib/types/affinity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"affinity.d.ts","sourceRoot":"","sources":["../../src/affinity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uDAAuD;AACvD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,CAAA;AAE3C,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;CACd;AAED,eAAO,MAAM,YAAY,MAAM,CAAA;AAE/B;;iEAEiE;AACjE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;EAKjB,CAAA;AAEV,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAA;IACrB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,eAAO,MAAM,qBAAqB,EAAE,cAMnC,CAAA;AAED,wBAAgB,aAAa,IAAI,aAAa,CAE7C;AAED,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,QAAQ,EAAE,aAAa,CAAA;IACvB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAA;IACb,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAA;IAChB,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,8BAA8B;AAC9B,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAMtE;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,cAAsC,GAC7C,kBAAkB,CA+BpB;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,MAAM,GAAE,cAAsC,GAC7C,aAAa,CAKf"}

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

@@ -0,0 +1,44 @@
+/**
+ * Dock anchor inside `conversation.input.selector.context`: the input
+ * selector row mounts in EVERY conversation phase (no-session cold start,
+ * the blank-session hero, and the active seat), so the floating pet stays on
+ * screen on the new-conversation screen too. While visible it mounts the
+ * floating WhalePet (portal); while hidden it renders the summon button.
+ * @module @linxin666/dsh-pet/client/PetDockEntry
+ */
+import { type ReactElement } from 'react';
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { PetStoreInstance } from './pet-store.ts';
+import { NS } from './locales.ts';
+/** Injected actions handed to the dock entry component. */
+export interface PetInjected {
+    /** The app-wide pet store instance (snapshot + feedback). */
+    store: PetStoreInstance;
+    /** Ensure the first snapshot is fetched (called on mount). */
+    ensure: () => void;
+    /** Pet the whale girl (click). */
+    pet: () => void;
+    /** Feed the whale girl. */
+    feed: () => void;
+    /** Hide the whale girl. */
+    hide: () => void;
+    /** Summon the hidden whale girl back. */
+    summon: () => void;
+    /** Persist a drag position. */
+    dragEnd: (right: number, bottom: number) => void;
+    /** Rename the pet (persisted by the host). */
+    rename: (name: string) => void;
+    /** Clear the reaction bubble. */
+    feedbackDone: () => void;
+}
+/** Composed props of the dock entry (runtime + locale + injected). */
+export type PetDockEntryProps = PropsRuntime<'conversation.input.selector.context'> & PetInjected & PropsLocale<typeof NS>;
+/**
+ * Dock entry: while the pet is visible, mount the floating WhalePet (it
+ * portals itself onto document.body); while hidden, render the summon
+ * button so the pet can always come back. The store is the plugin-owned
+ * single instance — the slot system provides none because the pet is
+ * host-global, not session-scoped.
+ */
+export declare function PetDockEntry(props: PetDockEntryProps): ReactElement;
+//# sourceMappingURL=PetDockEntry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PetDockEntry.d.ts","sourceRoot":"","sources":["../../../src/client/PetDockEntry.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAmC,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAGjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAGjC,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,KAAK,EAAE,gBAAgB,CAAA;IACvB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,kCAAkC;IAClC,GAAG,EAAE,MAAM,IAAI,CAAA;IACf,2BAA2B;IAC3B,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,yCAAyC;IACzC,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,+BAA+B;IAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAChD,8CAA8C;IAC9C,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,iCAAiC;IACjC,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB;AAED,sEAAsE;AACtE,MAAM,MAAM,iBAAiB,GAC3B,YAAY,CAAC,qCAAqC,CAAC,GACjD,WAAW,GACX,WAAW,CAAC,OAAO,EAAE,CAAC,CAAA;AAI1B;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAuCnE"}

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

@@ -0,0 +1,67 @@
+/**
+ * The pet settings card: display layout and name, bound to the `pet` settings
+ * namespace the host plugin registers. Registered into the
+ * `settings.plugin.item` slot the plugin-configuration section renders.
+ */
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SettingsScope, SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+import { type CardActions, type CardShell, type FieldState as CardFieldState } from './settings-form.ts';
+/** The pet's settings fields this card edits (the namespace's full schema). */
+export interface PetSettings {
+    /** Master switch for the plugin. */
+    enabled?: boolean;
+    /** Master switch. */
+    visible?: boolean;
+    /** Scale of the rendered pet in px (sprite cell height). */
+    size?: number;
+    /** Horizontal inset from the viewport right edge, px. */
+    right?: number;
+    /** Vertical inset from the viewport bottom edge, px. */
+    bottom?: number;
+    /** User-customizable pet display name. */
+    name?: string;
+}
+/** What the pet settings card renders. */
+export interface PetSettingsCardState extends CardShell {
+    /** Plugin master switch. */
+    enabled: CardFieldState;
+    /** Master switch. */
+    visible: CardFieldState;
+    /** Pet scale. */
+    size: CardFieldState;
+    /** Right inset. */
+    right: CardFieldState;
+    /** Bottom inset. */
+    bottom: CardFieldState;
+    /** Pet name. */
+    name: CardFieldState;
+}
+/** The registration-side face the card's slot entry injects. */
+export interface PetSettingsCardFace extends CardActions {
+    hooks: {
+        /** Card snapshot bound by the renderer as usePetSettingsCard. */
+        petSettingsCard: SnapshotStore<PetSettingsCardState>;
+    };
+}
+/** Bridges the `pet` scope onto the card's staged form. */
+export declare class PetSettingsCardController {
+    private readonly form;
+    private readonly store;
+    /** @param scope - the bound settings scope for the `pet` namespace. */
+    constructor(scope: SettingsScope<PetSettings>);
+    private projection;
+    /**
+     * Build the face the card's slot registration injects.
+     * @returns the card's snapshot and its form actions.
+     */
+    inject(): PetSettingsCardFace;
+}
+/** Props the renderer binds for the pet settings card. */
+export type PetSettingsCardProps = PropsRuntime<'web-ui.plugin.item'> & PropsLocale<'pet'> & InjectFace<PetSettingsCardFace>;
+/**
+ * Render the pet settings card.
+ * @param props - locale copy, the card snapshot, and its form actions.
+ * @returns the card.
+ */
+export declare function PetSettingsCard(props: PetSettingsCardProps): import("react").JSX.Element;
+//# sourceMappingURL=PetSettingsCard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PetSettingsCard.d.ts","sourceRoot":"","sources":["../../../src/client/PetSettingsCard.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAC7F,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAE1F,OAAO,EAAkD,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,IAAI,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExJ,+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,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;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,gBAAgB;IAChB,IAAI,EAAE,cAAc,CAAA;CACrB;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;IAE3D,uEAAuE;gBAC3D,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC;IAY7C,OAAO,CAAC,UAAU;IAYlB;;;OAGG;IACH,MAAM,IAAI,mBAAmB;CAG9B;AAED,0DAA0D;AAC1D,MAAM,MAAM,oBAAoB,GAC9B,YAAY,CAAC,oBAAoB,CAAC,GAChC,WAAW,CAAC,KAAK,CAAC,GAClB,UAAU,CAAC,mBAAmB,CAAC,CAAA;AAEnC;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,+BAoF1D"}

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

@@ -0,0 +1,78 @@
+/**
+ * Shared chrome for the plugin settings card: a disclosure header naming the
+ * plugin and what its settings govern, the controls inside, and the save that
+ * writes them. Renders nothing while the namespace is unavailable — a
+ * deployment that does not compose the owning plugin should show no trace of
+ * it. Mirrors the official ui-plugin-config PluginCard in a self-contained
+ * slice (this package must not depend on a sibling UI package).
+ */
+import { type ReactNode } from 'react';
+import type { CardShell } from './settings-form.ts';
+import type { SettingsCardKey } from './locales.ts';
+/** Card chrome shared by every plugin settings card. */
+export interface PluginSettingsCardProps {
+    /** Locale reader for this card's copy. */
+    t: (key: SettingsCardKey) => string;
+    /** Locale key of the plugin's name. */
+    titleKey: SettingsCardKey;
+    /** Locale key of the line describing what this plugin's settings govern. */
+    descriptionKey: SettingsCardKey;
+    /** The card's form state: availability, writability, and what a save would do. */
+    state: CardShell;
+    /** Write every staged edit. */
+    onSave: () => void;
+    /** Drop every staged edit. */
+    onDiscard: () => void;
+    /** The plugin's controls. */
+    children: ReactNode;
+}
+/**
+ * Render one plugin settings card.
+ * @param props - the plugin's copy keys, its form state, and its controls.
+ * @returns the card, or nothing when the namespace is unavailable.
+ */
+export declare function PluginSettingsCard(props: PluginSettingsCardProps): import("react").JSX.Element | null;
+/** Props every field control needs regardless of its value type. */
+export interface FieldProps {
+    /** Stable id associating the label with its control. */
+    id: string;
+    /** Visible label. */
+    label: string;
+    /** One-line explanation rendered under the control. */
+    hint: string;
+    /** Draft text this control renders. */
+    text: string;
+    /** True when saving would leave a user-layer entry for this field. */
+    overridden: boolean;
+    /** True when the draft is not a value this field accepts. */
+    invalid: boolean;
+    /** Copy for the overridden badge. */
+    overriddenLabel: string;
+    /** Copy for the reset control. */
+    resetLabel: string;
+    /** Copy shown in place of the hint while the draft is invalid. */
+    invalidLabel: string;
+    /** Disables every control (read-only document, or an unavailable namespace). */
+    disabled: boolean;
+    /** Stage draft text. */
+    onEdit: (text: string) => void;
+    /** Stage a clear so the field re-inherits the composition layer. */
+    onReset: () => void;
+}
+/** A staged value field. `numeric` only hints the keypad: which drafts a field accepts is decided by its spec. */
+export declare function ValueField(props: FieldProps & {
+    /** Hints a numeric keypad without narrowing what the control accepts. */
+    numeric?: boolean;
+    /** Placeholder shown while the draft is empty. */
+    placeholder?: string;
+}): import("react").JSX.Element;
+/** A staged boolean field: 继承 / 开 / 关. */
+export declare function BooleanField(props: FieldProps & {
+    /** Copy for the inherit option. */
+    inheritLabel: string;
+    /** Copy for the on option. */
+    onLabel: string;
+    /** Copy for the off option. */
+    offLabel: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=PluginSettingsCard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PluginSettingsCard.d.ts","sourceRoot":"","sources":["../../../src/client/PluginSettingsCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAGnD,wDAAwD;AACxD,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,MAAM,CAAA;IACnC,uCAAuC;IACvC,QAAQ,EAAE,eAAe,CAAA;IACzB,4EAA4E;IAC5E,cAAc,EAAE,eAAe,CAAA;IAC/B,kFAAkF;IAClF,KAAK,EAAE,SAAS,CAAA;IAChB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,6BAA6B;IAC7B,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,sCAmDhE;AAED,oEAAoE;AACpE,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAA;IACV,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,UAAU,EAAE,OAAO,CAAA;IACnB,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAA;IAChB,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAA;IACvB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAA;IAClB,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAA;IACpB,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAA;IACjB,wBAAwB;IACxB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,oEAAoE;IACpE,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,kHAAkH;AAClH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG;IAC7C,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,+BAqCA;AAED,0CAA0C;AAC1C,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG;IAC/C,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAA;CACjB,+BAmCA"}

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

@@ -0,0 +1,49 @@
+/**
+ * Whale-girl companion component — the browser half's centerpiece. Renders a
+ * fixed-position floating sprite (React portal onto document.body), plays
+ * the spritesheet track matching the host animation snapshot, and exposes
+ * the interaction surface: click to pet, hover panel with feed/hide, drag to
+ * reposition (persisted via setConfig).
+ * @module @linxin666/dsh-pet/client/WhalePet
+ */
+import type { 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';
+import type { PetFeedback } from './pet-store.ts';
+import { NS } from './locales.ts';
+/** Browser URL of the whale-girl atlas (served by the host half's own route). */
+export declare const PET_SPRITESHEET_URL = "/pet/whale/spritesheet.webp";
+/** Browser URL of the whale-girl manifest (authoritative per-row frame counts). */
+export declare const PET_MANIFEST_URL = "/pet/whale/pet.json";
+/** Props injected by the slot registration (store actions + locale). */
+export interface WhalePetProps {
+    /** Latest host snapshot; null while loading. */
+    snapshot: PetStateView | null;
+    /** Display configuration (persisted by the host). */
+    display: PetDisplayConfig;
+    /** Active reaction bubble, if any. */
+    feedback: PetFeedback | null;
+    /** Pet the whale girl (click). */
+    onPet: () => void;
+    /** Feed the whale girl (panel button). */
+    onFeed: () => void;
+    /** Hide the whale girl (panel button). */
+    onHide: () => void;
+    /** Persist a drag position. */
+    onDragEnd: (right: number, bottom: number) => void;
+    /** Rename the pet (persisted by the host). */
+    onRename: (name: string) => void;
+    /** Clear the reaction bubble (after its CSS animation). */
+    onFeedbackDone: () => void;
+    /** Locale translate seat (namespace-bound). */
+    t: TranslateNS<typeof NS>;
+}
+/**
+ * The floating pet. The spritesheet frame advances on requestAnimationFrame
+ * with per-frame durations from TRACKS; the atlas image is loaded once and
+ * the background position is written straight to the sprite element (no
+ * per-frame React state).
+ */
+export declare function WhalePet(props: WhalePetProps): ReactPortal;
+//# sourceMappingURL=WhalePet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WhalePet.d.ts","sourceRoot":"","sources":["../../../src/client/WhalePet.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAqC,WAAW,EAAE,MAAM,OAAO,CAAA;AAE3E,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,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAGjD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAGjC,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,gCAAgC,CAAA;AAEhE,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,wBAAwB,CAAA;AAErD,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;IAC7B,qDAAqD;IACrD,OAAO,EAAE,gBAAgB,CAAA;IACzB,sCAAsC;IACtC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAA;IAC5B,kCAAkC;IAClC,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,+BAA+B;IAC/B,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAClD,8CAA8C;IAC9C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,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,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,WAAW,CAuR1D"}

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

@@ -0,0 +1,46 @@
+/**
+ * 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.
+ * @module @linxin666/dsh-pet/client
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+/** Required services. */
+export declare const inject: string[];
+/** Re-exported for consumers that type against the injected face. */
+export type { PetInjected, PetDockEntryProps } from './PetDockEntry.tsx';
+export type { PetUiState, PetFeedback } from './pet-store.ts';
+export type { PetSettingsCardFace, PetSettingsCardState } from './PetSettingsCard.tsx';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface SlotMap {
+        /**
+         * The child slot the Web UI plugin group declares; this card registers
+         * into the group instead of the top-level `settings.plugin.item` list.
+         * Spelled here with the same shape so this package can register without
+         * depending on the sibling UI package.
+         */
+        'web-ui.plugin.item': {
+            kind: 'list';
+            scope: 'root';
+            owner: SettingsPluginItemOwnerProps;
+        };
+    }
+}
+/** Owner share of a plugin card (the group card supplies nothing). */
+export interface SettingsPluginItemOwnerProps {
+    /** Marker field: card owner props are intentionally empty. */
+    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.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,CAkK9C"}

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

@@ -0,0 +1,101 @@
+/**
+ * dsh-pet locale dictionaries (zh/en).
+ * @module @linxin666/dsh-pet/client/locales
+ */
+/** Dictionary namespace this package registers. */
+export declare const NS = "pet";
+/** Chinese copy. */
+export declare const zh: {
+    readonly 'pet.feed': "喂食";
+    readonly 'pet.hide': "隐藏";
+    readonly 'pet.rename': "改名";
+    readonly 'pet.confirm': "确定";
+    readonly 'pet.namePlaceholder': "输入新名字";
+    readonly 'pet.summon': "召唤{name}";
+    readonly 'pet.rank': "亲密度 {rank}";
+    readonly 'pet.points': "{points} 点";
+    readonly 'pet.treats': "小鱼干 ×{n}";
+    readonly 'pet.state.loading': "鲸鱼娘正在赶来…";
+    readonly 'pet.state.error': "鲸鱼娘迷路了（连接失败）";
+    readonly 'settings.title': "宠物";
+    readonly 'settings.description': "鲸鱼娘的显示布局与名字。";
+    readonly 'settings.enabled': "启用宠物";
+    readonly 'settings.enabledHint': "关闭后隐藏宠物并停止轮询，可在设置里重新启用。";
+    readonly 'settings.visible': "显示宠物";
+    readonly 'settings.visibleHint': "关闭后宠物隐藏，可从聊天输入区重新召唤。";
+    readonly 'settings.size': "大小（px）";
+    readonly 'settings.sizeHint': "精灵单元高度，范围 32–512。";
+    readonly 'settings.right': "距右侧（px）";
+    readonly 'settings.rightHint': "距视口右边缘的水平内缩距离。";
+    readonly 'settings.bottom': "距底部（px）";
+    readonly 'settings.bottomHint': "距视口底边的垂直内缩距离。";
+    readonly 'settings.name': "名字";
+    readonly 'settings.nameHint': "宠物显示名，1–20 个字符。";
+    readonly 'settings.inherit': "继承";
+    readonly 'settings.on': "开";
+    readonly 'settings.off': "关";
+    readonly 'settings.overridden': "已覆盖";
+    readonly 'settings.reset': "恢复默认";
+    readonly 'settings.readOnly': "当前部署的设置只读。";
+    readonly 'settings.expand': "展开设置";
+    readonly 'settings.collapse': "收起设置";
+    readonly 'settings.save': "保存";
+    readonly 'settings.saving': "保存中…";
+    readonly 'settings.discard': "放弃";
+    readonly 'settings.unsaved': "未保存";
+    readonly 'settings.saveFailed': "部署未接受这些值，已保留供你修改。";
+    readonly 'settings.invalidNumber': "请输入数字，留空则使用默认值。";
+};
+/** English copy. */
+export declare const en: {
+    readonly 'pet.feed': "Feed";
+    readonly 'pet.hide': "Hide";
+    readonly 'pet.rename': "Rename";
+    readonly 'pet.confirm': "OK";
+    readonly 'pet.namePlaceholder': "Enter a new name";
+    readonly 'pet.summon': "Summon {name}";
+    readonly 'pet.rank': "Affinity {rank}";
+    readonly 'pet.points': "{points} pts";
+    readonly 'pet.treats': "Treats ×{n}";
+    readonly 'pet.state.loading': "The whale girl is on her way…";
+    readonly 'pet.state.error': "The whale girl is lost (connection failed)";
+    readonly 'settings.title': "Pet";
+    readonly 'settings.description': "The whale girl’s display layout and name.";
+    readonly 'settings.enabled': "Enable the pet";
+    readonly 'settings.enabledHint': "When off, the pet hides and polling stops; re-enable it here.";
+    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)";
+    readonly 'settings.sizeHint': "Sprite cell height, 32–512.";
+    readonly 'settings.right': "Right inset (px)";
+    readonly 'settings.rightHint': "Horizontal inset from the viewport right edge.";
+    readonly 'settings.bottom': "Bottom inset (px)";
+    readonly 'settings.bottomHint': "Vertical inset from the viewport bottom edge.";
+    readonly 'settings.name': "Name";
+    readonly 'settings.nameHint': "The pet’s display name, 1–20 characters.";
+    readonly 'settings.inherit': "Inherit";
+    readonly 'settings.on': "On";
+    readonly 'settings.off': "Off";
+    readonly 'settings.overridden': "Overridden";
+    readonly 'settings.reset': "Reset to default";
+    readonly 'settings.readOnly': "This deployment stores settings read-only.";
+    readonly 'settings.expand': "Show settings";
+    readonly 'settings.collapse': "Hide settings";
+    readonly 'settings.save': "Save";
+    readonly 'settings.saving': "Saving…";
+    readonly 'settings.discard': "Discard";
+    readonly 'settings.unsaved': "Unsaved";
+    readonly 'settings.saveFailed': "The deployment did not accept these values; they were left for you to correct.";
+    readonly 'settings.invalidNumber': "Enter a number, or leave blank to use the default.";
+};
+/** Key union for this namespace. */
+export type PetKey = keyof typeof zh;
+/** The settings-card slice of the pet dictionary. */
+export type SettingsCardKey = PetKey;
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** dsh-pet UI copy. */
+        pet: PetKey;
+    }
+}
+//# sourceMappingURL=locales.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,49 @@
+/**
+ * Browser-side pet store: the pet state snapshot plus transient UI feedback
+ * (reaction bubbles), written only through the store's audit actions. The
+ * RPC polling and interactions live in the plugin apply body; components
+ * only ever read snapshots.
+ * @module @linxin666/dsh-pet/client/pet-store
+ */
+import type { EngineStoreHandle, EngineStoreInstance } from '@deepseek-ai/dsh-client-runtime/client';
+import type { PetStateView } from '../service.ts';
+import type { PetInteraction } from '../affinity.ts';
+/** One transient reaction bubble on the pet. */
+export interface PetFeedback {
+    /** Bubble copy. */
+    text: string;
+    /** Interaction kind driving the reaction animation. */
+    kind: PetInteraction | 'none';
+    /** Epoch ms when the bubble appeared (for expiry). */
+    at: number;
+}
+/** Pet UI state as consumers see it. */
+export interface PetUiState {
+    /** Latest host snapshot; null before the first successful fetch. */
+    snapshot: PetStateView | null;
+    /** Fetch lifecycle. */
+    state: 'loading' | 'ready' | 'error';
+    /** Transport error message (for the debug surface), when any. */
+    error: string | null;
+    /** Active reaction bubble, if any. */
+    feedback: PetFeedback | null;
+}
+/** Store write set. */
+export type PetUiActions = {
+    /** Replace the host snapshot (poll result). */
+    setSnapshot: (draft: PetUiState, snapshot: PetStateView) => void;
+    /** Mark the fetch lifecycle. */
+    setState: (draft: PetUiState, state: PetUiState['state'], error: string | null) => void;
+    /** Show a reaction bubble. */
+    setFeedback: (draft: PetUiState, feedback: PetFeedback | null) => void;
+};
+/** Create the pet store handle (apply world only; never module-level). */
+export declare function createPetStore(): EngineStoreHandle<PetUiState, PetUiActions>;
+export type { PetInteraction };
+/**
+ * A live pet store instance (one per host, owned by the plugin apply body —
+ * the pet itself is host-global, so its UI state must not ride the slot
+ * system's per-session store scoping).
+ */
+export type PetStoreInstance = EngineStoreInstance<PetUiState, PetUiActions>;
+//# sourceMappingURL=pet-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pet-store.d.ts","sourceRoot":"","sources":["../../../src/client/pet-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAA;AACpG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,uDAAuD;IACvD,IAAI,EAAE,cAAc,GAAG,MAAM,CAAA;IAC7B,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAA;CACX;AAED,wCAAwC;AACxC,MAAM,WAAW,UAAU;IACzB,oEAAoE;IACpE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;IAC7B,uBAAuB;IACvB,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;IACpC,iEAAiE;IACjE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,sCAAsC;IACtC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAA;CAC7B;AAED,uBAAuB;AACvB,MAAM,MAAM,YAAY,GAAG;IACzB,+CAA+C;IAC/C,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAA;IAChE,gCAAgC;IAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACvF,8BAA8B;IAC9B,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;CACvE,CAAA;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,IAAI,iBAAiB,CAAC,UAAU,EAAE,YAAY,CAAC,CAuB5E;AAED,YAAY,EAAE,cAAc,EAAE,CAAA;AAE9B;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA"}