/* ============================================================
 * CyberStrike 3D — 触屏控件样式（owner: US-004，占位文件由 US-003 建立）
 * 职责：虚拟摇杆、转向区域、动作按钮（开火/瞄准/换弹/跳跃/上下载具/
 *       切枪/切视角/暂停）的布局、尺寸与触摸反馈。
 * 依赖：css/style.css 中的 CSS 变量（--neon-cyan / --safe-* / --z-touch）。
 * 要求：按钮点击区 >= 44px（移动端建议 56px 以上），竖屏与横屏均不重叠，
 *       且**不遮挡画面中心准星**（所有控件只占据屏幕四角/边缘）。
 *
 * DOM 结构由 js/input.js 的 setTouchUI(true) 注入 #hud-root：
 *   .touch-layer[data-active="true"][data-forced="true|auto"]
 *     ├── .touch-stick            （左手摇杆；子节点 .touch-stick__knob）
 *     ├── .touch-actions
 *     │     └── .touch-actions__row > button.touch-btn[data-touch-action]
 *     ├── button.touch-btn.touch-btn--pause   （右上角）
 *     └── .touch-hint
 *
 * 可调参数（US-014 打磨画质/手感时只改变量，不要改选择器）：
 *   --touch-btn-opacity            常态透明度
 *   --touch-btn-opacity-active     按下透明度
 *   --btn-size / --btn-size-lg / --btn-size-sm / --stick-size / --stick-knob
 *   --touch-stick-inset / --touch-actions-inset    控件到安全区的边距
 * ============================================================ */

:root {
  /* 规范变量名（US-004 使用；尺寸单位 px，可用 em 覆盖以跟随根字号） */
  --btn-size: 56px;                       /* 普通动作按钮直径/边长 */
  --btn-size-lg: 76px;                    /* 开火键（最大，右手拇指位） */
  --btn-size-sm: 44px;                    /* 次级按钮，不低于最小点击区 */
  --stick-size: 120px;                    /* 虚拟摇杆底盘直径 */
  --stick-knob: 56px;                     /* 摇杆手柄直径 */
  --btn-gap: calc(env(safe-area-inset-bottom, 0px) + 10px);

  /* 兼容别名（历史命名，保持向后兼容） */
  --touch-btn-size: var(--btn-size);
  --touch-btn-size-lg: var(--btn-size-lg);
  --touch-stick-size: var(--stick-size);
  --touch-stick-knob: var(--stick-knob);

  /* 触感配色（半透明玻璃 + 霓虹描边，与 style.css 主题一致） */
  --touch-btn-bg: rgba(12, 20, 34, 0.55);
  --touch-btn-bg-active: rgba(0, 234, 255, 0.32);
  --touch-btn-border: rgba(0, 234, 255, 0.45);
  --touch-stick-track: rgba(0, 234, 255, 0.12);

  /* ---- US-004 新增：透明度与留白（便于 US-014 统一调参） ---- */
  --touch-btn-opacity: 0.62;              /* 常态透明度：不干扰视野 */
  --touch-btn-opacity-active: 0.96;       /* 按下反馈 */
  --touch-btn-blur: 6px;                  /* 玻璃模糊 */
  --touch-stick-opacity: 0.52;            /* 摇杆底盘透明度 */
  --touch-stick-outline: rgba(0, 234, 255, 0.28);
  --touch-stick-inset: 18px;              /* 摇杆距左右安全区 */
  --touch-actions-inset: 14px;            /* 按钮簇距右侧安全区 */
  --touch-hint-opacity: 0.7;
}

/* 触屏控件容器与按钮的具体规则由 US-004（input.js owner）在此文件内实现。
   默认仅在触屏模式下显示，桌面端隐藏。 */
.touch-layer {
  position: fixed;
  inset: 0;
  z-index: var(--z-touch);
  pointer-events: none;
  display: none;
}

.touch-layer[data-active="true"] {
  display: block;
}

@media (hover: hover) and (pointer: fine) {
  /* 桌面端默认不显示触屏控件（可用 ?touch=1 强制覆盖） */
  .touch-layer[data-forced="false"] {
    display: none;
  }
}

/* ------------------------------------------------------------
 * .touch-only：只在触摸设备上出现的元素（US-012 的 HUD 可用）。
 * 注意：US-004 注入的控件**不使用**该类——触屏 UI 的显隐由
 * `setTouchUI(true)`（即 .touch-layer[data-active]）决定，
 * 这样 `?touch=1` 在桌面端也能强制显示（AC 要求）。
 * ---------------------------------------------------------- */
.touch-only {
  display: none;
}

@media (pointer: coarse) {
  .touch-only {
    display: flex;
  }
}

/* ------------------------------------------------------------
 * 1. 虚拟摇杆（左手区，屏幕左下角）
 * ---------------------------------------------------------- */
.touch-stick {
  position: absolute;
  left: calc(var(--safe-left) + var(--touch-stick-inset));
  bottom: calc(var(--safe-bottom) + var(--touch-stick-inset));
  width: var(--stick-size);
  height: var(--stick-size);
  border-radius: 50%;
  background: var(--touch-stick-track);
  border: 1px solid var(--touch-stick-outline);
  box-shadow: inset 0 0 18px rgba(0, 234, 255, 0.12);
  opacity: var(--touch-stick-opacity);
  pointer-events: auto;
  touch-action: none;
  -webkit-user-select: none;
  user-select: none;
  -webkit-tap-highlight-color: transparent;
  will-change: transform;
}

.touch-stick__knob {
  position: absolute;
  left: 50%;
  top: 50%;
  width: var(--stick-knob);
  height: var(--stick-knob);
  border-radius: 50%;
  background: var(--touch-btn-bg-active);
  border: 1px solid var(--touch-btn-border);
  box-shadow: 0 0 10px rgba(0, 234, 255, 0.35);
  transform: translate(-50%, -50%);
  pointer-events: none;
  will-change: transform;
}

/* ------------------------------------------------------------
 * 2. 动作按钮簇（右手区，屏幕右下角）
 * ---------------------------------------------------------- */
.touch-actions {
  position: absolute;
  right: calc(var(--safe-right) + var(--touch-actions-inset));
  bottom: calc(var(--safe-bottom) + var(--touch-actions-inset));
  display: flex;
  flex-direction: column;
  align-items: flex-end;
  gap: var(--btn-gap);
  pointer-events: none;
}

.touch-actions__row {
  display: flex;
  align-items: center;
  justify-content: flex-end;
  gap: var(--btn-gap);
  pointer-events: none;
}

.touch-btn {
  pointer-events: auto;
  touch-action: none;
  display: flex;
  align-items: center;
  justify-content: center;
  width: var(--btn-size);
  height: var(--btn-size);
  min-width: var(--btn-size);
  min-height: var(--btn-size);
  padding: 0;
  margin: 0;
  border-radius: 50%;
  border: 1px solid var(--touch-btn-border);
  background: var(--touch-btn-bg);
  color: var(--text-primary);
  font-family: var(--font-ui);
  font-size: 12px;
  line-height: 1;
  letter-spacing: 0.04em;
  text-align: center;
  opacity: var(--touch-btn-opacity);
  backdrop-filter: blur(var(--touch-btn-blur));
  -webkit-backdrop-filter: blur(var(--touch-btn-blur));
  -webkit-user-select: none;
  user-select: none;
  -webkit-tap-highlight-color: transparent;
  transition: opacity 90ms linear, background-color 90ms linear;
}

/* 开火键：最大，右手拇指最容易够到 */
.touch-btn--lg {
  width: var(--btn-size-lg);
  height: var(--btn-size-lg);
  min-width: var(--btn-size-lg);
  min-height: var(--btn-size-lg);
  font-size: 15px;
  font-weight: 600;
  letter-spacing: 0.08em;
}

/* 暂停键：固定在右上角，远离画面中心 */
.touch-btn--pause {
  position: absolute;
  top: calc(var(--safe-top) + 12px);
  right: calc(var(--safe-right) + var(--touch-actions-inset));
  width: var(--btn-size-sm);
  height: var(--btn-size-sm);
  min-width: var(--btn-size-sm);
  min-height: var(--btn-size-sm);
  font-size: 11px;
}

/* 按下反馈（.is-active 由 input.js 在 touchstart/touchend 维护） */
.touch-btn.is-active,
.touch-btn:active {
  opacity: var(--touch-btn-opacity-active);
  background: var(--touch-btn-bg-active);
  border-color: var(--neon-cyan);
  box-shadow: var(--glow-cyan);
}

/* ------------------------------------------------------------
 * 3. 操作提示（底部中央，纯装饰，不接收触摸）
 * ---------------------------------------------------------- */
.touch-hint {
  position: absolute;
  left: 50%;
  bottom: calc(var(--safe-bottom) + 4px);
  transform: translateX(-50%);
  max-width: 60%;
  font-size: 10px;
  letter-spacing: 0.14em;
  color: var(--text-dim);
  opacity: var(--touch-hint-opacity);
  pointer-events: none;
  white-space: nowrap;
  overflow: hidden;
  text-overflow: ellipsis;
}

/* ------------------------------------------------------------
 * 4. 横屏 / 小屏自适应：压低控件高度，避免占用可视区域
 * ---------------------------------------------------------- */
@media (orientation: landscape) and (max-height: 520px) {
  :root {
    --btn-size: 48px;
    --btn-size-lg: 64px;
    --btn-size-sm: 40px;
    --stick-size: 104px;
    --stick-knob: 48px;
    --btn-gap: 8px;
    --touch-stick-inset: 12px;
    --touch-actions-inset: 12px;
    --touch-btn-opacity: 0.55;
    --touch-stick-opacity: 0.45;
  }
}

/* 极窄竖屏（小手机）：缩小摇杆，保证不与按钮簇重叠 */
@media (orientation: portrait) and (max-width: 359px) {
  :root {
    --btn-size: 48px;
    --btn-size-lg: 64px;
    --stick-size: 104px;
    --stick-knob: 48px;
    --btn-gap: 8px;
  }
}

/* 粗指针设备把触摸目标放大到 48px 下限（与 style.css 保持一致） */
@media (pointer: coarse) {
  :root {
    --btn-size-sm: 48px;
  }
}