chore(task): plan crosswalk element editor experiment

.trellis/tasks/08-28-crosswalk-element-editor/design.md

@@ -0,0 +1,59 @@
+# 斑马线元素级编辑器设计
+
+## 架构边界
+
+本实验扩展现有直接编辑链路，而非建立画布对象存储：
+
+```text
+crosswalk feature 点击
+  -> elementId
+  -> element manifest (anchor + parameters + legal controls)
+  -> native-road-edits/v2 constraint
+  -> resolveDirectEditConstraints
+  -> compileControlMarkings
+  -> preview / save / recompile
+```
+
+`elementId` 是选择和分组标识；持久化仍使用稳定语义 anchor 上的 constraint。它不能是 GeoJSON 数组下标、屏幕坐标或临时 UUID。
+
+## 选择合同
+
+斑马线的每一条 stripe feature 必须包含 `native_id`、`element_id` 与可回链的 crossing / approach 身份。选择适配层只读取 `element_id`，再向服务器取得选中元素的权威 manifest。客户端不会据条带数量、空间距离或渲染顺序自行聚类。
+
+元素 manifest 至少包含：
+
+```ts
+interface EditableElement {
+  elementId: string
+  kind: 'crosswalk'
+  anchor: { type: 'junction-approach'; nodeId: string; segmentId: string }
+  featureIds: string[]
+  controls: Array<{
+    kind: 'position' | 'length' | 'width'
+    value: { current: number; min: number; max: number; unit: 'meter' }
+    axisAzimuth?: number
+  }>
+  fields: Array<{ key: string; value: number; min: number; max: number; unit: 'meter' | 'count' }>
+}
+```
+
+第一阶段只发布 `position` 及其现有 `junction-crosswalk-inset` 回写规则。第二阶段再加入尺寸和条带参数，避免在实验开始前规定尚未验证的通用元素协议。
+
+## 编辑与预览
+
+- 选择由 `MapCanvas` 的 feature 事件产生，但选择状态由 App/编辑会话持有，不能写入 baseline source。
+- 元素控件写入的是 manifest 指定的 constraint kind/value；表单复用同一写入器。
+- 选中框和控件只是 `editHandles` / `editGhost` 层的临时 UI；权威预览仍由服务端返回，baseline source 不被客户端改写。
+- 空白点击会清除元素选择；道路选择可继续决定道路级 handle manifest。斑马线元素选中与道路选择可并存，但两组控件不得重叠或竞争同一 pointer 手势。
+
+## 数据演进
+
+第一阶段不新增 persisted schema：位置继续使用已有 `junction-crosswalk-inset`。第二阶段如果确实需要尺寸参数，新增一个专属 kind 或扩展同一 kind 的严格 schema 校验；具体选择以第一阶段运行结果为准，不预先固化。
+
+缺省参数必须字节级保持现有斑马线输出。参数越界、条带间互相重叠或越过可用进口范围均返回 blocking diagnostic，不在客户端静默钳制真实约束。
+
+## 兼容与回滚
+
+- 无新 constraint 时，编译输出与当前版本一致。
+- `directEdit` 关闭时不请求 element manifest、不安装元素选择交互、不产生额外图层。
+- 第一阶段每个步骤独立提交；回滚元素 UI 或 manifest 不影响既有道路级控制。