/*
 * 全站样式。页面先引 reset.css（基础重置），再引这份。
 *
 * 不经过任何构建：浏览器直接读这个文件，改完刷新即生效。
 */

/* ==================== 通用工具类 ==================== */

/*
 * index.html 里直接写在元素上的几个小工具类（只有画布、CRT 层、「未加载 ROM」提示层和
 * 隐藏的文件选择框在用；JS 生成的界面全部用下面的语义类名，不用这些）。
 *
 * 类名和取值照搬 Tailwind CSS v3 的同名工具类（tailwindcss.com/docs 各类名词条），
 * 以前这些由 Tailwind 构建时生成，现在手写在这里，所以 HTML 不用改、画面不变。
 * 新界面请写语义类名，不要往这里加 —— 这一节只为这几处既有标记存在。
 *
 * 放在文件最前面、比后面的组件样式先声明：同等优先级时，组件样式能盖过工具类，
 * 和以前 Tailwind 把工具类插在这份文件开头时的层叠顺序一致。
 */
.hidden { display: none; }
.block { display: block; }
.flex { display: flex; }
.absolute { position: absolute; }
.inset-0 { inset: 0px; }
.w-full { width: 100%; }
.h-full { height: 100%; }
.items-center { align-items: center; }
.justify-center { justify-content: center; }
.pointer-events-none { pointer-events: none; }
.px-4 { padding-left: 1rem; padding-right: 1rem; }
.text-center { text-align: center; }
.text-sm { font-size: 0.875rem; line-height: 1.25rem; }
.text-gray-300 { color: rgb(209 213 219); }
.bg-black\/70 { background-color: rgb(0 0 0 / 0.7); }

/* ==================== 屏幕外围主题 ==================== */

/*
 * 外围（屏幕之外那一层）：中性石墨底 + 一支青强调。
 *
 * 为什么外围不给自己配一套色相：屏幕内是照着 RetroArch Ozone 做的中性灰 + 青
 * （出处见下面 .sys-ui 前那段注释），外围原先是另一套「复古未来」的深紫 + 霓虹紫，
 * 于是同一页上有两套语言 —— 按下键跳出来的紫和菜单里那圈青在互相打架。
 * 现在整页只剩一个色相：背景压成近黑（留两档免得看成死平），
 * 强调色和 Ozone 的选中框 `#2DA3CB` 同族、更亮一档。
 */
:root {
  /* 背景：径向渐变两档 + 极淡网格 */
  --bg-primary: #0B0B0D;   /* 外圈，最深 */
  --bg-accent: #1A1A1E;    /* 中心，抬一档 */
  --stage-grid: rgba(255, 255, 255, 0.025);

  /* 文字 */
  --text-primary: #E2E8F0;
  --text-secondary: #94A3B8;

  /*
   * 强调色：按下描边、拖入 ROM 时的边框、摆放框、摆放按钮。
   * --accent-fill 是它的填充档（按下的底、主按钮底），比 --accent 深一档 ——
   * 半透明的提亮色压在近黑底上会发灰，看不出「按下了」。
   * 需要更淡的地方（hover 底、1px 细边）直接写 rgba(127, 216, 245, …)，同一支换 alpha。
   */
  --accent: #7FD8F5;
  --accent-fill: rgba(89, 198, 232, 0.34);

  /*
   * 手柄那套「材质」：方向键的四片、六个按键、屏幕内的菜单按钮都读这一组，
   * 所以它们看着是一套东西，而不是各自为政的控件。改这里三处一起变。
   * 定义在 :root 而不是 #touch-controls 上，因为菜单按钮住在 .screen 里，
   * 拿不到 #touch-controls 上的变量（自定义属性只往下传，不跨分支）。
   *
   * 唯一的例外是 --pad-line-w：手柄可以整块放大（尺子 --pad-u 见 .stage），
   * 描边不跟着放的话，拨片那条（按盒子缩放）会和按钮那条（固定值）不再等粗，
   * 「一套材质」就破了。所以 #touch-controls 上按同一把尺子重算一遍这条，
   * 屏幕里的菜单按钮继续用这里的 3px（它不参与手柄缩放）。
   */
  --pad-surface: rgba(226, 232, 240, 0.09);
  --pad-line: rgba(148, 163, 184, 0.45);
  --pad-line-w: 3px;
  --pad-press: var(--accent-fill);
  --pad-press-line: var(--accent);
}

/* NES 画布像素化渲染 */
.image-rendering-pixelated {
  image-rendering: pixelated;
  image-rendering: crisp-edges;
}

/*
 * 全站禁用「长按弹出系统菜单」。
 *
 * 手机上玩的时候拇指经常压在按键上不动，浏览器会把这一下当成"长按文本/图片"：
 * Android 弹出复制/保存图画的系统菜单，iOS 弹出 callout 气泡，两种都会把
 * 按键的 pointerup 吞掉，游戏就变成"按住不放一直往前跑"。
 *
 * 三条各管一段，缺一不可：
 * - touch-callout: 只对 iOS 有效，挡的就是那个"按住不放"弹出的系统气泡，
 *   取值 default / none，会往下继承，所以写在 html 上就够了
 *   （出处：MDN「-webkit-touch-callout」，标注为非标准属性，只有 WebKit 系实现 ——
 *   Chromium 在解析阶段就当非法声明丢掉，所以这条只能在 CSS 源文本里验，见踩坑记录）。
 * - user-select: 选不中文字，长按就没有"复制"可给，Android 的菜单少一半触发点
 *   （出处：MDN「user-select」，Safari 需要 -webkit- 前缀）。
 * - contextmenu 事件：Android Chrome 长按直接派发这个事件，CSS 挡不住，
 *   只能在 JS 里 preventDefault（见 app.js）。
 *
 * 全站没有可输入的文本框（只有一个隐藏的 input[type=file]），所以禁选字不影响功能。
 */
html,
body {
  -webkit-touch-callout: none;
  -webkit-user-select: none;
  user-select: none;
  /* 长按时不给手指那块涂高亮（出处：MDN「-webkit-tap-highlight-color」） */
  -webkit-tap-highlight-color: transparent;
}

/* CRT 滤镜效果 - 参考 CRT-Royale 等成熟方案的参数 */
.crt-filter {
  /* 扫描线 - 轻微变暗，不遮挡画面 */
  background-image:
    repeating-linear-gradient(
      to bottom,
      transparent 0px,
      transparent 2px,
      rgba(0, 0, 0, 0.12) 2px,
      rgba(0, 0, 0, 0.12) 3px
    ),
    repeating-linear-gradient(
      to right,
      rgba(255, 0, 0, 0.03) 0px,
      rgba(0, 255, 0, 0.03) 1px,
      rgba(0, 0, 255, 0.03) 2px,
      transparent 3px
    );
  /* 屏幕曲率暗角 - 非常轻微 */
  box-shadow: inset 0 0 60px rgba(0, 0, 0, 0.25);
}

/* CRT 滤镜关闭状态 */
.crt-filter.off {
  display: none;
}

/* ==================== 屏幕内系统界面（Ozone 风格） ==================== */

/*
 * 常驻菜单按钮：固定在屏幕右上角，游戏中半透明、菜单打开时变成不透明。
 *
 * 为什么要有这个按钮：手柄玩家用 SELECT+START、键盘玩家用 Esc，但触摸设备上
 * 用户得先去屏幕外找 ☰ 按钮，视线和手指都要离开游戏区域。放在屏幕内右上角，
 * 手指不用移动太远，且任何时候都在同一位置 —— 菜单开着时它变成「关闭」，
 * 位置不变，用户不用重新找。
 *
 * 位置固定在 .screen 内（不是 .sys-ui 内）：.sys-ui 在菜单关闭时 hidden，
 * 放进那里按钮会跟着消失。
 *
 * 对标：RetroArch 的菜单呼出靠手柄组合键，没有常驻按钮（它面向手柄）。
 * 这里是针对触摸/鼠标的有意增强，不冲突：手柄和键盘的热键照旧可用。
 */

/*
 * 屏幕右上角这一排两颗常驻按钮：左边全屏、右边菜单。位置和大小跟着屏幕缩放
 * （见下面的 --menu-btn-size），摆位和顶栏文字同一行。
 * 放在 .screen 内（不是 .sys-ui 内），因为菜单关闭时 .sys-ui 会 hidden，两颗按钮都得常在。
 * 选择器带 .screen 前缀是必需的：`.touch-btn`（手柄基础样式，3u 圆片，(0,1,0)）
 * 在本规则之后，多一级选择器才能让按钮尺寸只由这里决定。
 *
 * 这两颗不受手柄的尺寸档位影响：它们的宽高由下面的 --menu-btn-size 按画面缩放，
 * 描边也继续用 :root 的 3px（#touch-controls 上那条按尺子重算的 --pad-line-w
 * 传不到这里，因为它们在 .screen 里）。把档位调到最大也不会顶栏跟着胖。
 *
 * 颜色这一处不跟手柄那套材质（见 :root 的 --pad-*），只管摆位、大小、形状和「自带对比」：
 * 手柄的按键压在近黑的页面底上，半透明浅灰描边够用；这两颗压在**游戏画面**上，
 * 底下是什么颜色没人知道。浅色画面时 --pad-line 和画面合成后几乎同色，整颗按钮就消失了。
 */
.screen .touch-menu,
.screen .touch-fs {
  position: absolute;
  /*
   * 与顶栏文字垂直居中对齐：行中线到 .screen 内边盒顶沿 = 1.5 × --screen-font。
   * 实测六种视口（顶栏是 align-items:center 的 flex，行中线即内容盒中线）：
   *   1440x900 / 1024x768 / 844x390 → 25.48 / 17.00 = 1.4988
   *   390x844                      → 18.13 / 12.09 = 1.5000
   *   320x568                      → 14.99 / 10.00 = 1.4990
   * 再用 translateY(-50%) 把按钮中心压到这条线上。
   */
  top: calc(var(--screen-font) * 1.5);
  transform: translateY(-50%);
  /*
   * 按钮占的槽位（内缩距离 + 边长 + 两颗之间的间隙）定义在下面的 .screen 上，
   * 见那里的 --menu-btn-* 说明：顶栏要让出右端给这两颗，两处必须用同一组数，
   * 否则改了按钮尺寸顶栏就让位不足。
   */
  right: var(--menu-btn-inset);
  z-index: 16;
  /* 游戏中略透，菜单打开时不透明（见下面 .screen.menu-open） */
  opacity: 0.85;
  width: var(--menu-btn-size);
  height: var(--menu-btn-size);
  /*
   * 形状跟着屏幕里的其他可点元素（菜单行、分类项都是小圆角方块），
   * 不跟手柄的圆片走：这两颗住在顶栏上，读起来是界面的一部分。
   */
  border-radius: calc(var(--screen-font) * 0.35);

  /*
   * 自带对比的三样东西，从外到内：深色描边 → 浅色描边 → 深玻璃底。
   *
   * 「双色描边」= 外圈一条深色 + 内圈一条浅色。一个颜色做不到在深浅两种背景上都
   * 有 3:1 对比（WCAG 2.2 SC 1.4.11 非文本对比：控件的边界要能从相邻颜色里分出来，
   * 要求 ≥3:1），一深一浅两条则无论画面亮还是暗，总有一条起作用 —— 地图标记和
   * 游戏浮层控件就是这么画的（亮形体描暗边、暗形体描亮边，这里两条都描）。
   * 第二圈用 inset box-shadow 画：再加元素要多套一层 div，outline 画在边框外侧
   * 会把圆角甩在脑后；inset 阴影画在边框的内边缘，不动布局
   * （出处：MDN「box-shadow」的 inset 一节）。
   *
   * 底必须是深色：「菜单」两个字和全屏图标都是浅色，压在 --pad-surface
   * （alpha 0.09 的浅灰）上等于压在画面上，浅色画面里字先消失。
   * 深色取自屏幕外那套石墨的最深一档（`--bg-primary` #0B0B0D 量级），强调青留给按下态。
   *
   * 四档颜色只喂这两颗按钮，声明在按钮上而不是 :root：不和手柄的材质变量混在一起，
   * 改了不牵连方向键和动作键。
   */
  --btn-ring-out: rgba(0, 0, 0, 0.9);
  --btn-ring-in: rgba(255, 255, 255, 0.8);
  --btn-face: rgba(8, 11, 15, 0.92);
  /* 按下色 = 强调青以 0.28 压在深底上合成的不透明值（半透明的 --pad-press 直接盖上去在浅色画面上会发白） */
  --btn-face-press: rgba(41, 69, 79, 0.94);

  background: var(--btn-face);
  border-color: var(--btn-ring-out);
  box-shadow: inset 0 0 0 1px var(--btn-ring-in);
}

/* 菜单按钮是两个字，全屏按钮是一个图标，字号各按内容 */
.screen .touch-menu {
  /* 两个字比「MENU」那四个字母窄，字号给到 0.6 倍字号才不显小 */
  font-size: calc(var(--screen-font) * 0.6);
}

.screen .touch-fs {
  /* 排在菜单按钮左边：让开一颗按钮 + 一份间隙 */
  right: calc(var(--menu-btn-inset) + var(--menu-btn-size) + var(--topbar-btn-gap));
}

/* 图标占按钮内切的一半，留出的边距和「菜单」两个字的视觉重量差不多 */
.screen .touch-fs .fs-icon {
  width: calc(var(--menu-btn-size) * 0.5);
  height: calc(var(--menu-btn-size) * 0.5);
}

/* 进 / 退全屏两个朝向的图标靠 data-on 换（JS 在 fullscreenchange 时写，见 app.js） */
.screen .touch-fs .fs-icon-out {
  display: none;
}

.screen .touch-fs[data-on="true"] .fs-icon-in {
  display: none;
}

.screen .touch-fs[data-on="true"] .fs-icon-out {
  display: inline;
}

.screen.menu-open .touch-menu,
.screen.menu-open .touch-fs {
  opacity: 1;
}

/*
 * 按下反馈：手柄按钮基础样式 `.touch-btn:active` 写的是 `transform: scale(0.92)`，
 * 与本规则优先级相同（0,2,0）且声明在后，会把上面的 translateY(-50%) 整体换掉 ——
 * transform 是单个属性，不叠加。实测按下时按钮中心直接下坠 19.97px（半个按钮高）。
 * 这里用更高一级的选择器把「位移 + 缩放」一起写全，缩放反馈保留、位置不动。
 *
 * 同时把底色和描边也在这里写全：`.touch-btn:active` 那条会把底色换成半透明的强调青、
 * 描边换成强调青，压在浅色画面上都会发白 —— 按下的这一下反而看不见按钮了。
 * 外圈保持深色（按下也要有轮廓），内圈和底改用强调青的两档，反馈靠这两处变亮。
 */
.screen .touch-menu:active,
.screen .touch-fs:active {
  transform: translateY(-50%) scale(0.92);
  background: var(--btn-face-press);
  border-color: var(--btn-ring-out);
  box-shadow: inset 0 0 0 1px var(--accent);
}

/*
 * 结构对标 RetroArch Ozone（docs.libretro.com/guides/ozone/）。
 * 配色直接取自 RetroArch 源码的默认主题 `ozone_theme_dark`
 * （menu/drivers/ozone.c:1220，`ozone->default_theme = &ozone_theme_dark` 见同文件 9817 行），
 * 不是凭印象配的：
 *
 *   background            0x2D2D2D  菜单铺满时的底色
 *   selection             0x212227  选中项填充（比底色更暗，这是 Ozone 的招牌）
 *   selection_border      0x2DA3CB  选中项四边描边（青）
 *   text_selected         0x00D9AE  选中项文字（青绿）
 *   text_sublabel         0x9F9FA1  次要文字
 *   entries_border        0x51514F  列表分隔线
 *   message_background    0x464646  空状态/提示块的底
 *   sidebar_background    0.2,0.2,0.2 = #333333
 *   sidebar_gradient      0.20→0.18 / 0.18→0.20（上下各一条极淡的纵向渐变）
 *   cursor_border_0/1     0x198AC6 / 0x89F1F2（光标动画的两端色）
 *
 * 两个容易做反的地方：
 * 1. **选中项比底色暗**。多数现代 UI 把选中行提亮，Ozone 反过来 ——
 *    填充 #212227 比底色 #2D2D2D 更深，靠青色描边和青绿文字来凸显。
 *    提亮会让它不像 Ozone，所以这里照源码来。
 * 2. **游戏中菜单是半透明的**。源码 `ozone_set_background_running_opacity()`
 *    （ozone.c:1941）注明：framebuffer_opacity 默认 0.900 时，
 *    背景顶部 alpha=1.0、底部 alpha=0.75。所以游戏中呼出菜单能看到后面的
 *    游戏画面，越往下越透 —— 这就是 Ozone「不打断游戏」的观感来源。
 *
 * 变量只在 .sys-ui 作用域内定义：屏幕外是另一套（石墨底 + 强调青，见文件开头），
 * 两边数值不同 —— Ozone 的青是选中框的 #2DA3CB，外围的 #7FD8F5 要压在近黑底上显眼，
 * 混用会互相污染（屏幕内的灰照抄源码，不该被外围的亮青带跑）。
 */

.sys-ui {
  /* Ozone dark 主题色板（定义在 .screen 上，见上方说明） */
  position: absolute;
  inset: 0;
  z-index: 15;
  display: flex;
  flex-direction: column;
  background: var(--oz-bg);
  color: var(--oz-text);
  font-size: var(--screen-font);
  line-height: 1.35;
  user-select: none;
  -webkit-user-select: none;
}

/*
 * 游戏中呼出菜单：换成半透明渐变，后面的游戏画面透出来。
 * 数值对应 Ozone 在默认 framebuffer_opacity(0.9) 下的计算结果：
 * 顶部 alpha = 0.9/0.9 = 1.00，底部 alpha = 2.5*0.9-1.5 = 0.75。
 * 底色用源码里游戏中专用的 0.176/0.178（≈#2D2D2D，和菜单底色同色系）。
 */
.sys-ui[data-running='true'] {
  background: linear-gradient(
    180deg,
    rgba(45, 45, 45, 1) 0%,
    rgba(45, 45, 45, 0.94) 45%,
    rgba(45, 45, 45, 0.75) 100%
  );
  /* 菜单底下有画面，加一点背景模糊让文字更好读（Ozone 无此效果，
   * 属有意增强：网页上游戏画面动得快，纯叠加会干扰阅读） */
  backdrop-filter: blur(2px);
}

.sys-ui[hidden] {
  display: none;
}

/* ---------- 顶部标题栏 ---------- */

.sys-topbar {
  position: relative;
  display: flex;
  align-items: center;
  gap: 0.75em;
  /*
   * 右侧让出右上角那排常驻按钮占的槽位（.touch-fs + .touch-menu 叠在顶栏右端之上，
   * 见 .screen 的 --topbar-menu-slot）。
   * 上下内边距参与顶栏行中线计算，按钮的 top: 1.5 × --screen-font 是据此实测出来的，不要改。
   */
  padding: 0.6em var(--topbar-menu-slot) 0.6em 0.9em;
  /* Ozone 顶栏分隔线是白色，实心太抢眼，按同等观感降到低透明度 */
  border-bottom: 1px solid var(--oz-separator);
  background: var(--oz-sidebar-bg);
  flex: none;
}

.sys-back {
  display: flex;
  align-items: center;
  justify-content: center;
  width: 1.8em;
  height: 1.8em;
  padding: 0;
  border: 1px solid var(--oz-entries-border);
  border-radius: 0.25em;
  background: transparent;
  color: var(--oz-text);
  cursor: pointer;
  flex: none;
  transition: background 0.15s ease, color 0.15s ease;
}

.sys-back:hover {
  background: var(--oz-selection);
  color: var(--oz-text-selected);
}

.sys-back:active {
  transform: scale(0.92);
}

.sys-back svg {
  width: 1em;
  height: 1em;
}

.sys-title {
  font-weight: 800;
  font-size: 1.05em;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--oz-text);
}

/*
 * 顶栏右端徽标：这一层是什么（「游戏中」、某款游戏的名字、「确认」）。
 * 语义是视图属性而不是标题的一部分，所以不放标题旁边，推到右侧和左边的标题拉开
 * —— 和 Ozone 顶栏「主标题在左、次要信息在右」的排法一致。
 * 保持次要文字色、不做成色块：右端已经有两颗常驻按钮，
 * 再加一个填充形状会在同一条窄栏里出现三个抢眼元素。
 * 「多少款游戏」这类数量不在这里，它在菜单左下角（见 .sys-count）。
 */
.sys-badge {
  margin-left: auto;
  flex: none;
  font-size: 0.75em;
  font-weight: 700;
  color: var(--oz-text-sublabel);
  letter-spacing: 0.08em;
  text-transform: uppercase;
  white-space: nowrap;
}

/* ---------- 主体：三栏 ---------- */

.sys-body {
  display: flex;
  flex: 1;
  min-height: 0; /* 不加这行，flex 子项不会收缩，列表溢出后底部提示栏被挤出屏幕 */
}

/* 左侧分类栏：Ozone 的 sidebar 底色，用户指定 #282828 */
.sys-sidebar {
  display: flex;
  flex-direction: column;
  gap: 0.25em;
  flex: none;
  width: 30%;
  min-width: 4.5em;
  max-width: 9em;
  padding: 0.5em;
  background: var(--oz-sidebar-bg);
  border-right: 1px solid var(--oz-separator);
  overflow-y: auto;
  /*
   * 分类放不下时要能上下推，但不给滚动条留位置：屏幕本来就窄，
   * 滚动条会吃掉十几个像素，而且一列图标旁边竖条看着像坏了。
   * 光标移到哪一项，那一项自己会滚进视野（见 screen-ui.js 的 scrollIntoView）。
   */
  scrollbar-width: none; /* Firefox */
}

.sys-sidebar::-webkit-scrollbar {
  display: none; /* Chrome / Safari / WebView */
}

.sys-sidebar[hidden] {
  display: none;
}

.sys-nav-item {
  display: flex;
  align-items: center;
  gap: 0.5em;
  padding: 0.5em 0.55em;
  border: 1px solid transparent;
  border-radius: 0.15em;
  background: transparent;
  color: var(--oz-text);
  font: inherit;
  font-weight: 600;
  text-align: left;
  cursor: pointer;
  transition: background 0.15s ease, border-color 0.15s ease;
}

.sys-nav-item:hover {
  background: rgba(255, 255, 255, 0.06);
}

/*
 * 选中态照 Ozone 的 ozone_draw_selection（ozone.c:3305）：
 * 深色填充 + 四边青色描边 + 青绿文字。
 *
 * 但「描边」只画在焦点所在的那一栏（焦点区见 .sys-ui[data-focus]，
 * 由 screen-ui.js 每次重绘写上来）。带分类栏的菜单里两处同时有选中项：
 * 分类栏的当前分类 + 该分类列表的光标行。两边都描边就看不出方向键
 * 此刻动的是哪一栏，所以分类只保留填充色当「当前分类」，框给焦点。
 */
.sys-nav-item.selected {
  background: var(--oz-selection);
  color: var(--oz-text-selected);
}

.sys-ui[data-focus="sidebar"] .sys-nav-item.selected {
  border-color: var(--oz-selection-border);
}

.sys-nav-icon {
  display: flex;
  flex: none;
  width: 1.15em;
  height: 1.15em;
}

.sys-nav-icon svg {
  width: 100%;
  height: 100%;
}

.sys-nav-label {
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

/* 中间条目列表 */
.sys-content {
  display: flex;
  flex-direction: column;
  flex: 1;
  min-width: 0;
  overflow: hidden;
}

.sys-list {
  flex: 1;
  margin: 0;
  padding: 0.4em;
  list-style: none;
  overflow-y: auto;
  overscroll-behavior: contain;
}

.sys-item {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 0.6em;
  padding: 0.5em 0.6em;
  border: 1px solid transparent;
  border-radius: 0.15em;
  cursor: pointer;
  transition: background 0.12s ease, border-color 0.12s ease;
}

.sys-item:hover {
  background: rgba(255, 255, 255, 0.06);
}

/*
 * 列表光标行的样式和分类栏同理：只有焦点在列表上时才画。
 * 焦点在分类栏时这一行什么都不标，整块界面只有一个框（见 .sys-nav-item.selected）。
 * 没有分类栏的菜单（快速菜单、存档槽位…）焦点永远在列表上，样式照旧。
 */
.sys-ui[data-focus="list"] .sys-item.selected {
  background: var(--oz-selection);
  border-color: var(--oz-selection-border);
}

.sys-item-main {
  min-width: 0;
  flex: 1;
}

.sys-item-label {
  font-weight: 600;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

.sys-ui[data-focus="list"] .sys-item.selected .sys-item-label {
  color: var(--oz-text-selected);
}

/* 次要文字用 Ozone 的 sublabel 灰（#9F9FA1，在 #2D2D2D 上对比度 5.2，达 AA） */
.sys-item-sub {
  font-size: 0.78em;
  color: var(--oz-text-sublabel);
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

.sys-item-value {
  flex: none;
  font-size: 0.85em;
  font-weight: 700;
  color: var(--oz-text);
  white-space: nowrap;
}

.sys-ui[data-focus="list"] .sys-item.selected .sys-item-value {
  color: var(--oz-text-selected);
}

.sys-empty {
  padding: 1em;
  text-align: center;
  color: var(--oz-text-sublabel);
  font-size: 0.85em;
  background: var(--oz-message-bg);
  border-radius: 0.2em;
  margin: 0.4em;
}

/* 右侧详情栏 */
.sys-detail {
  flex: none;
  width: 34%;
  max-width: 12em;
  padding: 0.7em;
  border-left: 1px solid var(--oz-separator);
  overflow-y: auto;
}

.sys-detail[hidden] {
  display: none;
}

.sys-detail-row {
  display: flex;
  justify-content: space-between;
  gap: 0.5em;
  padding: 0.2em 0;
  font-size: 0.82em;
}

.sys-detail-key {
  color: var(--oz-text-sublabel);
  flex: none;
}

.sys-detail-val {
  color: var(--oz-text);
  text-align: right;
  word-break: break-word;
}

.sys-detail-empty {
  margin: 0;
  font-size: 0.82em;
  color: var(--oz-text-sublabel);
  line-height: 1.5;
}

/* ---------- 底部提示栏（只在菜单里） ---------- */

/*
 * 底栏两样东西：左边「当前列表有多少项」（.sys-count），右边「现在能按什么」
 * 的按键图例（.sys-hints，用户要求靠右排）。整栏是 .sys-ui 的子元素：菜单关掉
 * 整栏跟着消失，不用谁手动清空，也不用为它在屏幕外留位置。
 *
 * 默认 flex-end：绝大多数菜单没有数量可说，这时 .sys-count 整块隐藏，图例照旧贴右。
 * .sys-count 用 margin-right: auto 把自己顶到最左 —— 有数量时左数量、右图例，
 * 没数量时不会把图例一起拽到左边。
 *
 * 不换行（nowrap）：换行会把这一栏撑高、列表挤矮。真挤不下时靠自己的
 * overflow: hidden 裁掉最左一条 —— 宁可少一条提示，也不让布局上下抖。
 */
.sys-hintbar {
  display: flex;
  flex-wrap: nowrap;
  align-items: center;
  justify-content: flex-end;
  gap: 0.4em 0.9em;
  flex: none;
  box-sizing: border-box;
  padding: 0.3em calc(var(--screen-font) * 0.6);
  border-top: 1px solid var(--oz-separator);
  overflow: hidden;
}

/*
 * 左下角这一格只写「当前这个列表有多少项」（如「9 款」）。放在底栏而不是顶栏右端：
 * 顶栏右端已经有全屏 + 菜单两颗常驻按钮，再挤一段文字，三个元素挤在一条窄栏里。
 * 没有数量可说（大多数子菜单）就整块隐藏，不占栏高。
 */
.sys-count {
  flex: none;
  margin-right: auto;
  font-size: 0.78em;
  font-weight: 700;
  color: var(--oz-text-sublabel);
  letter-spacing: 0.08em;
  white-space: nowrap;
  overflow: hidden;
  text-overflow: ellipsis;
}

.sys-count[hidden] {
  display: none;
}

/* ---------- 一次性提示（toast） ---------- */

/*
 * 系统提示（"已保存到 1 号槽位"、报错、"正在读取…"）改成显示完就消失的一次性提示：
 * 游戏画面不需要一条一直在的状态栏。
 *
 * 三个摆位理由：
 * - 挂在 .screen 上而不是 .sys-ui 里 —— 菜单关着时它还得能弹出来。
 * - 顶部居中 —— 底部在手机上会被虚拟手柄叠住，顶部不会；z-index 压在 .sys-ui（15）
 *   之上，菜单开着也能看见；top 从顶栏下沿起算（顶栏约 2.55em + 1px 分隔线），
 *   不跟标题抢地方。
 * - pointer-events: none —— 它只是给人看的，不该挡住下面按得动的东西。
 *
 * 计时交给 CSS：一条 --toast-ms 的动画演完就收，JS 只换文案并重播动画
 * （没有 setTimeout，也就没有「新消息被上一条的定时器提前收掉」这类坑）。
 */
.toast {
  --toast-ms: 2.8s;
  --toast-ms-long: 6s;

  position: absolute;
  left: 50%;
  top: calc(var(--screen-font) * 3.1);
  transform: translateX(-50%);
  z-index: 20;
  max-width: calc(100% - var(--screen-font) * 2);
  box-sizing: border-box;
  padding: 0.35em 0.85em;
  border: 1px solid var(--oz-separator);
  border-radius: 0.3em;
  /* 取自 --oz-sidebar-bg（#282828），压到 0.92 让它浮在画面上而不是一块死黑 */
  background: rgba(40, 40, 40, 0.92);
  /* 菜单开着时它压在列表行之上，只靠描边分不清谁在前面，补一层投影 */
  box-shadow: 0 0.15em 0.7em rgba(0, 0, 0, 0.55);
  color: var(--oz-text);
  font-size: var(--screen-font);
  line-height: 1.35;
  text-align: center;
  /*
   * 允许换行：报错类消息要把「哪儿失败了、怎么修」说完，一行放不下。
   * 原先是 nowrap + ellipsis，手机上「非 HTTPS 地址下浏览器禁用了网页音频…」
   * 被截成半句话，玩家看到的是一句看不懂也修不了的话。
   */
  white-space: normal;
  overflow-wrap: break-word;
  pointer-events: none;
  user-select: none;
  -webkit-user-select: none;
  animation: toast-life var(--toast-ms) ease forwards;
}

.toast[hidden] {
  display: none;
}

/* 报错 / 没做成的消息：同一条动画，只是走得更慢（停留约两倍时间） */
.toast-important {
  animation-duration: var(--toast-ms-long);
}

/* 进出场用 margin-top 位移（transform 已经被水平居中占用了） */
@keyframes toast-life {
  0% {
    opacity: 0;
    margin-top: calc(var(--screen-font) * -0.4);
  }
  7%, 86% {
    opacity: 1;
    margin-top: 0;
  }
  100% {
    opacity: 0;
    margin-top: calc(var(--screen-font) * -0.4);
  }
}

/*
 * 按键图例：一组 = 一串键帽 + 一句「这么按是干什么」。
 * .sys-hints 是底栏右侧那个容器，图例条目排在这里面。
 */
.sys-hints {
  display: flex;
  flex-wrap: nowrap;
  align-items: center;
  gap: 0.4em 0.9em;
}

.sys-hint {
  display: inline-flex;
  align-items: center;
  gap: 0.3em;
  font-size: 0.78em;
  color: var(--oz-text-sublabel);
  white-space: nowrap;
}

.sys-hint-keys {
  display: inline-flex;
  gap: 0.15em;
}

.sys-hint kbd {
  font-family: inherit;
  font-size: 0.92em;
  font-weight: 700;
  padding: 0.05em 0.35em;
  border: 1px solid var(--oz-entries-border);
  border-radius: 0.2em;
  background: var(--oz-message-bg);
  color: var(--oz-text);
}

/*
 * 窄屏（手机竖屏下的屏幕区域）：屏幕本身只有 300px 上下宽，
 * 三栏挤在一起每栏只剩几十像素，文字全被截断。
 *
 * 这里只把详情栏挪到列表下面一行，**分类栏仍然竖着排**。
 * 曾经的做法是把分类栏横过来当顶部标签，被否掉了：一级分类是「我在哪儿」的位置感，
 * 横排之后六个标签挤在一行里放不下，光标移到「关于」时看不出自己离起点有多远。
 * 放不下就上下推（见 .sys-sidebar 的 overflow-y + 藏滚动条）。
 *
 * 注意：这里不能用 `.sys-body` 的 `flex-wrap: wrap` 来换行。换行的 flex 容器在
 * 「内容比容器高」时不会收缩那一行（align-content 只在有余量时拉伸），
 * 结果侧栏和列表都按内容长到 527px、直接被 `.screen` 裁掉，看着像没反应，实际是溢出。
 */
@container (max-width: 420px) {
  .sys-sidebar {
    /* 竖排要占宽度，按百分比给，同时保证五个字放得下 */
    width: 36%;
    min-width: 6em;
    max-width: none;
  }

  /* 详情栏显示时改成上下排：横着切会把宽度分成三条，每栏几十像素，键值对全断行。
     用 :has() 挑「真的带详情栏」的那一次——详情栏只在子菜单（存档槽位）里出现，
     那时分类栏本来就是隐藏的，上下排不会浪费侧栏位置。 */
  .sys-body:has(> .sys-detail:not([hidden])) {
    flex-direction: column;
  }

  .sys-detail {
    width: auto;
    max-width: none;
    max-height: 40%;
    border-left: none;
    border-top: 1px solid var(--oz-separator);
  }
}

/* 未加载 ROM 时的提示：在系统界面之下 */
#canvas-overlay {
  z-index: 5;
}

/* ==================== 布局：画面最大化 ==================== */

/*
 * 目标：画面在任何分辨率下都取「视口内能放下的最大 4:3 矩形」，
 * 完整可见、不溢出；界面不占用画面高度，而是放进画面之外的空间。
 *
 * 为什么这样做：
 * 画面是 4:3，屏幕比例却五花八门，所以画面铺满一屏后必然在某个方向留下余量
 * ——宽屏（16:9 等）左右有余量，竖屏（手机）下方有余量。如果让界面跟画面上下
 * 分屏，界面就会吃掉画面高度（实测吃掉 216~268px，占屏高 20%~30%）。
 * 把界面挪进这些余量区，画面就能吃到理论最大值。
 *
 * 对标来源：
 * - MDN《Understanding and setting aspect ratios》：aspect-ratio 定义盒子的首选
 *   宽高比，宽高只需给出一个，另一个由比例推出。
 * - MDN《min()》：min() 取逗号列表中的最小值，允许混用不同单位，用于表达
 *   「尽量占满，但不超过上限」。
 * - MDN《<length>》视口单位章节：原文写明 vh 等价于 lvh（大视口单位），
 *   浏览器界面展开时内容可能被遮挡；dvh 随浏览器界面显隐实时更新，
 *   适合要求「完整可见」的布局。
 * - MDN《<length>》容器查询单位章节 +《container-type》：cqw / cqh 是
 *   相对「查询容器」尺寸的单位（1cqw = 容器宽度的 1%），容器查询单位
 *   自 Chrome 105 / Firefox 110 / Safari 16 起为 Baseline 广泛可用。
 * - MDN《CSS container queries》：@container 支持 min/max-aspect-ratio 条件，
 *   也可用 and 组合。本文件用它按「视口比 4:3 宽还是窄」切换界面位置。
 *
 * 为什么不用 object-fit: contain：canvas 的固有比例是 256:240（即 16:15），
 * 而 NES 要按 4:3 拉伸显示（当年的美术就是按 4:3 的非方形像素设计的）。
 * contain 会保住 16:15 而在左右留黑边，恰好破坏我们要的 4:3 拉伸效果，
 * 因此这里有意不使用它，改用默认的填充行为。
 */

/*
 * 舞台：铺满整个视口，画面居中，界面绝对定位在其中。
 * 同时作为「尺寸查询容器」，让内部用 cqw / cqh 表达尺寸。
 *
 * 必须用 height 而不是 min-height：container-type: size 会施加尺寸包含，
 * 而 cqh 要求容器高度「确定」；用 min-height 时高度不确定，cqh 会解析成 0，
 * 画面宽高都算成 0、整个画面消失（实测 9 种分辨率全部 0x0）。
 */
.stage {
  position: relative;
  width: 100vw;
  height: 100dvh;
  container-type: size;
  overflow: hidden;

  /*
   * 手柄的尺子：--pad-u。虚拟按键的每一个长度都写成「几个 u」，所以换档位是整块等比
   * 放大，不会出现键大了、缝没大、拨片描边还是原来那么粗的走形。
   *
   * 为什么用变量而不是各处写死 rem：三档要改的是一整族长度（臂格、键径、两处间距、
   * 两颗胶囊、字号、内边距、描边粗），写死就得上下改十几处，漏一处就不等比。
   *
   * 三档取值（小档就是尺寸档位加进来之前手柄的实际尺寸，一像素没变）：
   *   小 16px —— 键径 48px、十字块 132px 见方、胶囊 56×28px、手柄本体高 171px
   *   中 19px —— 键径 57px（+19%）、十字块 156.8px、胶囊 66.5×33.3px、高 203px【默认】
   *   大 22px —— 键径 66px（+38%）、十字块 181.5px、胶囊 77×38.5px、高 235px
   * 封顶停在 22px 的理由：真 NES 手柄的 A/B 键直径约 10mm，66px 折算回来正好是这个
   * 量级 —— 大档是「按起来像真手柄」，不是「占满半屏」。再往上两块键区的宽度就要
   * 超过一部手机的宽度，拇指落点和摆放模式都变得别扭。
   *
   * min(…, 100vw / 19) 是**宽度封顶**：横屏和桌面拿满档位，窄竖屏自动收小。
   * 分母 19 是整屏横向要放下的东西（单位都是 u）：左右两块各 8.25u（十字键和三行
   * 圆键本来就是同宽，见下面两处推导）= 16.5u，容器左右内边距各 1u = 2u，
   * 两块之间最少留 0.5u 的缝，合计 19u。封顶之后「两块不相撞、不跑出屏幕」
   * 是算出来的，不是人肉调出来的。折算：320px 宽封顶 ≈ 16.8px（中档和大档在那里
   * 看着差不多大，这是物理限制），390px ≈ 20.5px，414px ≈ 21.8px，横屏拿得满。
   *
   * 尺子为什么定义在 .stage 而不是 #touch-controls：画面（.screen）也要知道手柄有多高
   * （见上面 @container 那条「靠上多少」的算式），而 .screen 是 #touch-controls 的
   * 兄弟，拿不到它下面的变量（自定义属性只往下传，不跨分支）。
   * 100vw 就是 .stage 自己的宽（它 width: 100vw），不用 cqw 是因为容器查不了自己。
   */
  --pad-u-base: 16px;
  --pad-u: min(var(--pad-u-base), calc(100vw / 19));

  /*
   * 屏幕内界面的基准字号。定义在这里（而不是 .sys-ui 上）是因为有三个消费者：
   *   .sys-ui    菜单本体
   *   .touch-menu 屏幕内的菜单按钮（在 .screen 内，不在 .sys-ui 内）
   *   .toast     一次性提示（同理，挂在 .screen 上，菜单开关都要能显示）
   * 三者都需要同一个基准，才能保证按钮、菜单和提示视觉一致。
   * 3.1cqw 相对 .stage 宽度，即视口宽度。
   */
  --screen-font: clamp(10px, 3.1cqw, 17px);

  /* 外围背景：石墨渐变 + 极淡网格（网格只到「看得出是工作台」，不当装饰层） */
  background:
    repeating-linear-gradient(
      0deg,
      transparent 0px,
      transparent 40px,
      var(--stage-grid) 40px,
      var(--stage-grid) 41px
    ),
    repeating-linear-gradient(
      90deg,
      transparent 0px,
      transparent 40px,
      var(--stage-grid) 40px,
      var(--stage-grid) 41px
    ),
    radial-gradient(ellipse at center, var(--bg-accent) 0%, var(--bg-primary) 70%);
}

/*
 * 画面：视口内能放下的最大 4:3 矩形。
 * 宽取「容器宽」与「容器高换算出的宽」中的较小者，高由比例推出。
 * 宽屏时高度是瓶颈（左右留余量），竖屏时宽度是瓶颈（下方留余量）。
 */
.screen {
  position: absolute;
  left: 50%;
  top: 50%;
  transform: translate(-50%, -50%);
  width: min(100cqw, calc(100cqh * 4 / 3));
  aspect-ratio: 4 / 3;
  overflow: hidden;

  /*
   * Ozone 色板定义在屏幕容器上（不是 .sys-ui 上）：屏幕内的消费者不止菜单本体 ——
   * 系统菜单 .sys-ui、菜单按钮 .touch-menu、一次性提示 .toast 都要用同一套色。
   * 后两个必须在菜单关闭时也可见，不能放进 .sys-ui（那里 hidden 时整个子树都不显示）。
   * 定义在共同祖先 .screen 上，三方都能取到，也不必各写一份色值。
   */
  --oz-bg: #2d2d2d;
  --oz-selection: #212227;
  --oz-selection-border: #2da3cb;
  --oz-text-selected: #00d9ae;
  --oz-text: #ffffff;
  --oz-text-sublabel: #9f9fa1;
  --oz-entries-border: #51514f;
  --oz-message-bg: #464646;
  --oz-sidebar-bg: #282828;
  --oz-cursor-0: #198ac6;
  --oz-cursor-1: #89f1f2;
  --oz-separator: rgba(255, 255, 255, 0.16);

  /*
   * 右上角那排常驻按钮（全屏 + 菜单）占的槽位。系数只能按 --screen-font 取值，不能用 rem：
   * rem 相对根字号（固定 16px）不随画面缩放，而位置按 --screen-font 缩放，
   * 两套基准不同步 —— 之前在小屏上按钮会越出 .screen 上沿（390x844 超 1.2px、
   * 320x568 超 3.9px）。系数按桌面观感（--screen-font = 17px）换算：40px → 2.35 倍。
   * 定义在这里而不是 .screen .touch-menu 里，是因为顶栏的右内边距也要用到同一组数
   * （--topbar-menu-slot），一处改动两处同步。
   */
  --menu-btn-inset: calc(var(--screen-font) * 0.9);
  --menu-btn-size: calc(var(--screen-font) * 2.35);
  /* 两颗按钮之间、以及顶栏文字到按钮之间的避让间隙（同一个数，三处共用） */
  --topbar-btn-gap: calc(var(--screen-font) * 0.45);
  /* 顶栏右端让位 = 按钮内缩 + 两颗按钮边长 + 两份间隙 */
  --topbar-menu-slot: calc(var(--menu-btn-inset) + var(--menu-btn-size) * 2 + var(--topbar-btn-gap) * 2);

  /* 屏幕外壳：深色边框，在明亮背景上清晰区分屏幕区域 */
  border: 3px solid #2d3748;
  border-radius: 12px;
  /* 多层阴影：外壳厚度 + 投影 + 高光 */
  box-shadow:
    /* 外壳内侧倒角 */
    inset 0 0 0 1px rgba(0, 0, 0, 0.08),
    /* 外壳外侧倒角 */
    0 0 0 1px rgba(255, 255, 255, 0.4),
    /* 主投影 */
    0 8px 24px rgba(0, 0, 0, 0.15),
    /* 近距离补影 */
    0 2px 6px rgba(0, 0, 0, 0.08),
    /* 顶部高光 */
    0 -1px 0 rgba(255, 255, 255, 0.6);
}

/*
 * 竖屏（比 4:3 窄）：画面靠上，只留 8px 缝隙，不要垂直居中。
 * 居中会把余量平分到上下两半，而触摸手柄是按「整个下方区域」底部定位的，
 * 结果手柄会往上压住画面下半部分（实测手机竖屏遮挡 94%）。
 * 靠上后余量全部集中到下方，手柄摆在那块余量里，两边都不挡。
 */
@container (max-aspect-ratio: 4/3) {
  /*
   * 8px 是「别顶着屏幕边」，不是想挪出多少空间。再多就不行了：能挪的量只有
   * 手柄用剩的空白 —— 手柄要吃掉块高 12.7u（两块同构：簇 8.25u + 键行距 0.7u
   * + 扁条 1.75u = 10.7u，左列是十字键 + SELECT，右块是五键簇 + START；
   * 再加容器上下各 1u 内边距）
   * 加离底边的抬升（180px 减掉容器自己的 1u 内边距），合计 11.7u + 180px。
   * 空白 = 视口高 - 画面高，画面高 = 画面宽 × 3/4
   * = min(75cqw, 100cqh)（4:3 里宽是长边，别拿画面宽当高）。
   * 空白不够的窗口这里算出负数、被 max 夹成 0，画面退回贴顶。
   * 手柄档位调大时这里的减数跟着长（画面就往顶上多让一点），两边用的是同一把尺子。
   */
  .screen {
    top: min(8px, max(0px, calc(100cqh - min(75cqw, 100cqh) - 180px - 11.7 * var(--pad-u))));
    transform: translate(-50%, 0);
  }
}

/*
 * 拖入 .nes 文件时给屏幕描一圈边：整页都是投放区，没有专门的投放框，
 * 所以用「画面被框住了」表示「现在松手就会载入」（操作必须有反馈）。
 * 用 outline 而不是改 border/box-shadow：.screen 的边框宽度和那几层阴影是
 * 外壳造型，改一下外壳就塌了；outline 不占布局，跟着 border-radius 走。
 */
.stage.dragging .screen {
  outline: 3px solid var(--accent);
  outline-offset: -3px;
}

/* 按钮点击反馈 */
button:active {
  transform: scale(0.96);
}

/* 按钮加载状态 */
button.loading {
  opacity: 0.5;
  pointer-events: none;
}

/* ==================== 触摸手柄 ==================== */

/*
 * 手柄的尺子 --pad-u 定义在 .stage（三档取值、宽度封顶的推导都在那里），
 * 因为画面也要按手柄有多高来让位，而画面是 #touch-controls 的兄弟。
 *
 * 这里只重算一条：描边粗。拨片那条描边是 viewBox 单位、按盒子缩放，
 * 按钮这条是绝对长度；尺子一改，两者就不再等粗，「一套材质」就破了。
 * 0.1875u 在小档正好是 3px（= :root 那个值），所以小档一像素没变。
 * 屏幕内那两颗按钮（菜单/全屏）住在 .screen 里，拿不到这里的覆盖，
 * 继续用 :root 的 3px —— 它们是界面控件，不参与手柄缩放。
 *
 * 取整到整像素是必需的，不是讲究：**边框宽度浏览器会向下取整**（实测 3.56px→3、
 * 3.85px→3），而 SVG 描边不取整（照 3.85px 画）。放任算式给小数，中/大档就会
 * 「键的圈比十字细一截」。round 到最近整数后两边最多差半像素，取整误差从 0.86px
 * 收到 0.44px（verify-dpad 那条「等粗」判的是 0.6px）。
 */
#touch-controls {
  display: none;
  position: absolute;
  bottom: 0;
  left: 0;
  right: 0;
  z-index: 25;
  padding: var(--pad-u);
  --pad-line-w: round(nearest, calc(var(--pad-u) * 0.1875), 1px);
  pointer-events: none;
}

/* 三档：换掉那把尺子。data-pad-size 由 touch-layout.js 按设置 controls.padSize 写上来 */
.stage[data-pad-size="medium"] { --pad-u-base: 19px; }
.stage[data-pad-size="large"] { --pad-u-base: 22px; }

/* 仅在触摸设备显示 */
@media (pointer: coarse) {
  #touch-controls {
    display: flex;
    justify-content: space-between;
    align-items: flex-end;
  }
}

/*
 * 左手这块：方向键 + 它下面的 SELECT。
 * 分成左右两块的依据是「谁用哪个拇指」：左手方向和 SELECT，右手动作键和 START，
 * 两块都各自是一个整块，摆放模式按块拖（见 touch-layout.js 的 DRAG_UNITS）。
 * pointer-events 在这里打开：容器 #touch-controls 是 none，
 * SELECT/START 两颗按钮自己没有写 pointer-events，靠这块给它们可点。
 *
 * 网格只有两列，列宽由十字键撑出来（每列 4.125u）；SELECT 跨两列居中，
 * 于是它落在十字键正下方，不会歪到某一侧。
 */
.touch-dpad-group {
  display: grid;
  grid-template-columns: repeat(2, auto);
  gap: calc(var(--pad-u) * 0.7);
  justify-items: center;
  align-items: center;
  pointer-events: auto;
}

/*
 * 十字键：四片软拨片拼成的方向面，边长 = 3 个臂宽，每个臂格 2.75u（小档 44px，触摸目标下限）。
 * 按下去算的是「指针相对中心的角度」，四个方向各占 ±22.5° 的扇区；
 * 斜向不归扇区管，归外切圆上那四段独立弧键（.dpad-diag）—— 按在两片之间的空白什么都不给。
 * 判定见 input-manager.js 的 attachTouchDpad，臂的方位由 data-action + 实际位置现算。
 *
 * 容器 pointer-events: none，命中交给子元素（.touch-dpad-hit、四个臂、弧键的命中带）：
 * 摆放模式的拦截挂在这个容器的捕获阶段，只有当事件目标是它的后代，
 * 拦截才会发生在目标收到事件之前。容器自己能被点中的话，那条拦截就形同虚设。
 */
.touch-dpad {
  --pad-arm: calc(var(--pad-u) * 2.75);
  grid-column: 1 / 3;
  grid-row: 1;
  position: relative;
  display: grid;
  grid-template-columns: repeat(3, var(--pad-arm));
  grid-template-rows: repeat(3, var(--pad-arm));
  width: calc(var(--pad-arm) * 3);
  height: calc(var(--pad-arm) * 3);
  pointer-events: none;
  user-select: none;
  -webkit-user-select: none;
  /* 方向键要「按住滑动换向」，必须让浏览器别把滑动当成页面滚动/缩放手势 */
  touch-action: none;
}

/* 命中层：铺满整块十字（含四角），保证斜向按得到 */
.touch-dpad-hit {
  grid-column: 1 / 4;
  grid-row: 1 / 4;
  pointer-events: auto;
  touch-action: none;
}

/*
 * 四个臂格子只是「哪个方向占哪块位置」的声明与命中区（方位由 JS 现量），
 * 不画东西；按下的反馈点亮的是下面 SVG 里对应的那一片。
 */
.touch-dpad-arm {
  pointer-events: auto;
  touch-action: none;
}

.touch-up { grid-column: 2; grid-row: 1; }
.touch-left { grid-column: 1; grid-row: 2; }
.touch-right { grid-column: 3; grid-row: 2; }
.touch-down { grid-column: 2; grid-row: 3; }

/* 外形画在臂上面（玻璃质感：亮的是底下那层，轮廓始终清楚） */
.touch-dpad-face {
  position: absolute;
  inset: 0;
  z-index: 3;
  width: 100%;
  height: 100%;
  pointer-events: none;
}

/*
 * 四片拨片：外端扁弧接一段直边，再直直收成圆头尖，尖都指向中心，片之间的缝指向斜向。
 * 描边粗用 viewBox 单位，换算要看取景框：框边长 93.52（见 index.html），格子 8.25u，
 * 1 单位 = 8.25u/93.52 ≈ 0.0882u，所以 2.13 单位 ≈ 0.1875u —— 正是 --pad-line-w
 * 那个倍数。按钮那边把同一个倍数取整到整像素（浏览器本来就会把边框宽度向下取整），
 * 两边最多差半像素，手柄放大多少倍都不脱钩。
 * 反推：要外缘铺满格子，框得内缩「拨片最外缘 4.3 − 半个描边」，
 * 而描边折算成 px 又要等于 --pad-line-w —— 两个条件联立才得到 93.52 / 2.13 这一对数。
 * 格子大小（--pad-arm）或描边粗（--pad-line-w）改比例时要重算这两个数。
 */
.dpad-blade {
  fill: var(--pad-surface);
  stroke: var(--pad-line);
  stroke-width: 2.13;
  stroke-linejoin: round;
  transition: fill 0.08s ease, stroke 0.08s ease;
}

/* 按下的那一片整片亮起（data-active 由 attachTouchDpad 写成「UP DOWN」这样的动作列表） */
.touch-dpad[data-active~="UP"] .dpad-blade-up,
.touch-dpad[data-active~="DOWN"] .dpad-blade-down,
.touch-dpad[data-active~="LEFT"] .dpad-blade-left,
.touch-dpad[data-active~="RIGHT"] .dpad-blade-right {
  fill: var(--pad-press);
  stroke: var(--pad-press-line);
}

/*
 * 四段斜向弧键：沿十字的外切圆（半径 = 中心到拨片外缘 = 45.7 单位）排在四个斜角上，
 * 一段跨 20°（±10°），画出来长 20°×π/180×45.7 ≈ 15.97 单位 ≈ 1.41u（小档 22.5px，
 * 两端圆头各再长出约半个描边）。弧越短、和拨片之间那道空隙越大（小档最近处 15.8px，
 * 扣掉两边描边净空约 12px），空隙就是「这里按不到」的说明。
 * 下面这些数都是 viewBox 单位，1 单位 = 8.25u/93.52 ≈ 0.0882u（小档约 1.411px），
 * 所以换档位时它们和格子一起等比放大，**角度一点不变**（判定靠的就是角度）：
 * 看得见的那条 2.83 单位 ≈ 0.25u（小档 4px），比拨片那条描边略粗一点，
 * 读起来是「一颗键」而不是一条缝；
 * 命中带 12 单位 ≈ 1.06u（小档 16.9px，径向 ±8.5px），手指按不准 4px 的细线，所以带比弧粗。
 * 命中带粗到 ±0.53u，角度上就再多占约 7.5°（圆头），所以它的角域是 45°±17.5°，
 * 落在两个扇区（各到 ±22.5°，即 22.5° 与 67.5°）之间，两边各留 5° 谁也不抢。
 */
.dpad-diag-face {
  fill: none;
  stroke: var(--pad-line);
  stroke-width: 2.83;
  stroke-linecap: round;
  pointer-events: none;
  transition: stroke 0.08s ease;
}

/* 透明命中带：画不出东西，只把这段弧变成按得着的地方 */
.dpad-diag-hit {
  fill: none;
  stroke: transparent;
  stroke-width: 12;
  stroke-linecap: round;
  pointer-events: stroke;
}

/*
 * 按住弧 = 两个方向同时按下，所以「这两个方向都亮着」时这段弧亮。
 * 两根拇指分别按住上和右也是两个方向都亮着，弧跟着亮没错 —— 它亮的含义是「斜向正有效」，
 * 不是「这根手指正按在弧上」。
 */
.touch-dpad[data-active~="UP"][data-active~="RIGHT"] .dpad-diag-up-right .dpad-diag-face,
.touch-dpad[data-active~="RIGHT"][data-active~="DOWN"] .dpad-diag-right-down .dpad-diag-face,
.touch-dpad[data-active~="DOWN"][data-active~="LEFT"] .dpad-diag-down-left .dpad-diag-face,
.touch-dpad[data-active~="LEFT"][data-active~="UP"] .dpad-diag-left-up .dpad-diag-face {
  stroke: var(--pad-press-line);
}

/*
 * 右手这块：动作簇 + 它下面的 START。结构和左手那块一模一样（两列、扁键跨两列居中），
 * 于是两块同高（簇 8.25u + 行距 0.7u + 扁条 1.75u = 10.7u）。
 * #touch-controls 是 align-items: flex-end，两块底边对齐又同高，顶边就对齐，
 * 十字键中心和五键簇中心落在同一条水平线上，不需要再补一段抬升。
 */
.touch-actions-group {
  display: grid;
  grid-template-columns: repeat(2, auto);
  gap: calc(var(--pad-u) * 0.7);
  justify-items: center;
  align-items: center;
  /* 和左手那块一样：容器开可点，START 自己没有 pointer-events，靠这块继承 */
  pointer-events: auto;
}

/*
 * 动作簇：五颗一样大的圆键（上排 X/Y、中排 A/B、正中间 AB）。
 * 四颗角键围出的正方形就是簇，AB 靠这块的 50%/50% 定位，所以这块必须
 * position: relative 且自己就是那个正方形 —— 簇和 AB 之间不能再插一层，
 * 否则 50% 算的是那一层，四颗键一旦不等距就歪了（外面那块 .touch-actions-group
 * 只管把 START 摆在簇下面，不掺和簇内部定位）。
 *
 * 间距 2.25u（小档 36px）是让 AB 和四颗键同尺寸后反推出来的：
 * 相邻键圆心相距 3u+2.25u=5.25u，簇心到任一颗键圆心 5.25u/√2 ≈ 3.71u，
 * 减掉两个半径 3u，四边各留约 0.71u 缝。这个间距使整簇正好 8.25u 见方（小档 132px），
 * 和左边的十字键同宽 —— 左右两块一眼看过去分量对得上，不会一边挤一边空。
 */
.touch-actions {
  grid-column: 1 / 3;
  grid-row: 1;
  position: relative;
  display: grid;
  grid-template-columns: repeat(2, auto);
  gap: calc(var(--pad-u) * 2.25);
  justify-items: center;
  align-items: center;
  pointer-events: auto;
}

/* 上排 X、Y（界面键，说明见「按键映射」菜单，外观不再用颜色区分） */
.touch-x { grid-column: 1; grid-row: 1; }
.touch-y { grid-column: 2; grid-row: 1; }
/* 中排 A、B：A 在左、B 在右（拇指往内收是 A，往外是 B） */
.touch-a { grid-column: 1; grid-row: 2; }
.touch-b { grid-column: 2; grid-row: 2; }
/* 两条扁长键一边一颗：SELECT 在十字键正下方，START 在动作簇正下方 */
.touch-select { grid-column: 1 / 3; grid-row: 2; }
.touch-start { grid-column: 1 / 3; grid-row: 2; }

/*
 * 触摸按钮基础样式：底色和描边跟方向键那四片读同一组变量，所以是一套东西。
 * 形状分两类：五颗动作键（X/Y/A/B + 簇心 AB）是同一种圆片（3u，小档 48px = 触摸目标下限），
 * SELECT/START 是扁长条。
 */
.touch-btn {
  width: calc(var(--pad-u) * 3);
  height: calc(var(--pad-u) * 3);
  border-radius: 50%;
  border: var(--pad-line-w) solid var(--pad-line);
  background: var(--pad-surface);
  color: var(--text-primary);
  font-size: calc(var(--pad-u) * 0.75);
  font-weight: 700;
  cursor: pointer;
  user-select: none;
  -webkit-user-select: none;
  touch-action: manipulation;
  transition: all 0.1s ease;
  display: flex;
  align-items: center;
  justify-content: center;
}

.touch-btn:active {
  background: var(--pad-press);
  border-color: var(--pad-press-line);
  transform: scale(0.92);
}

/*
 * Select/Start：扁长条，真实手柄上这两颗就是细长条（MENU 已搬到屏幕内，不属于手柄区）。
 * 圆角给到胶囊形（两端是半圆），和拨片外端那种大圆角同一种手感，
 * 所以它既跟圆键不撞，也不像混进来的方角控件。
 * 一边一颗，各在自家簇的正下方：这两颗要两只拇指一起按才呼得出菜单，
 * 挨在一起就等于按不到一起。隔开还顺带避免了误按（中间隔着整块簇）。
 * 高 1.75u（小档 28px），低于 44px 的触摸目标建议值：这两颗按得少、
 * 而且在摆放模式里能整块拖到自己顺手的位置，先按外形优先。
 */
.touch-select, .touch-start {
  width: calc(var(--pad-u) * 3.5);
  height: calc(var(--pad-u) * 1.75);
  border-radius: 999px;
  font-size: calc(var(--pad-u) * 0.55);
}

/*
 * AB：簇心那颗，按住等于同时按住 A 和 B（动作写在 data-action="A B"）。
 * 和四颗角键同尺寸（尺寸、字号都用 .touch-btn 的原值），只在几何上特殊：
 * 它不是格子里的东西，是叠在四颗键围出的正方形正中，所以脱离网格流定位。
 * 间距 2.25u 就是为「同尺寸还留得住缝」定的（推导见 .touch-actions）。
 * 用 transform 居中，而 `.touch-btn:active` 的 scale 会整条顶掉 transform
 * （见 doc/值得记住的坑/nes-console.md），所以下面按下态重写完整一条。
 */
.touch-ab {
  position: absolute;
  left: 50%;
  top: 50%;
  transform: translate(-50%, -50%);
}

.touch-ab:active {
  transform: translate(-50%, -50%) scale(0.92);
}

/*
 * 手机竖屏：布局目标 = 游戏屏幕下方那块空白里、靠底但不贴底的一排 ——
 * 方向键左手边、动作键右手边（和横屏同一种分工），中间空出来的就是拇指的自然落点。
 * 之前这里写成 `flex-direction: column` 把两组叠成一竖列，等于把右手键位推到
 * 左手拇指底下，横屏能用的布局到竖屏反而不用了，所以两条媒体查询合并成同一种排法。
 *
 * `bottom` 为什么不是固定值：竖屏时画面贴顶（见上面那条 @container 规则），
 * 剩下的空白高度 = 视口高 - 画面高。画面高 = 画面宽 × 3/4 = min(75cqw, 100cqh)
 * （画面宽是 min(100cqw, 133.333cqh)，别把宽当成高，那样空白会少算四分之一屏宽）。
 * 整块手柄占多高：两块同构，都是「簇 8.25u + 键行距 0.7u + 扁条 1.75u = 10.7u」
 * （左列是十字键 + SELECT，右块是五键簇 + START）。
 * 再加容器上下各 1u 内边距 = 12.7u。
 * 抬升量取「空白 - 12.7u」和「180px - 1u」里较小的那个，再用 0 兜底 ——
 * 于是普通手机抬到按键离底边 180px（拇指不必伸到屏幕最下沿，也让开系统手势条），
 * 而近正方形这种空白本来就薄的窗口会自动退回贴底，先保证不压住画面。
 * 减掉那 1u 是因为容器自己还有 `padding: 1u`，不减就是离底 196px。
 * 那个 180px 是拇指落点，绝对量，不随档位放大；会变的是 12.7u —— 手柄越高，
 * 能从底边抬开的余量越少，薄窗口会更早退回贴底。
 */
@media (pointer: coarse) and (max-aspect-ratio: 1/1) {
  #touch-controls {
    flex-direction: row;
    justify-content: space-between;
    align-items: flex-end;
    --pad-blank: calc(100cqh - min(75cqw, 100cqh));
    bottom: clamp(0px, calc(var(--pad-blank) - 12.7 * var(--pad-u)), calc(180px - var(--pad-u)));
  }
}

/* 手机横屏：手柄在左右两侧 */
@media (pointer: coarse) and (min-aspect-ratio: 1/1) {
  #touch-controls {
    flex-direction: row;
    justify-content: space-between;
  }
}

/* ==================== 虚拟手柄的显隐与摆放 ==================== */
/*
 * 由「控制管理」菜单驱动，状态类打在 .stage 上（见 touch-layout.js）。
 * 选择器都带 #touch-controls，是为了压过上面那两条只有一级 id 的显示规则 ——
 * 媒体查询不加优先级，谁写得晚、选择器更具体谁赢。
 */

.stage.pad-always #touch-controls {
  display: flex;
}

.stage.pad-never #touch-controls {
  display: none;
}

/* 单个按键/整组隐藏：方向键是 .touch-dpad，其余是 .touch-btn */
.stage #touch-controls .pad-off {
  display: none;
}

/* 摆放模式：明确「这块可以拖」，并关掉浏览器手势，否则拖动会变成页面滚动 */
.stage.layout-edit .touch-dpad-group,
.stage.layout-edit .touch-actions-group {
  cursor: move;
  touch-action: none;
  outline: 2px dashed rgba(127, 216, 245, 0.85);
  outline-offset: 8px;
}

.layout-editor {
  position: absolute;
  top: 0.75rem;
  left: 50%;
  transform: translateX(-50%);
  z-index: 30;
  display: flex;
  align-items: center;
  gap: 0.75rem;
  padding: 0.5rem 0.75rem;
  border: 1px solid rgba(127, 216, 245, 0.5);
  border-radius: 10px;
  /* 比外围亮一档：底色压成中性之后，工具条再比背景暗就浮不起来了 */
  background: rgba(38, 38, 43, 0.94);
  box-shadow: 0 6px 18px rgba(0, 0, 0, 0.35);
  font-size: 0.8rem;
  color: var(--text-primary);
}

.layout-editor[hidden] {
  display: none;
}

.layout-editor-tip {
  color: var(--text-secondary);
}

.layout-editor-btn {
  padding: 0.3rem 0.7rem;
  border: 1px solid rgba(148, 163, 184, 0.5);
  border-radius: 8px;
  background: transparent;
  color: var(--text-primary);
  font-size: 0.8rem;
  font-weight: 600;
  cursor: pointer;
  transition: background 0.15s ease, border-color 0.15s ease;
}

.layout-editor-btn:hover {
  border-color: var(--accent);
  background: rgba(127, 216, 245, 0.18);
}

.layout-editor-btn-primary {
  border-color: rgba(127, 216, 245, 0.75);
  background: var(--accent-fill);
}

