@linxin666/dsh-pet 0.3.17 → 0.3.19

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

@@ -52,7 +52,60 @@ function validateFrames2dConfig(config) {
     if (typeof phases.idle !== 'string' || tracks[phases.idle] === undefined) {
         throw new Error('frames2d phases.idle must name an existing track');
     }
-    return { tracks, phases: phases };
+    // Skins: keep entries whose idleTrack survives validation and loops —
+    // a non-looping base idle would settle into itself forever. Click actions
+    // with an unresolvable track are dropped from that skin.
+    let skins;
+    if (Array.isArray(config.skins)) {
+        const resolved = [];
+        for (const skin of config.skins) {
+            if (!isRecord(skin) || typeof skin.id !== 'string' || typeof skin.label !== 'string'
+                || typeof skin.idleTrack !== 'string' || skin.idleTrack === '')
+                continue;
+            const target = tracks[skin.idleTrack];
+            if (target === undefined || !target.loop)
+                continue;
+            let clickActions;
+            if (Array.isArray(skin.clickActions)) {
+                const kept = [];
+                for (const action of skin.clickActions) {
+                    if (!isRecord(action) || typeof action.track !== 'string' || action.track === ''
+                        || typeof action.probability !== 'number' || !(action.probability > 0) || action.probability > 1)
+                        continue;
+                    if (tracks[action.track] === undefined)
+                        continue;
+                    kept.push({
+                        track: action.track,
+                        probability: action.probability,
+                        ...(Array.isArray(action.phrases) ? { phrases: action.phrases } : {}),
+                    });
+                }
+                if (kept.length > 0)
+                    clickActions = kept;
+            }
+            let gameplayTracks;
+            if (isRecord(skin.gameplayTracks)) {
+                const kept = {};
+                for (const [state, trackName] of Object.entries(skin.gameplayTracks)) {
+                    if (typeof trackName !== 'string' || trackName === '' || tracks[trackName] === undefined)
+                        continue;
+                    kept[state] = trackName;
+                }
+                if (Object.keys(kept).length > 0)
+                    gameplayTracks = kept;
+            }
+            resolved.push({
+                id: skin.id,
+                label: skin.label,
+                idleTrack: skin.idleTrack,
+                ...(clickActions === undefined ? {} : { clickActions }),
+                ...(gameplayTracks === undefined ? {} : { gameplayTracks }),
+            });
+        }
+        if (resolved.length > 0)
+            skins = resolved;
+    }
+    return { tracks, phases: phases, ...(skins === undefined ? {} : { skins }) };
 }
 export const frames2dRenderer = {
     id: 'frames2d',
@@ -146,11 +199,18 @@ export const frames2dRenderer = {
         let frameIndex = 0;
         let lastAdvance = Date.now();
         let override;
+        // Skin base idle: every "back to idle" target resolves through this
+        // (idle phase, unmapped phases and fallbacks), so a selected skin swaps
+        // the pet's resting look without touching gameplay tracks.
+        let baseIdle = config.phases.idle;
         let drawToken = 0;
         let lastDrawnUrl;
         const trackForPhase = (phase) => {
             const mapped = config.phases[phase];
-            return mapped !== undefined && config.tracks[mapped] !== undefined ? mapped : config.phases.idle;
+            if (mapped === undefined)
+                return baseIdle;
+            const target = mapped === config.phases.idle ? baseIdle : mapped;
+            return config.tracks[target] !== undefined ? target : baseIdle;
         };
         /** Canvas path: paints the newest requested frame; stale draws drop out. */
         const paintCanvas = (url) => {
@@ -211,11 +271,14 @@ export const frames2dRenderer = {
                 schedule(def.durations[frameIndex] ?? 200);
                 return;
             }
-            // Non-loop completion: settle into the fallback; when the fallback is
-            // what the phase map would play anyway, release the gameplay override.
+            // Non-loop completion: settle into the fallback — an explicit fallback to
+            // a real track wins, except when it points back at the manifest idle
+            // (that resolves through the skin base idle); anything else lands on
+            // the skin base idle. When the settle target is what the phase map
+            // plays anyway, release the gameplay override.
             const target = def.fallback !== undefined && config.tracks[def.fallback] !== undefined
-                ? def.fallback
-                : config.phases.idle;
+                ? (def.fallback === config.phases.idle ? baseIdle : def.fallback)
+                : baseIdle;
             if (target === trackForPhase(ctx.phase.get()))
                 override = undefined;
             play(target);
@@ -224,7 +287,7 @@ export const frames2dRenderer = {
             if (disposed)
                 return;
             if (config.tracks[trackId] === undefined)
-                trackId = config.phases.idle;
+                trackId = baseIdle;
             if (timer !== undefined)
                 clearTimeout(timer);
             track = trackId;
@@ -313,6 +376,20 @@ export const frames2dRenderer = {
                 if (next !== track)
                     play(next);
             },
+            setIdleTrack(next) {
+                if (disposed)
+                    return;
+                if (next === undefined || (config.tracks[next] !== undefined && config.tracks[next].loop)) {
+                    baseIdle = next ?? config.phases.idle;
+                }
+                // A skin only owns the resting look: re-resolve only when no
+                // gameplay override is active (active overrides end into baseIdle).
+                if (override === undefined) {
+                    const target = trackForPhase(ctx.phase.get());
+                    if (target !== track)
+                        play(target);
+                }
+            },
             currentTrack() {
                 return track;
             },

package/lib/types/manifest-v2.d.ts

@@ -99,6 +99,41 @@ export interface PetManifestFrames2d {
     phases: Partial<Record<ActivityPhase, string>> & {
         idle: string;
     };
+    /**
+     * Optional selectable skins: a skin swaps the base idle target (the idle
+     * phase, unmapped phases, and every fallback back to idle) to its own
+     * looping idle track. Gameplay tracks (shy/work/sleep...) are not replaced.
+     */
+    skins?: PetManifestSkin[];
+}
+/** One selectable frames2d skin. */
+export interface PetManifestSkin {
+    id: string;
+    label: string;
+    /** A declared, looping track that becomes the base idle while selected. */
+    idleTrack: string;
+    /**
+     * Optional click-triggered actions exclusive to this skin: while the skin
+     * is selected, a tap rolls each action by probability (in order) and plays
+     * its track once if hit. Misses fall through to the regular touch zones.
+     */
+    clickActions?: PetManifestSkinClickAction[];
+    /**
+     * Optional gameplay-track overrides: gameplay state name (e.g. 'sleep' or
+     * 'work') -> a declared track the skin swaps in while selected. Lets a skin
+     * restyle a gameplay loop (e.g. its own sleep animation) without touching
+     * the default pet's tracks.
+     */
+    gameplayTracks?: Record<string, string>;
+}
+/** One probability-rolled tap action a skin may declare. */
+export interface PetManifestSkinClickAction {
+    /** A declared track played once on hit (usually non-looping). */
+    track: string;
+    /** Hit probability for this action (0..1). */
+    probability: number;
+    /** Optional lines spoken when the action fires. */
+    phrases?: string[];
 }
 /** Normalized v2 manifest the registry consumes. */
 export interface PetManifestV2 {
@@ -150,6 +185,16 @@ export declare const KNOWN_LIVE2D: Set<string>;
 export declare const KNOWN_FRAMES2D: Set<string>;
 /** frames2d track field allow-list (drift-locked to the schema file). */
 export declare const KNOWN_FRAMES2D_TRACK: Set<string>;
+/** frames2d skin entry field allow-list (drift-locked to the schema file). */
+export declare const KNOWN_SKIN: Set<string>;
+/** frames2d skin click-action field allow-list (drift-locked to the schema file). */
+export declare const KNOWN_SKIN_CLICK: Set<string>;
+/** Max selectable skins a frames2d manifest may declare. */
+export declare const FRAMES2D_MAX_SKINS = 16;
+/** Max click actions one skin may declare. */
+export declare const FRAMES2D_MAX_SKIN_CLICKS = 8;
+/** Max gameplay-state overrides one skin may declare. */
+export declare const FRAMES2D_MAX_SKIN_GAMEPLAY = 8;
 /**
  * Validate a manifest-relative asset path: no absolute paths, no backslashes,
  * no traversal, plain safe segments only. Returns the normalized path.

package/lib/types/manifest-v2.d.ts.map

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

package/lib/types/manifest-v2.js

@@ -50,9 +50,35 @@ export const KNOWN_SPRITE2D = new Set(['spritesheetPath', 'cell', 'columns', 'at
 /** live2d block field allow-list (drift-locked to the schema file). */
 export const KNOWN_LIVE2D = new Set(['model', 'scale', 'translate', 'motions', 'expressions', 'hitAreas', 'lipSync']);
 /** frames2d block field allow-list (drift-locked to the schema file). */
-export const KNOWN_FRAMES2D = new Set(['dir', 'defaultFrameMs', 'tracks', 'phases']);
+export const KNOWN_FRAMES2D = new Set(['dir', 'defaultFrameMs', 'tracks', 'phases', 'skins']);
 /** frames2d track field allow-list (drift-locked to the schema file). */
 export const KNOWN_FRAMES2D_TRACK = new Set(['frames', 'frameMs', 'loop', 'fallback']);
+/** frames2d skin entry field allow-list (drift-locked to the schema file). */
+export const KNOWN_SKIN = new Set(['id', 'label', 'idleTrack', 'clickActions', 'gameplayTracks']);
+/** frames2d skin click-action field allow-list (drift-locked to the schema file). */
+export const KNOWN_SKIN_CLICK = new Set(['track', 'probability', 'phrases']);
+/** Max selectable skins a frames2d manifest may declare. */
+export const FRAMES2D_MAX_SKINS = 16;
+/** Max click actions one skin may declare. */
+export const FRAMES2D_MAX_SKIN_CLICKS = 8;
+/** Max gameplay-state overrides one skin may declare. */
+export const FRAMES2D_MAX_SKIN_GAMEPLAY = 8;
+/** Max spoken lines one skin click action may declare. */
+const SKIN_CLICK_MAX_PHRASES = 5;
+/** Max length of one spoken line. */
+const SKIN_CLICK_PHRASE_MAX_LENGTH = 120;
+/** Validate a skin click action's optional phrase pool (same spirit as gameplay phrases). */
+function parseSkinPhrases(raw, field, diag) {
+    if (raw === undefined)
+        return undefined;
+    if (!Array.isArray(raw) || raw.length === 0 || raw.length > SKIN_CLICK_MAX_PHRASES
+        || raw.some(line => typeof line !== 'string' || line.trim() === '' || line.length > SKIN_CLICK_PHRASE_MAX_LENGTH)) {
+        diag.error(field + ' must be 1..' + SKIN_CLICK_MAX_PHRASES + ' non-empty lines of at most '
+            + SKIN_CLICK_PHRASE_MAX_LENGTH + ' chars');
+        return undefined;
+    }
+    return raw;
+}
 class Diagnostics {
     list = [];
     source;
@@ -391,6 +417,118 @@ function parseFrames2dBlock(raw, diag) {
             diag.error('frames2d.tracks.' + name + '.fallback references unknown track ' + JSON.stringify(track.fallback));
         }
     }
+    // Optional skins: each selects a declared looping idle track as the base
+    // idle while active (id/label are UI-facing, idleTrack is structure).
+    if (raw.skins !== undefined) {
+        if (!Array.isArray(raw.skins) || raw.skins.length === 0 || raw.skins.length > FRAMES2D_MAX_SKINS) {
+            diag.error('frames2d.skins must be an array of 1..' + FRAMES2D_MAX_SKINS + ' skins');
+        }
+        else {
+            const skins = [];
+            const seen = new Set();
+            for (const [index, entry] of raw.skins.entries()) {
+                const field = 'frames2d.skins[' + index + ']';
+                if (!isRecord(entry)) {
+                    diag.error(field + ' must be an object');
+                    continue;
+                }
+                const extra = unknownKeys(entry, KNOWN_SKIN);
+                if (extra.length > 0)
+                    diag.error(field + ': unknown field(s) ' + extra.map(k => JSON.stringify(k)).join(', '));
+                const id = typeof entry.id === 'string' ? entry.id.trim() : '';
+                if (id === '' || id.length > 24 || !FRAMES2D_TRACK_NAME.test(id)) {
+                    diag.error(field + '.id must be a lowercase kebab id of at most 24 chars');
+                    continue;
+                }
+                if (seen.has(id)) {
+                    diag.error(field + ': duplicate skin id ' + JSON.stringify(id));
+                    continue;
+                }
+                seen.add(id);
+                const label = typeof entry.label === 'string' ? entry.label.trim() : '';
+                if (label === '' || label.length > 40) {
+                    diag.error(field + '.label must be a non-empty string of at most 40 chars');
+                    continue;
+                }
+                const idleTrack = typeof entry.idleTrack === 'string' ? entry.idleTrack : '';
+                if (!validTrackName(idleTrack) || tracks[idleTrack] === undefined) {
+                    diag.error(field + '.idleTrack must name a declared frames2d track');
+                    continue;
+                }
+                // Optional click actions: each names a declared track and a hit
+                // probability; phrases reuse the gameplay phrase constraints.
+                let clickActions;
+                if (entry.clickActions !== undefined) {
+                    if (!Array.isArray(entry.clickActions) || entry.clickActions.length === 0 || entry.clickActions.length > FRAMES2D_MAX_SKIN_CLICKS) {
+                        diag.error(field + '.clickActions must be an array of 1..' + FRAMES2D_MAX_SKIN_CLICKS + ' actions');
+                    }
+                    else {
+                        const resolved = [];
+                        for (const [cIndex, action] of entry.clickActions.entries()) {
+                            const cField = field + '.clickActions[' + cIndex + ']';
+                            if (!isRecord(action)) {
+                                diag.error(cField + ' must be an object');
+                                continue;
+                            }
+                            const cExtra = unknownKeys(action, KNOWN_SKIN_CLICK);
+                            if (cExtra.length > 0)
+                                diag.error(cField + ': unknown field(s) ' + cExtra.map(k => JSON.stringify(k)).join(', '));
+                            const trackName = typeof action.track === 'string' ? action.track : '';
+                            if (!validTrackName(trackName) || tracks[trackName] === undefined) {
+                                diag.error(cField + '.track must name a declared frames2d track');
+                                continue;
+                            }
+                            if (typeof action.probability !== 'number' || !Number.isFinite(action.probability)
+                                || action.probability <= 0 || action.probability > 1) {
+                                diag.error(cField + '.probability must be a number in (0, 1]');
+                                continue;
+                            }
+                            const phrases = parseSkinPhrases(action.phrases, cField + '.phrases', diag);
+                            resolved.push({ track: trackName, probability: action.probability, ...(phrases === undefined ? {} : { phrases }) });
+                        }
+                        if (resolved.length > 0)
+                            clickActions = resolved;
+                    }
+                }
+                // Optional gameplay-track overrides: gameplay state name -> declared
+                // track swapped in while this skin is selected (e.g. a skin variant of
+                // the sleep loop). State names mirror gameplay blocks (sleep/work...);
+                // values must reference declared tracks.
+                let gameplayTracks;
+                if (entry.gameplayTracks !== undefined) {
+                    if (!isRecord(entry.gameplayTracks)) {
+                        diag.error(field + '.gameplayTracks must be an object mapping gameplay state names to tracks');
+                    }
+                    else {
+                        const states = Object.keys(entry.gameplayTracks);
+                        if (states.length === 0 || states.length > FRAMES2D_MAX_SKIN_GAMEPLAY) {
+                            diag.error(field + '.gameplayTracks must map 1..' + FRAMES2D_MAX_SKIN_GAMEPLAY + ' gameplay states');
+                        }
+                        else {
+                            const resolvedTracks = {};
+                            for (const state of states) {
+                                if (!/^[a-z0-9][a-z0-9-]*$/.test(state)) {
+                                    diag.error(field + '.gameplayTracks key ' + JSON.stringify(state) + ' must be a lowercase kebab state name');
+                                    continue;
+                                }
+                                const gTrack = entry.gameplayTracks[state];
+                                if (typeof gTrack !== 'string' || !validTrackName(gTrack) || tracks[gTrack] === undefined) {
+                                    diag.error(field + '.gameplayTracks[' + JSON.stringify(state) + '] must name a declared frames2d track');
+                                    continue;
+                                }
+                                resolvedTracks[state] = gTrack;
+                            }
+                            if (Object.keys(resolvedTracks).length > 0)
+                                gameplayTracks = resolvedTracks;
+                        }
+                    }
+                }
+                skins.push({ id, label, idleTrack, ...(clickActions === undefined ? {} : { clickActions }), ...(gameplayTracks === undefined ? {} : { gameplayTracks }) });
+            }
+            if (skins.length > 0)
+                block.skins = skins;
+        }
+    }
     return diag.hasErrors ? undefined : block;
 }
 /** v1 compat read: map the legacy flat manifest onto the v2 sprite2d shape. */

package/lib/types/persist.d.ts

@@ -22,7 +22,7 @@ export interface PetDisplayConfig {
 export declare const defaultDisplayConfig: PetDisplayConfig;
 /** Display value bounds (shared by load-time validation and setConfig). */
 export declare const DISPLAY_SIZE_MIN = 32;
-export declare const DISPLAY_SIZE_MAX = 512;
+export declare const DISPLAY_SIZE_MAX = 1024;
 export declare const DISPLAY_INSET_MAX = 10000;
 /** Everything persisted for the pet. */
 export interface PetPersist {

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

@@ -1 +1 @@
-{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../src/persist.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAA+B,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AAC/E,OAAO,EAAwC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AAEpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAErD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEhE,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAA;CACf;AAED,eAAO,MAAM,oBAAoB,EAAE,gBAKlC,CAAA;AAED,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAClC,eAAO,MAAM,gBAAgB,MAAM,CAAA;AACnC,eAAO,MAAM,iBAAiB,QAAS,CAAA;AAEvC,wCAAwC;AACxC,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,QAAQ,EAAE,aAAa,CAAA;IACvB,gCAAgC;IAChC,MAAM,EAAE,WAAW,CAAA;IACnB,OAAO,EAAE,gBAAgB,CAAA;IACzB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CAC3C;AAED,wBAAwB;AACxB,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC,wBAAgB,YAAY,IAAI,UAAU,CASzC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AA+DD,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAqB,GAAG,UAAU,CAoDrE;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,GAAE,MAAqB,GAAG,IAAI,CAMjF"}
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../src/persist.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAA+B,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AAC/E,OAAO,EAAwC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AAEpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAErD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEhE,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAA;CACf;AAED,eAAO,MAAM,oBAAoB,EAAE,gBAKlC,CAAA;AAED,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAClC,eAAO,MAAM,gBAAgB,OAAO,CAAA;AACpC,eAAO,MAAM,iBAAiB,QAAS,CAAA;AAEvC,wCAAwC;AACxC,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,QAAQ,EAAE,aAAa,CAAA;IACvB,gCAAgC;IAChC,MAAM,EAAE,WAAW,CAAA;IACnB,OAAO,EAAE,gBAAgB,CAAA;IACzB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CAC3C;AAED,wBAAwB;AACxB,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC,wBAAgB,YAAY,IAAI,UAAU,CASzC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AA+DD,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAqB,GAAG,UAAU,CAoDrE;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,GAAE,MAAqB,GAAG,IAAI,CAMjF"}

package/lib/types/persist.js

@@ -19,7 +19,7 @@ export const defaultDisplayConfig = {
 };
 /** Display value bounds (shared by load-time validation and setConfig). */
 export const DISPLAY_SIZE_MIN = 32;
-export const DISPLAY_SIZE_MAX = 512;
+export const DISPLAY_SIZE_MAX = 1024;
 export const DISPLAY_INSET_MAX = 10_000;
 /** Name constraints. */
 export const PET_NAME_MAX_LENGTH = 20;

package/lib/types/registry.d.ts

@@ -159,6 +159,28 @@ export interface PetFrames2dDefinition {
     phases: Partial<Record<ActivityPhase, string>> & {
         idle: string;
     };
+    /** Selectable skins; each swaps the base idle target to its idleTrack. */
+    skins?: PetSkinDefinition[];
+}
+/** One selectable frames2d skin as served to the browser half. */
+export interface PetSkinDefinition {
+    id: string;
+    label: string;
+    /** A declared looping track that becomes the base idle while selected. */
+    idleTrack: string;
+    /** Click actions exclusive to this skin (roll by probability; miss → touch zones). */
+    clickActions?: PetSkinClickActionDefinition[];
+    /** Gameplay-state overrides (state -> track) swapped in while selected. */
+    gameplayTracks?: Record<string, string>;
+}
+/** One probability-rolled tap action a skin may declare. */
+export interface PetSkinClickActionDefinition {
+    /** A declared track played once on hit. */
+    track: string;
+    /** Hit probability (0..1). */
+    probability: number;
+    /** Optional lines spoken when the action fires. */
+    phrases?: string[];
 }
 /** A normalized pet as served to the browser half. */
 export interface PetDefinition {

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

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

package/lib/types/registry.js

@@ -478,6 +478,50 @@ function resolveFrames2dEntry(manifest, dir, options) {
             phases[phase] = idleTrack;
         }
     }
+    // Skins: keep only entries whose idleTrack survived track resolution, and
+    // drop click actions whose track did not (the skin itself stays usable).
+    let skins;
+    if (block.skins !== undefined) {
+        const resolved = [];
+        for (const skin of block.skins) {
+            if (tracks[skin.idleTrack] === undefined) {
+                record('warning', 'pet ' + manifest.id + ': frames2d skin ' + JSON.stringify(skin.id) + ' idleTrack dropped; skipping');
+                continue;
+            }
+            let clickActions;
+            if (skin.clickActions !== undefined) {
+                const kept = [];
+                for (const action of skin.clickActions) {
+                    if (tracks[action.track] === undefined) {
+                        record('warning', 'pet ' + manifest.id + ': frames2d skin ' + JSON.stringify(skin.id)
+                            + ' click action track ' + JSON.stringify(action.track) + ' dropped');
+                        continue;
+                    }
+                    kept.push(action);
+                }
+                if (kept.length > 0)
+                    clickActions = kept;
+            }
+            // Gameplay track overrides: drop entries whose track did not survive.
+            let gameplayTracks;
+            if (skin.gameplayTracks !== undefined) {
+                const kept = {};
+                for (const [state, gTrack] of Object.entries(skin.gameplayTracks)) {
+                    if (tracks[gTrack] === undefined) {
+                        record('warning', 'pet ' + manifest.id + ': frames2d skin ' + JSON.stringify(skin.id)
+                            + ' gameplay track override ' + JSON.stringify(state) + ' -> ' + JSON.stringify(gTrack) + ' dropped');
+                        continue;
+                    }
+                    kept[state] = gTrack;
+                }
+                if (Object.keys(kept).length > 0)
+                    gameplayTracks = kept;
+            }
+            resolved.push({ ...skin, ...(clickActions === undefined ? {} : { clickActions }), ...(gameplayTracks === undefined ? {} : { gameplayTracks }) });
+        }
+        if (resolved.length > 0)
+            skins = resolved;
+    }
     const remarks = normalizePetRemarks(manifest.remarks, message => record('warning', 'pet ' + manifest.id + ': ' + message));
     // Gameplay layer: shop item icons are manifest-relative frame paths —
     // verify them, promote them to browser URLs, and add them to the servable
@@ -516,7 +560,7 @@ function resolveFrames2dEntry(manifest, dir, options) {
         displayName: manifest.displayName,
         description: manifest.description ?? '',
         renderer: 'frames2d',
-        frames2d: { tracks, phases },
+        frames2d: { tracks, phases, ...(skins === undefined ? {} : { skins }) },
         ...(gameplay === undefined ? {} : { gameplay }),
         cell,
         columns: DEFAULT_PET_COLUMNS,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@linxin666/dsh-pet",
   "description": "Multi-pet companion plugin for the dsh web GUI: a registry-driven floating pet that reacts to model activity, with per-pet naming, petting/feeding interactions and an affinity score",
-  "version": "0.3.17",
+  "version": "0.3.19",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
@@ -34,6 +34,7 @@
     "assets/whale",
     "assets/whale-refined",
     "assets/ouo-neko",
+    "assets/blue-throated-bee-eater",
     "assets/decorations",
     "contracts"
   ],

package/src/client/gameplay-hud.test.tsx

@@ -271,6 +271,70 @@ describe('GameplayHud', () => {
     expect(api.touch).not.toHaveBeenCalled()
   })
 
+  it('skin taps never fall through to the default touch zones', async () => {
+    // A skinned pet whose skin has no click actions: taps must resolve to
+    // the plain click boost (touch() without a zone) instead of playing the
+    // default pet's touch reactions (safety: skin ≠ default gameplay).
+    const def = petDefinition()
+    def.frames2d!.skins = [
+      { id: 'lanhainishang', label: '蓝海霓裳', idleTrack: 'lanhainishang-idle' },
+    ]
+    const store = createPetStore().create()
+    store.actions.setSnapshot(snapshot(gameplayView()))
+    const api = {
+      touch: vi.fn(async () => ({ ok: true, view: gameplayView() })),
+      setMode: vi.fn(), workTick: vi.fn(), buy: vi.fn(),
+    } as unknown as Harness['api']
+    const setTrack = vi.fn()
+    const bus: GameplayBus = { setTrack }
+    render(<GameplayHud definition={def} store={store} api={api} bus={bus} drag={createDragStream()} t={t} />)
+    // Select the skin through the menu card so skinIdRef is active.
+    await act(async () => {
+      bus.openCard?.()
+    })
+    fireEvent.click(screen.getByText('皮肤'))
+    fireEvent.click(screen.getByText('蓝海霓裳'))
+    await act(async () => {
+      bus.tap!(0.5, 0.3) // head zone → default would be the 'happy' state
+    })
+    // No zone verb, no default track: the tap is a plain boost only.
+    expect(api.touch).toHaveBeenCalledWith()
+    expect(api.touch).not.toHaveBeenCalledWith('head')
+    expect(setTrack).not.toHaveBeenCalledWith('happy')
+  })
+
+  it('plays the skin click action on a rolled hit and skips the default touch', async () => {
+    const def = petDefinition()
+    def.frames2d!.skins = [
+      {
+        id: 'lanhainishang', label: '蓝海霓裳', idleTrack: 'lanhainishang-idle',
+        clickActions: [{ track: 'lanhainishang-lift-skirt', probability: 0.3 }],
+      },
+    ]
+    const store = createPetStore().create()
+    store.actions.setSnapshot(snapshot(gameplayView()))
+    const api = {
+      touch: vi.fn(async () => ({ ok: true, view: gameplayView() })),
+      setMode: vi.fn(), workTick: vi.fn(), buy: vi.fn(),
+    } as unknown as Harness['api']
+    const setTrack = vi.fn()
+    const bus: GameplayBus = { setTrack }
+    render(<GameplayHud definition={def} store={store} api={api} bus={bus} drag={createDragStream()} t={t} />)
+    await act(async () => {
+      bus.openCard?.()
+    })
+    fireEvent.click(screen.getByText('皮肤'))
+    fireEvent.click(screen.getByText('蓝海霓裳'))
+    // Force a hit (roll < 0.3).
+    vi.spyOn(Math, 'random').mockReturnValue(0.1)
+    await act(async () => {
+      bus.tap!(0.5, 0.3)
+    })
+    vi.restoreAllMocks()
+    expect(setTrack).toHaveBeenCalledWith('lanhainishang-lift-skirt')
+    expect(api.touch).not.toHaveBeenCalledWith('head')
+  })
+
   it('runs the idle director: weighted act rolls on the interval', async () => {
     const h = harness()
     await act(async () => {