gis-view-webgl2 0.1.9 → 0.1.11

package/dist/index.d.ts

@@ -1841,6 +1841,20 @@ export interface GisViewDirectLineConnection {
 /** getDirectConnections 的一项：直接通道或直接线路（通道与成员回线可能同时命中） */
 export type GisViewDirectConnection = GisViewDirectChannelConnection | GisViewDirectLineConnection
 
+/** getDirectConnections 要查哪一列：缺省 / 'both' 两列都查 */
+export type GisViewDirectConnectionKind = 'channel' | 'line' | 'both'
+
+/** getDirectConnections 第二段的写法：也可以直接传 'channel' / 'line' / 'both' */
+export interface GisViewDirectConnectionsOptions {
+	kind?: GisViewDirectConnectionKind
+}
+
+/** getDirectConnections 的返回值：外层固定拆成通道与线路两列，没命中的那一列是空数组 */
+export interface GisViewDirectConnections {
+	channels: GisViewDirectChannelConnection[]
+	lines: GisViewDirectLineConnection[]
+}
+
 /** 新增通道草稿的配置：beginAddChannel 用 */
 export interface GisViewChannelDraftOptions {
 	/** 两个节点一选完就自动提交，不用再调 commitAddChannel */
@@ -5291,6 +5305,35 @@ export interface GisViewChannelSnapshot {
 }
 
 
+/** getPointSpacing() 的端点：可见节点在原始 points 里的 id、下标与数据对象 */
+export interface GisViewPointSpacingNode {
+	id: string | number
+	index: number
+	item: GisViewPoint
+}
+
+/** getPointSpacing() 的一对节点：distance 是当前相机比例下的 CSS 像素 */
+export interface GisViewPointSpacingPair {
+	from: GisViewPointSpacingNode
+	to: GisViewPointSpacingNode
+	distance: number
+}
+
+/**
+ * getPointSpacing() 的读数：当前可见节点的最近正距离与最远距离，单位都是 CSS 像素，
+ * 与 fitSpacing 同一套屏幕口径，并随当前相机比例换算。筛选 / 隐藏后的节点不参与。
+ */
+export interface GisViewPointSpacing {
+	/** 当前参与统计的可见节点数 */
+	count: number
+	/** 最近两个不同位置节点之间的 CSS 像素距离；不足两个节点或全部重合时为 null */
+	minDistance: number | null
+	/** 最远两个节点之间的 CSS 像素距离；不足两个节点时为 null，全部重合时为 0 */
+	maxDistance: number | null
+	nearest: GisViewPointSpacingPair | null
+	farthest: GisViewPointSpacingPair | null
+}
+
 /** getViewState() 的一次性读数：相机 / 视口 / 可视范围 / 布局 / 选中 / 筛选 / 光标 / 渲染统计 */
 export interface GisViewViewState {
 	camera: GisViewCamera
@@ -5459,12 +5502,15 @@ export interface GisViewInitialView {
 
 /**
  * 适应视图的节点间距兜底：普通「铺满数据范围」让最近节点在屏幕上挤在一起时，
- * 按 minDistance 反推一个更高的相机比例。放大时以最近节点对的中点为中心，
- * 远处孤立点可以把包围盒撑大，但不再把主体节点压成一团，也允许落到视口外。
+ * 按 minDistance 反推一个更高的相机比例；节点分布太散、最远节点铺得过开时，
+ * 按 maxDistance 把比例压回来。minDistance / maxDistance 二选一，
+ * 同时给时只启用 maxDistance；相机中心始终沿用普通适应的包围盒中心。
  */
 export interface GisViewFitSpacingOptions {
-	/** 可见节点中心之间的最小屏幕距离（CSS 像素），默认 24；写 0 或负数关闭 */
+	/** 距离模式一：可见节点中心之间的最小屏幕距离（CSS 像素），默认 24；与 maxDistance 二选一 */
 	minDistance?: number
+	/** 距离模式二：可见节点里最远一对的中心距不超过这个屏幕距离（CSS 像素）；与 minDistance 二选一，同时给时只启用它 */
+	maxDistance?: number
 	/** 相对普通适应比例的最大放大倍数，默认 0（不限，只受 maxScale 约束）；正数表示上限 */
 	maxZoom?: number
 }
@@ -6724,7 +6770,8 @@ export interface GisViewOptions {
 	initialView?: GisViewInitialView | null
 	/**
 	 * 适应视图时按可见节点间距兜底（默认关）：true 用 minDistance 24 / maxZoom 不限，
-	 * 对象可改两个参数。只在首次默认适应与 fitView() 生效，显式 initialView.scale / zoom 优先。
+	 * 对象在 minDistance / maxDistance 中二选一，另可改 maxZoom。只在首次默认适应与 fitView() 生效，
+	 * 显式 initialView.scale / zoom 优先。
 	 */
 	fitSpacing?: boolean | GisViewFitSpacingOptions
 	/**
@@ -7880,6 +7927,12 @@ export interface GisViewInstance {
 	/** 只移动视图中心、保持当前比例；返回 this 以便链式调用 */
 	setCenter(center: [number, number]): GisViewInstance
 	getBounds(): GisViewBounds
+	/**
+	 * 当前可见节点的最近正距离 / 最远距离（CSS 像素，和 fitSpacing 同一套屏幕口径）。
+	 * 读数随当前相机比例换算；每个距离带两端节点与同口径的 distance；筛选 / 隐藏后的节点不参与。
+	 * 少于两个可见节点时为 null，全部重合时 nearest 为 null、maxDistance 为 0。
+	 */
+	getPointSpacing(): GisViewPointSpacing
 	/** 缩放联动的基准比例（pointZoomScale / lineZoomScale 共用那一份）：缺省是首次适应视图时的 camera.scale */
 	getZoomBaseScale(): number
 	/** 重定缩放联动的基准比例：不传就取当下相机的比例（把现在这一屏当成「原样大小」），之后放大缩小都从它算倍数，返回 this */
@@ -8322,9 +8375,13 @@ export interface GisViewInstance {
 	/**
 	 * 一组节点之间的直接通道 / 线路：两端都必须真实存在且都在传入的 id 集合里，
 	 * 只认通道端点或线路 from / to 的直接绑定，不沿线路穿中间节点，也不返回集合外的边。
-	 * 通道按 channels 顺序、线路按 lines 顺序；一条都没命中时返回空数组。
+	 * 返回固定拆成 channels / lines 两列；options 写 'channel' / 'line' 只查一类，
+	 * 省略或写 'both' 两列都查。没有命中时两列都是空数组。
 	 */
-	getDirectConnections(pointIds: string | number | Array<string | number>): GisViewDirectConnection[]
+	getDirectConnections(
+		pointIds: string | number | Array<string | number>,
+		options?: GisViewDirectConnectionKind | GisViewDirectConnectionsOptions
+	): GisViewDirectConnections
 	/**
 	 * 程序化新增一个通道：第一段是通道信息 `{ from, to, name, id, path, routing, channelProps }`，第二段是线路数据 ——
 	 * 每条按自己的 id 建进通道（id 自动成为 lineIds），第三段是可选的分组信息。只负责新建一个通道：