que01
bc4b9a9717
Steps 1-3 of the main map road interval editor. EditSession keeps the command stack, undo/redo and previewSeq arbitration as pure logic with no OpenLayers reference, so all of it is unit-tested in node. Pointer displacement converts to meters through EPSG:4326 and spherical distance: treating a 3857 delta as meters desyncs the geometry from the cursor by 1/cos(latitude). Handle drags project onto the axis the manifest declares and clamp to its range, so the client never writes a coordinate into a road polygon. All of it sits behind a directEdit flag that defaults to off. With the flag off the workbench requests no manifest, creates no extra source and registers no interaction, so behaviour matches main. The ol-ext probe passed its three gates but is not adopted for road handles. Transform translates by the raw pointer delta, so a handle detaches from its clamped constraint value: a drag reading -24.1 m produced a draft of -5.4 m. Production needs the handle position derived from the constraint instead, which means owning the position update, so native OL PointerInteraction will carry the drag. ol-ext stays out of package.json; the probe is kept as a manual harness. Reserve handles are unreachable with the current solver, recorded in research/ rather than worked around. Also names the dead backend when an API response is empty, instead of surfacing "Unexpected end of JSON input" from response.json(). Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
69 lines
3.6 KiB
Markdown
69 lines
3.6 KiB
Markdown
# ol-ext Transform 限时探针
|
||
|
||
对应 `.trellis/tasks/08-26-direct-edit-map-editor/implement.md` 第 1 步。
|
||
|
||
这个探针只回答一个问题：**能否复用 ol-ext 通用 handle 的命中、pointer 生命周期与视觉反馈。**
|
||
它不回答“道路语义怎么建模”——那部分由 `src/edit/` 的 `EditSession` / `projection` 负责，且已经独立单测通过。
|
||
|
||
## 怎么跑
|
||
|
||
```bash
|
||
npm install ol-ext --no-save # 门禁通过前不进依赖清单
|
||
npm run dev
|
||
```
|
||
|
||
然后打开 <http://localhost:5173/probe/ol-ext-transform/>。
|
||
|
||
不需要导入 OSM，也不需要后端：页面用 `fixture.ts` 里的合成道路。
|
||
|
||
## 你要做的事
|
||
|
||
拖动地图上那个**蓝色圆点手柄**，来回拖几次，快慢都试，然后看右侧面板。
|
||
|
||
## 三条门禁（必须同时成立）
|
||
|
||
| # | 门禁 | 面板怎么读 |
|
||
|---|---|---|
|
||
| 1 | OL `Map` 未被重建 | “实例 #N，累计构造 N 次”两个数字必须相等。再点几次“强制 React 重渲染”，数字仍要相等。 |
|
||
| 2 | 基线 source 未被写入 | “写入 0 次，几何未改变”。拖拽过程中这行**任何变化都算失败**。 |
|
||
| 3 | proxy 拖拽稳定且事件能转成 draft 值 | 看**「原始位移」**那行跟手连续变化、松手不跳；手柄不粘滞、不丢命中。 |
|
||
|
||
门禁 3 要看的是「原始位移」，不是「约束值」。约束值带生产钳位 `±5.4 米`，
|
||
而 5.4 米在 zoom 20 只有约 47 像素，稍微拖远就会顶到边界显示成常量——那是正常的，不代表跟踪有问题。
|
||
「原始位移」不钳位，所以它才反映跟手质量。
|
||
|
||
两个数都是用生产代码算的（`signedMetersAlongAxis()` / `projectHandleValue()`），
|
||
所以门禁 3 同时验证了“事件 → 约束值”这条链路。
|
||
|
||
另外面板会显示收到了多少个 `translating` 事件。这个数字和 React 渲染次数的比例是个有用的信号：
|
||
探针已经把逐帧读数用 `requestAnimationFrame` 合并了，生产实现还要更进一步——
|
||
ghost 直接写自己的 OL source，绝不为每次指针移动重渲染 React 树。
|
||
|
||
注意：**卸载/重新挂载地图会构造新的 Map，这是预期行为**，不算门禁 1 失败。门禁 1 针对的是拖拽与重渲染。
|
||
|
||
## 请回报给我
|
||
|
||
1. 三条门禁分别通过/未通过。
|
||
2. 未通过的，面板上的具体数字或现象。
|
||
3. 主观手感：拖拽是否顺滑，手柄命中是否可靠。
|
||
|
||
## 已知的、探针之外的结论
|
||
|
||
这些我已经查过，不用你验证，但会计入最终取舍：
|
||
|
||
- ol-ext 4.0.38，BSD-3-Clause，`peerDependencies: ol >= 5.3.0`，无运行时依赖。
|
||
- **不带 TypeScript 类型，也没有 `@types/ol-ext`。** 本目录的 `ol-ext.d.ts` 是我为探针手写的最小声明；
|
||
真要把 ol-ext 提为正式依赖，就要长期自己维护一份声明文件。
|
||
- `Transform` 的 `translate` 分支直接对传入 feature 调 `geometry.translate()`。
|
||
所以它只能绑一次性 proxy，绝不能绑编译产物图层——这也是门禁 2 存在的原因。
|
||
- 它的手柄模型是 bounding box 的 scale/rotate/stretch，跟道路法线偏移、区间范围、路口 cutback 不是一回事。
|
||
即使门禁全过，它最多承担“通用手柄的命中与拖拽生命周期”，语义投影仍然是我们自己的 `projection.ts`。
|
||
|
||
## 如果门禁没过
|
||
|
||
按 `design.md` 的回退优先级，删掉本目录，改用回退方案 1：
|
||
原生 OL `Snap` + 小型 `PointerInteraction` adapter。
|
||
|
||
`HandleManifest → RoadEditOperation → RoadConstraint → preview solver` 的数据合约不变，
|
||
所以这一步失败只换输入层，第 2 步已交付的 `EditSession` / `projection` / `meters` 全部保留。
|