66 lines
3.0 KiB
Markdown
66 lines
3.0 KiB
Markdown
# Reasonix Batch F / Worker A：5-29 block menu layout helper 候选
|
||
|
||
Project root：`/mnt/Data1T/mnote-worktrees/0525-f-worker-a-5-29-block-menu-layout`
|
||
|
||
## 目标
|
||
|
||
在独立 worktree 中产出候选 patch，把 `rust/spikes/leptos-tiptap-spike/src/lib.rs` 中 block menu hover / layout 的最小可迁 helper 迁入 `editor_runtime` 子模块，继续减少 `lib.rs` 中 block menu overlay 逻辑。
|
||
|
||
优先迁出：
|
||
|
||
- `hover_anchor_top(block)`
|
||
- `hover_anchor_transform(block)`
|
||
- `block_menu_layout(block)`
|
||
|
||
如实现边界自然，可新增 `editor_runtime/block_menu_overlay.rs` 或等价命名。不要迁 `pointer_in_handle_corridor`、`drop_indicator_from_target`、`drop_indicator_from_point`，因为它们更接近拖拽 hit-test 逻辑。
|
||
|
||
## 允许修改
|
||
|
||
- `rust/spikes/leptos-tiptap-spike/src/lib.rs`
|
||
- `rust/spikes/leptos-tiptap-spike/src/editor_runtime/mod.rs`
|
||
- 新增 `rust/spikes/leptos-tiptap-spike/src/editor_runtime/block_menu_overlay.rs`
|
||
|
||
如 Rust island 源码变更并需要浏览器验证，可更新：
|
||
|
||
- `rust/spikes/leptos-tiptap-spike/generated/island/mnote-leptos-tiptap-spike-island.js`
|
||
- `rust/spikes/leptos-tiptap-spike/generated/island/mnote-leptos-tiptap-spike-island_bg.wasm`
|
||
|
||
## 禁止事项
|
||
|
||
- 不修改 `rust/crates/mnote-web/`。
|
||
- 不迁 `sync_editor_overlay_state` / `try_sync_editor_overlay_state` 整个大函数。
|
||
- 不迁拖拽 hit-test：`pointer_in_handle_corridor`、`drop_indicator_from_target`、`drop_indicator_from_point`。
|
||
- 不改 block menu 行为语义，不回退 history-safe delete。
|
||
- 不修改 AGENTS、design、bugs 或 git 状态。
|
||
- 不提交 git。
|
||
|
||
## 实现要求
|
||
|
||
- 新模块只承接 block menu hover anchor / layout helper，可通过参数注入 `stage_width` / `stage_top` / `stage_left` 等值，也可在模块内调用现有 DOM helper，但必须保持行为同构。
|
||
- 如果引入参数化 helper，`lib.rs` 保留 DOM 查询，模块只做几何计算优先。
|
||
- 保持 `BlockMenuLayout`、`HoveredBlockState` 从 `block_hover_state.rs` 读取。
|
||
- 不新增对 Leptos signal 的依赖。
|
||
|
||
## 验收命令
|
||
|
||
```bash
|
||
cargo fmt --manifest-path rust/Cargo.toml --all --check
|
||
cargo check --manifest-path rust/spikes/leptos-tiptap-spike/Cargo.toml
|
||
cargo build --manifest-path rust/spikes/leptos-tiptap-spike/Cargo.toml --target wasm32-unknown-unknown --release
|
||
wasm-bindgen rust/spikes/leptos-tiptap-spike/target/wasm32-unknown-unknown/release/mnote_leptos_tiptap_spike.wasm --target web --out-dir rust/spikes/leptos-tiptap-spike/generated/island --out-name mnote-leptos-tiptap-spike-island
|
||
NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task489-block-menu-delete-undo-smoke.js
|
||
NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task488-local-attachment-link-delete-undo-smoke.js
|
||
```
|
||
|
||
## 输出要求
|
||
|
||
handoff 必须列出：
|
||
|
||
- 修改文件。
|
||
- 迁出的 helper 和未迁出的边界。
|
||
- 为什么不会破坏 block menu delete undo / drag reorder。
|
||
- 验收命令和结果。
|
||
- 浏览器 smoke 证据路径。
|
||
- 未覆盖风险。
|
||
- `git diff --stat`。
|