/* ══════════════════════════════════════════════════════════════════════════
   私信通話（1 對 1）—— 樣式
   ══════════════════════════════════════════════════════════════════════════

   契約：`docs/call-contract.md` 的「前端契約」那一節。
   動效：`docs/motion.md`（只有三種時長、只有 transform/opacity 能動）。
   色彩：**一律用 `app.css` 的 token**，這個檔案裡沒有任何色彩字面值。
        深色模式因此自動成立（token 在 `@media (prefers-color-scheme: dark)`
         裡被換掉），不需要在這裡寫第二份規則。

   ── 這個檔案消費哪些名字（以及為什麼）────────────────────────────────

   契約原文：「DOM（id 固定，**樣式**與探針都靠它們）」⇒ **有 id 的元素一律用
   id 選**。class 只用在那個元素**沒有 id** 的時候：

     有 id（用 id 選）：
       #call-incoming  #call-incoming-name  #call-accept  #call-decline
       #call-panel  #call-peer-name  #call-timer  #call-hangup
       #call-mute  #call-video  #call-ss  #call-ss-audio  #call-ss-audio-wrap
       #call-local  #call-remote  #call-status

     沒有 id ⇒ 用 class（這些是 `public/index.php` 5620–5672 行產生、
     而**沒有別的樣式表碰過**的版面角色）：
       .call-ring  .call-card-body  .call-card-kicker  .call-card-hint
       .call-card-actions  .call-head  .call-stage  .call-actions
       .call-video（兩個 <video> 共用）

   ⚠ **刻意沒有消費**的 class（它們**有** id，依上面的規則用 id 選）：
     `.call-card` `.call-panel` `.call-card-name` `.call-peer` `.call-timer`
     `.call-status` `.call-video-remote` `.call-video-local`
     —— 它們是 HTML 的可讀性標記，不是「被忘記的樣式」。
     （`tools/css-dead.py` 檢查的是「CSS 選了但沒人產生」，方向相反，
      所以這些不構成問題。）

   ⚠ **`#call-start` 不在這裡**：它是私信房間標題列裡的撥號鈕
     （`.chat-tools` 裡），而 `app.css:1772` 的 `.chat-tools button`
     已經給了它內距與字級。**不重複宣告** —— 重複宣告會變成兩份會各自漂移
     的真相，而症狀（「只有通話鈕的內距跟別人不一樣」）幾乎看不出來。

   ── 這個檔案自己的三個判斷（給複核者）────────────────────────────────

   ① **面板在右上角，不在右下角**。這個站的輸入框固定在畫面底部
      （`.composer` 是 `.chat` 這個 flex column 的最後一項），右下角會直接
      蓋住輸入框與送出鍵。右上角只壓到訊息區頂端，輸入區完整可用。
   ② **`#call-status` 用 `--on-panel`，不是 `--ink-*`**。它疊在
      `--panel-ink`（**兩個主題都是深色**，刻意如此）的影像上，
      所以它的前景色必須是「面板上的字」那一組 token。
      用 `--ink-2` 的症狀是**淺色主題下深字疊深底 ⇒ 幾乎看不見**。
   ③ **沒有任何 `:active` 的 transform**。`app.css` 的 `button` 基礎規則
      已經給每一顆按鈕按下的縮放（`button.primary:active` 是 0.95、
      `button.danger:active` 是 0.94），而且**它自己的 reduce 區塊已經
      逐條歸零**。這裡若再宣告一次，特異度（id）會高於那組歸零規則 ⇒
      就必須自己再補一份 reduce 歸零，否則「減少動態」的使用者看到
      一顆不聽話的按鈕。**不宣告就沒有這個坑。**
       （這是把上一版的一個真缺陷**連根移除**，而不是再補一條規則去蓋它。）
   ══════════════════════════════════════════════════════════════════════════ */


/* ══════════════════════════════════════════════════════════════════════════
   一、來電浮框
   ──────────────────────────────────────────────────────────────────────────
   使用者的原話是「如果他還停留在網頁上，只會彈出一個浮框，問他是否要接受
   電話」⇒ 這是一個**要你回答**的東西，不是通知。

   ★ 放在**畫面上方**。底部是行動裝置上手掌與輸入框最常佔走的位置，
     把「要不要接這通電話」塞在那裡，等於要使用者先移開手才看得到。
   ══════════════════════════════════════════════════════════════════════════ */

#call-incoming {
  position: fixed;
  /*
   * 置中方式：`inset-inline: 0` ＋ `margin-inline: auto`。
   * ⚠ **刻意不用** `inset-inline-start: 50%` ＋ `translateX(-50%)`：
   *   `transform` 會讓這個元素**變成子孫的 containing block**，
   *   而 `#call-incoming` 裡面沒有任何絕對定位的子孫（目前），
   *   但我不想要一個「以後加一個絕對定位的子孫就會安靜地錯位」的結構。
   *   auto margin 沒有這個副作用。
   */
  inset-block-start: var(--space-lg);
  inset-inline: 0;
  margin-inline: auto;
  inline-size: min(26rem, calc(100% - var(--space-lg) * 2));
  /*
   * z-index 的相對關係（全部在 root stacking context，所以可直接比較）：
   *   `.sidebar`（手機抽屜）30 ／ `.modal` 40 ／ `.lightbox` 50 ／
   *   `.toast-stack`、`.reaction-picker` 60 ／ **通話面板 70** ／ **來電 80**
   * 任務要求「高於既有的訊息動作列與側欄抽屜」—— 那些是 30 與 auto。
   *
   * ★ **來電比通話面板更高**（80 > 70）：兩者在正常流程下不會同時出現
   *   （對方在通話中時 `POST api/call/start` 回 `409 callee_busy`），
   *   但**萬一同時出現**，該贏的是**需要你回答**的那一個：面板是背景狀態
   *   （你不理它，通話照走），來電是有時限、不回答就消失的。
   *   ⚠ 第一版寫反了（面板 80、來電 70），而**截圖當場看得出來** ——
   *   來電浮框右上角那顆「拒絕」被面板蓋掉一塊。那一版如果只看
   *   「z-index 等於 70 / 80」那兩條斷言是**全綠**的：它們只驗數字，
   *   不驗誰蓋住誰。
   */
  z-index: 80;
  display: flex;
  align-items: center;
  gap: var(--space-md);
  padding: var(--space-md);
  background: var(--paper-2);
  border: 1px solid var(--accent);
  border-radius: var(--radius-lg);
  box-shadow: var(--shadow-lg);
  color: var(--ink);
}

/*
 * 進場：從上方落下（`ui-drop` 是 `app.css` 的既有 keyframe）。
 * 只驗 `:not([hidden])`，不要再加 `.is-*` 條件 —— 浮框沒有 state class
 * （契約的 state class 只掛在 `#call-panel` 上），多寫一個條件會讓動畫
 * **永遠不播**，而症狀是「什麼都沒發生」。
 */
#call-incoming:not([hidden]) {
  animation: ui-drop var(--dur-base) var(--ease-out) both;
}

/* 鈴聲的視覺訊號。純裝飾（用 `aria-hidden="true"` 的 div）。 */
.call-ring {
  flex: 0 0 auto;
  inline-size: 0.75rem;
  block-size: 0.75rem;
  border-radius: var(--radius-pill);
  background: var(--accent);
}
/*
 * ⚠ `no-preference` 這一層是必要的：`voice-pulse` 是 `infinite`，
 *   在 reduce 模式下若照播，它會變成一個**閃爍**而不是「減少動態」。
 *   這是 `app.css` 自己對同一個 keyframe 用的寫法。
 *   `1.2s` 是硬寫的時長：`--dur-*` 三個 token 是給**轉場**用的，
 *   而 `voice-pulse` 是 `app.css` 已登記的**功能性**動畫例外
 *   （`tools/motion-guard.py` 的 `FUNCTIONAL_ANIM_EXCEPTIONS`），
 *   它在 `app.css` 裡用的也是 `1.2s`。兩邊必須一致。
 */
@media (prefers-reduced-motion: no-preference) {
  .call-ring { animation: voice-pulse 1.2s var(--ease-in-out) infinite; }
}

.call-card-body {
  display: flex;
  flex: 1 1 auto;
  /* ★ flex item 的 `min-inline-size` 預設是 `auto`（＝內容最小尺寸）
     ⇒ 長暱稱不會被壓縮，而是把整張卡片撐開 → 水平溢出。
     要讓 `text-overflow: ellipsis` 生效，這一條是前提。 */
  min-inline-size: 0;
  flex-direction: column;
  gap: var(--space-3xs);
}

.call-card-kicker {
  margin: 0;
  font-size: var(--text-2xs);
  font-weight: 600;
  letter-spacing: 0.08em;
  color: var(--accent-deep);
}

#call-incoming-name {
  margin: 0;
  font-size: var(--text-lg);
  font-weight: 600;
  /* 三段式省略號：缺任何一段都不會生效，而且是**安靜**的。 */
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

.call-card-hint {
  margin: 0;
  overflow: hidden;
  font-size: var(--text-xs);
  color: var(--ink-2);
  text-overflow: ellipsis;
  white-space: nowrap;
}

.call-card-actions {
  display: flex;
  flex: 0 0 auto;
  align-items: center;
  gap: var(--space-sm);
}

/* 接聽：實心強調色（`button.primary` 已經給了底色與字色，這裡只補
   「通話控制必須一眼看到」的份量）。 */
#call-accept {
  font-weight: 600;
}

/* 拒絕：實心紅。
   ⚠ `button.danger` 的預設是**外框**（`border-color` ＋ `color`，見
   `app.css:404`），紅色只在 hover 時才填滿。在「來電」這張卡片上，
   「拒絕」必須與「接聽」等重 —— 這是刻意的偏離，不是沒看到基礎規則。
   用 id 選 ⇒ 特異度（1,0,0）高於 `button.danger`（0,1,1），
   所以**必須自己寫 hover**（不然 hover 會是外框變實心的舊行為疊上來）。 */
#call-decline {
  background: var(--danger);
  border-color: var(--danger);
  color: var(--on-solid);
  font-weight: 600;
}


/* ★ 2026-10-16（第 50 輪）**移除**：這裡原本是「二、通話中面板」
   （`#call-panel`、`.call-head`、`#call-peer-name`、`#call-timer`、
    `.call-stage`、`.call-video`、`#call-local`、`#call-remote`、
    `#call-status`、`.call-actions`、`#call-mute`、`#call-video`、`#call-ss`、
    `#call-hangup`、`.call-ss-audio*`）。

   使用者這一輪的要求是「**打电话的话额外开个页面**」
   ⇒ 那個面板搬到 `public/call/index.php` ＋ `public/assets/call-page.css`。

   ⚠⚠ **為什麼一定要刪，而不是「留著也沒人看得到」**：
     `public/call/index.php` 的 HTML **刻意用了同樣的 id 名稱**
     （`#call-local`、`#call-status`、`#call-mute`…），而
     `tools/orphan-ids.py` 與 `tools/css-dead.py` 把**全站 HTML 當成一個池子**
     ⇒ 這兩支守衛會拿**另一個頁面**的同名元素來滿足這裡的規則，
     **靜默地變綠**。留著這一整段，等於把兩個守衛的眼睛遮住，
     而它們存在的目的正是「抓搬了 HTML 沒帶走 CSS」。

     ⚠ 我有實測：把 `public/call/index.php` 的 `id="call-local"` 改一個字，
       這裡的 `#call-local` 立刻讓 `tools/orphan-ids.py` 變紅
       （`CSS 有規則，但沒有任何頁面的 HTML 提供它`）。
       ⇒ 它今天綠，靠的是**另一個頁面**，不是這一頁。

   ⚠ 另一個線索：`tools/css-dead.py` **有**抓到 `.has-call`（那條在
     `@media (pointer: coarse)` 裡，見第五段）—— 因為那個 class
     只有 `call.css` 與 `call.js` 用過，**沒有第二個頁面能替它背書**。

   ⚠ 這段刪掉之後，`call.css` 不再有任何 `#call-panel` 的規則，
     而那些版面決定（面板在右上角、`#call-status` 的前景 token、
     手機上的寬度上限）全部**搬到了 `call-page.css`** ——
     `public/call/index.php` 是那裡的唯一消費者。**不要在這一頁補一份。**
   ══════════════════════════════════════════════════════════════════════════ */


/* ══════════════════════════════════════════════════════════════════════════
   三、hover 的份量（只加陰影，不動位置以外的 transform）
   ──────────────────────────────────────────────────────────────────────────
   ⚠ 整段包在 `@media (hover: hover)`：`app.css` 的慣例，也是
     `docs/motion.md` 的要求 —— 觸控裝置不該有 hover 態（它會在點完之後
     卡住，看起來像「按鈕卡在按下的樣子」）。
   ⚠ 這裡只加 `box-shadow`。**不改 `transform`** 的原因：`app.css` 的
     `button:hover` 已經有 `translateY(-1px)`＋spring，而它在
     `@media (hover: hover)` 區塊裡**刻意把 `:active` 重新宣告一次**
     來確保「按住」贏過「浮起」（`app.css:459` 的長註解）。
     我在這裡再動 `transform` 會打亂那個順序。
   ══════════════════════════════════════════════════════════════════════════ */

@media (hover: hover) {
  #call-accept:hover:not(:disabled) {
    box-shadow: var(--shadow-md);
  }
  #call-decline:hover:not(:disabled) {
    box-shadow: var(--shadow-md);
  }
  /* ★ 2026-10-16（第 50 輪）：這裡原本還有 `#call-hangup` 的 hover 與
     三顆開關（`#call-mute`／`#call-video`／`#call-ss`）的 hover。
     那些元素已經搬到 `public/call/index.php`，而 `call-page.css` 有自己的
     那一組 —— 它用 `:active` 的縮放而不是 `box-shadow`，
     理由寫在那一邊（通話中的按鈕要「立刻」回饋，陰影不夠）。 */
}


/* ★ 2026-10-16（第 50 輪）**移除**：「四、精確指標」整段
   （`@media (pointer: fine)` 顯示 `#call-ss` 與 `#call-ss-audio-wrap`）。
   螢幕共享是**通話中**才有的動作，而通話中面板已經不在這一頁
   ⇒ 這個 `@media` 在這裡沒有任何元素可以作用。

   ⚠ 那個「只在桌機顯示螢幕共享」的判斷**沒有消失**，它搬到
     `call-page.css` 的同名 `@media (pointer: fine)`（理由不變：
     `pointer: fine` 比 `hover: hover` 精確 —— 判斷的是「有沒有精確指標」，
     而有些觸控裝置會回報 `hover: hover`）。
   ══════════════════════════════════════════════════════════════════════════ */


/* ══════════════════════════════════════════════════════════════════════════
   五、觸控裝置
   ══════════════════════════════════════════════════════════════════════════

   ⚠⚠ **整段放在檔案的最後面是刻意的。**
     同特異度的規則，**後出現的勝**；而 `@media` 不會報錯、不影響特異度
     ⇒ 這段若寫在基礎規則前面，底下**每一條覆寫都會安靜地失效**
     （量到的還是基礎值，沒有任何症狀）。
     `tools/css-order-guard.py` 就是為了抓這件事而存在的。

   ⚠ 這一整段都不需要重宣告觸控尺寸：`app.css` 的 `button` 基礎規則
     已經給了 `min-block-size: var(--tap-min)`（44px）。**不重複宣告**。
   ══════════════════════════════════════════════════════════════════════════ */

@media (pointer: coarse) {
  /* ── 來電浮框：撐滿寬度，按鈕換到第二行、各佔一半 ──────────────────── */
  #call-incoming {
    inset-block-start: var(--space-sm);
    inset-inline: var(--space-sm);
    inline-size: auto;
    flex-wrap: wrap;
    padding: var(--space-sm) var(--space-md);
  }
  .call-card-actions {
    /* 換到下一行並吃滿寬度 ⇒ 兩顆按鈕可以各分一半，
       而不是擠在暱稱右邊被壓成一顆小方塊。 */
    flex: 1 1 100%;
    gap: var(--space-sm);
  }
  #call-accept,
  #call-decline {
    /* 各分一半：**不給「正確答案」比較大的面積** ——
       拒絕與接聽在這個卡片上等重（誤觸接聽的代價比誤觸拒絕高）。 */
    flex: 1 1 0;
  }

  /* ★ 2026-10-16（第 50 輪）**移除**：這裡原本是通話面板在手機上的覆寫
     —— `#call-panel` 的寬度、`max-block-size` 那段「最壞情況」算式、
     `body.has-call .chat-head { display: none }`、三顆控制鈕平分、
     `#call-local` 的寬度上限。

     ⚠ 其中 `body.has-call .chat-head` **是真的死碼**，而且它是
       `tools/css-dead.py` 唯一抓到的那一條：`body.has-call` 由
       `call.js` 的 `paintPhase()` 產生，而第 50 輪把 `paintPhase()`
       連同 RTC 整段搬走了 ⇒ 那個 class **不再有產生端**。
       留著它會讓那個守衛紅（正確的紅），而修法只能是刪規則。

     ⚠ 那條規則原本還帶著一個**已知的安靜失效模式**（它靠 `app.css` 的
       `.chat-head` 這個 class 名，改名就會靜默失效）。刪掉它順帶移除了
       那個耦合 —— 這一頁現在**完全不依賴 `app.css` 的任何 class 名**。

     ⚠ `62vh` 那段算式（含「`.composer` 最壞 184px」的推導）**很重要**，
       它沒有消失，它搬到了 `call-page.css`。⚠ 但獨立通話頁**沒有
       `.composer`**（那是聊天室頁的輸入框）⇒ 那一頁的上限算式是
       **另一組**，而且是根據「那個視窗自己的高度」推的。
       **不要把這裡的算式照抄過去。**
     ══════════════════════════════════════════════════════════════════════ */}


/* ══════════════════════════════════════════════════════════════════════════
   六、減少動態
   ══════════════════════════════════════════════════════════════════════════

   這個檔案**沒有需要歸零的裝飾性 transform**，所以這裡沒有宣告 ——
   但請不要因此把這個區塊刪掉，它是給下一個人的位置。

   逐條說明為什麼不需要：

   · `#call-incoming` 的進場用的是 `ui-drop`。`app.css` 的 reduce 區塊
     **重新定義了** `@keyframes ui-drop`
     （`from { transform: none } to { transform: none }`）⇒ 全站任何用到
     它的地方都自動只淡入、不位移。**不需要在這裡再寫一次。**
     ⚠ 這一條是**跨檔案的推論**（我依賴 `app.css` 的 reduce 區塊），
       所以它有一個安靜的失效模式：`app.css` 若拿掉那個重新定義，
       這一頁的浮框就會開始位移，而**這裡沒有任何跡象**。
       `tools/motion-guard.py` 的「跨檔案 keyframe 鏡像」那一節就是守這個的。
   · `.call-ring` 的 `voice-pulse` 包在 `no-preference` 裡 ⇒ 不成立就不播。
   · 這裡**完全沒有** `:active` / `:hover` 的 `transform` 宣告（檔頭判斷③）
     ⇒ 沒有「特異度比 `app.css` 的歸零規則高、於是不聽話」的按鈕。

   ★ 2026-10-16（第 50 輪）這一節**內容變短了**，因為那些屬於通話面板的
     條目（`#call-local` 的 `scaleX(-1)`、`#call-status:empty`）都跟著面板
     搬到 `call-page.css` 了 —— 那裡有它自己的「減少動態」區塊。

   ⚠ 若將來在這裡新增任何 `transform` / `animation`，**必須同時在這裡
     把它的裝飾性 transform 歸零**（選擇器字串要與基礎段**逐字相同**，
     特異度才會相同），否則「減少動態」的使用者會看到一個動的元素。
   ══════════════════════════════════════════════════════════════════════════ */
