dsh-plugin-vrmpet3d 0.1.1 → 0.1.3

package/lib/client.js

@@ -300,6 +300,7 @@
      */
     '.vrmpet3d-status[data-tone="gold"]{color:light-dark(#8a5a00,#ffc94d);--dsw-alias-label-shimmer:light-dark(#ffe0a3,#fff0c9)}',
     '.vrmpet3d-status[data-tone="gold"][data-bold="1"]{font-weight:700}',
+    '.vrmpet3d-status[data-attention="1"]{pointer-events:auto;cursor:pointer;text-shadow:0 0 4px currentColor,0 0 10px currentColor,0 0 18px currentColor}',
     '.vrmpet3d-status[data-tone="danger"]{color:light-dark(#b3261e,#ff6b6b);--dsw-alias-label-shimmer:light-dark(#ffc9c4,#ffd0cc)}',
     /**
      * 碎碎念: the pet's own short remark, in a bubble above the status prompt.
@@ -411,6 +412,7 @@
     '.vrmpet3d-status-content{display:flex;align-items:center;min-width:0}',
     /* `nowrap`, always: the operator's "提示文字永不换行". One line, however long the line is. */
     '.vrmpet3d-status-text{color:inherit;font-variant-numeric:tabular-nums;white-space:nowrap}',
+    '.vrmpet3d-status-dot{pointer-events:auto;cursor:pointer}',
     /* The words are rendered twice from ONE string: `attr()` feeds both copies, so the two cannot drift. */
     '.vrmpet3d-status-text[data-shimmer-text]::after{content:attr(data-shimmer-text)}',
     '.vrmpet3d-status-decoration{position:absolute;inset:0;overflow:clip;pointer-events:none;user-select:none}',
@@ -780,6 +782,8 @@
   function VrmPet3DWidget(host, options) {
     options = options || {};
     this.host = host;
+    this.openSession = options.openSession || function () {};
+    this.conversationVisible = options.conversationVisible || function () { return true; };
     this.core = globalThis.__VRMPET3D_CORE__;
     this.sceneApi = globalThis.__VRMPET3D_SCENE__;
     /**
@@ -812,6 +816,7 @@
     this.placement = new Placement(this.preferences, function () { return Date.now(); }, this.core);
 
     this.machine = new this.core.PetMachine(function () { return Date.now(); }, this.preferences.sleepAfterMs);
+    this.machine.requireViewedAcknowledgement = typeof options.conversationVisible === 'function';
     /**
      * The machine reads the settings it needs through the WIDGET, not from a copy.
      *
@@ -1135,6 +1140,7 @@
      */
     if (this.core.watchHostPreview) {
       this.previewSync = this.core.watchHostPreview({
+        onNavigate: function (id) { self.openSession(id); },
         onPreview: function (preview) {
           /**
            * A PREVIEW ENDS A DANCE — and a preview of the DANCING state STARTS one.
@@ -1224,6 +1230,7 @@
   // ---- DOM -----------------------------------------------------------------
 
   VrmPet3DWidget.prototype.build = function () {
+    var self = this;
     var doc = this.document;
     var root = doc.createElement('div');
     root.className = 'vrmpet3d-root';
@@ -1288,6 +1295,10 @@
     this.canvas = root.querySelector('.vrmpet3d-pet canvas');
     this.badge = root.querySelector('.vrmpet3d-badge');
     this.statusNode = root.querySelector('.vrmpet3d-status');
+    this.statusNode.addEventListener('click', function (event) {
+      event.stopPropagation();
+      self.openStatusSession();
+    });
     this.statusIcon = root.querySelector('.vrmpet3d-status-icon');
     /**
      * The green dot, when a completion is waiting elsewhere.
@@ -1298,6 +1309,11 @@
      * puts beside that session in its list, and it disappears when the user goes back there.
      */
     this.statusDot = root.querySelector('.vrmpet3d-status-dot');
+    this.statusDot.addEventListener('click', function (event) {
+      event.stopPropagation();
+      self.openQueuedSession('completed');
+    });
+    this.statusDot.title = this.language === 'en' ? 'Open completed conversation' : '打开已完成的会话';
     this.statusDecoration = root.querySelector('.vrmpet3d-status-decoration');
     /**
      * The prompt's two text copies — the real one and the masked highlight — which always render the SAME
@@ -1651,6 +1667,19 @@
    */
   VrmPet3DWidget.prototype.openSettingsWindow = function (page) {
     var self = this;
+    if (page === 'game') {
+      var gameUrl = '/vrmpet3d/game?model=' + encodeURIComponent(self.currentModelId() || '');
+      if ((!globalThis.dshDesktop && !/Electron\//i.test(globalThis.navigator.userAgent)) || !self.canUseIndependentPet()) {
+        globalThis.open(gameUrl, '_blank', 'noopener'); return;
+      }
+      fetch('/vrmpet3d/desktop', { method: 'POST', credentials: 'omit',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ action: 'game', modelId: self.currentModelId() })
+      }).then(function (response) {
+        if (!response.ok) self.showStatus('小游戏窗口打开失败，请重试。');
+      }).catch(function () { self.showStatus('小游戏窗口打开失败，请重试。'); });
+      return;
+    }
     /**
      * Which window, and the host action that opens it.
      *
@@ -1762,6 +1791,7 @@
    */
   VrmPet3DWidget.prototype.openMenuAt = function (clientX, clientY) {
     if (!this.menu) return false;
+    if (typeof this.menu.setSurfaceVisible === 'function') this.menu.setSurfaceVisible(this.canUseIndependentPet());
     var doc = this.document;
     var view = doc.defaultView;
     var viewportWidth = Number(view && view.innerWidth) || doc.documentElement.clientWidth || 0;
@@ -1774,6 +1804,7 @@
      * it is read when the menu is built.
      */
     this.menu.setSurfaceAllowed(this.preferences.petSurface !== 'both');
+    if (this.menu.setDanceState) this.menu.setDanceState(this.machine.state);
     /**
      * 重力's check mark, read at the same moment and for the same reason: a host snapshot or a settings-window
      * edit can change the preference while the page keeps running, so a menu that cached it would show the
@@ -1834,6 +1865,7 @@
       container: this.root,
       language: this.language,
       toSurface: 'window',
+      showSurface: this.canUseIndependentPet(),
       onChoose: function (id) { self.onMenuChoice(id); },
     });
     return this.menu;
@@ -1856,6 +1888,7 @@
     // 切换模型: the model picker's own page. It decides WHICH model every other page is about, so it is a
     // window of its own rather than a row inside 当前模型参数设置 (see ITEMS in lib/menu.js).
     if (id === 'switchModel') { this.openSettingsWindow('picker'); return; }
+    if (id === 'miniGame') { this.openSettingsWindow('game'); return; }
     /**
      * 重载模型 — re-read the model file and rebuild the scene (operator, 2026-10-14: 「给内置和外置宠物的右键菜单新增“重载模型”
      * 的选项，用来刷新模型」).
@@ -2284,6 +2317,12 @@
    * the widget's own state. "The window is up but the pet is not drawing in it" stays answerable that way, which
    * is the whole reason the host reports the page's own verdict.
    */
+  VrmPet3DWidget.prototype.canUseIndependentPet = function () {
+    // The host can borrow Electron even when it is itself a plain Node process.
+    // Its runtime result, rather than the UI bridge or process type, decides this.
+    return Boolean(this.desktopStatus && this.desktopStatus.electronAvailable === true);
+  };
+
   VrmPet3DWidget.prototype.syncDesktop = function (status, note) {
     var strings = words(this.language);
     this.desktopStatus = status || null;
@@ -2370,6 +2409,7 @@
    * place that knows it. A caller that omits it gets the click pool, which is what an older cached chunk does.
    */
   VrmPet3DWidget.prototype.reactSpeech = function (anatomy, gesture) {
+    if (this.machine && this.machine.state === 'dancing') return null;
     if (!this.speech) return null;
     var random = this.scene && typeof this.scene.random === 'function' ? this.scene.random : null;
     var line = this.speech.react(
@@ -3052,6 +3092,7 @@
    */
   VrmPet3DWidget.prototype.startDance = function (motionId) {
     if (!this.machine || typeof this.machine.setDancing !== 'function') return false;
+    if (['resting', 'offline', 'dancing'].indexOf(this.machine.resolve(this.aggregate.snapshot())) === -1) return false;
     var wanted = typeof motionId === 'string' && motionId ? motionId : null;
     if (!wanted) {
       var ids = this.danceClipIds();
@@ -3080,6 +3121,9 @@
         self.scene.setPreview({ state: 'dancing', motionId: wanted });
       }
     });
+    // Publish the accepted dance immediately, including when this surface is hidden.
+    // The floating window must not wait for the next background animation frame.
+    if (!this.disposed) this.pump();
     return true;
   };
 
@@ -3347,6 +3391,11 @@
       running: snap.running === true,
       working: Number(snap.workingCount) || 0,
       waiting: Number(snap.waitingCount) || 0,
+      statusSessionId: this.machine.state === 'waiting' ? snap.waitingSessionId
+        : (this.machine.notice && this.machine.notice.sessionId) || null,
+      completedSessionId: snap.completedSessionId || null,
+      waitingSessionIds: snap.waitingSessionIds || [],
+      completedSessionIds: snap.completedSessionIds || [],
       unread: Number(snap.unreadCount) || 0,
       /**
        * The breakdown behind that count, as numbers — why the green dot is lit, with no session id or title in it.
@@ -3952,8 +4001,11 @@
       }
     }
 
+    this.acknowledgeVisibleConversation();
     var snapshot = this.aggregate.snapshot();
     var state = this.machine.resolve(snapshot);
+    this.completedUnreadCount = snapshot.completedUnreadCount;
+    if (this.menu && this.menu.setDanceState) this.menu.setDanceState(state);
     // Dance previews belong to the dance lifetime, including work interruption.
     if (this.scene.preview && this.scene.preview.state === 'dancing' && state !== 'dancing') {
       this.scene.setPreview(null);
@@ -3985,11 +4037,13 @@
      */
     var clock = this.machine && typeof this.machine.statusClock === 'function' ? this.machine.statusClock() : null;
     var clockKey = clock ? clock.startedAt + ':' + (clock.endedAt || '') : '';
+    var completedKey = (snapshot.completedSessionIds || []).join(',') + '|' + (snapshot.waitingSessionIds || []).join(',');
     if (state !== this.lastPublishedState || speech !== this.lastPublishedSpeech || touch !== null
-      || clockKey !== this.lastPublishedClockKey) {
+      || clockKey !== this.lastPublishedClockKey || completedKey !== this.lastPublishedCompletedKey) {
       this.lastPublishedState = state;
       this.lastPublishedSpeech = speech;
       this.lastPublishedClockKey = clockKey;
+      this.lastPublishedCompletedKey = completedKey;
       /**
        * `clock` rides along because the window has no turn frames of its own, and the UNREAD count because the window
        * has no session store either: its green dot is DSH's `completionUnread`, which only this half can see.
@@ -3998,7 +4052,7 @@
        * question with an answer (`/vrmpet3d/state`) instead of a guess. See `decisionWhy`.
        */
       if (this.publishState) {
-        this.publishState(state, speech, touch, clock, null, this.machine ? this.machine.unreadCount : 0, this.decisionWhy());
+        this.publishState(state, speech, touch, clock, null, snapshot.completedUnreadCount || 0, this.decisionWhy());
       }
     }
 
@@ -4019,7 +4073,7 @@
     // The TURN clock, not the state's own age: 用时 is a claim about DSH's turn (`PetMachine.statusClock`), and the
     // token is dropped entirely while no turn is open — DSH's own token-free 「深度求索中」.
     var clock = this.machine && typeof this.machine.statusClock === 'function' ? this.machine.statusClock() : undefined;
-    var line = this.core.statusFor(this.preferences, state, this.machine.stateSince, Date.now(), clock, this.language);
+    var line = this.core.statusFor(this.preferences, state, this.machine.stateSince, Date.now(), clock, this.language, this.completedUnreadCount);
     /**
      * A state with no line clears the prompt rather than leaving the previous one up: a caption that
      * outlives its state is how a pet ends up saying 深度求索中 over a finished turn.
@@ -4047,6 +4101,8 @@
      * other, and the attribute is cheap. `data-tone` is what the stylesheet reads, so the colours live in CSS
      * (where the two surfaces can differ) and the DECISION lives in `core.statusFor` (where they cannot).
      */
+    if (['done', 'waiting', 'error'].indexOf(state) !== -1) node.setAttribute('data-attention', '1');
+    else node.removeAttribute('data-attention');
     if (line.tone) node.setAttribute('data-tone', line.tone);
     else node.removeAttribute('data-tone');
     if (line.bold) node.setAttribute('data-bold', '1');
@@ -4074,8 +4130,8 @@
       // The dot is about ANOTHER session's unread completion, so it is drawn from the machine's count and not from
       // the line: the line is what is happening here, the dot is what finished elsewhere.
       if (this.statusDot) {
-        this.statusDot.hidden = !(line.state === 'working'
-          && this.machine && Number(this.machine.unreadCount) > 0);
+        this.statusDot.hidden = !(['working', 'waiting'].indexOf(line.state) !== -1
+          && Number(this.completedUnreadCount) > 0);
       }
     }
     // Every frame, not only when the words change: the caption is anchored to the HEAD, so an orbit, a zoom
@@ -4206,6 +4262,27 @@
     return line;
   };
 
+  VrmPet3DWidget.prototype.openStatusSession = function () {
+    var state = this.machine.state;
+    if (state === 'waiting' || state === 'done') return this.openQueuedSession(state === 'waiting' ? 'waiting' : 'completed');
+    var snap = this.aggregate.snapshot();
+    var id = state === 'waiting' ? snap.waitingSessionId
+      : ((state === 'done' || state === 'error') && this.machine.notice ? this.machine.notice.sessionId : null);
+    if (id) this.openSession(id);
+  };
+
+  VrmPet3DWidget.prototype.openQueuedSession = function (kind) {
+    var snap = this.aggregate.snapshot();
+    var ids = kind === 'waiting' ? snap.waitingSessionIds : snap.completedSessionIds;
+    if (!ids || !ids.length) return null;
+    this.queueCursor = this.queueCursor || {};
+    var index = ids.indexOf(this.queueCursor[kind]);
+    var id = ids[(index + 1) % ids.length];
+    this.queueCursor[kind] = id;
+    this.openSession(id);
+    return id;
+  };
+
   /**
    * Ask the host for a generated line, when the machine has asked for one and nobody has yet.
    *
@@ -4436,22 +4513,27 @@
     // …and a badge the scene wrote is retracted once the scene is happy again (see `retractSceneStatus`).
     this.retractSceneStatus();
 
-    // The aim is measured against the pet's own centre each frame, from the placement
-    // the pet has THIS frame: the cursor can sit anywhere in the window (the listener is
-    // on the document), and the pet can be dragged or falling while it looks. Using the
-    // placement instead of `getBoundingClientRect` keeps this out of layout.
+    // The rendered eyes, rather than the slot's centre, are the zero of the aim.
     if (this.preferences.lookAtPointer && this.pointer) {
       var pixels = this.placement.pixels();
+      var eye = typeof this.scene.gazeOrigin === 'function' ? this.scene.gazeOrigin() : null;
+      var gazeView = this.document && this.document.defaultView;
+      var gazeScreenWidth = Number(gazeView && gazeView.screen && gazeView.screen.width) || this.placement.viewportWidth;
       var aim = this.core.pointerAim({
         pointerX: this.pointer.x,
         pointerY: this.pointer.y,
-        centreX: pixels.left + this.placement.width / 2,
-        centreY: pixels.top + this.placement.height / 2,
+        centreX: pixels.left + (eye ? eye.x * this.placement.width / this.scene.width : this.placement.width / 2),
+        centreY: pixels.top + (eye ? eye.y * this.placement.height / this.scene.height : this.placement.height / 2),
         // The same two settings as the floating window's (the 模型参数 window's 视线 section), with the
-        // same "auto" default: 0 px means this frame's width, which here is the app window.
-        spanX: this.core.resolveGazeSpan(this.preferences.gazeSpanX, this.placement.viewportWidth),
-        spanY: this.core.resolveGazeSpan(this.preferences.gazeSpanY, this.core.GAZE_SPAN.y),
-        curve: this.preferences.gazeCurve
+        // same "auto" default: 0 px means half the screen width for both axes.
+        spanX: this.core.resolveGazeSpan(this.preferences.gazeSpanX, gazeScreenWidth),
+        spanY: this.core.resolveGazeSpan(this.preferences.gazeSpanY, gazeScreenWidth),
+        curve: this.preferences.gazeCurve,
+        curveY: this.preferences.gazeCurveY,
+        curveRadial: this.preferences.gazeCurveRadial,
+        curveSpatial: this.preferences.gazeCurveSpatial,
+        distance: this.preferences.gazeDistance,
+        mode: this.preferences.gazeCurveMode
       });
       this.scene.motion.setGaze(this.scene.gazeFromAim(aim));
     } else {
@@ -4463,15 +4545,30 @@
 
   // ---- session bridge ------------------------------------------------------
 
+  VrmPet3DWidget.prototype.acknowledgeVisibleConversation = function () {
+    var focused = typeof this.document.hasFocus === 'function' ? this.document.hasFocus() : this.machine.focused;
+    if (!focused || this.document.visibilityState === 'hidden' || this.machine.interaction || !this.conversationVisible()) return;
+    // Read the visible conversation on every host update and pump, regardless of how it was opened.
+    var input = this.aggregate.input;
+    this.aggregate.acknowledgeViewed(selectedSessionId(input.catalog) || input.currentSessionId);
+  };
+
   VrmPet3DWidget.prototype.setInput = function (input) {
     this.aggregate.setInput(input);
+    this.acknowledgeVisibleConversation();
     var snapshot = this.aggregate.snapshot();
     this.machine.resolve(snapshot);
   };
 
   VrmPet3DWidget.prototype.boundary = function (event) {
     this.aggregate.boundary(event);
-    this.machine.boundary(this.aggregate.snapshot(), event);
+    if (event && event.sessionId && !this.aggregate.mainSession(event.sessionId)) {
+      this.machine.resolve(this.aggregate.snapshot());
+      return;
+    }
+    this.machine.boundary(this.aggregate.snapshot(), Object.assign({}, event, {
+      confirmed: event && event.reason === 'completed' && this.aggregate.running(event.sessionId) === false,
+    }));
   };
 
   VrmPet3DWidget.prototype.resetAggregate = function (identities) {
@@ -4721,6 +4818,10 @@
 
   function selectedSessionId(catalog) {
     if (!catalog) return undefined;
+    var visible = Object.values(catalog.byId || {}).find(function (row) {
+      return row && row.retainedBy && Number(row.retainedBy.mainView) > 0;
+    });
+    if (visible && typeof visible.id === 'string') return visible.id;
     if (typeof catalog.currentSessionId === 'string') return catalog.currentSessionId;
     if (catalog.selectedSessionId) return catalog.selectedSessionId;
     if (catalog.current && typeof catalog.current.id === 'string') return catalog.current.id;
@@ -5056,6 +5157,18 @@
                    * whenever the settings change (`adoptLanguage`), because `auto` means "whatever DSH says".
                    */
                   locale: ctx.locale,
+                  conversationVisible: function () {
+                    var layout = typeof ctx.get === 'function' ? ctx.get('layout') : ctx.layout;
+                    return !layout || !layout.panelInfo || layout.panelInfo.getSnapshot().activePanelId === null;
+                  },
+                  openSession: function (id) {
+                    var entries = ctx.slots.entries('sidebar.workspaces');
+                    for (var i = 0; i < entries.length; i += 1) {
+                      var injected = typeof entries[i].inject === 'function' ? entries[i].inject() : entries[i].inject;
+                      if (injected && typeof injected.open === 'function') { injected.open(id); return true; }
+                    }
+                    return false;
+                  },
                   onScopeChange: function (scope) { if (changeScope.current) changeScope.current(scope); },
                   /**
                    * Report the state to the host, so the floating window can show the same prompt.
@@ -5073,6 +5186,21 @@
                   }
                 });
                 widgetRef.current = widget;
+                // A browser game opens this explicit query contract in a NEW DSH tab.
+                // Retry until the workspace slot is ready; consume the query only on success.
+                var gameTarget = new URL(globalThis.location.href).searchParams.get('vrmpet3d-session');
+                if (gameTarget && gameTarget.length <= 64) {
+                  var gameAttempts = 0;
+                  var gameNavigation = setInterval(function () {
+                    if (disposed || ++gameAttempts > 60) { clearInterval(gameNavigation); return; }
+                    if (widget.openSession(gameTarget)) {
+                      clearInterval(gameNavigation);
+                      var cleanUrl = new URL(globalThis.location.href);
+                      cleanUrl.searchParams.delete('vrmpet3d-session');
+                      globalThis.history.replaceState(globalThis.history.state, '', cleanUrl.href);
+                    }
+                  }, 250);
+                }
                 widgets.add(widget);
                 setStatus('ready');
               } catch (error) {

package/lib/client.menu.js

@@ -68,6 +68,7 @@
      * whose effect ends by itself (the clip finishes, or the user double-clicks the pet, or work starts).
      */
     'dance',
+    'miniGame',
     /**
      * 重载模型 — refresh the model on screen without touching anything else (operator, 2026-10-14: 「给内置和外置宠物的右键菜单
      * 新增“重载模型”的选项，用来刷新模型」).
@@ -110,10 +111,11 @@
       resetSize: 'Reset size',
       globalSettings: 'General settings',
       switchModel: 'Switch model',
+      miniGame: 'Pet breakout',
     reloadModel: 'Reload model',
     dance: 'Dance for me',
       modelSettings: "This model's parameters",
-      surfaceWindow: 'Move to the floating window',
+      surfaceWindow: 'Switch to an independent pet',
       surfaceApp: 'Move back inside the app',
       surfaceOff: 'disabled while debug mode is on',
       gravity: 'Gravity',
@@ -138,10 +140,11 @@
       resetSize: '重置大小',
       globalSettings: '通用设置',
       switchModel: '切换模型',
+      miniGame: '小游戏 · 吃白饭',
     reloadModel: '重载模型',
     dance: '跳支舞',
       modelSettings: '当前模型参数设置',
-      surfaceWindow: '切换回窗口外',
+      surfaceWindow: '切换为独立宠物',
       surfaceApp: '切换回窗口内',
       surfaceOff: '调试模式下不生效',
       gravity: '重力',
@@ -236,6 +239,7 @@
     var onChoose = typeof options.onChoose === 'function' ? options.onChoose : function () {};
     var toSurface = options.toSurface === 'app' ? 'app' : 'window';
     var surfaceAllowed = options.surfaceAllowed !== false;
+    var danceState = 'resting';
     /** Whether this surface offers the 切换 row at all. See the `showSurface` option. */
     var showSurface = options.showSurface !== false;
 
@@ -262,6 +266,8 @@
 
     /** The label for one id, from the state this menu was built with. */
     function labelFor(id) {
+      if (id === 'dance') return danceState === 'dancing' ? (options.language === 'en' ? 'Another dance' : '换一支舞')
+        : (['resting', 'offline'].indexOf(danceState) === -1 ? (options.language === 'en' ? 'The pet is busy…' : '宠物目前很忙…') : text.dance);
       if (id === 'surface') return toSurface === 'app' ? text.surfaceApp : text.surfaceWindow;
       if (id === 'closePet') return toSurface === 'app' ? text.closePetWindow : text.closePetApp;
       return text[id] || id;
@@ -275,7 +281,8 @@
       ITEMS.forEach(function (id) {
         // The 切换 row is the one entry a surface may omit — the window's 关闭独立宠物 already does its job.
         if (id === 'surface' && !showSurface) return;
-        var disabled = id === 'surface' && surfaceAllowed !== true;
+        var disabled = (id === 'surface' && surfaceAllowed !== true)
+          || (id === 'dance' && ['resting', 'offline', 'dancing'].indexOf(danceState) === -1);
         var toggle = TOGGLES.indexOf(id) !== -1;
         var checked = toggle && checkedState[id] === true;
         var item = doc.createElement('button');
@@ -300,7 +307,7 @@
            * waiting to happen ("the switch does nothing"). The reason is the operator's own qualifier —
            * 非debug模式生效 — spelled out for the mode that turns it off.
            */
-          item.title = text.surfaceOff;
+          item.title = id === 'dance' ? label : text.surfaceOff;
         } else {
           if (toggle && !checked) item.title = text.gravityOff;
           item.addEventListener('click', function (event) {
@@ -456,6 +463,12 @@
       setSurface: function (next) { toSurface = next === 'app' ? 'app' : 'window'; },
       /** Whether that row may be used at all (false in debug mode). */
       setSurfaceAllowed: function (allowed) { surfaceAllowed = allowed !== false; },
+      setSurfaceVisible: function (visible) { showSurface = visible === true; },
+      setDanceState: function (state) {
+        if (danceState === state) return;
+        danceState = state;
+        if (!element.hidden) render();
+      },
       /**
        * Which way a SWITCH row is thrown, read at OPEN time by the surface that owns the preference.
        *