feedscope 0.1.0__py3-none-any.whl

feedscope/ui/dialogs.py

@@ -0,0 +1,127 @@
+"""弹层底座与轻弹层：居中卡片 + 按钮行的骨架只写一次。
+
+之前是三胞胎（账号框 / 确认框 / 输入框各抄一份 compose 与底座 CSS）；
+差异本来只有三件事——提示文案、确认按钮的词、要不要多一个输入框。
+卡片 CSS 与 Esc 取消在 ArrowModalScreen 唯一实现（.modal-card +
+action_cancel，各弹层永远同形），本模块只剩轻弹层自己的增量。
+"""
+
+from __future__ import annotations
+
+from typing import TypeVar
+
+from textual.app import ComposeResult
+from textual.containers import Horizontal, Vertical
+from textual.widgets import Button, Input, Label
+
+from feedscope.ui.focus_nav import ArrowModalScreen
+from feedscope.core.i18n import t
+
+_DialogT = TypeVar("_DialogT")
+
+
+class DialogScreen(ArrowModalScreen[_DialogT]):
+    """居中卡片弹层底座（泛型 = dismiss 值类型）：卡片宽度约束 + 提示行样式；
+    compose 与取消值留给子类（Confirm -> bool，Input -> str | None）。"""
+
+    DEFAULT_CSS = """
+    .dialog-card { max-width: 64; }
+    .dialog-prompt { padding-bottom: 1; }
+    """
+
+    def action_cancel(self) -> None:
+        raise NotImplementedError  # 子类声明自己的取消值（False / None）
+
+
+class ConfirmScreen(DialogScreen[bool]):
+    """轻确认弹框：True=确认，Esc/取消=False。
+
+    PROMPT_ID / OK_ID 是语义化 id 的挂点（账号框覆写成 account-*，
+    测试与排错好认），按钮 id 只在屏内寻址、跨屏不撞。
+    """
+
+    PROMPT_ID = "confirm-prompt"
+    OK_ID = "confirm-ok"
+
+    def __init__(self, prompt: str, confirm_label: str = "") -> None:
+        # confirm_label 空串 = 默认键（构造时解析：类体默认值在 import 期，语言未定）
+        confirm_label = confirm_label or t("dialogs.confirm")
+        super().__init__()
+        self._prompt = prompt
+        self._confirm_label = confirm_label
+
+    def compose(self) -> ComposeResult:
+        with Vertical(classes="modal-card dialog-card"):
+            yield Label(self._prompt, id=self.PROMPT_ID, classes="dialog-prompt")
+            with Horizontal(classes="modal-actions"):
+                yield Button(self._confirm_label, id=self.OK_ID, variant="primary")
+                yield Button(t("dialogs.cancel"), id="confirm-cancel")
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        self.dismiss(event.button.id == self.OK_ID)
+
+    def action_cancel(self) -> None:
+        self.dismiss(False)
+
+
+class AccountScreen(ConfirmScreen):
+    """账号操作弹框：登录 / 登出一个源。返回 True=确认、False=取消。
+
+    只在「选择」阶段可见；确认后即 dismiss，真正的有头登录 / 清 cookie 由
+    后台 worker 执行（期间 profile 锁冲突由登录进行中标志挡刷新兜底）。
+    """
+
+    PROMPT_ID = "account-prompt"
+    OK_ID = "account-go"
+
+    def __init__(self, label: str, action_key: str) -> None:
+        # action_key 是文案键（dialogs.login / dialogs.logout）：动作词与提示语一次解析
+        action = t(action_key)
+        prompt = (
+            t("dialogs.login_prompt", label=label)
+            if action_key == "dialogs.login"
+            else t("dialogs.logout_prompt", label=label)
+        )
+        super().__init__(prompt, confirm_label=action)
+
+
+class InputScreen(DialogScreen[str | None]):
+    """单行输入弹层：Enter 确定 / Esc 取消，返回文本（空 = None）。
+
+    全应用唯一的文本输入（粘贴走终端原生 bracketed paste，从 Finder 拖
+    文件进终端即得路径）；Input 自己消费字符键（←/→ 是文本光标），↑/↓
+    在输入行与按钮行间移动焦点（ArrowModalScreen）。
+    """
+
+    CSS = """
+    .dialog-fixed { width: 64; }  /* 输入行要 1fr：卡片定宽，输入行才有得铺 */
+    """
+
+    def __init__(self, title: str, *, initial: str = "", placeholder: str = "") -> None:
+        super().__init__()
+        self._title = title
+        self._initial = initial
+        self._placeholder = placeholder
+
+    def compose(self) -> ComposeResult:
+        with Vertical(classes="modal-card dialog-card dialog-fixed"):
+            yield Label(self._title, id="input-title", classes="dialog-prompt")
+            yield Input(value=self._initial, placeholder=self._placeholder, id="input-line")
+            with Horizontal(classes="modal-actions"):
+                yield Button(t("dialogs.ok"), id="input-ok", variant="primary")
+                yield Button(t("dialogs.cancel"), id="input-cancel")
+
+    def on_mount(self) -> None:
+        self.query_one("#input-line", Input).focus()
+
+    def on_input_submitted(self, event: Input.Submitted) -> None:
+        self.dismiss(event.value.strip() or None)
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        if event.button.id == "input-ok":
+            self.dismiss(self.query_one("#input-line", Input).value.strip() or None)
+        else:
+            self.dismiss(None)
+
+    def action_cancel(self) -> None:
+        self.dismiss(None)

feedscope/ui/feedback.py

@@ -0,0 +1,64 @@
+"""用户反馈统一出口：对用户的提示措辞与级别都在这里定。
+
+分工：notify 是瞬时反馈（数秒后消失）；屏内常驻状态（列表空态、详情失败
+文案）由各屏自己挂，但失败文案复用本模块的 failure_text，保证同义同形。
+收件人 App 或 Screen 皆可（Textual 两者都有 notify，屏内调用直接传 self）。
+错误分级直接用 Textual notify 自带的 severity（info/warning/error），不另造枚举。
+
+action 是动作文案键（feedback.*）：请求/添加/登出/评论加载/加载更多失败
+各有一键，标题跟随动作——登出失败别写成「抓取失败」。
+"""
+
+from __future__ import annotations
+
+from textual.app import App
+from textual.screen import Screen
+
+from feedscope.core.i18n import has, t
+from feedscope.core.source import Source, SourceError
+
+ACTION_FETCH = "feedback.action_fetch"  # 默认动作（列表/详情首载）
+
+
+def _action_text(action: str) -> str:
+    """动作参数 -> 展示文本：键走 t()，非键（历史调用/特殊拼接）直通。"""
+    return t(action) if has(action) else action
+
+
+def failure_text(source: Source | None, exc: Exception, action: str = ACTION_FETCH) -> str:
+    """面向用户的失败文案。
+
+    SourceError 的消息已是完整文案（源在边界包装时带上了源标签与原因）；
+    其余技术异常（playwright 超时之类）才在这里补「{源} {动作}：」前缀。
+    source 为 None（无源语境的业务流，如订阅添加）只补「{动作}：」。
+    """
+    if isinstance(exc, SourceError):
+        return str(exc)
+    if source is None:
+        return t("feedback.failure", action=_action_text(action), error=exc)
+    return t(
+        "feedback.failure_with_source",
+        source=source.label_text, action=_action_text(action), error=exc,
+    )
+
+
+def fail(
+    app: App | Screen, source: Source | None, exc: Exception, action: str = ACTION_FETCH
+) -> None:
+    """失败通知（error 级）。标题跟随动作：登出/加载更多失败别都写成「抓取失败」。"""
+    title = (
+        t("feedback.title_fetch_failed")
+        if action == ACTION_FETCH
+        else _action_text(action)
+    )
+    app.notify(failure_text(source, exc, action), title=title, severity="error")
+
+
+def warn(app: App | Screen, msg: str, title: str) -> None:
+    """警告通知（warning 级），如需要登录。"""
+    app.notify(msg, title=title, severity="warning")
+
+
+def info(app: App | Screen, msg: str) -> None:
+    """普通通知（info 级），如「没有更多了」。"""
+    app.notify(msg)

feedscope/ui/focus_nav.py

@@ -0,0 +1,113 @@
+"""弹层的方向键焦点移动：与主屏同一套「方向键管焦点」的键位语言。
+
+弹层结构都是「纵向列表 + 底部按钮行」：列表到底再 ↓ 移交按钮行、按钮上
+按 ↑ 回列表、按钮行内 ←/→ 平移——不碰 Tab 也能全键盘走完任何弹层。
+列表的 ↑/↓ 是控件级原生键（先在本列表内移动），「到底走出」必须由列表
+子类在到边时自己移交焦点；按钮/输入框不绑方向键，屏级绑定直接命中
+（屏级先于 App 级，主屏的导航绑定不会掺和——主屏键已随 MainScreen 归屏）。
+
+ArrowModalScreen 的焦点链是线性的（布局顺序），←/↑ 与 →/↓ 两两同义——
+不假称空间语义；四个方向仍各留一个 action 方法，因为 → 是覆写点
+（F2 源管理里「列表上 → 进订阅管理」，见 source_setup 的 action_nav_right）。
+
+ArrowModalScreen 同时承载弹层家族的共享样式（DEFAULT_CSS 沿 MRO 合并）：
+居中卡片（.modal-card）与按钮行（.modal-actions）全弹层同形、唯一实现；
+Esc 取消也在这层声明，子类只实现 action_cancel 的取消值。
+"""
+
+from __future__ import annotations
+
+from typing import ClassVar, TypeVar
+
+from textual.binding import Binding
+from textual.screen import ModalScreen
+
+from feedscope.ui import Bindings
+from textual.widgets import ListView, SelectionList
+
+T = TypeVar("T")
+
+
+class ArrowModalScreen(ModalScreen[T]):
+    """弹层基类：←/↑ = 焦点后移、→/↓ = 焦点前移（焦点链 = 布局顺序）+ Esc 取消。
+
+    必须是 ModalScreen 子类才能进绑定的 MRO 合并（裸 mixin 的 BINDINGS
+    会被 _merge_bindings 跳过）；列表类控件自己绑 ↑/↓ 优先在列表内移动，
+    这里的屏级绑定只在聚焦控件不消费方向键（按钮/输入框空档）时命中。
+    需要给 → 留屏内语义的（F2 的管理订阅）覆写 action_nav_right 即可；
+    action_cancel 的取消值（False / None / 改动标记）由子类声明。
+    """
+
+    BINDINGS: ClassVar[Bindings] = [
+        Binding("left", "nav_left", show=False),
+        Binding("right", "nav_right", show=False),
+        Binding("up", "nav_up", show=False),
+        Binding("down", "nav_down", show=False),
+        Binding("escape", "cancel", "bindings.cancel", show=False),
+    ]
+
+    # 弹层卡片三件套的唯一实现（所有弹层同形）：宽度约束（min/max-width）
+    # 是各弹层差异，写在各屏自己的 CSS 里
+    DEFAULT_CSS = """
+    .modal-card {
+        width: auto; height: auto;
+        background: $surface; border: ascii $primary; padding: 1 2;
+    }
+    .modal-actions { height: auto; }
+    .modal-actions Button { margin-right: 1; }
+    """
+
+    def action_nav_left(self) -> None:
+        self.focus_previous()  # focus_next/previous 是 Screen 的方法
+
+    def action_nav_right(self) -> None:
+        self.focus_next()
+
+    def action_nav_up(self) -> None:
+        self.focus_previous()
+
+    def action_nav_down(self) -> None:
+        self.focus_next()
+
+    def action_cancel(self) -> None:
+        raise NotImplementedError  # 子类声明自己的取消值（False / None / 改动标记）
+
+
+def _exit_at_end(widget, *, at_end: bool) -> None:
+    """列表的 ↓ 统一出口：末行（或空表）再 ↓ 出列表进按钮行，否则本列表内下移。
+
+    FocusNav 两族列表共用的「到底走出」约定——各列表只判自己的到边条件
+    （SelectionList 看 highlighted/option_count，ListView 看 index/children）。
+    """
+    if at_end:
+        widget.screen.focus_next()
+    else:
+        widget.action_cursor_down()
+
+
+class FocusNavSelectionList(SelectionList):
+    """源勾选列表：末行再 ↓ 移交按钮行（首行 ↑ 留原生夹持——上方无可聚焦）。"""
+
+    # ↓ 绑定两族列表各声明一份：裸 mixin 的 BINDINGS 不进 Textual 的合并链
+    # （同 ArrowModalScreen docstring 的说明），共享基类省不掉这两行——
+    # 到边条件与出口统一收在 _exit_at_end，那才是可共享的部分
+    BINDINGS: ClassVar[Bindings] = [
+        Binding("down", "cursor_down_or_exit", show=False),
+    ]
+
+    def action_cursor_down_or_exit(self) -> None:
+        _exit_at_end(
+            self,
+            at_end=self.highlighted is None or self.highlighted >= self.option_count - 1,
+        )
+
+
+class FocusNavListView(ListView):
+    """订阅列表：末行再 ↓ 移交按钮行（订阅列表的 Enter 是改名，不受影响）。"""
+
+    BINDINGS: ClassVar[Bindings] = [
+        Binding("down", "cursor_down_or_exit", show=False),
+    ]
+
+    def action_cursor_down_or_exit(self) -> None:
+        _exit_at_end(self, at_end=self.index is None or self.index >= len(self.children) - 1)

feedscope/ui/labels.py

@@ -0,0 +1,38 @@
+"""键位文案的 i18n 解析：类级 BINDINGS 的 description 存文案键，挂载时翻译。
+
+Binding 的 description 在类体里求值（import 期），那时进程语言未定（测试
+还要在同进程里来回切），description 只能存 i18n 键、挂载时统一解析——
+Footer 实时读 _bindings，替换即生效。这与 reading 系按源单位词 relabel
+（_relabel_bindings，传最终文案）是同一手法的两个用法：一个是静态键、
+一个是动态词。
+
+约定：App 与各 Screen 的 on_mount 调 retranslate_bindings(self)；带键位
+的 widget（主屏列表：tab/shift+tab 的真实归属）由所属屏一并翻译——漏调
+的地方 Footer 会显示原始键名（肉眼即见，en 冒烟测试兜底）。
+"""
+
+from __future__ import annotations
+
+import dataclasses
+from typing import Any
+
+from textual.app import App
+from textual.widget import Widget
+
+from feedscope.core.i18n import has, t
+
+
+def retranslate_bindings(holder: App[Any] | Widget) -> None:
+    """把 holder 键位表里以文案键书写的 description 换成当前语言文本。
+
+    非键描述直通（has 判定）：relabel 后的源单位词等最终文案不是键，不能
+    进 t()——否则落到「缺键」警告还会把文案换成键名。
+    """
+    table = holder._bindings.key_to_bindings
+    for key, bindings in list(table.items()):
+        table[key] = [
+            dataclasses.replace(b, description=t(b.description))
+            if b.description and has(b.description)
+            else b
+            for b in bindings
+        ]

feedscope/ui/layout.py

@@ -0,0 +1,66 @@
+"""布局度量：列表屏与详情屏共用的可用宽度计算、元信息列与 resize 防抖间隔。
+
+魔数与 CSS 的对应关系集中在这里——改 CSS 必须同步改这里，
+这是两屏唯一允许出现宽度算术的地方。
+"""
+
+from __future__ import annotations
+
+from feedscope.core.i18n import t
+from feedscope.core.models import FeedItem
+from feedscope.core.source import Source
+from feedscope.core.text import display_width
+
+# 列表行的固定开销（不含元信息列）：滚动条(2) + ListItem padding 0 1(2)
+# + .item-title padding-left(1)；元信息列宽随批内容自适应（见 score_col_width），
+# 折行算术在 list_title_width 把两者合起来
+LIST_ROW_OVERHEAD = 5
+
+# 元信息列（.item-score）宽度算术：列宽 = 批内最长文本 + SPARE 余量（逐行
+# inline 设置，CSS 不写死）。X 署名「名字 @handle」完整可读靠折行而不是加宽
+# 列——正文都能折行，署名同理：超过列宽的在空格处断开，名字一行、@账号
+# 一行（右对齐 + text-wrap: wrap，绝不缩略）。MAX 是列宽上限，保标题列有
+# 足够宽度；18 ≈ 放得下任何 @handle（上限 15 字符）+ 常见短署名单行，
+# 知乎热榜「2606 万热度」这类短元信息也只占实际所需。
+META_COL_SPARE = 2
+META_COL_MAX = 18
+
+# 正文 markdown 可用宽 = 容器宽 - 8：
+# 滚动条(2) + 左右 padding 0 2(4) + 2 列余量防 Rich 二次折行
+MD_OVERHEAD = 8
+
+# resize 防抖：拖拽改宽会连发 Resize，稳定后再整屏重排
+RESIZE_DEBOUNCE = 0.15  # 秒
+
+
+def list_title_width(container_width: int, meta_col_width: int) -> int:
+    """列表标题列的折行可用宽；meta_col_width = 当前批的元信息列宽。"""
+    return max(10, container_width - LIST_ROW_OVERHEAD - meta_col_width)
+
+
+def md_body_width(container_width: int) -> int:
+    """详情正文的折行可用宽。"""
+    return max(20, container_width - MD_OVERHEAD)
+
+
+def meta_col_text(source: Source, it: FeedItem) -> str:
+    """元信息列文本：所有源、所有流同一条规则——「[类型标签] 作者/热度/回复数」。
+
+    标签预告 Enter 的行为（非详情类型跳浏览器，词汇表归源，见 Source.kind_labels）；
+    有标签时与元信息并列显示，不再顶掉作者。任何情况下不截断——列宽随批内
+    最长内容自适应（见 score_col_width），超上限的长署名在列内折行（换行可以，
+    缩略不行），名字与账号必须完整可见。
+    """
+    tag = t(source.kind_labels.get(it.kind, ""))
+    return f"[{tag}] {it.meta}".strip() if tag else it.meta
+
+
+def score_col_width(source: Source, items: list[FeedItem]) -> int:
+    """元信息列宽：批内最长文本的显示宽 + 2 余量（META_COL_MAX 封顶）。
+
+    自适应让知乎热榜「2606 万热度」这类短元信息只占实际所需；超过 MAX 的
+    长署名不加宽列（标题列优先），在列内折行——名字一行、@账号一行，完整
+    可见。空列表给 1（空态不显示列表）。
+    """
+    longest = max((display_width(meta_col_text(source, it)) for it in items), default=1)
+    return min(longest, META_COL_MAX) + META_COL_SPARE

feedscope/ui/list_render.py

@@ -0,0 +1,42 @@
+"""列表行的渲染件：FeedItem -> ListItem 部件（纯展示，与度量算术同族）。
+
+从 main.py 下沉的三个纯函数（main 只留「何时重建」，「怎么建一行」在这）：
+元信息列文本、折行标题、整行部件。度量与 CSS 常量的对应关系在
+ui/layout.py，本模块只做组装。
+"""
+
+from __future__ import annotations
+
+from rich.markup import escape
+from textual.containers import Horizontal
+from textual.widgets import Label, ListItem
+
+from feedscope.core.models import FeedItem
+from feedscope.core.source import Source
+from feedscope.ui.layout import meta_col_text
+from feedscope.ui.wrap import wrap_display
+
+
+def meta_col(source: Source, it: FeedItem) -> str:
+    """元信息列的 markup 文本（规则见 layout.meta_col_text）；空元信息占一格空位。"""
+    text = meta_col_text(source, it)
+    return f"[dim]{escape(text)}[/dim]" if text else " "
+
+
+def build_item(it: FeedItem, width: int, score_width: int, source: Source) -> ListItem:
+    """一条 FeedItem -> 列表行部件（元信息列 + 折行标题）。
+
+    标题按 width 折行（规范版：避头尾 + 词不拆），逐行转义；元信息列宽
+    逐行 inline 设置（列宽随批内容自适应，见 layout.score_col_width），
+    右对齐与超宽折行走 CSS（.item-score / .item-title）。
+    """
+    title = "\n".join(escape(line) for line in wrap_display(it.title, width))
+    score = Label(meta_col(source, it), classes="item-score")
+    score.styles.width = score_width
+    return ListItem(
+        Horizontal(
+            score,
+            Label(title, classes="item-title"),
+            classes="item-row",
+        )
+    )

feedscope/ui/screens/__init__.py

@@ -0,0 +1 @@
+"""TUI 屏幕：主屏在 main.py，问题详情屏在 detail.py，回答详情屏在 answer.py。"""