Files
mnote/design/04-tree-domain/done/4-13-task-004-picker-final-renderer-state-family-checklist-v1.md
T

38 lines
2.6 KiB
Markdown
Raw Normal View History

# 4-13 [done] task-004 picker final renderer state family 执行清单 v1
> 口径修正(2026-04-28):本文件的 `done` 状态只表示 picker state-family / runtime reducer / hydrated DOM patch 阶段完成;不表示 picker 已脱离 `TreeShellIframeHost` 的 inline JS DOM shell。final DOM shell 收口以 `4-18-tree-final-dom-shell-cutover-hard-gate-v1.md` 为准;该硬门禁现已在同目录 `done/` 收口。
## 目标
`picker``rust_family` 默认路径下继续退出 compat JS 高亮与 pick 执行路径,收口到轻量 final renderer state family
- 首屏 DOM 继续由 `data-rust-picker-renderer="initial_v1"` 输出。
- 空查询态、搜索结果态、根目录、排除项使用同一 picker state family 口径。
- 键盘高亮与 Enter pick 只走 `rust_picker_state_reducer_v1` 合同入口,并在 hydrated Rust DOM 上 patch `data-focused / tabIndex`
- 鼠标点击 picker row/root 不再绕过 state family;应先归一化当前 active item,再按同一 pick 结果回传宿主。
- 3000 inline host 与 `mnote-web /tree` debug shell 保持同一可测试合同。
## 执行项
- [x] 补齐 3000 inline picker state family 口径:
- [x] `getPickablePickerEntries` 区分 root 与 doc,并应用 `excludeIds` 后只返回可选项。
- [x] `normalize``focus``next/previous/home/end``pick` 使用同一 pickable 列表。
- [x] 鼠标点击 row/root 通过 state action + `postPickerPickResultToHost`,不直接调用 `handleNavigate` / `tree.pick.root`
- [x] 对齐 `mnote-web /tree` debug runtime
- [x] row/root 点击同样经 state action + pick result helper。
- [x] hydrated Rust DOM 下高亮变化只 patch,不整树重绘;键盘 command 不把焦点抢入 iframe,搜索框焦点保持在宿主输入框。
- [x] 测试覆盖:
- [x] `cargo test -p mnote-web picker_renderer && cargo test -p mnote-web picker_state`
- [x] `pnpm vitest run src/components/documents/move-embed-picker-dialog.test.tsx src/components/sidebar/tree-shell-iframe-host.test.tsx`
- [x] `node scripts/task113-picker-keyboard-regression-smoke.js`
## 完成记录
- 2026-04-26`task113` 的根因是键盘 command 后 hydrated picker row 主动 `focus()`,导致父级搜索输入框失焦;已改为键盘/state patch 只更新 `data-focused / tabIndex`,点击路径才允许 `focusDom: true`
- 2026-04-263000 inline host 与 `mnote-web /tree` debug shell 已同步 `postPickerPickResultToHost`、pickable state family、row/root click state action 路径。
## 非目标
- 本清单不处理 file tree 的 final renderer;对应 `task-005`
- 本清单不拆除 compat host;对应 `task-006`