From e7586ee1b4047b95381686751d60346aa82dcd7d Mon Sep 17 00:00:00 2001
From: Antigravity <Antigravity@qpid.pro>
Date: Mon, 5 Oct 2026 12:44:10 +0300
Subject: [PATCH] docs(todo): add reader popup positioning bugfix task

---
 TODO.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/TODO.md b/TODO.md
index ef004d9..f4140c6 100644
--- a/TODO.md
+++ b/TODO.md
@@ -21,6 +21,10 @@
   - **Слова внутри списков и цитат остаются кликабельными** (интерактивный клик-перевод работает!).
 - [ ] **Заголовки Markdown (`##`, `###`)**:
   - Конвертация в `<h3>`, `<h4>` с удалением сырых решёток `#`.
+- [ ] **Точное позиционирование окна перевода у курсора/слова (Popup Positioning)**:
+  - Исправить баг двойного смещения координат: у элемента `.reader-word-popup` в CSS задан `position: fixed`, а в JS к `rect.bottom` ошибочно прибавлялся `window.scrollY`, из-за чего окно улетало далеко вниз при любом скролле страницы.
+  - Позиционировать окно точно под кликнутым словом (`rect.bottom + 6`) либо над ним (`rect.top - popupHeight - 6`), если снизу недостаточно места до края экрана.
+  - Центрировать окно относительно слова с ограничением по границам вьюпорта (отступы минимум 12px от краёв экрана).
 - [ ] **Стилизация в CSS ([`app/static/css/style.css`](file:///home/ai-projects/services/study.qpid.pro/app/static/css/style.css))**:
   - Добавить стили для `.reader-content-body pre`, `code`, `blockquote`, `ul`, `ol`.