@ilikexiaoni/pi-task-list 0.4.1 → 0.4.2

package/README.md

@@ -13,6 +13,7 @@
 - `task-context-bridge` 通过 Pi 标准 `context` 事件注入短只读摘要，让上下文压缩后仍能看到当前、阻塞和下一步任务；它不修改 Magic Context，也不维护第二份状态。摘要按状态和总长度设上限，不注入完整证据。
 - TUI 中显示固定 5 行的紧凑任务 Widget、Footer 状态，以及 `/tasks` 可展开详细面板。
 - 紧凑 Widget 只挂载一次；任务变化时原地更新，内容未变化时不请求重绘。所有行按终端宽度截断，任务再多也不会扩高或换行。
+- `/tasks` 详情使用有界居中面板，窗口大小变化时自动重算视口；fullscreen 模式接收 Pi 归一化鼠标滚轮事件，regular 模式使用跨终端键盘导航，避免依赖 Linux/Windows 各自的原始鼠标序列。
 - 工具执行模式为 sequential，避免多个并行调用互相覆盖任务状态。
 
 ## 使用
@@ -45,6 +46,24 @@
 
 当存在阻塞时，第三行优先显示最高优先级的阻塞任务及原因；没有阻塞时才显示下一项可执行任务。完整任务、依赖、备注和全部证据仍通过 `/tasks` 查看。
 
+详情面板导航：
+
+```text
+↑↓ / j / k       上下滚动
+u / d / Space     上下翻页
+Home / End / g/G  跳到开头或结尾
+Esc               关闭面板
+鼠标滚轮          仅 fullscreen TUI 可用
+```
+
+需要鼠标滚轮时启动 fullscreen TUI：
+
+```powershell
+pi --tui-mode fullscreen
+```
+
+regular TUI 中终端会保留鼠标滚轮用于自己的 scrollback，这是 Pi 宿主的设计边界；插件不会拦截或伪造原始平台鼠标序列。
+
 典型更新：
 
 ```json
@@ -72,13 +91,13 @@ pi install npm:@ilikexiaoni/pi-task-list
 固定版本安装：
 
 ```powershell
-pi install npm:@ilikexiaoni/pi-task-list@0.4.1
+pi install npm:@ilikexiaoni/pi-task-list@0.4.2
 ```
 
 项目级安装：
 
 ```powershell
-pi install -l npm:@ilikexiaoni/pi-task-list@0.4.1
+pi install -l npm:@ilikexiaoni/pi-task-list@0.4.2
 ```
 
 本地开发安装：
@@ -91,7 +110,7 @@ pi install "path/to/pi-task-list"
 
 ## 发布
 
-包名为 `@ilikexiaoni/pi-task-list`，使用 `pi-package` keyword，可被 Pi Package Gallery 发现。发布前先执行 `npm pack --dry-run` 检查 tarball 内容，再由已登录的 npm 账号执行 `npm publish --access public`。
+包名为 `@ilikexiaoni/pi-task-list`，使用 `pi-package` keyword，可被 Pi Package Gallery 发现。当前发布版本为 `0.4.2`。发布前先执行 `npm pack --dry-run` 检查 tarball 内容，再由已登录的 npm 账号执行 `npm publish --access public`。
 
 本包不包含测试目录、会话数据或本机配置；发布动作不会由开发脚本自动执行。
 

package/extensions/task-list.ts

@@ -1,6 +1,6 @@
 import { StringEnum } from "@earendil-works/pi-ai";
 import type { ExtensionAPI, ExtensionContext, Theme } from "@earendil-works/pi-coding-agent";
-import { matchesKey, Text, truncateToWidth, type TUI } from "@earendil-works/pi-tui";
+import { matchesKey, Text, truncateToWidth, type TUI, type TuiMouseEvent, type TuiMouseEventResult } from "@earendil-works/pi-tui";
 import { Type } from "typebox";
 import {
   MAX_FIELD_LENGTH,
@@ -319,10 +319,16 @@ class TaskListComponent {
     private readonly dependencyState: TaskState = state,
   ) {}
 
-  private pageSize(): number {
+  private viewportRows(): number {
     const rows = this.tui.terminal?.rows;
+    if (typeof rows !== "number" || rows <= 0) return 24;
+    // Keep the detail view inside a stable modal viewport on both TUI modes.
+    return Math.max(6, Math.min(rows - 2, Math.floor(rows * 0.86)));
+  }
+
+  private pageSize(): number {
     // Reserve one line for the footer while remaining usable on tiny terminals.
-    return typeof rows === "number" && rows > 0 ? Math.max(1, rows - 2) : 22;
+    return Math.max(1, this.viewportRows() - 1);
   }
 
   private buildContent(width: number): string[] {
@@ -410,12 +416,12 @@ class TaskListComponent {
     const page = Math.max(1, this.pageSize() - 1);
     const maximum = this.maxScroll(width);
     let next = this.scrollTop;
-    if (matchesKey(data, "up")) next -= 1;
-    else if (matchesKey(data, "down")) next += 1;
-    else if (matchesKey(data, "pageUp")) next -= page;
-    else if (matchesKey(data, "pageDown")) next += page;
-    else if (matchesKey(data, "home")) next = 0;
-    else if (matchesKey(data, "end")) next = maximum;
+    if (matchesKey(data, "up") || data === "k") next -= 1;
+    else if (matchesKey(data, "down") || data === "j") next += 1;
+    else if (matchesKey(data, "pageUp") || data === "u") next -= page;
+    else if (matchesKey(data, "pageDown") || data === "d" || data === " ") next += page;
+    else if (matchesKey(data, "home") || data === "g") next = 0;
+    else if (matchesKey(data, "end") || data === "G") next = maximum;
     else return;
 
     next = Math.max(0, Math.min(maximum, next));
@@ -425,6 +431,21 @@ class TaskListComponent {
     this.tui.requestRender();
   }
 
+  handleMouse(event: TuiMouseEvent): TuiMouseEventResult | undefined {
+    // Pi's regular TUI intentionally leaves the wheel to the terminal scrollback.
+    // Only consume normalized wheel events in fullscreen, where the host enables mouse reporting.
+    if (this.tui.mode !== "fullscreen" || event.type !== "wheel" || !event.wheelDelta) return undefined;
+
+    const width = Math.max(1, event.width || this.cachedWidth || this.tui.terminal?.columns || 80);
+    const maximum = this.maxScroll(width);
+    const next = Math.max(0, Math.min(maximum, this.scrollTop + event.wheelDelta));
+    if (next === this.scrollTop) return { handled: true, focus: true, render: false };
+
+    this.scrollTop = next;
+    this.invalidate();
+    return { handled: true, focus: true, render: true };
+  }
+
   render(width: number): string[] {
     const safeWidth = Math.max(1, width);
     const content = this.buildContent(safeWidth);
@@ -437,7 +458,10 @@ class TaskListComponent {
     const visible = content.slice(this.scrollTop, this.scrollTop + viewport);
     while (visible.length < viewport) visible.push("");
     const position = content.length === 0 ? "0/0" : `${this.scrollTop + 1}-${Math.min(content.length, this.scrollTop + viewport)}/${content.length}`;
-    visible.push(truncateToWidth(`  ${this.theme.fg("dim", `位置 ${position} · ↑↓ 滚动 · PageUp/PageDown 翻页 · Home/End 跳转 · Esc 关闭`)}`, safeWidth));
+    const navigation = this.tui.mode === "fullscreen"
+      ? "滚轮/↑↓/jk 滚动 · u/d/Space 翻页 · Home/End/g/G 跳转 · Esc 关闭"
+      : "↑↓/jk 滚动 · u/d/Space 翻页 · Home/End/g/G 跳转 · Esc 关闭（fullscreen 支持滚轮）";
+    visible.push(truncateToWidth(`  ${this.theme.fg("dim", `位置 ${position} · ${navigation}`)}`, safeWidth));
 
     this.cachedWidth = safeWidth;
     this.cachedOffset = this.scrollTop;
@@ -642,7 +666,22 @@ export default function taskListExtension(pi: ExtensionAPI) {
         );
         return;
       }
-      await ctx.ui.custom<void>((tui, theme, _keybindings, done) => new TaskListComponent(selected.state, theme, selected.title, tui, () => done(), selected.dependencyState));
+      await ctx.ui.custom<void>(
+        (tui, theme, _keybindings, done) => new TaskListComponent(selected.state, theme, selected.title, tui, () => done(), selected.dependencyState),
+        {
+          // A modal gives fullscreen mode a bounded hit target for normalized wheel events.
+          // Regular mode still uses keyboard navigation because Pi delegates its wheel to scrollback.
+          overlay: true,
+          overlayOptions: () => {
+            return {
+              width: "92%",
+              maxHeight: "86%",
+              anchor: "center",
+              margin: 1,
+            };
+          },
+        },
+      );
     },
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ilikexiaoni/pi-task-list",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "type": "module",
   "description": "A generic structured task list extension for Pi with dependencies, evidence, and visible progress.",
   "keywords": [