gis-view-webgl2 0.1.4 → 0.1.6

package/docs/steps/selftest-demos.html

@@ -142,12 +142,14 @@
 				miniHost.style.cssText = 'position:absolute;left:-9999px;width:180px;height:120px'
 				document.body.append(miniHost)
 				const miniData = {
-					points: [{ x: 50, y: 50 }],
+					points: [{ x: 50, y: 50, size: 10, inheritSize: true }],
 					lines: [
 						{ path: [[0, 0], [100, 0]], minX: 0, minY: 0, maxX: 100, maxY: 0 },
 						{ path: [[1000, 1000], [1100, 1000]], minX: 1000, minY: 1000, maxX: 1100, maxY: 1000 }
 					]
 				}
+				const miniViewport = { cssWidth: 450, cssHeight: 600, pixelRatio: 1, displayScale: 1 }
+				let miniCameraScale = 1
 				const mini = createMinimap(miniHost, {
 					enabled: true,
 					width: 180,
@@ -157,8 +159,8 @@
 					maxPixelRatio: 1
 				}, {
 					getData: () => miniData,
-					getCamera: () => ({ center: [50, 50], scale: 1 }),
-					getViewport: () => ({ width: 180, height: 120, pixelRatio: 1, displayScale: 1 }),
+					getCamera: () => ({ center: [50, 50], scale: miniCameraScale }),
+					getViewport: () => miniViewport,
 					getFallbackBounds: () => ({ minX: 0, minY: 0, maxX: 100, maxY: 100 }),
 					getZoomBaseScale: () => 0,
 					getBackground: () => null
@@ -168,6 +170,21 @@
 				check('鹰眼图线路层：首帧只铺固定范围里的线路（范围外那条被跳过）',
 					miniFirst.lineRasterDraws > 0 && miniFirst.linePathsDrawn === miniFirst.lineRasterDraws,
 					JSON.stringify(miniFirst))
+				const inheritedAtBase = miniFirst.paintedInheritedSizeFactor
+				miniCameraScale = 2
+				mini.refresh()
+				await wait(100)
+				const inheritedAfterMainZoom = mini.getPaintStats().paintedInheritedSizeFactor
+				check('鹰眼图：沿用主图尺寸按 CSS 视口比例缩放，主图放大不改变继承节点大小',
+					Math.abs(inheritedAtBase - 0.2) < 1e-6 && Math.abs(inheritedAfterMainZoom - inheritedAtBase) < 1e-6,
+					`${inheritedAtBase} -> ${inheritedAfterMainZoom}`)
+				miniViewport.cssHeight = 300
+				mini.refresh()
+				await wait(100)
+				const inheritedAfterResize = mini.getPaintStats().paintedInheritedSizeFactor
+				check('鹰眼图：主图视口尺寸变化后，沿用主图尺寸按新的视口比例重铺',
+					Math.abs(inheritedAfterResize - 0.4) < 1e-6,
+					String(inheritedAfterResize))
 				mini.refresh()
 				await wait(100)
 				const miniRepeat = mini.getPaintStats()
@@ -422,6 +439,25 @@
 						const draftArrow = channelDraftArrowPlacement([[0, 0], [60, 0], [60, 80]])
 						check('可视化连线：预览箭头中心按整条折线弧长取中点（不是贴在最后一段末端），与落地线路的单箭头同口径', Boolean(draftArrow) && Math.abs(draftArrow.center[0] - 60) < 1e-9 && Math.abs(draftArrow.center[1] - 10) < 1e-9 && draftArrow.unitX === 0 && draftArrow.unitY === 1, JSON.stringify(draftArrow))
 
+						const startPointSelect = document.querySelector('[data-demo=connect-start-point]')
+						startPointSelect.value = 'node-0'
+						startPointSelect.dispatchEvent(new Event('change', { bubbles: true }))
+						await wait(60)
+						document.querySelector('[data-demo=connect-start]').click()
+						await wait(80)
+						const presetStartDraft = view.getAddChannelDraft()
+						check('可视化连线：下拉指定起点后，beginAddChannel 直接进入 from 草稿且下一次点击只选终点', presetStartDraft?.phase === 'from' && String(presetStartDraft?.from?.id) === 'node-0', presetStartDraft ? `${presetStartDraft.phase} / from ${presetStartDraft.from?.id}` : '没有草稿')
+						await clickNode('node-3')
+						const presetReadyDraft = await until(() => {
+							const current = view.getAddChannelDraft()
+							return current?.phase === 'ready' ? current : null
+						}, 2500)
+						check('可视化连线：指定起点 + 一次节点点击即可形成 ready 草稿', presetReadyDraft?.from?.id === 'node-0' && presetReadyDraft?.to?.id === 'node-3', presetReadyDraft ? `${presetReadyDraft.from?.id} → ${presetReadyDraft.to?.id}` : '没有 ready 草稿')
+						view.cancelAddChannel()
+						startPointSelect.value = ''
+						startPointSelect.dispatchEvent(new Event('change', { bubbles: true }))
+						await wait(80)
+
 						const cancelBefore = view.getData()
 						const cancelDraft = await selectPair('node-0', 'node-3')
 						const style = cancelDraft?.style ?? view.getOptions().channelDraftStyle
@@ -457,6 +493,21 @@
 						const spacingInput = document.querySelector('[data-demo=connect-spacing]')
 						spacingInput.value = '26'
 						spacingInput.dispatchEvent(new Event('input', { bubbles: true }))
+						const dotSizeInput = document.querySelector('[data-demo=connect-dot-size]')
+						dotSizeInput.value = '9'
+						dotSizeInput.dispatchEvent(new Event('input', { bubbles: true }))
+						const dotShapeSelect = document.querySelector('[data-demo=connect-dot-shape]')
+						dotShapeSelect.value = 'square'
+						dotShapeSelect.dispatchEvent(new Event('change', { bubbles: true }))
+						const startDotColorInput = document.querySelector('[data-demo=connect-dot-from-color]')
+						startDotColorInput.value = '#00aa88'
+						startDotColorInput.dispatchEvent(new Event('input', { bubbles: true }))
+						const endDotColorInput = document.querySelector('[data-demo=connect-dot-to-color]')
+						endDotColorInput.value = '#aa2200'
+						endDotColorInput.dispatchEvent(new Event('input', { bubbles: true }))
+						const draftLayerSelect = document.querySelector('[data-demo=connect-draft-layer]')
+						draftLayerSelect.value = 'below-points'
+						draftLayerSelect.dispatchEvent(new Event('change', { bubbles: true }))
 						await wait(100)
 						const beforeBlankCancel = view.getData()
 						document.querySelector('[data-demo=connect-start]').click()
@@ -467,10 +518,14 @@
 							return current?.phase === 'from' ? current : null
 						}, 2500)
 						check('可视化连线：3 回通道草稿把箭头位置与回线间距直接带进本次样式', stagedDraft?.kind === 'channel' && stagedDraft?.circuits === 3 && stagedDraft?.style?.arrowPositions?.join(',') === '0.25,0.75' && stagedDraft?.style?.circuitSpacing === 26, stagedDraft ? JSON.stringify({ kind: stagedDraft.kind, circuits: stagedDraft.circuits, arrows: stagedDraft.style?.arrowPositions, spacing: stagedDraft.style?.circuitSpacing }) : '没有 from 草稿')
+						check('可视化连线：两端示例点的尺寸 / 形状 / 分端颜色与 below-points 层级都进入草稿样式', stagedDraft?.style?.dots?.size === 9 && stagedDraft?.style?.dots?.shape === 'square' && stagedDraft?.style?.dots?.from?.color === '#00aa88' && stagedDraft?.style?.dots?.to?.color === '#aa2200' && stagedDraft?.style?.layer === 'below-points', JSON.stringify(stagedDraft?.style ? { dots: stagedDraft.style.dots, layer: stagedDraft.style.layer } : null))
 						await clickCanvasAt(box.left + 18, box.top + box.height - 18)
 						const blankCancelled = await until(() => view.getAddChannelDraft() === null, 2500)
 						const afterBlankCancel = view.getData()
 						check('可视化连线：选好起点后点空白立即取消，readout 报 click-outside-node 且数据不增加', Boolean(blankCancelled) && text('connect-cancel-readout').includes('click-outside-node') && afterBlankCancel.lines.length === beforeBlankCancel.lines.length && afterBlankCancel.points.length === beforeBlankCancel.points.length && channelList().length === 0, `${text('connect-cancel-readout')} / ${beforeBlankCancel.lines.length} -> ${afterBlankCancel.lines.length} 线`)
+						draftLayerSelect.value = 'above'
+						draftLayerSelect.dispatchEvent(new Event('change', { bubbles: true }))
+						await wait(60)
 
 						// 恢复独立线路配置，继续验证后面的真实落地入口
 						kindSelect.value = 'line'
@@ -480,6 +535,13 @@
 						spacingInput.value = '12'
 						spacingInput.dispatchEvent(new Event('input', { bubbles: true }))
 						await wait(100)
+						const beforeObjectLine = view.getData()
+						const objectLineDraft = await selectPair('node-3', 'node-6')
+						document.querySelector('[data-demo=connect-commit-object]').click()
+						await wait(160)
+						const afterObjectLine = view.getData()
+						const objectLine = afterObjectLine.lines.at(-1)
+						check('可视化连线：commitAddChannel 直接传线路对象即可落地，对象里的 path / 颜色 / 线宽优先于草稿', Boolean(objectLineDraft) && afterObjectLine.lines.length === beforeObjectLine.lines.length + 1 && channelList().length === 0 && String(objectLine?.id).startsWith('connect-object-line-') && (objectLine?.path?.length ?? 0) > 2 && objectLine?.color === '#2f6fd0' && objectLine?.width === 2.4, `${beforeObjectLine.lines.length} -> ${afterObjectLine.lines.length} 线 / ${objectLine?.id ?? '无'} / path ${objectLine?.path?.length ?? 0} / ${objectLine?.color} ${objectLine?.width}`)
 						kindSelect.value = 'channel-2'
 						kindSelect.dispatchEvent(new Event('change', { bubbles: true }))
 						await wait(80)
@@ -490,6 +552,13 @@
 						const afterChannels = view.getData()
 						const addedChannel = channelList().at(-1)
 						check('可视化连线：addChannels 入口真实新建通道并按 circuits 加回线', Boolean(channelDraft) && channelList().length === 1 && afterChannels.lines.length === beforeChannels.lines.length + 2 && addedChannel?.path?.length === 1, `${channelList().length} 通道 / ${beforeChannels.lines.length} -> ${afterChannels.lines.length} 线 / path ${addedChannel?.path?.length ?? 0} / ${text('connect-action-readout')}`)
+						const beforeObjectChannel = view.getData()
+						const objectChannelDraft = await selectPair('node-2', 'node-10')
+						document.querySelector('[data-demo=connect-commit-object]').click()
+						await wait(180)
+						const afterObjectChannel = view.getData()
+						const objectChannel = channelList().at(-1)
+						check('可视化连线：commitAddChannel 直接传通道对象即可按 lineIds / groups 落地', Boolean(objectChannelDraft) && channelList().length === 2 && afterObjectChannel.lines.length === beforeObjectChannel.lines.length + 2 && String(objectChannel?.id).startsWith('connect-object-channel-') && objectChannel?.lineIds?.length === 2 && objectChannel.lineIds.every(id => String(id).startsWith('connect-object-line-')), `${channelList().length} 通道 / ${beforeObjectChannel.lines.length} -> ${afterObjectChannel.lines.length} 线 / ${objectChannel?.id ?? '无'} / ${JSON.stringify(objectChannel?.lineIds ?? [])}`)
 						check('可视化连线：读数面板同步报出纯点 + 线 / 通道数量', text('connect-data-readout').includes('节点') && text('connect-data-readout').includes('通道'), text('connect-data-readout'))
 					}
 					else {
@@ -573,6 +642,111 @@
 						document.querySelector('[data-demo=minimap-zoom-reset]').click()
 						await wait(120)
 						check('鹰眼图配置：1× 按钮把倍数复位成 1', Math.abs(view.getMinimapZoom() - 1) < 1e-9, text('minimap-zoom-readout'))
+						const extentFollowInput = document.querySelector('[data-demo=minimap-extent-follow]')
+						check('鹰眼图配置：extentFollowCamera 默认关闭，自动范围仍按数据 ∪ 底图', Boolean(extentFollowInput) && !extentFollowInput.checked && setup.minimapOptions().extentFollowCamera === false && view.getOptions().minimap.extentFollowCamera === false, extentFollowInput ? `checked ${extentFollowInput.checked} / option ${setup.minimapOptions().extentFollowCamera}` : '没有范围开关')
+						extentFollowInput.click()
+						await wait(160)
+						check('鹰眼图配置：范围跟相机开关打开后下发 extentFollowCamera=true', setup.minimapOptions().extentFollowCamera === true && view.getOptions().minimap.extentFollowCamera === true, String(setup.minimapOptions().extentFollowCamera))
+						extentFollowInput.click()
+						await wait(120)
+						const extentContentInput = document.querySelector('[data-demo=minimap-extent-content]')
+						check('鹰眼图配置：extentFollowContent 默认关闭，内容变化不会重算小图范围', Boolean(extentContentInput) && !extentContentInput.checked && setup.minimapOptions().extentFollowContent === false && view.getOptions().minimap.extentFollowContent === false, extentContentInput ? `checked ${extentContentInput.checked} / option ${setup.minimapOptions().extentFollowContent}` : '没有内容范围开关')
+						extentContentInput.click()
+						await wait(160)
+						check('鹰眼图配置：内容范围开关打开后下发 extentFollowContent=true', setup.minimapOptions().extentFollowContent === true && view.getOptions().minimap.extentFollowContent === true, String(setup.minimapOptions().extentFollowContent))
+						extentContentInput.click()
+						await wait(120)
+						const dragHandle = document.querySelector('[data-demo=minimap-drag-handle]')
+						const dragRoot = document.querySelector('.gis-view__minimap')
+						const dragRectBefore = dragRoot?.getBoundingClientRect()
+						if (dragHandle && dragRoot && dragRectBefore) {
+							const pointer = { bubbles: true, cancelable: true, composed: true, pointerId: 23, pointerType: 'mouse', isPrimary: true, button: 0 }
+							const startX = dragRectBefore.left + dragRectBefore.width / 2
+							const startY = dragRectBefore.top + 8
+							dragHandle.dispatchEvent(new PointerEvent('pointerdown', { ...pointer, clientX: startX, clientY: startY }))
+							dragHandle.dispatchEvent(new PointerEvent('pointermove', { ...pointer, clientX: startX + 18, clientY: startY + 12 }))
+							dragHandle.dispatchEvent(new PointerEvent('pointerup', { ...pointer, clientX: startX + 18, clientY: startY + 12 }))
+							await wait(160)
+							const dragOffset = view.getOptions().minimap.offset
+							const dragRectAfter = dragRoot.getBoundingClientRect()
+							const moved = Math.abs((dragRectAfter.left - dragRectBefore.left) - 18) < 1 && Math.abs((dragRectAfter.top - dragRectBefore.top) - 12) < 1
+							check('鹰眼图配置：顶部手柄能整体拖动鹰眼图，offset 与容器位置同步', dragOffset?.[0] === 18 && dragOffset?.[1] === 12 && moved && text('minimap-offset-readout').includes('18, 12'), `offset=${JSON.stringify(dragOffset)} / ${dragRectBefore.left},${dragRectBefore.top} -> ${dragRectAfter.left},${dragRectAfter.top}`)
+							document.querySelector('[data-demo=minimap-offset-reset]').click()
+							await wait(120)
+							const resetOffset = view.getOptions().minimap.offset
+							check('鹰眼图配置：整图位置复位回到 offset [0, 0]', resetOffset?.[0] === 0 && resetOffset?.[1] === 0 && text('minimap-offset-readout').includes('0, 0'), `${JSON.stringify(resetOffset)} / ${text('minimap-offset-readout')}`)
+						}
+						else {
+							check('鹰眼图配置：能找到整图拖动手柄', false, dragHandle ? '小图根节点尺寸为 0' : '没有整图拖动手柄')
+						}
+						const pointSizeScaleInput = document.querySelector('[data-demo=minimap-point-size-scale]')
+						const lineWidthScaleInput = document.querySelector('[data-demo=minimap-line-width-scale]')
+						check(
+							'鹰眼图配置：节点 / 线路独立整体倍数控件默认都是 1',
+							Boolean(pointSizeScaleInput) && Boolean(lineWidthScaleInput) &&
+								setup.minimapOptions().pointSizeScale === 1 && setup.minimapOptions().lineWidthScale === 1,
+							`${setup.minimapOptions().pointSizeScale} / ${setup.minimapOptions().lineWidthScale}`
+						)
+						pointSizeScaleInput.value = '2'
+						pointSizeScaleInput.dispatchEvent(new Event('input', { bubbles: true }))
+						lineWidthScaleInput.value = '1.6'
+						lineWidthScaleInput.dispatchEvent(new Event('input', { bubbles: true }))
+						pointSizeScaleInput.dispatchEvent(new Event('change', { bubbles: true }))
+						await wait(160)
+						check(
+							'鹰眼图配置：独立整体倍数会随控件下发到 pointSizeScale / lineWidthScale',
+							setup.minimapOptions().pointSizeScale === 2 && setup.minimapOptions().lineWidthScale === 1.6 &&
+								view.getOptions().minimap.pointSizeScale === 2 && view.getOptions().minimap.lineWidthScale === 1.6,
+							`${setup.minimapOptions().pointSizeScale} / ${setup.minimapOptions().lineWidthScale}`
+						)
+						pointSizeScaleInput.value = '1'
+						lineWidthScaleInput.value = '1'
+						pointSizeScaleInput.dispatchEvent(new Event('input', { bubbles: true }))
+						lineWidthScaleInput.dispatchEvent(new Event('input', { bubbles: true }))
+						pointSizeScaleInput.dispatchEvent(new Event('change', { bubbles: true }))
+						await wait(120)
+
+						setup.zoomMode = 'off'
+						setup.dragAction = 'box'
+						setup.applyMinimap()
+						view.zoomBy(2)
+						await wait(260)
+						const boxRoot = document.querySelector('.gis-view__minimap')
+						const boxElement = boxRoot?.querySelector('.gis-view__minimap-box')
+						const rootRect = boxRoot?.getBoundingClientRect()
+						const viewBoxRect = boxElement?.getBoundingClientRect()
+						let boxSelectHit = false
+						if (boxRoot && rootRect && viewBoxRect) {
+							const startX = rootRect.left + 6
+							const startY = rootRect.top + 6
+							const outside = startX < viewBoxRect.left || startX > viewBoxRect.right || startY < viewBoxRect.top || startY > viewBoxRect.bottom
+							if (outside) {
+								const pointer = { bubbles: true, cancelable: true, composed: true, pointerId: 19, pointerType: 'mouse', isPrimary: true, button: 0 }
+								boxRoot.dispatchEvent(new PointerEvent('pointerdown', { ...pointer, clientX: startX, clientY: startY }))
+								boxRoot.dispatchEvent(new PointerEvent('pointermove', { ...pointer, clientX: startX + 36, clientY: startY + 24 }))
+								boxRoot.dispatchEvent(new PointerEvent('pointerup', { ...pointer, clientX: startX + 36, clientY: startY + 24 }))
+								boxSelectHit = Boolean(await until(() => text('minimap-interaction').includes('select'), 1800))
+							}
+						}
+						check('鹰眼图配置：缩放关闭时 dragAction=box 仍能在空白处直接框选主图范围', boxSelectHit && setup.minimapOptions().zoomable === false && setup.dragAction === 'box', `${text('minimap-interaction')} / zoomable ${setup.minimapOptions().zoomable} / dragAction ${setup.dragAction}`)
+
+						setup.zoomMode = 'manual'
+						setup.dragAction = 'pan'
+						setup.applyMinimap()
+						view.fitView(44)
+						await wait(260)
+						setup.zoomMode = 'follow'
+						setup.followZoomScale = 1
+						setup.applyMinimap()
+						await wait(220)
+						const followBase = view.getMinimapZoom()
+						view.zoomBy(1.5)
+						const followed = await until(() => view.getMinimapZoom() > followBase + 0.05, 1800)
+						const followZoom = view.getMinimapZoom()
+						check('鹰眼图配置：zoomable=follow 时主图放大，小图整体倍数按 followZoomScale 跟着变化', Boolean(followed) && setup.minimapOptions().zoomable === 'follow' && followZoom > followBase, `${followBase.toFixed(3)} -> ${followZoom.toFixed(3)} / ${setup.minimapOptions().zoomable}`)
+						view.setMinimapZoom(1)
+						await wait(100)
+						check('鹰眼图配置：跟随主图时 setMinimapZoom 不抢控制权，倍数仍由主图决定', Math.abs(view.getMinimapZoom() - followZoom) < 1e-9, `${followZoom} -> ${view.getMinimapZoom()}`)
 					}
 					else {
 						check('鹰眼图配置：画布与视图都起来了', false, `${ready ? 'canvas 就绪' : '没有 canvas'} / ${view ? 'view 就绪' : '没有 view'}`)
@@ -660,6 +834,71 @@
 							view.focusOn(groupHit)
 							view.selectFeatures(groupHit)
 							check('搜索与筛选：scope=groups 返回通道分组，并可直接聚焦 / 选中分组命中', Boolean(groupReady) && readout('search-filter-summary').includes('节点 0') && readout('search-filter-summary').includes('通道 0') && groupHit?.kind === 'group' && view.getSelections().length > 0, `${readout('search-filter-summary')} / ${JSON.stringify(groupHit)}`)
+							// 相机飞行：duration 0 立即落位；普通时长能读进度并随时停；程序化改相机会自动让路
+							view.flyTo({ minX: 0, minY: 0, maxX: 10, maxY: 10 }, { duration: 0 })
+							const landed = view.getCamera()
+							check('相机飞行：duration=0 立即落位，中心与目标一致且没有残留动画',
+								Math.abs(landed.center[0] - 5) < 1e-6 && Math.abs(landed.center[1] - 5) < 1e-6 && view.cameraAnimating === false && view.getCameraAnimation() === null,
+								JSON.stringify(landed))
+							view.flyTo({ minX: 1000, minY: 1000, maxX: 1010, maxY: 1010 }, { duration: 600 })
+							const flight = view.getCameraAnimation()
+							check('相机飞行：进行中 cameraAnimating / getCameraAnimation / 终点读数都对得上',
+								view.cameraAnimating === true && flight?.active === true && flight.duration === 600 && Math.abs(flight.to.center[0] - 1005) < 1e-6 && Math.abs(flight.to.center[1] - 1005) < 1e-6,
+								JSON.stringify(flight))
+							const stopReturned = view.stopCameraAnimation()
+							check('相机飞行：stopCameraAnimation 链式返回实例、立即结束动画',
+								stopReturned === view && view.cameraAnimating === false && view.getCameraAnimation() === null)
+							view.flyTo({ minX: 1000, minY: 1000, maxX: 1010, maxY: 1010 }, { duration: 600 })
+							view.setCamera({ center: [12, 34] })
+							const overridden = view.getCamera()
+							check('相机飞行：程序化 setCamera 会取消飞行，最终相机以调用方为准',
+								view.cameraAnimating === false && overridden.center[0] === 12 && overridden.center[1] === 34,
+								JSON.stringify(overridden))
+							click('search-filter-fly-all')
+							await wait(60)
+							const demoFlying = readout('search-filter-camera').includes('true') && view.cameraAnimating && readout('search-filter-action').includes('flyTo')
+							click('search-filter-stop-flight')
+							await wait(60)
+							const demoStopped = readout('search-filter-camera').includes('false') && !view.cameraAnimating && readout('search-filter-action').includes('stopCameraAnimation')
+							check('相机飞行 demo：按钮能启动并停止飞行，读数同步 cameraAnimating', demoFlying && demoStopped, `${readout('search-filter-camera')} / ${readout('search-filter-action')}`)
+							// flyToCamera：只给 center 时比例沿用当前相机；只给 scale 时中心沿用当前相机
+							const cameraApiScale = view.getCamera().scale
+							const flyCameraReturned = view.flyToCamera({ center: [20, 30] }, { duration: 0 })
+							const centerOnly = view.getCamera()
+							view.flyToCamera({ scale: 5 }, { duration: 0 })
+							const scaleOnly = view.getCamera()
+							check('flyToCamera：未写的相机字段沿用当前值，duration=0 立即落位并链式返回实例',
+								flyCameraReturned === view && Math.abs(centerOnly.center[0] - 20) < 1e-6 && Math.abs(centerOnly.center[1] - 30) < 1e-6 && Math.abs(centerOnly.scale - cameraApiScale) < 1e-6 &&
+									Math.abs(scaleOnly.center[0] - 20) < 1e-6 && Math.abs(scaleOnly.center[1] - 30) < 1e-6 && Math.abs(scaleOnly.scale - 5) < 1e-6,
+								`center-only ${JSON.stringify(centerOnly)} / scale-only ${JSON.stringify(scaleOnly)}`)
+							click('search-filter-fly-camera')
+							await wait(80)
+							const cameraPresetFlying = view.cameraAnimating && readout('search-filter-action').includes('flyToCamera')
+							view.stopCameraAnimation()
+							check('flyToCamera demo：按钮直接飞相机目标，不经过要素解析', cameraPresetFlying, `${readout('search-filter-camera')} / ${readout('search-filter-action')}`)
+							// 线路窄样式：换色 / 加宽后 getLineStyle 立刻是新值，dataVersion 不动
+							const styleVersionBefore = view.dataVersion
+							const styleBefore = view.getLineStyle(0)
+							click('search-filter-line-recolor')
+							await wait(100)
+							const styleAfter = view.getLineStyle(0)
+							check('getLineStyle：线路换色 / 加宽后读到最新解析值，dataVersion 不变',
+								styleBefore !== null && styleAfter !== null && Math.abs(styleAfter.width - 3.2) < 1e-6 && Math.abs(styleAfter.opacity - 1) < 1e-6 &&
+									styleAfter.color.some((value, index) => Math.abs(value - styleBefore.color[index]) > 1e-3) &&
+									styleVersionBefore === view.dataVersion && readout('search-filter-line-style').includes('width=3.20'),
+								`${JSON.stringify(styleBefore)} -> ${JSON.stringify(styleAfter)} · dataVersion ${styleVersionBefore} -> ${view.dataVersion}`)
+							click('search-filter-line-recolor')
+							await wait(80)
+							// 数据修订号：改点后递增，onDataChange 载荷与只读属性是同一个数
+							const dataVersionBefore = view.dataVersion
+							click('search-filter-data-bump')
+							const dataVersionText = await until(() => {
+								const text = readout('search-filter-data-version')
+								return view.dataVersion > dataVersionBefore && text.includes(`dataVersion=${view.dataVersion}`) && text.includes(`onDataChange=${view.dataVersion}`) ? text : ''
+							}, 3000) ?? ''
+							check('dataVersion：改一个点后递增，onDataChange 载荷与只读属性同步',
+								Boolean(dataVersionText) && view.dataVersion > dataVersionBefore,
+								`${dataVersionBefore} -> ${view.dataVersion} / ${dataVersionText}`)
 							click('search-filter-preset-symbol')
 						const symbolReady = await until(() => readout('search-filter-summary').includes('节点 8'), 4000)
 						check('搜索与筛选：显式 fields=[symbol] 能搜默认跳过的符号字段', Boolean(symbolReady) && readout('search-filter-hit-0').includes('symbol = square'), `${readout('search-filter-summary')} / ${readout('search-filter-hit-0')}`)
@@ -2254,18 +2493,22 @@
 					await wait(150)
 					const apiItems = () => [...document.querySelectorAll('.demo-api-list:not(.demo-api-list--options) .demo-api-item')]
 					const optionItems = () => [...document.querySelectorAll('.demo-api-list--options .demo-api-item')]
-					check('实例方法速查：整份成员清单按分组列全（16 组 / 256 个成员）',
-						Boolean(ready) && document.querySelectorAll('.demo-api-group').length === 16 && apiItems().length === 256,
+					check('实例方法速查：整份成员清单按分组列全（16 组 / 264 个成员）',
+						Boolean(ready) && document.querySelectorAll('.demo-api-group').length === 16 && apiItems().length === 264,
 						`${document.querySelectorAll('.demo-api-group').length} 组 / ${apiItems().length} 个成员`)
 					const apiNames = apiItems().map(node => node.querySelector('b')?.textContent)
 					const roundNames = ['registerSymbol', 'unregisterSymbol', 'listSymbols']
 					check('实例方法速查：本轮新增的三个方法都在清单里（registerSymbol / unregisterSymbol / listSymbols）',
 						roundNames.every(name => apiNames.includes(name)),
 						roundNames.filter(name => !apiNames.includes(name)).join(' / ') || '三个都在')
-					const roundNamesAuto = ['getZoomBaseScale', 'setZoomBaseScale']
-					check('实例方法速查：自适应比例的读 / 写两个方法在清单里（getZoomBaseScale / setZoomBaseScale）',
-						roundNamesAuto.every(name => apiNames.includes(name)),
-						roundNamesAuto.filter(name => !apiNames.includes(name)).join(' / ') || '两个都在')
+					const roundNamesAuto = ['getZoomBaseScale', 'setZoomBaseScale']
+					check('实例方法速查：自适应比例的读 / 写两个方法在清单里（getZoomBaseScale / setZoomBaseScale）',
+						roundNamesAuto.every(name => apiNames.includes(name)),
+						roundNamesAuto.filter(name => !apiNames.includes(name)).join(' / ') || '两个都在')
+					const roundNamesCameraApi = ['flyToCamera', 'getLineStyle', 'dataVersion']
+					check('实例方法速查：相机目标、线路样式快照与数据版本三个成员在清单里',
+						roundNamesCameraApi.every(name => apiNames.includes(name)),
+						roundNamesCameraApi.filter(name => !apiNames.includes(name)).join(' / ') || '三个都在')
 					const roundNames1597 = ['addChannelGroupLines', 'joinChannelGroupLines', 'endAddChannel']
 					check('实例方法速查：这一轮拆出来的方法也在清单里（addChannelGroupLines / joinChannelGroupLines / endAddChannel）',
 						roundNames1597.every(name => apiNames.includes(name)),

package/docs/steps/selftest-docs.html

@@ -520,8 +520,8 @@
 				if (check('API 速查：挂上了 __gisApi 钩子（数据来自 api-index.js，没钩子多半是 file:// 打开的）', Boolean(apiHook))) {
 					const apiDoc = apiFrame.contentDocument
 					const summary = apiHook.summary
-					check('API 速查：清单来自 api-index（256 个成员 / 253 个方法 / 96 个 options / 16 个分组）',
-						summary.members === 256 && summary.methods === 253 && summary.options === 96 && summary.sections === 16,
+					check('API 速查：清单来自 api-index（264 个成员 / 259 个方法 / 5 个属性 / 96 个 options / 16 个分组）',
+						summary.members === 264 && summary.methods === 259 && summary.properties === 5 && summary.options === 96 && summary.sections === 16,
 						JSON.stringify(summary))
 					const topJumps = [...apiDoc.querySelectorAll('.doc-jump')]
 					const jumpTargets = topJumps.map(node => `${node.dataset.docJump}:${node.getAttribute('href')}`)
@@ -559,7 +559,7 @@
 						`${apiDoc.querySelectorAll('.api-member').length} 张卡片 / 属性 ${apiDoc.querySelectorAll('.api-member[data-kind="property"]').length} 张`)
 					const noExample = [...apiDoc.querySelectorAll('.api-member')].filter(node => Number(node.dataset.examples) < 1)
 					check('API 速查：每个成员都带至少一段示例（不出现空卡片）', noExample.length === 0,
-						noExample.length ? noExample.map(node => node.dataset.name).join(' / ') : '256 张卡片都有示例')
+						noExample.length ? noExample.map(node => node.dataset.name).join(' / ') : '264 张卡片都有示例')
 					check('API 速查：96 个 options 都列全（名字 / 类型 / 默认值 / 说明四件套）',
 						apiDoc.querySelectorAll('.api-option').length === summary.options && [...apiDoc.querySelectorAll('.api-option')].every(node => node.querySelector('.name code') && node.querySelector('.type') && node.querySelector('.def') && node.querySelector('.doc')),
 						`${apiDoc.querySelectorAll('.api-option').length} 个`)