From c1be4dcb1e5fd3f55a9a6a01e4c18dbb18c09cd3 Mon Sep 17 00:00:00 2001
From: Joywayer <joywayer@163.com>
Date: Sun, 28 Jun 2026 14:21:46 +0800
Subject: [PATCH] =?UTF-8?q?feat(framework):=20core=20=E5=BA=A7=E4=BD=8D?=
 =?UTF-8?q?=E2=86=94=E8=A7=86=E5=9B=BE=E8=BD=AC=E6=8D=A2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../YouleNexus/assets/framework/core/seat.ts  |  9 ++++++++
 .../framework-tests/core/seat.test.ts         | 21 +++++++++++++++++++
 2 files changed, 30 insertions(+)
 create mode 100644 cocoscreator_projects/YouleNexus/assets/framework/core/seat.ts
 create mode 100644 cocoscreator_projects/framework-tests/core/seat.test.ts

diff --git a/cocoscreator_projects/YouleNexus/assets/framework/core/seat.ts b/cocoscreator_projects/YouleNexus/assets/framework/core/seat.ts
new file mode 100644
index 0000000..5540648
--- /dev/null
+++ b/cocoscreator_projects/YouleNexus/assets/framework/core/seat.ts
@@ -0,0 +1,9 @@
+/** 绝对座位 → 以 mySeat 为视角的视图位（自己=0，其余环形顺延）。 */
+export function toView(mySeat: number, targetSeat: number, seatCount: number): number {
+  return ((targetSeat - mySeat) % seatCount + seatCount) % seatCount;
+}
+
+/** 视图位 → 绝对座位（toView 的逆运算）。 */
+export function fromView(mySeat: number, viewSeat: number, seatCount: number): number {
+  return ((viewSeat + mySeat) % seatCount + seatCount) % seatCount;
+}
diff --git a/cocoscreator_projects/framework-tests/core/seat.test.ts b/cocoscreator_projects/framework-tests/core/seat.test.ts
new file mode 100644
index 0000000..87a1951
--- /dev/null
+++ b/cocoscreator_projects/framework-tests/core/seat.test.ts
@@ -0,0 +1,21 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { toView, fromView } from '../../YouleNexus/assets/framework/core/seat.ts';
+
+test('toView：自己永远是视图 0 号位', () => {
+  assert.equal(toView(2, 2, 4), 0); // mySeat=2, target=2 → 0
+});
+
+test('toView：他人按环形相对自己排布', () => {
+  // 4 人桌，我在 2 号位：座位 3→视图1，座位 0→视图2，座位 1→视图3
+  assert.equal(toView(2, 3, 4), 1);
+  assert.equal(toView(2, 0, 4), 2);
+  assert.equal(toView(2, 1, 4), 3);
+});
+
+test('fromView 是 toView 的逆运算', () => {
+  const seatCount = 4, mySeat = 2;
+  for (let s = 0; s < seatCount; s++) {
+    assert.equal(fromView(mySeat, toView(mySeat, s, seatCount), seatCount), s);
+  }
+});