From ec918674eed478bbd9957946bcad7b03be7dbad3 Mon Sep 17 00:00:00 2001
From: CieanYau <ltd@crash.work>
Date: Sat, 7 Nov 2026 02:23:19 +0800
Subject: [PATCH] document the single UI stack and strengthen resize focus
 coverage

---
 README.md                                |  5 +++++
 app/components/PasswordField.vue         |  6 +++---
 app/components/config/ConfigDiskCard.vue |  2 +-
 tests/README.md                          |  1 +
 tests/review-ui-foundation.e2e.test.mjs  | 10 ++++++++++
 5 files changed, 20 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 755f143..9ade37e 100644
--- a/README.md
+++ b/README.md
@@ -29,6 +29,11 @@
 | 源码       | JavaScript、Vue 单文件组件、CSS，Nuxt 配置使用 TypeScript       |
 | 验证工具   | Node.js `node:test`、Playwright、源码检查脚本、ESLint、Prettier |
 
+界面基础统一为 `openvue`、`@openvue/forms`、`@openvue/themes` 1.1.1，不使用 npm alias 或并行 PrimeVue 依赖。
+后台布局移植自 Deni，保留本项目 Nuxt 路由、鉴权、权限菜单、维护条和三态主题；
+不导入模板的演示业务、分析上报或额外图表/图标库。来源与 MIT 许可见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
+主题入口为 `app/config/openvue.js`；OpenVue 上游保留的 `.p-*` 类和 `--p-*` 令牌不是遗留包依赖。
+
 依赖的精确版本以 `package-lock.json` 为准。
 
 ## 快速开始
diff --git a/app/components/PasswordField.vue b/app/components/PasswordField.vue
index 6d96942..7e9c863 100644
--- a/app/components/PasswordField.vue
+++ b/app/components/PasswordField.vue
@@ -1,5 +1,5 @@
 <script setup>
-/** 复用 PrimeVue 的密码/反馈状态，只统一原生输入语义与可键盘访问的显隐操作。 */
+/** 复用 OpenVue 的密码/反馈状态，只统一原生输入语义与可键盘访问的显隐操作。 */
 import { computed, nextTick, ref, useSlots } from "vue";
 import Password from "openvue/password";
 
@@ -22,7 +22,7 @@ const nativeProps = computed(() => ({
 const toggleButton = ref(null);
 async function togglePassword(callback) {
   callback();
-  // PrimeVue切换两个显隐slot时会替换按钮；把焦点交回新按钮，键盘才能连续显示/隐藏。
+  // OpenVue切换两个显隐slot时会替换按钮；把焦点交回新按钮，键盘才能连续显示/隐藏。
   await nextTick();
   toggleButton.value?.focus();
 }
@@ -71,7 +71,7 @@ async function togglePassword(callback) {
 .password-field {
   --password-toggle-size: 44px;
 }
-/* PrimeVue公开的输入样式类位于子组件内；操作宽度与逻辑末端留白必须同源，避免文字被按钮截获。 */
+/* OpenVue公开的输入样式类位于子组件内；操作宽度与逻辑末端留白必须同源，避免文字被按钮截获。 */
 .password-field:has(.password-toggle) :deep(.p-password-input) {
   padding-inline-end: calc(
     var(--password-toggle-size) + var(--p-form-field-padding-x)
diff --git a/app/components/config/ConfigDiskCard.vue b/app/components/config/ConfigDiskCard.vue
index e4525eb..d3c9503 100644
--- a/app/components/config/ConfigDiskCard.vue
+++ b/app/components/config/ConfigDiskCard.vue
@@ -169,7 +169,7 @@ var m = {
             !S.disabled && S.removable && C(`remove`);
           }
           async function I(t) {
-            // PrimeVue 完成内部输入更新后再同步合法值与 aria 状态，避免显示值和实际容量不一致。
+            // OpenVue 完成内部输入更新后再同步合法值与 aria 状态，避免显示值和实际容量不一致。
             (await Promise.resolve(), await nextTick());
             let n = t.originalEvent.target;
             ((n.value = String(O.value)),
diff --git a/tests/README.md b/tests/README.md
index 6e98007..4b0996f 100644
--- a/tests/README.md
+++ b/tests/README.md
@@ -39,6 +39,7 @@ CHROME_PATH=/absolute/path/to/chrome npm test
 - `review-purchase.e2e.test.mjs`：镜像订单未付复用、取消后重建、已付授权延迟不重复收费；级联候选与默认、结算、购物车恢复一致。
 - `review-fields.e2e.test.mjs`：常见 ASCII 规则本地拦截、PCRE 专有规则交后端校验；实例随机密码实际提交及安全源失效、无偏采样边界。
 - `review-theme.e2e.test.mjs`：认证页三态主题文案、持久化与跟随系统变化。
+- `review-ui-foundation.e2e.test.mjs`：OpenVue/Deni 的手机导航焦点约束、Escape/离页关闭、1024/1025 断点与桌面恢复、手机表格字段标签和可操作的窄屏编辑弹窗。
 - `review-style-layout.e2e.test.mjs`：维护条随内容与视口变化、超长通知内部滚动、帮助/购物车/机型/配置摘要吸顶避让，退出布局后的偏移清理与导航单一键盘焦点；首页用户 ID 复制按钮在各宽度下不拆行（该问题只在 Firefox 出现，场景额外启动 Playwright Firefox，需先执行 `npx playwright install firefox`）。
 - `review-style-fields.e2e.test.mjs`：深色商品说明对比度、提现样式隔离、实名认证与转账凭证上传名称；实际升级弹窗的窄屏网格。
 - `review-style-motion.e2e.test.mjs`：实例监控 Canvas 初始/刷新/加载反馈跟随系统减动偏好，并验证偏好切换及离页后无运行时错误。
diff --git a/tests/review-ui-foundation.e2e.test.mjs b/tests/review-ui-foundation.e2e.test.mjs
index f07cbe7..ca674fa 100644
--- a/tests/review-ui-foundation.e2e.test.mjs
+++ b/tests/review-ui-foundation.e2e.test.mjs
@@ -133,6 +133,16 @@ test(
         await page.getByRole("dialog", { name: "主导航", exact: true }).count(),
         0,
       );
+      const link = navigation(page).getByRole("link", {
+        name: "SSH 密钥",
+        exact: true,
+      });
+      await link.focus();
+      assert.equal(
+        await link.evaluate((element) => element === document.activeElement),
+        true,
+        "Desktop navigation is focusable after the overlay closes",
+      );
       return {
         desktopAt1025: true,
         overlayAt1024: true,