dsh-plugin-vrmpet3d 0.1.0 → 0.1.2

package/lib/desktop-page.js

@@ -65,6 +65,49 @@
    */
   var MENU_MARGIN = 4;
 
+  /**
+   * This page's own words, in the two languages — `{ zh: {...}, en: {...} }` with IDENTICAL key sets, the
+   * repository's per-surface shape (`lib/menu.js`'s `LABELS`, `lib/client.js`'s `STRINGS`).
+   *
+   * These four are the only strings this page PAINTS that are its own rather than the app's: the three moments
+   * of 重载模型 and 跳支舞 with nothing to dance to, all of them said in the pet's bubble (`showLocalSpeech`).
+   * The app's pet says the same four things in its badge for the same gestures, so the wording here is kept in
+   * step with that table BY HAND — a drift is one gesture answered in two different sentences. `assets/motions/dance`
+   * is a path rather than words and is written the same way in both halves.
+   *
+   * Read at CALL time through `word`: `preferences.language` can change while this window runs.
+   */
+  var TEXT = {
+    zh: {
+      reloading: '正在重载模型…',
+      reloaded: '模型已重载',
+      reloadFailed: '模型重载失败',
+      danceEmpty: '没有可用的舞蹈动作（assets/motions/dance 是空的）',
+    },
+    en: {
+      reloading: 'Reloading the model…',
+      reloaded: 'Model reloaded',
+      reloadFailed: 'Could not reload the model',
+      danceEmpty: 'No dance clip is available (assets/motions/dance is empty).',
+    },
+  };
+
+  /**
+   * One entry out of {@link TEXT}, in the language on screen — read at CALL time, never captured.
+   *
+   * `'en'` is the only value that selects the English half: every language this page resolves is exactly 'zh' or
+   * 'en' (see the mount), and anything unexpected reads the Chinese half, which is the fallback the markup and
+   * `lib/menu.js`'s own `strings()` already use. An entry missing from THAT half falls back to the other one, and
+   * an entry missing from both returns the key — a gap that SHOWS rather than `undefined` drawn in the pet's
+   * bubble, which is the rule `core.textOf` follows.
+   */
+  function word(language, key) {
+    var half = language === 'en' ? TEXT.en : TEXT.zh;
+    if (typeof half[key] === 'string') return half[key];
+    var other = language === 'en' ? TEXT.zh : TEXT.en;
+    return typeof other[key] === 'string' ? other[key] : key;
+  }
+
   /**
    * This page's own stylesheet, injected once.
    *
@@ -121,6 +164,7 @@
        */
       '.vrmpet3d-desktop-status[data-tone="gold"]{color:#ffc94d}',
       '.vrmpet3d-desktop-status[data-tone="gold"][data-bold="1"]{font-weight:700}',
+      '.vrmpet3d-desktop-status[data-attention="1"]{pointer-events:auto;cursor:pointer;text-shadow:0 0 4px currentColor,0 0 10px currentColor,0 0 18px currentColor}',
       '.vrmpet3d-desktop-status[data-tone="danger"]{color:#ff6b6b}',
       /**
        * 碎碎念: the pet's own short remark, above the prompt.
@@ -179,6 +223,7 @@
       '.vrmpet3d-desktop-status-content{display:flex;align-items:center;min-width:0}',
       /* `nowrap`, always: the operator's "提示文字永不换行". One line, however long the line is. */
       '.vrmpet3d-desktop-status-text{color:inherit;font-variant-numeric:tabular-nums;white-space:nowrap}',
+      '.vrmpet3d-desktop-status-dot{pointer-events:auto;cursor:pointer}',
       '.vrmpet3d-desktop-status-text[data-shimmer-text]::after{content:attr(data-shimmer-text)}',
       '.vrmpet3d-desktop-status-decoration{position:absolute;inset:0;overflow:clip;pointer-events:none;user-select:none}',
       '.vrmpet3d-desktop-status-decoration[hidden]{display:none}',
@@ -593,8 +638,21 @@
     // 是不对的。删掉两个单独的设置面板。」); every setting it used to offer is on one of the two settings pages.
     // ---------------------------------------------------------------------------------------
     var doc = canvas.ownerDocument || globalThis.document || null;
-    var language = options.language
-      || ((globalThis.navigator && /^zh/i.test(globalThis.navigator.language || '')) ? 'zh' : 'en');
+    /**
+     * 界面语言, resolved through the ONE shared rule rather than guessed here.
+     *
+     * An explicit `preferences.language` wins, and `auto` follows the FIRST hint that says anything — and this
+     * page has no DSH locale to ask (it is served by the launcher, not by DSH), so the hints are the browser's own
+     * two: `navigator.language`, which in this window is Electron's and therefore the machine's, and then the
+     * document's `lang`. English is what nothing-at-all answers.
+     *
+     * A core chunk that predates the rule (the stale-delivery case this repository has eaten more than once) falls
+     * back to the browser hint this page used before, so an older host costs the SHARING of the rule, not the
+     * language. The preference is re-read by `adoptLanguage` whenever the settings change.
+     */
+    var language = typeof core.resolveLanguage === 'function'
+      ? core.resolveLanguage(preferences.language, core.browserLanguageHints())
+      : ((globalThis.navigator && /^zh/i.test(globalThis.navigator.language || '')) ? 'zh' : 'en');
     installDesktopStyles(doc);
     var menu = null;
     var menuOpen = false;
@@ -659,10 +717,9 @@
          * 旧的 `client.menu.js`，而那个 chunk 里这一行还在。这时它必须照旧工作，而不是掉出函数末尾什么都不做 ——
          * 一个点了没反应的菜单项，比一个不显示的行难查得多。
          *
-         * 动作本身没变：宠物回到 DSH 里，而这个窗由 APP 关掉（一个写者；见 `applySurface`/`adoptSurface`）。
+         * 宠物回到 DSH 里；本页持久化选择后直接请宿主关闭浮窗，不依赖 DSH 页面在前台。
          */
-        preferences.petSurface = 'app';
-        writePreferences(store, core, preferences);
+        returnToApp();
         return;
       }
       /**
@@ -682,13 +739,12 @@
         /**
          * 关闭独立宠物: the pet goes back INSIDE the app, which is the only thing closing this window can mean.
          *
-         * It is the same write as 切换回窗口内 — this window is the pet's box, so a window with no pet in it is
-         * nothing at all, and the app is what stops this window (one writer; see the `surface` branch above).
+         * Persist the same choice as 切换回窗口内, then ask the host to stop this window.
+         * The app renderer may be paused in the background; it reads that choice when it wakes.
          * The row was 关闭宠物 until 2026-10-12 and used to HIDE the pet as well; the operator split the two
          * meanings then, keeping hiding for the app's pet (隐藏宠物) and this one for handing the pet back.
          */
-        preferences.petSurface = 'app';
-        writePreferences(store, core, preferences);
+        returnToApp();
         return;
       }
       if (id === 'restartHarness' || id === 'quitHarness') {
@@ -699,6 +755,26 @@
       }
     }
 
+    function returnToApp() {
+      preferences.petSurface = 'app';
+      // Persist first, then stop this window through the host. A background DSH
+      // renderer may not run its settings callback until it becomes foreground.
+      return fetch('/vrmpet3d/settings', {
+        method: 'POST', headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ preferences: { petSurface: 'app' } }),
+      }).then(function (response) { return response.ok ? response.json() : null; })
+        .then(function (snapshot) {
+          if (!snapshot || !snapshot.preferences || snapshot.preferences.petSurface !== 'app') return null;
+          preferences.petSurface = 'app';
+          try { if (store) store.setItem(core.STORAGE_KEY, JSON.stringify(preferences)); } catch (_error) { /* host is authoritative */ }
+          return fetch('/vrmpet3d/desktop', {
+            method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ action: 'disable' }),
+          }).then(function (response) {
+            if (!response.ok && bridge && typeof bridge.quit === 'function') bridge.quit();
+          }, function () { if (bridge && typeof bridge.quit === 'function') bridge.quit(); });
+        }).catch(function () { return null; });
+    }
+
     /**
      * Push this surface's 重力 (`windowGravity`) into the placement.
      *
@@ -725,6 +801,13 @@
      */
     function buildMenu() {
       var api = globalThis.__VRMPET3D_MENU__;
+      /**
+       * A REBUILD replaces the element rather than leaving the old one in the body: the menu carries its words
+       * from `createMenu` and cannot be re-worded in place, so `adoptLanguage` builds a new one — and a second
+       * copy would keep its own document listeners. `menuOpen`/`menuBox` are the page's own and are cleared by
+       * `closeMenu`/`onMenuClosed` before this runs.
+       */
+      if (menu && typeof menu.destroy === 'function') menu.destroy();
       if (!api || typeof api.createMenu !== 'function' || !doc) return null;
       api.injectStyle(doc, 'vrmpet3d-menu-style');
       return api.createMenu({
@@ -769,6 +852,7 @@
      */
     function openMenuAt(frameX, frameY) {
       if (!menu) return false;
+      prepareDance();
       /**
        * 非debug模式生效, read at OPEN time.
        *
@@ -790,6 +874,7 @@
       if (typeof menu.setChecked === 'function') {
         menu.setChecked('gravity', preferences.windowGravity === true);
       }
+      if (menu.setDanceState) menu.setDanceState(hostState);
       var size = menu.open();
       var width = Math.min(size.width, Math.max(80, placement.viewportWidth - MENU_MARGIN * 2));
       var height = Math.min(size.height, Math.max(80, placement.viewportHeight - MENU_MARGIN * 2));
@@ -836,6 +921,40 @@
     }
 
     menu = buildMenu();
+    /**
+     * Follow 界面语言 — the preference, this page's environment, and its own four sentences.
+     *
+     * Called from every path that replaces `preferences` (a host snapshot, a storage write from the settings
+     * window), because the language is a preference like any other and a change made there has to reach this
+     * window without a reload. 'auto' means what the browser says here, and the browser can be re-read at any
+     * time; only a CHANGE does anything, since this rebuilds the menu.
+     *
+     * What a change touches, and why exactly these:
+     *   * `language` is read at CALL time by everything that words this page (the say request, the shipped pool
+     *     for a touched part, `core.statusFor`'s default line and its clock units, the published readout, the four
+     *     bubble sentences), so a new value reaches all of them by itself;
+     *   * the MENU carries its labels from `createMenu`, so it is rebuilt — and a menu that is OPEN is closed
+     *     first, because its rows are the old words and its closing is what gives the window its pet-sized box
+     *     back;
+     *   * the prompt is redrawn here rather than on the next frame: this page's frame loop re-renders on a cached
+     *     key, and a language change does not alter the STATE, so the cached line would otherwise keep the old
+     *     words until the state changed.
+     */
+    function adoptLanguage() {
+      var next = typeof core.resolveLanguage === 'function'
+        ? core.resolveLanguage(preferences.language, core.browserLanguageHints())
+        : ((globalThis.navigator && /^zh/i.test(globalThis.navigator.language || '')) ? 'zh' : 'en');
+      if (next === language) return;
+      language = next;
+      if (menuOpen) closeMenu();
+      menu = buildMenu();
+      statusKey = null;
+      renderStatus();
+      layout();
+      reportRect();
+      publish();
+    }
+
     /**
      * The model catalog, fetched once — and re-read whenever the store names a model this list cannot answer for
      * (`refreshCatalog`). See the snapshot handler for the import-while-running case that made that necessary.
@@ -890,6 +1009,24 @@
     var speechNode = null;
     var speechBox = null;
     var hostSpeech = null;
+    var hostSpeechUntil = 0;
+    var hostSpeechTimer = null;
+
+    function receiveHostSpeech(line) {
+      var next = typeof line === 'string' && line ? line : null;
+      if (next === hostSpeech) return;
+      if (hostSpeechTimer) clearTimeout(hostSpeechTimer);
+      hostSpeechTimer = null;
+      hostSpeech = next;
+      var hold = preferences && preferences.speech && Number(preferences.speech.holdSeconds);
+      hostSpeechUntil = next ? Date.now() + (hold > 0 ? hold : 8) * 1000 : 0;
+      if (next) hostSpeechTimer = setTimeout(function () {
+        hostSpeechTimer = null;
+        renderSpeech();
+        reportRect();
+        publish();
+      }, Math.max(0, hostSpeechUntil - Date.now()));
+    }
     var speechShown = null;
     /**
      * A line THIS page said, because its own pet was touched, and until when.
@@ -1011,6 +1148,17 @@
       statusNode.appendChild(statusIconNode);
       statusNode.appendChild(shimmer);
       doc.body.appendChild(statusNode);
+      statusDotNode.title = language === 'en' ? 'Open completed conversation' : '打开已完成的会话';
+      statusNode.addEventListener('click', function (event) {
+        var completed = event.target === statusDotNode && ['working', 'waiting'].indexOf(hostState) !== -1 && Number(hostUnread) > 0;
+        if (!completed && ['done', 'waiting', 'error'].indexOf(hostState) === -1) return;
+        fetch('/vrmpet3d/desktop', {
+          method: 'POST', headers: { 'content-type': 'application/json' },
+          body: JSON.stringify({ action: completed ? 'open-completed-session' : 'open-status-session' }),
+        }).then(function (response) { return response.ok ? response.json() : null; }).then(function (body) {
+          if (body && body.ok && globalThis.vrmpet3dDesktop && globalThis.vrmpet3dDesktop.focusHost) globalThis.vrmpet3dDesktop.focusHost();
+        }).catch(function () {});
+      });
     }
 
     /**
@@ -1126,7 +1274,7 @@
       if (scene.THREE && typeof scene.projectToCanvas === 'function') {
         top = scene.projectToCanvas(new scene.THREE.Vector3(0, modelHeight, 0));
       }
-      var centreX = top ? box.left + top.x : box.left + box.width / 2;
+      var centreX = box.left + box.width / 2;
       var width = speechNode.offsetWidth || 0;
       var height = speechNode.offsetHeight || 0;
       var promptHeight = statusBox && statusBox.width > 0 ? statusBox.height : 0;
@@ -1162,7 +1310,7 @@
       // A line THIS page said takes precedence while it lasts: the pet was touched here, and the next state poll
       // must not wipe the answer before it has been read.
       var localUp = localSpeech && Date.now() < localSpeech.until ? localSpeech : null;
-      var line = localUp ? localUp.text : hostSpeech;
+      var line = hostState === 'dancing' ? null : (localUp ? localUp.text : (Date.now() < hostSpeechUntil ? hostSpeech : null));
       if (!line) {
         speechShown = null;
         speechNode.hidden = true;
@@ -1193,6 +1341,7 @@
 
     /** Put a line up for `holdSeconds`, then hand the bubble back to whatever the app is publishing. */
     function showLocalSpeech(text, holdSeconds) {
+      if (hostState === 'dancing') return;
       var hold = Number.isFinite(Number(holdSeconds)) ? Math.max(1, Number(holdSeconds)) : 4;
       localSpeech = { text: text, until: Date.now() + hold * 1000 };
       if (localSpeechTimer) clearTimeout(localSpeechTimer);
@@ -1228,7 +1377,12 @@
         body: JSON.stringify({
           state: hostState || null,
           event: stateEventName(),
-          language: preferences.language === 'en' ? 'en' : 'zh',
+          /**
+           * The language this page is DRAWN in, not `preferences.language` raw: 'auto' is not a language, and a
+           * host asked for a line in 'auto' would have to guess at exactly the thing this page has already
+           * resolved. The host's prompt is built from this, so a line arrives in the language on screen.
+           */
+          language: language,
           part: item.id,
           structure: structure || null,
           chain: chain || null,
@@ -1308,8 +1462,10 @@
     function applyHostState(state, at, line, error, stale, clock) {
       var known = typeof state === 'string' && Array.isArray(core.STATES) && core.STATES.indexOf(state) !== -1;
       hostState = known ? state : null;
+      if (menu && menu.setDanceState) menu.setDanceState(hostState);
+      if (hostState === 'dancing') localSpeech = null;
       hostStateAt = Number(at) > 0 ? Number(at) : Date.now();
-      hostSpeech = typeof line === 'string' && line ? line : null;
+      receiveHostSpeech(line);
       hostStateError = typeof error === 'string' && error ? error : null;
       hostStateClock = clock === 'state'
         // The sentinel from a deployment with no turn frames: the duration is measured on this page's own state age.
@@ -1413,7 +1569,7 @@
       if (!statusNode) return;
       // The TURN clock the app sent with the state, not this page's own age for it: 用时 is a claim about DSH's turn,
       // and with no turn to report the token is dropped (DSH's own token-free 「深度求索中」). See `PetMachine.statusClock`.
-      var line = core.statusFor(preferences, hostState, hostStateAt, Date.now(), hostStateClock);
+      var line = core.statusFor(preferences, hostState, hostStateAt, Date.now(), hostStateClock, language, hostUnread);
       if (!line) {
         statusKey = null;
         statusShown = null;
@@ -1429,7 +1585,7 @@
        * 「用时 14分46秒」 — so the clock ticks by re-keying, exactly as the app's own label counts.
        */
       var key = line.animation + '\u0000' + (line.icon ? '1' : '0') + '\u0000'
-        + (line.state === 'working' && Number(hostUnread) > 0 ? 'dot' : '') + '\u0000' + shown;
+        + (['working', 'waiting'].indexOf(line.state) !== -1 && Number(hostUnread) > 0 ? 'dot' : '') + '\u0000' + shown;
       /**
        * The tone — 任务达成 gold and bold, 任务失败/出错 red — written every frame rather than on a re-key.
        *
@@ -1437,6 +1593,8 @@
        * about which state is gold; only the shades below are the window's own, because it draws on a
        * transparent desktop instead of DSH's theme tokens.
        */
+      if (['done', 'waiting', 'error'].indexOf(hostState) !== -1) statusNode.setAttribute('data-attention', '1');
+      else statusNode.removeAttribute('data-attention');
       if (line.tone) statusNode.setAttribute('data-tone', line.tone);
       else statusNode.removeAttribute('data-tone');
       if (line.bold) statusNode.setAttribute('data-bold', '1');
@@ -1456,7 +1614,7 @@
         if (statusIconNode) statusIconNode.hidden = line.icon !== true;
         // And the green dot, when another session's completion is still unread (DSH's own marker for it).
         if (statusDotNode) {
-          statusDotNode.hidden = !(line.state === 'working' && Number(hostUnread) > 0);
+          statusDotNode.hidden = !(['working', 'waiting'].indexOf(line.state) !== -1 && Number(hostUnread) > 0);
         }
         // A line that just appeared has no measured box yet: laying it out on this same frame keeps the
         // window from lagging a frame behind the text.
@@ -1610,12 +1768,15 @@
       if (!id) return Promise.resolve(null);
       if (typeof scene.bustModelCache === 'function') scene.bustModelCache();
       // The bubble is this page's own way of saying something transient — the same channel a touched part uses.
-      showLocalSpeech('正在重载模型…', 3);
+      // The three lines of 重载模型 come from this page's own table, and are the same three the app's pet puts in
+      // its badge for the same menu row.
+      showLocalSpeech(word(language, 'reloading'), 3);
       return loadModelSerialized(id).then(function (status) {
         layout();
         scene.applyPreferences(preferences);
         publish();
-        showLocalSpeech(status && status.ok ? '模型已重载' : ((status && status.error) || '模型重载失败'), 3);
+        showLocalSpeech(status && status.ok ? word(language, 'reloaded')
+          : ((status && status.error) || word(language, 'reloadFailed')), 3);
         return status;
       });
     }
@@ -1627,7 +1788,7 @@
      * whose `state` is `dancing` into a real dance, and a preview of anything else interrupts one — which is what 「预览动作的
      * 时候，也应该打断跳舞」 asks for, with no second channel.
      */
-    function requestDance() {
+    function danceClipIds() {
       var all = motionCatalog && Array.isArray(motionCatalog.motions) ? motionCatalog.motions : [];
       var folders = motionCatalog && motionCatalog.stateFolders && Array.isArray(motionCatalog.stateFolders.dancing)
         ? motionCatalog.stateFolders.dancing
@@ -1637,15 +1798,49 @@
         return entry && typeof entry.id === 'string'
           && prefixes.some(function (prefix) { return String(entry.name || '').indexOf(prefix) === 0; });
       }).map(function (entry) { return entry.id; });
-      if (!ids.length) {
-        showLocalSpeech('没有可用的舞蹈动作（assets/motions/dance 是空的）', 3);
+      return ids;
+    }
+
+    // Prepare one random candidate while the menu is open, without changing state.
+    function prepareDance() {
+      var ids = danceClipIds();
+      var current = dancePreview && dancePreview.motionId;
+      var alternatives = ids.filter(function (id) { return id !== current; });
+      if (alternatives.length) ids = alternatives;
+      if (!ids.length) return null;
+      if (!preparedDance || ids.indexOf(preparedDance) === -1) preparedDance = ids[Math.floor(Math.random() * ids.length)];
+      ensureMotion(preparedDance, false);
+      return preparedDance;
+    }
+
+    function requestDance() {
+      if (['resting', 'offline', 'dancing'].indexOf(hostState) === -1) return Promise.resolve(null);
+      var picked = prepareDance();
+      if (!picked) {
+        // The same sentence the app's pet shows in its badge for its own 跳支舞 row.
+        showLocalSpeech(word(language, 'danceEmpty'), 3);
         return Promise.resolve(null);
       }
-      var picked = ids[Math.floor(Math.random() * ids.length)];
+      var request = ++danceRequest;
+      preparedDance = null;
       return fetch('/vrmpet3d/preview', {
         method: 'POST',
         headers: { 'content-type': 'application/json' },
         body: JSON.stringify({ preview: { state: 'dancing', motionId: picked } }),
+      }).then(function (response) {
+        if (!response.ok) return null;
+        if (previewLink && typeof previewLink.load === 'function') previewLink.load();
+        // The app still owns the state. Only while this request is pending do we
+        // ask for its answer faster than the normal one-second background poll.
+        var deadline = Date.now() + 3000;
+        function follow() {
+          if (request !== danceRequest || !stateLink || typeof stateLink.load !== 'function') return;
+          stateLink.load().then(function () {
+            if (request === danceRequest && hostState !== 'dancing' && Date.now() < deadline) setTimeout(follow, 100);
+          });
+        }
+        follow();
+        return response;
       }).catch(function () { return null; });
     }
 
@@ -1778,8 +1973,9 @@
        * guard against sub-pixel `setBounds` churn absorbs.
        */
       if (statusBox && statusBox.width > 0) {
-        x = Math.min(x, statusBox.left);
-        y = Math.min(y, statusBox.top);
+        var glowPadding = ['done', 'waiting', 'error'].indexOf(hostState) !== -1 ? 18 : 0;
+        x = Math.min(x, statusBox.left - glowPadding);
+        y = Math.min(y, statusBox.top - glowPadding);
       }
       /**
        * AND THE 碎碎念 BAND — because it is REPORTED, and this function's one job is to predict the window the launcher
@@ -2218,7 +2414,11 @@
        * no prompt up, the pet's box is.
        */
       var anchor = statusBox && statusBox.width > 0 && statusBox.top < box.top ? statusBox.top : box.top;
-      return { left: box.left, top: anchor - height, width: box.width, height: height };
+      // The text stays the same size when the pet shrinks. Reserve its fixed wrap width too,
+      // otherwise layoutSpeech paints a 220px plate into a window narrower than that plate.
+      var wrapPx = core.SPEECH_LIMITS && core.SPEECH_LIMITS.wrapPx ? core.SPEECH_LIMITS.wrapPx : 220;
+      var width = Math.max(box.width, wrapPx);
+      return { left: box.left - (width - box.width) / 2, top: anchor - height, width: width, height: height };
     }
 
     function reportRect() {
@@ -2246,10 +2446,10 @@
          */
         status: statusBox && statusBox.width > 0
           ? {
-            left: screenBox.x + statusBox.left,
-            top: screenBox.y + statusBox.top,
-            width: statusBox.width,
-            height: statusBox.height,
+            left: screenBox.x + statusBox.left - (['done', 'waiting', 'error'].indexOf(hostState) !== -1 ? 18 : 0),
+            top: screenBox.y + statusBox.top - (['done', 'waiting', 'error'].indexOf(hostState) !== -1 ? 18 : 0),
+            width: statusBox.width + (['done', 'waiting', 'error'].indexOf(hostState) !== -1 ? 36 : 0),
+            height: statusBox.height + (['done', 'waiting', 'error'].indexOf(hostState) !== -1 ? 36 : 0),
           }
           : null,
         /**
@@ -2305,7 +2505,7 @@
     /**
      * The gaze, from the launcher's cursor rather than from an event.
      *
-     * Aim is measured against the PET's centre (`core.pointerAim`, the same function the in-app
+     * Aim is measured against the projected eye midpoint (`core.pointerAim`, the same function the in-app
      * overlay uses), so the pet looks at the cursor wherever it is on the desktop ?including
      * outside the pet, which is the whole point of a desktop pet.
      */
@@ -2316,17 +2516,25 @@
         return;
       }
       var pixels = boxPixels();
+      var eye = typeof scene.gazeOrigin === 'function' ? scene.gazeOrigin() : null;
+      var canvasPixels = canvasBox();
+      var gazeScreenWidth = Number(globalThis.screen && globalThis.screen.width) || screenBox.width;
       var aim = core.pointerAim({
         pointerX: cursor.x - screenBox.x,
         pointerY: cursor.y - screenBox.y,
-        centreX: pixels.left + placement.width / 2,
-        centreY: pixels.top + placement.height / 2,
+        centreX: eye ? canvasPixels.left + eye.x * canvasPixels.width / scene.width : pixels.left + placement.width / 2,
+        centreY: eye ? canvasPixels.top + eye.y * canvasPixels.height / scene.height : pixels.top + placement.height / 2,
         // Both of these are SETTINGS (the 模型参数 window's 视线 section) with an "auto" default: a span of
-        // 0 means one frame width, which on the floating pet is the screen's horizontal resolution, and the
+        // 0 means half the screen width for both axes, and the
         // curve defaults to the shipped notch between "sluggish near, twitchy far" and "straight line".
-        spanX: core.resolveGazeSpan(preferences.gazeSpanX, screenBox.width),
-        spanY: core.resolveGazeSpan(preferences.gazeSpanY, core.GAZE_SPAN.y),
+        spanX: core.resolveGazeSpan(preferences.gazeSpanX, gazeScreenWidth),
+        spanY: core.resolveGazeSpan(preferences.gazeSpanY, gazeScreenWidth),
         curve: preferences.gazeCurve,
+        curveY: preferences.gazeCurveY,
+        curveRadial: preferences.gazeCurveRadial,
+        curveSpatial: preferences.gazeCurveSpatial,
+        distance: preferences.gazeDistance,
+        mode: preferences.gazeCurveMode,
       });
       lastAim = aim;
       scene.motion.setGaze(scene.gazeFromAim(aim));
@@ -2423,7 +2631,8 @@
          * `setMotionMap` refuses them, and a clip assigned to 空闲 is the right thing to show during a nap.
          */
         var drawn = 'resting';
-        if (placement.dragging && drag && drag.moved) drawn = 'held';
+        if (hostState === 'waiting') drawn = 'waiting';
+        else if (placement.dragging && drag && drag.moved) drawn = 'held';
         else if (placement.isAirborne()) drawn = 'falling';
         else if (motionStates.indexOf(hostState) !== -1) drawn = hostState;
         scene.setState(drawn);
@@ -2448,7 +2657,7 @@
          *
          * Sent ONCE per dance: the flag resets as soon as the drawn state leaves 跳舞, so a finished clip cannot post every frame.
          */
-        if (drawn === 'dancing' && scene.playback && scene.playback.record && scene.playback.record.finished === true) {
+        if (drawn === 'dancing' && scene.playback && scene.playback.state === 'dancing' && scene.playback.record && scene.motionFinished(scene.playback.record)) {
           if (!danceEndedReported) {
             danceEndedReported = true;
             try {
@@ -2510,6 +2719,10 @@
     /** Set once a 跳舞 clip has been reported as finished, so one dance posts one "it is over" (see the frame loop). */
     var danceEndedReported = false;
     var dancePreview = null;
+    var preparedDance = null;
+    var danceRequest = 0;
+    var previewLink = null;
+    var stateLink = null;
 
     /** One line of text for anything throwable, the way the rest of this page reports failures. */
     function errorText(error) {
@@ -2779,9 +2992,14 @@
         // Published so a launcher-side probe can tell "the setting reached the renderer" from "the slider
         // did nothing" — the two are indistinguishable from outside otherwise.
         gaze: {
-          curve: preferences.gazeCurve,
-          spanX: core.resolveGazeSpan(preferences.gazeSpanX, screenBox.width),
-          spanY: core.resolveGazeSpan(preferences.gazeSpanY, core.GAZE_SPAN.y),
+          curve: preferences.gazeCurveMode === 'spatial' ? preferences.gazeCurveSpatial
+            : preferences.gazeCurveMode === 'radial' ? preferences.gazeCurveRadial : preferences.gazeCurve,
+          distance: preferences.gazeDistance,
+          autoSpan: core.resolveGazeSpan(0, Number(globalThis.screen && globalThis.screen.width) || screenBox.width),
+          curveY: preferences.gazeCurveY,
+          mode: preferences.gazeCurveMode,
+          spanX: core.resolveGazeSpan(preferences.gazeSpanX, Number(globalThis.screen && globalThis.screen.width) || screenBox.width),
+          spanY: core.resolveGazeSpan(preferences.gazeSpanY, Number(globalThis.screen && globalThis.screen.width) || screenBox.width),
           aim: lastAim,
           /**
            * What the RENDERER applied, which is not the same thing as the aim.
@@ -3049,7 +3267,8 @@
         core.VIEW_LIMITS.pitchMax,
       );
       scene.applyPreferences(preferences);
-      writePreferences(store, core, preferences);
+      // finishViewDrag persists once. Posting on every move echoed partial angles
+      // back into the active gesture and repeatedly laid out the transparent canvas.
     }
 
     /**
@@ -3410,6 +3629,19 @@
     canvas.addEventListener('pointermove', onPointerMove);
     canvas.addEventListener('pointerup', onPointerUp);
     canvas.addEventListener('pointercancel', onPointerUp);
+    function onDoubleClick(event) {
+      if (event.button !== undefined && event.button !== 0) return;
+      if (hostState !== 'dancing' && !dancePreview) return;
+      dancePreview = null;
+      if (hostState === 'dancing') hostState = 'resting';
+      scene.setPreview(null);
+      scene.setState('resting');
+      fetch('/vrmpet3d/preview', {
+        method: 'POST', credentials: 'omit',
+        headers: { 'content-type': 'application/json' }, body: '{}',
+      }).catch(function () { return null; });
+    }
+    canvas.addEventListener('dblclick', onDoubleClick);
     canvas.addEventListener('wheel', onWheel, { passive: false });
     canvas.addEventListener('contextmenu', onContextMenu);
     /**
@@ -3538,6 +3770,10 @@
      * the model the renderer resolves overrides for.
      */
     function applyExternalPreferences(next, shownModel) {
+      if (viewDrag && viewDrag.moved) {
+        next.viewYaw = preferences.viewYaw;
+        next.viewPitch = preferences.viewPitch;
+      }
       // Empty rather than a built-in id: with no avatar installed there is nothing to compare against, and a
       // stand-in name here is what used to make the page describe a pet that was not on screen.
       var current = scene.currentModelId || '';
@@ -3558,6 +3794,12 @@
       placement.preferences = next;
       placement.setSize(client.BASE_PET_SIZE.width, client.BASE_PET_SIZE.height);
       placement.clampToViewport();
+      /**
+       * 界面语言 is a preference like the rest, and only now is the answer readable — `next.language` may be an
+       * explicit 中文/English or `auto`, which this page answers from its own environment. After the size clamp,
+       * because a language change lays the window out again.
+       */
+      adoptLanguage();
       /**
        * 重力 comes from the store like everything else, and it is PHYSICS rather than a value the scene
        * re-applies — so it has to be pushed here too. Without this line the switch would work until the next
@@ -3629,10 +3871,14 @@
      * on demand before it is handed to the scene, exactly as a mapped clip is.
      */
     if (core.watchHostPreview) {
-      core.watchHostPreview({
+      previewLink = core.watchHostPreview({
         onPreview: function (preview) {
           dancePreview = preview && preview.state === 'dancing' ? preview : null;
           if (dancePreview) {
+            // Each preview notification is a NEW run, including the same sole clip.
+            danceEndedReported = false;
+            scene.setPreview(null);
+            if (scene.playback && scene.playback.state === 'dancing') scene.stopPlayback(null);
             ensureMotion(preview.motionId, false);
             return;
           }
@@ -3664,7 +3910,7 @@
      * and this page draws whatever it is told. One clock for the feature, not two that can disagree.
      */
     if (core.watchHostState) {
-      core.watchHostState({
+      stateLink = core.watchHostState({
         onState: function (state, body) {
           // The unread count first: `renderStatus` reads it when it decides whether the dot is drawn, and it runs
           // inside `applyHostState`.
@@ -3717,6 +3963,9 @@
         placement.preferences = next;
         placement.setSize(client.BASE_PET_SIZE.width, client.BASE_PET_SIZE.height);
         placement.clampToViewport();
+        // A storage write is the fallback path for a host without the settings route, and the settings window is
+        // where 界面语言 is chosen: the same re-resolution the snapshot path does, after the size clamp.
+        adoptLanguage();
         // The scene re-reads the whole preference set: springs and expressions are applied from it, so
         // a change made in the settings window lands on the pet through this one call.
         scene.applyPreferences(Object.assign({}, next, { motions: effectiveMotions() }));
@@ -3896,7 +4145,7 @@
        */
       speech: function () { return speechBox; },
       setSpeech: function (line) {
-        hostSpeech = typeof line === 'string' && line ? line : null;
+        receiveHostSpeech(line);
         renderSpeech();
         layout();
         reportRect();
@@ -3904,11 +4153,16 @@
         return speechShown;
       },
       destroy: function () {
+        if (hostSpeechTimer) clearTimeout(hostSpeechTimer);
         running = false;
+        danceRequest += 1;
+        if (previewLink && typeof previewLink.stop === 'function') previewLink.stop();
+        if (stateLink && typeof stateLink.stop === 'function') stateLink.stop();
         canvas.removeEventListener('pointerdown', onPointerDown);
         canvas.removeEventListener('pointermove', onPointerMove);
         canvas.removeEventListener('pointerup', onPointerUp);
         canvas.removeEventListener('pointercancel', onPointerUp);
+        canvas.removeEventListener('dblclick', onDoubleClick);
         canvas.removeEventListener('wheel', onWheel);
         canvas.removeEventListener('contextmenu', onContextMenu);
         if (menu && typeof menu.destroy === 'function') menu.destroy();