cesium-to-three 0.1.0

package/dist/types/lib/ground/depth.d.ts

@@ -0,0 +1,63 @@
+import { Mesh, Object3D, Scene, WebGLRenderTarget, WebGLRenderer, type PerspectiveCamera } from 'three';
+/**
+ * 渲染 Cesium 风格的 packed globe depth 纹理。
+ */
+export declare class CesiumGlobeDepth {
+    readonly scene: Scene;
+    readonly target: WebGLRenderTarget;
+    private readonly packDepthMaterial;
+    constructor(width: number, height: number);
+    /**
+     * 添加一个只写入 packed depth 纹理的网格。
+     *
+     * @param mesh 为 globe depth 提供几何深度的网格。
+     */
+    addDepthMesh(mesh: Mesh): void;
+    /**
+     * 把任意对象树加入此深度通道的私有场景。
+     *
+     * @param object 为 globe depth 提供网格深度的对象树。
+     */
+    addDepthObject(object: Object3D): void;
+    /**
+     * 将 packed depth 渲染到本通道的渲染目标。
+     *
+     * @param renderer 当前 Three 渲染器。
+     * @param camera 当前相机。pack-depth 材质需要它逐帧写入 Cesium 兼容的 LOG_DEPTH。
+     * @param sourceScene 可选外部场景，用于 3d-tiles-renderer 内容。
+     * @param depthRoot 渲染 sourceScene 时需要单独保留的可选根对象。
+     */
+    render(renderer: WebGLRenderer, camera: PerspectiveCamera, sourceScene?: Scene, depthRoot?: Object3D): void;
+    /**
+     * 调整 packed depth 帧缓冲尺寸。
+     *
+     * @param width 绘制缓冲宽度。
+     * @param height 绘制缓冲高度。
+     */
+    resize(width: number, height: number): void;
+    /**
+     * 释放本通道持有的 GPU 资源。
+     */
+    dispose(): void;
+    /**
+     * 刷新 pack-depth 着色器的 log-depth uniform，使其匹配当前相机 near/far。
+     * 等价于 Cesium UniformState.update 对 `czm_currentFrustum`、
+     * `czm_farDepthFromNearPlusOne` 和 `czm_oneOverLog2FarDepthFromNearPlusOne`
+     * 的更新。
+     *
+     * @param camera 当前透视相机。
+     */
+    private updateLogDepthUniforms;
+}
+/**
+ * 创建 CesiumGlobeDepth 和主帧缓冲深度预通道使用的椭球深度网格。
+ *
+ * @param widthSegments 水平方向分段数。
+ * @param heightSegments 垂直方向分段数。
+ * @returns 主场景深度网格与 packed-depth 通道网格。
+ */
+export declare function createCesiumEllipsoidDepthMeshes(widthSegments?: number, heightSegments?: number): {
+    mainDepthMesh: Mesh;
+    packedDepthMesh: Mesh;
+};
+//# sourceMappingURL=depth.d.ts.map

package/dist/types/lib/ground/depth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"depth.d.ts","sourceRoot":"","sources":["../../../../src/lib/ground/depth.ts"],"names":[],"mappings":"AASA,OAAO,EAEN,IAAI,EAEJ,QAAQ,EAGR,KAAK,EAIL,iBAAiB,EACjB,aAAa,EAEb,KAAK,iBAAiB,EACtB,MAAM,OAAO,CAAC;AASf;;GAEG;AACH,qBAAa,gBAAgB;IAC5B,SAAgB,KAAK,EAAE,KAAK,CAAC;IAC7B,SAAgB,MAAM,EAAE,iBAAiB,CAAC;IAE1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;gBAElC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAcjD;;;;OAIG;IACI,YAAY,CAAE,IAAI,EAAE,IAAI,GAAI,IAAI;IAKvC;;;;OAIG;IACI,cAAc,CAAE,MAAM,EAAE,QAAQ,GAAI,IAAI;IAI/C;;;;;;;OAOG;IACI,MAAM,CACZ,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,iBAAiB,EACzB,WAAW,GAAE,KAAkB,EAC/B,SAAS,CAAC,EAAE,QAAQ,GAClB,IAAI;IA0CP;;;;;OAKG;IACI,MAAM,CAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAI,IAAI;IAIpD;;OAEG;IACI,OAAO,IAAI,IAAI;IAKtB;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;CAkB9B;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC/C,aAAa,SAAM,EACnB,cAAc,SAAK,GACjB;IAAE,aAAa,EAAE,IAAI,CAAC;IAAC,eAAe,EAAE,IAAI,CAAA;CAAE,CA0ChD"}

package/dist/types/lib/ground/geometry.d.ts

@@ -0,0 +1,12 @@
+import type { Vector3 } from 'three';
+/**
+ * 使用 Cesium 相同的定点拆分方式编码 Three 向量。
+ *
+ * 保留在本模块中，方便 classification.ts 沿用原导入路径。
+ *
+ * @param source ECEF / 模型坐标向量。
+ * @param high 输出 high 向量。
+ * @param low 输出 low 向量。
+ */
+export declare function encodeCesiumVector3(source: Vector3, high: Vector3, low: Vector3): void;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/types/lib/ground/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../../../src/lib/ground/geometry.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAsBrC;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAI,IAAI,CAOxF"}

package/dist/types/lib/ground/index.d.ts

@@ -0,0 +1,6 @@
+export * from './cesium-ground-adapter';
+export { CesiumGroundTextPrimitive } from './text';
+export type { PlotTextOptions, PlotTextAlign, PlotTextVerticalAlign, PlotTextAnchorX, PlotTextAnchorY, PlotTextLayoutDirection, PlotTextBoxOverflow, } from './text';
+export { CESIUM_GLOBE_MINIMUM_ALTITUDE, CESIUM_GROUND_NON_PICKABLE_LAYER, LINE_DEFAULT_GRANULARITY, LINE_DEFAULT_RENDER_ORDER, LINE_DEFAULT_WIDTH_PIXELS, MAX_CIRCLE_GRANULARITY_RADIANS, MIN_CIRCLE_GRANULARITY_RADIANS, } from './constants';
+export type { CartesianLike, CesiumClassificationCommandVisibility, CesiumGeometryAttribute, CesiumGeometryResult, CesiumGroundArcType, CesiumGroundArrowMode, CesiumGroundArrowStyle, CesiumGroundCircleOptions, CesiumGroundCirclePrimitiveOptions, CesiumGroundFrameState, CesiumGroundLineWidthMode, CesiumGroundPointOptions, CesiumGroundPointPrimitiveOptions, CesiumGroundPointShape, CesiumGroundPolygonOptions, CesiumGroundPolylineOptions, CesiumGroundRectangleOptions, CesiumGroundRectanglePrimitiveOptions, EastNorthOffsetMeters, EncodedScalar, LonLatPoint, LongitudeLatitude, PlanarBounds, PlanarExtents, PolygonHierarchyDegrees, RectangleDegrees, RectangleMeterSize, RectangleRadians, SharedUniforms, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/lib/ground/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/ground/index.ts"],"names":[],"mappings":"AAQA,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,yBAAyB,EAAE,MAAM,QAAQ,CAAC;AACnD,YAAY,EACX,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,mBAAmB,GACnB,MAAM,QAAQ,CAAC;AAChB,OAAO,EACN,6BAA6B,EAC7B,gCAAgC,EAChC,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,8BAA8B,EAC9B,8BAA8B,GAC9B,MAAM,aAAa,CAAC;AACrB,YAAY,EACX,aAAa,EACb,qCAAqC,EACrC,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,kCAAkC,EAClC,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EACxB,iCAAiC,EACjC,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,qCAAqC,EACrC,qBAAqB,EACrB,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,GACd,MAAM,SAAS,CAAC"}

package/dist/types/lib/ground/line/line-arrowhead.d.ts

@@ -0,0 +1,67 @@
+import { BufferGeometry } from 'three';
+import type { DensifiedLine } from './line-types';
+/** 箭头放置模式枚举（内部使用，公开 API 用字符串）。 */
+export declare const ARROW_MODE: {
+    /** 不画箭头（默认）。 */
+    readonly NONE: 0;
+    /** 仅起点端（折线 `points[0]`）画箭头。 */
+    readonly LEFT: 1;
+    /** 仅终点端（折线 `points[N-1]`）画箭头。 */
+    readonly RIGHT: 2;
+    /** 两端都画。 */
+    readonly BOTH: 3;
+};
+export type ArrowMode = typeof ARROW_MODE[keyof typeof ARROW_MODE];
+/** 箭头样式：实心三角 / 开口雪佛龙。 */
+export type ArrowStyle = 'solid' | 'open';
+/**
+ * 端点局部标架（ECEF 三向单位向量 + 尖端 ECEF 位置 + 端点处地形高度窗口）。
+ *
+ * - `tip` 是端点在椭球面（h=0）的 ECEF 位置。FS 把地形点 `P` 投到这个标架。
+ * - `back` 指向线内部（首段正方向 / 末段反方向），构成「沿线长」轴。
+ * - `right` 端点处的右法线，构成「横向」轴。
+ * - `up` 椭球面法线，配合 VS 把盒子竖直挤成「穿过地表的薄墙」。
+ * - `terrainMinHeight` / `terrainMaxHeight` 端点附近的地形高度范围（米）。
+ *   箭头盒子在 VS 里 顶 / 底 沿 `up` 推到这两个高度——**必须覆盖实际地形高度**，
+ *   否则盒子在 alt=0 的投影与「FS 重建地形点」的屏幕位置错位，箭头表现为
+ *   「随缩放变形」「顶部冒出线段」等 alignment 伪影（尼泊尔 5 km 地形是典型场景）。
+ *
+ * 三个方向向量应正交（`back ⟂ right ⟂ up`），由调用方保证。
+ */
+export interface EndpointFrame {
+    tip: [number, number, number];
+    back: [number, number, number];
+    right: [number, number, number];
+    up: [number, number, number];
+    terrainMinHeight: number;
+    terrainMaxHeight: number;
+}
+/**
+ * 从密集线数据算出 start / end 两端的标架。每端：
+ *
+ * - `tip = cartographic(lon, lat, h=0)` 反投影到 ECEF（与线 ecStart 同源）。
+ * - `back` = 指向相邻内点的方向（首段正方向 / 末段反方向）。
+ * - `right` = 端点处密集线给出的几何法线（首末点的 `normals[]`）。
+ * - `up` = `geodeticSurfaceNormal(tip)`，与端点切平面正交。
+ * - `terrainMinHeight` / `terrainMaxHeight` 端点附近的地形高度窗口。
+ *
+ * @param wall 加密后的密集线数据（来自 buildWallArrays）。
+ * @returns    起 / 终两端的标架。
+ * @throws     `wall.pointCount < 2` 时抛错（首尾两端没有意义）。
+ */
+export declare function computeEndpointFrames(wall: DensifiedLine): {
+    startFrame: EndpointFrame;
+    endFrame: EndpointFrame;
+};
+/**
+ * 构造箭头几何。每个启用的端 = 一个 8 顶点薄盒（盒尺寸在 VS 里按 metersPerPixel
+ * 动态挤出，CPU 端只存「单位标架 + 角点系数」）。
+ *
+ * @param startFrame 起点端标架（mode === LEFT 或 BOTH 时使用）。
+ * @param endFrame   终点端标架（mode === RIGHT 或 BOTH 时使用）。
+ * @param mode       箭头模式枚举。
+ * @returns          已装好属性 + 索引的 BufferGeometry。无 `position` 属性，
+ *                   调用方应设 `mesh.frustumCulled = false`。NONE 模式返回空几何。
+ */
+export declare function buildArrowHeadGeometry(startFrame: EndpointFrame, endFrame: EndpointFrame, mode: ArrowMode): BufferGeometry;
+//# sourceMappingURL=line-arrowhead.d.ts.map

package/dist/types/lib/ground/line/line-arrowhead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-arrowhead.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ground/line/line-arrowhead.ts"],"names":[],"mappings":"AAeA,OAAO,EAAmB,cAAc,EAAW,MAAM,OAAO,CAAC;AAiBjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,kCAAkC;AAClC,eAAO,MAAM,UAAU;IACtB,gBAAgB;;IAEhB,+BAA+B;;IAE/B,iCAAiC;;IAEjC,YAAY;;CAEH,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAE,MAAM,OAAO,UAAU,CAAE,CAAC;AAErE,yBAAyB;AACzB,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,CAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAE,CAAC;IAChC,IAAI,EAAE,CAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAE,CAAC;IACjC,KAAK,EAAE,CAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAE,CAAC;IAClC,EAAE,EAAE,CAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAE,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CACzB;AAsFD;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,aAAa,GACjB;IAAE,UAAU,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,CAoHxD;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACrC,UAAU,EAAE,aAAa,EACzB,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,SAAS,GACb,cAAc,CA6DhB"}

package/dist/types/lib/ground/line/line-densify.d.ts

@@ -0,0 +1,35 @@
+import { Vector3 } from 'three';
+import type { Cartographic } from '../math/cartographic';
+import { ArcType } from './line-types';
+/**
+ * 单点 push（端点用，doc 02 §3.3）：把一个 cartographic 端点的 bottom / top /
+ * 几何法线 / cartographic 追加到四个累加数组。
+ *
+ * @param carto              端点 cartographic（lon/lat 弧度）。
+ * @param normal             已算好的几何法线（vertex miter 或 right normal）。
+ * @param minHeight          标准墙下沿高度（构造期统一 0）。
+ * @param maxHeight          标准墙上沿高度（构造期统一 1000）。
+ * @param normalsArray       追加目标。
+ * @param bottomPositionsArray 追加目标。
+ * @param topPositionsArray  追加目标。
+ * @param cartographicsArray 追加目标（顺序：lat 先 lon 后）。
+ */
+export declare function pushVertex(carto: Cartographic, normal: Vector3, minHeight: number, maxHeight: number, normalsArray: number[], bottomPositionsArray: number[], topPositionsArray: number[], cartographicsArray: number[]): void;
+/**
+ * 在 start → end 之间按 granularity 等弧长插入「中间点」（不含 start/end）。
+ * 每个中间点的几何法线复用该段端点 right normal（doc 02 §3.1）。
+ *
+ * @param start              段起点。
+ * @param end                段终点。
+ * @param minHeight          标准墙下沿高度。
+ * @param maxHeight          标准墙上沿高度。
+ * @param granularity        加密阈值（弧度），与 surfaceDistance（米）直接比较，
+ *                           对应 Cesium 的实现细节（不做单位换算）。
+ * @param arcType            连线方式。
+ * @param normalsArray       追加目标。
+ * @param bottomPositionsArray 追加目标。
+ * @param topPositionsArray  追加目标。
+ * @param cartographicsArray 追加目标。
+ */
+export declare function interpolateSegment(start: Cartographic, end: Cartographic, minHeight: number, maxHeight: number, granularity: number, arcType: ArcType, normalsArray: number[], bottomPositionsArray: number[], topPositionsArray: number[], cartographicsArray: number[]): void;
+//# sourceMappingURL=line-densify.d.ts.map

package/dist/types/lib/ground/line/line-densify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-densify.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ground/line/line-densify.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAUzD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAiCvC;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CACzB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EAAE,EACtB,oBAAoB,EAAE,MAAM,EAAE,EAC9B,iBAAiB,EAAE,MAAM,EAAE,EAC3B,kBAAkB,EAAE,MAAM,EAAE,GAC1B,IAAI,CAKN;AAyCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,EAAE,EACtB,oBAAoB,EAAE,MAAM,EAAE,EAC9B,iBAAiB,EAAE,MAAM,EAAE,EAC3B,kBAAkB,EAAE,MAAM,EAAE,GAC1B,IAAI,CAqCN"}

package/dist/types/lib/ground/line/line-geometry-normals.d.ts

@@ -0,0 +1,49 @@
+import { Vector3 } from 'three';
+import type { Cartographic } from '../math/cartographic';
+import type { ArcType, DensifiedLine } from './line-types';
+/**
+ * 端点（非 loop 首 / 末点）法线：沿该段方向、指向右侧、与 up 正交的单位向量。
+ *
+ * @param start     段起点 carto。
+ * @param end       段终点 carto。
+ * @param maxHeight 标准墙上沿高度（用于算 up）。
+ * @param out       接收单位法线。
+ * @returns         out。
+ */
+export declare function computeRightNormal(start: Cartographic, end: Cartographic, maxHeight: number, out: Vector3): Vector3;
+/**
+ * 内部顶点的 miter 法线：相邻两段方向的角平分线方向（切平面内）对应的
+ * 右法线。dot(toPrev, toNext) ≈ -1（直线穿过）时走特例分支。
+ *
+ * @param previousBottom 前点 @minHeight。
+ * @param vertexBottom   当前点 @minHeight。
+ * @param vertexTop      当前点 @maxHeight（用以定义 up）。
+ * @param nextBottom     后点 @minHeight。
+ * @param out            接收单位法线。
+ * @returns              out。
+ */
+export declare function computeVertexMiterNormal(previousBottom: Vector3, vertexBottom: Vector3, vertexTop: Vector3, nextBottom: Vector3, out: Vector3): Vector3;
+/**
+ * 若当前 endGeometryNormal 与本段方向夹角过小 / 过大（拐角过尖），把它绕
+ * vertexUp 旋 ±90° 打断斜接，防止 box 退化或暴长。
+ *
+ * @param endGeometryNormal 输入并被原地修改。
+ * @param startBottom       段起点 @minHeight。
+ * @param endBottom         段终点 @minHeight。
+ * @param endTop            段终点 @maxHeight。
+ * @returns                 是否触发打断（供主循环的 miterBroken 状态机用）。
+ */
+export declare function breakMiter(endGeometryNormal: Vector3, startBottom: Vector3, endBottom: Vector3, endTop: Vector3): boolean;
+/**
+ * 把一组 cartographic 折点构造成「加密 + 法线」后的墙数据。
+ *
+ * @param cartographics 预处理后的 cartographic 列表（≥ 2 点）。
+ * @param loop          是否闭合。
+ * @param arcType       连线方式。
+ * @param granularity   加密阈值。
+ * @param minHeight     标准墙下沿高度（默认 WALL_INITIAL_MIN_HEIGHT=0）。
+ * @param maxHeight     标准墙上沿高度（默认 WALL_INITIAL_MAX_HEIGHT=1000）。
+ * @returns             加密 + 法线后的密集线数据。
+ */
+export declare function buildWallArrays(cartographics: Cartographic[], loop: boolean, arcType: ArcType, granularity: number, minHeight?: number, maxHeight?: number): DensifiedLine;
+//# sourceMappingURL=line-geometry-normals.d.ts.map

package/dist/types/lib/ground/line/line-geometry-normals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-geometry-normals.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ground/line/line-geometry-normals.ts"],"names":[],"mappings":"AAeA,OAAO,EAAc,OAAO,EAAE,MAAM,OAAO,CAAC;AAQ5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKzD,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AA2D3D;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,OAAO,GACV,OAAO,CAoBT;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACvC,cAAc,EAAE,OAAO,EACvB,YAAY,EAAE,OAAO,EACrB,SAAS,EAAE,OAAO,EAClB,UAAU,EAAE,OAAO,EACnB,GAAG,EAAE,OAAO,GACV,OAAO,CAuBT;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACzB,iBAAiB,EAAE,OAAO,EAC1B,WAAW,EAAE,OAAO,EACpB,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,OAAO,GACb,OAAO,CAYT;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC9B,aAAa,EAAE,YAAY,EAAE,EAC7B,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAAgC,EAC3C,SAAS,GAAE,MAAgC,GACzC,aAAa,CA0If"}

package/dist/types/lib/ground/line/line-options.d.ts

@@ -0,0 +1,54 @@
+import type { CesiumGroundArcType, CesiumGroundArrowMode, CesiumGroundArrowStyle, CesiumGroundLineWidthMode, CesiumGroundPolylineOptions, LonLatPoint } from '../types';
+import { type ArrowMode, type ArrowStyle } from './line-arrowhead';
+import { ArcType, LineWidthMode, type LineShadowVolumeOptions } from './line-types';
+/** 解析后的公开选项（含全部已填默认值与字符串→枚举映射）。 */
+export interface ResolvedLineOptions {
+    points: LonLatPoint[];
+    loop: boolean;
+    arcType: ArcType;
+    granularityRadians: number;
+    minimumHeight: number;
+    maximumHeight: number;
+    widthMode: LineWidthMode;
+    widthPixels: number;
+    widthMeters: number;
+    renderOrder: number;
+    visible: boolean;
+    strokeColor: string;
+    strokeOpacity: number;
+    dashLengthMeters: number;
+    gapLengthMeters: number;
+    dashEnabled: boolean;
+    debugVolume: boolean;
+    arrowMode: ArrowMode;
+    arrowStyle: ArrowStyle;
+    arrowWidthMode: LineWidthMode;
+    arrowLengthPixels: number;
+    arrowWidthPixels: number;
+    arrowLengthMeters: number;
+    arrowWidthMeters: number;
+    arrowColor: string | undefined;
+    arrowOpacity: number | undefined;
+    arrowStrokeWidthPixels: number;
+}
+/** 字符串 arcType → 内部枚举。未识别值抛错（绝不静默回退到 geodesic）。 */
+export declare function parseArcType(value: CesiumGroundArcType | undefined): ArcType;
+/** 字符串 widthMode → 内部枚举。 */
+export declare function parseWidthMode(value: CesiumGroundLineWidthMode | undefined): LineWidthMode;
+/** 字符串 arrowMode → 内部枚举。 */
+export declare function parseArrowMode(value: CesiumGroundArrowMode | undefined): ArrowMode;
+/** 字符串 arrowStyle → 内部联合。 */
+export declare function parseArrowStyle(value: CesiumGroundArrowStyle | undefined): ArrowStyle;
+/**
+ * 校验 + 默认值。逐字对应 doc 09 §1.1 / §6 与 doc 10 §3。
+ *
+ * @param options 公开选项。
+ * @returns       已解析的内部选项（字段全部填齐，可直接给几何 facade）。
+ * @throws        Error：违规字段会一次性抛出（详细原因）。
+ */
+export declare function resolvePublicLineOptions(options: CesiumGroundPolylineOptions): ResolvedLineOptions;
+/**
+ * 取出几何 facade 需要的 sub-set，避免传递与几何无关的颜色 / dash 字段。
+ */
+export declare function toLineShadowVolumeOptions(resolved: ResolvedLineOptions): LineShadowVolumeOptions;
+//# sourceMappingURL=line-options.d.ts.map

package/dist/types/lib/ground/line/line-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-options.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ground/line/line-options.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACX,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,EAC3B,WAAW,EACX,MAAM,UAAU,CAAC;AAElB,OAAO,EAAc,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEpF,mCAAmC;AACnC,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,aAAa,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,EAAE,aAAa,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,sBAAsB,EAAE,MAAM,CAAC;CAC/B;AAED,mDAAmD;AACnD,wBAAgB,YAAY,CAAE,KAAK,EAAE,mBAAmB,GAAG,SAAS,GAAI,OAAO,CAW9E;AAED,4BAA4B;AAC5B,wBAAgB,cAAc,CAC7B,KAAK,EAAE,yBAAyB,GAAG,SAAS,GAC1C,aAAa,CAQf;AAED,4BAA4B;AAC5B,wBAAgB,cAAc,CAC7B,KAAK,EAAE,qBAAqB,GAAG,SAAS,GACtC,SAAS,CAcX;AAED,6BAA6B;AAC7B,wBAAgB,eAAe,CAC9B,KAAK,EAAE,sBAAsB,GAAG,SAAS,GACvC,UAAU,CAQZ;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,2BAA2B,GAClC,mBAAmB,CAmLrB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,mBAAmB,GAC3B,uBAAuB,CASzB"}

package/dist/types/lib/ground/line/line-preprocess.d.ts

@@ -0,0 +1,12 @@
+import type { Cartographic } from '../math/cartographic';
+import type { LonLatPoint } from '../types';
+import { ArcType } from './line-types';
+/**
+ * 完整预处理流水线：归一 → 拆段 → cartographic 去重。
+ *
+ * @param points  公开 lon/lat 点（度）。
+ * @param arcType 连线类型（影响 §2 拆段的交点求解）。
+ * @returns       去重后的 Cartographic 序列，>= 2 个点。
+ */
+export declare function preprocessLine(points: LonLatPoint[], arcType: ArcType): Cartographic[];
+//# sourceMappingURL=line-preprocess.d.ts.map

package/dist/types/lib/ground/line/line-preprocess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-preprocess.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ground/line/line-preprocess.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAOzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAqMvC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,WAAW,EAAE,EACrB,OAAO,EAAE,OAAO,GACd,YAAY,EAAE,CAQhB"}

package/dist/types/lib/ground/line/line-segment-attributes.d.ts

@@ -0,0 +1,24 @@
+import type { DensifiedLine, SegmentBoxAttributes } from './line-types';
+/**
+ * 主装配函数：把密集线 + 法线打包成 8 顶点 box 几何属性。
+ *
+ * 高度窗口逐字对齐 Cesium `generateGeometryAttributes`：每段查
+ * `ApproximateTerrainHeights.getMinimumMaximumHeights( segment 的 lat/lon
+ * 外接矩形 )` 得 terrain-tight 的 minHeight / maxHeight，再传 `adjustHeights`。
+ *
+ * 这是替代 doc 04 §7 的固定 ±55km 方案的关键修复——固定 ±55km 会让 box 顶
+ * 远在相机之上（altitude > camera altitude），在透视投影下变成 w<0 顶点，
+ * 光栅器对 w<0 三角形按 near plane clipping，盒子的侧面被切碎，FS 不在
+ * 那些被切掉的像素跑——线就出现「随相机缩放而闪烁的断线」。terrain-tight
+ * 让 box 顶贴近实际地形（典型 100m～5km altitude），任何在地面之上的相机
+ * 视角下整盒子都在视锥内，FS 在每像素完整运行，断线消失。
+ *
+ * @param wall          doc 03 buildWallArrays 的产出（含 cartographicsArray，
+ *                      用于查 ApproximateTerrainHeights）。
+ * @param minHeightHint 调用方建议的下限（米）。用作 `min(terrainMin, hint)`
+ *                      的兜底，防止 terrain table 未初始化时 box 退化。
+ * @param maxHeightHint 调用方建议的上限（米）。用作 `max(terrainMax, hint)`。
+ * @returns             9 个 Buffer 数据，可直接装入 Three BufferGeometry。
+ */
+export declare function buildSegmentBoxAttributes(wall: DensifiedLine, minHeightHint: number, maxHeightHint: number): SegmentBoxAttributes;
+//# sourceMappingURL=line-segment-attributes.d.ts.map

package/dist/types/lib/ground/line/line-segment-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-segment-attributes.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ground/line/line-segment-attributes.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAyIxE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,aAAa,EACnB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,GACnB,oBAAoB,CAyNtB"}

package/dist/types/lib/ground/line/line-shadow-volume.d.ts

@@ -0,0 +1,25 @@
+import { BufferGeometry } from 'three';
+import { type EndpointFrame } from './line-arrowhead';
+import type { LineShadowVolumeOptions } from './line-types';
+/**
+ * `geometry.userData` 上挂的扩展信息。CesiumGroundPolylinePrimitive 在构造
+ * 期读出 `length3D` 写到 `u_lineTotalMeters`（doc 06 §4 虚线相位用）。
+ * `startFrame` / `endFrame` 是端点标架，供线端箭头几何 `buildArrowHeadGeometry`
+ * 使用——挂在 wall facade 这里避免外部调用方再走一遍 cartographic / 法线
+ * 抽取逻辑。
+ */
+export interface LineGeometryUserData {
+    length3D: number;
+    pointCount: number;
+    segmentCount: number;
+    startFrame: EndpointFrame;
+    endFrame: EndpointFrame;
+}
+/**
+ * 构造贴地线 BufferGeometry。一次性、纯 CPU、零 GPU 调用。
+ *
+ * @param options 内部选项（已校验 + 填默认）。
+ * @returns       9-attribute BufferGeometry，`userData.length3D` 含全线长度。
+ */
+export declare function buildLineShadowVolumeGeometry(options: LineShadowVolumeOptions): BufferGeometry;
+//# sourceMappingURL=line-shadow-volume.d.ts.map

package/dist/types/lib/ground/line/line-shadow-volume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-shadow-volume.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ground/line/line-shadow-volume.ts"],"names":[],"mappings":"AAcA,OAAO,EAAmB,cAAc,EAAE,MAAM,OAAO,CAAC;AAIxD,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAI7E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,aAAa,CAAC;IAC1B,QAAQ,EAAE,aAAa,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC5C,OAAO,EAAE,uBAAuB,GAC9B,cAAc,CAkEhB"}

package/dist/types/lib/ground/line/line-types.d.ts

@@ -0,0 +1,74 @@
+import type { LonLatPoint } from '../types';
+/** 折线连线方式。对外字符串经 `resolvePublicLineOptions` 映射到枚举。 */
+export declare const ArcType: {
+    /** 直连（ECEF 弦），仅当极短或调用方显式要求时用。 */
+    readonly NONE: 0;
+    /** 大地线（最短路径，Vincenty）。默认。 */
+    readonly GEODESIC: 1;
+    /** 恒向线（罗盘恒定方位角）。 */
+    readonly RHUMB: 2;
+};
+export type ArcType = typeof ArcType[keyof typeof ArcType];
+/** 线宽语义：屏宽（像素恒定）或世界宽（米恒定）。 */
+export declare const LineWidthMode: {
+    readonly SCREEN: 0;
+    readonly WORLD: 1;
+};
+export type LineWidthMode = typeof LineWidthMode[keyof typeof LineWidthMode];
+/**
+ * `buildLineShadowVolumeGeometry` 入参（内部）。`resolvePublicLineOptions`
+ * 把公开 `CesiumGroundPolylineOptions` 转成这个形态后传给 facade。
+ */
+export interface LineShadowVolumeOptions {
+    /** lon/lat 折点（度），≥ 2 个。 */
+    points: LonLatPoint[];
+    /** 是否闭合成环。 */
+    loop: boolean;
+    /** 加密 arc 类型。 */
+    arcType: ArcType;
+    /** 加密角分辨率（弧度）。 */
+    granularity: number;
+    /** 高度窗口下限（米）。 */
+    minimumHeight: number;
+    /** 高度窗口上限（米）。 */
+    maximumHeight: number;
+}
+/**
+ * 加密 + 法线后的密集折线数据。每个数组都是「扁平 Float64 / number[]」，
+ * 长度对齐为 `pointCount * 3`（normals / bottom / top）或 `pointCount * 2`
+ * （cartographics，顺序是 [lat, lon, ...]）。
+ *
+ * 注意：`cartographicsArray` 的「lat 在前 lon 在后」顺序逐字对齐 Cesium，
+ * 不能反——doc 04 计算段外接矩形时按这个顺序读取。
+ */
+export interface DensifiedLine {
+    /** 每点的几何法线 [nx, ny, nz, ...]。 */
+    normalsArray: number[];
+    /** 每点在 minHeight 处的 ECEF 位置 [x, y, z, ...]。 */
+    bottomPositionsArray: number[];
+    /** 每点在 maxHeight 处的 ECEF 位置 [x, y, z, ...]。 */
+    topPositionsArray: number[];
+    /** 每点 cartographic，顺序 [lat, lon, ...]（弧度）。 */
+    cartographicsArray: number[];
+    /** 是否闭合（与入参 loop 相同；2 点强制 false 在更上层处理）。 */
+    loop: boolean;
+    /** 加密后的点数 = bottomPositionsArray.length / 3。 */
+    pointCount: number;
+}
+/**
+ * 每段 8 顶点 box 装配产出。`positions` 是 box 8 角的 Float64 ECEF，
+ * 五个 Float32 vec4 描述符与 batchId / 索引按 doc 04 §9 契约打包。
+ */
+export interface SegmentBoxAttributes {
+    vertexCount: number;
+    positions: Float64Array;
+    startHiFwdX: Float32Array;
+    startLoFwdY: Float32Array;
+    startNormFwdZ: Float32Array;
+    endNormTexX: Float32Array;
+    rightNormTexY: Float32Array;
+    indices: Uint16Array | Uint32Array;
+    /** 全线长度（米）。供 FS 虚线 / 渐变模式作为 `u_lineTotalMeters` 使用。 */
+    length3D: number;
+}
+//# sourceMappingURL=line-types.d.ts.map

package/dist/types/lib/ground/line/line-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-types.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ground/line/line-types.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,sDAAsD;AACtD,eAAO,MAAM,OAAO;IACnB,iCAAiC;;IAEjC,6BAA6B;;IAE7B,oBAAoB;;CAEX,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAE,MAAM,OAAO,OAAO,CAAE,CAAC;AAE7D,8BAA8B;AAC9B,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAE,MAAM,OAAO,aAAa,CAAE,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACvC,2BAA2B;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,cAAc;IACd,IAAI,EAAE,OAAO,CAAC;IACd,iBAAiB;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB;IACjB,aAAa,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC7B,iCAAiC;IACjC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,+CAA+C;IAC/C,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,+CAA+C;IAC/C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,8CAA8C;IAC9C,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,4CAA4C;IAC5C,IAAI,EAAE,OAAO,CAAC;IACd,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,YAAY,CAAC;IACxB,WAAW,EAAE,YAAY,CAAC;IAC1B,WAAW,EAAE,YAAY,CAAC;IAC1B,aAAa,EAAE,YAAY,CAAC;IAC5B,WAAW,EAAE,YAAY,CAAC;IAC1B,aAAa,EAAE,YAAY,CAAC;IAC5B,OAAO,EAAE,WAAW,GAAG,WAAW,CAAC;IACnC,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/lib/ground/materials.d.ts

@@ -0,0 +1,69 @@
+import { RawShaderMaterial, type Side, type StencilOp } from 'three';
+import type { SharedUniforms } from './types';
+declare const ENABLE_LOG_DEPTH = true;
+/**
+ * 创建深度打包 shader:非 log-depth 模式下用 Cesium czm_packDepth 打包
+ * gl_FragCoord.z;启用 LOG_DEPTH 时打包 Cesium 对数深度值。两种情况下结果都
+ * 对齐 ShadowVolumeAppearanceFS 中 czm_unpackDepth 的预期,让 color 命令的
+ * 片元着色器能通过 czm_screenToEyeCoordinates 正确重建 eye 坐标。
+ *
+ * @returns globe depth pass 使用的 RawShaderMaterial。
+ */
+export declare function createPackDepthMaterial(): RawShaderMaterial;
+/**
+ * 为 Cesium stencil-depth 命令创建一个面向特定面的材质。
+ *
+ * @param uniforms 所有 classification 命令共享的 uniforms。
+ * @param side 与 Cesium front/back 命令匹配的 Three 面选择。
+ * @param stencilZFail 深度测试失败时执行的 stencil 操作。
+ * @param name 材质调试名称。
+ * @returns 匹配 Cesium z-fail 命令半边的 RawShaderMaterial。
+ */
+export declare function createStencilMaterial(uniforms: SharedUniforms, side: Side, stencilZFail: StencilOp, name: string): RawShaderMaterial;
+/**
+ * 为 Cesium 最终 color classification 命令创建材质。
+ *
+ * @param uniforms 所有 classification 命令共享的 uniforms。
+ * @param fragmentCull Cesium fragment-culling shader define 是否启用。
+ * @returns 匹配 Cesium color pass 渲染状态的 RawShaderMaterial。
+ */
+export declare function createColorMaterial(uniforms: SharedUniforms, fragmentCull: boolean): RawShaderMaterial;
+/**
+ * 创建贴地文字 color 材质。渲染状态逐字节匹配 `createColorMaterial`,让
+ * front-stencil / back-stencil / color 命令块保持同一 render-order 契约;
+ * 唯一差异是 `CESIUM_THREE_TEXT` define 与采样 `u_textTexture` 的片元分支。
+ * 调用方应通过共享 `extraUniforms` 路径注入纹理 uniform,从而保持
+ * LOG_DEPTH + CPU-plane + Float64-RTE 精度管线不变。
+ *
+ * @param uniforms     共享 uniforms(必须包含 `u_textTexture` 值)。
+ * @param fragmentCull Cesium `CULL_FRAGMENTS` define 是否启用。
+ * @returns            文字 color 命令使用的 RawShaderMaterial。
+ */
+export declare function createTextColorMaterial(uniforms: SharedUniforms, fragmentCull: boolean): RawShaderMaterial;
+/**
+ * 创建贴地线材质:单 mesh、BackSide、无 stencil、depthTest 关闭、预乘混合。
+ * 通过 `CESIUM_THREE_POLYLINE` define 复用 createVertexPrefix /
+ * createFragmentPrefix,引入 metersPerPixel 与线 uniform,同时保持 stencil /
+ * color 材质输出逐字节一致。
+ *
+ * @param uniforms     共享 uniforms 映射(必须包含 `czm_projection`,
+ *                     `czm_pixelRatio`, `u_lineWidthPixels`, `u_lineWidthMode`,
+ *                     `u_lineWidthMeters`, dash uniforms, `u_lineTotalMeters`).
+ * @param debugVolume  When true，FS 用半透红色直接绘制盒子的所有像素（不做
+ *                     terrain depth 重建 / 平面距离裁切），方便诊断「盒子有没有
+ *                     盖到该屏幕区域」「FS 是不是被裁切掉」这类几何 / 着色器问题。
+ * @returns            驱动深度重建线 pass 的 RawShaderMaterial。
+ */
+export declare function createPolylineMaterial(uniforms: SharedUniforms, debugVolume?: boolean): RawShaderMaterial;
+/**
+ * 创建线端箭头材质。与线材质字节级相同的渲染状态，只换 shader 主体 + 加
+ * `CESIUM_THREE_POLYLINE_ARROW` define 拉出 arrow uniform。
+ *
+ * @param uniforms     共享 uniforms（与同一 polyline 实例共用）。
+ * @param debugVolume  把盒子整体染绿调试用。
+ * @param open         true → 走开口雪佛龙样式（`ARROW_OPEN`）；默认实心三角。
+ * @returns            RawShaderMaterial。
+ */
+export declare function createArrowHeadMaterial(uniforms: SharedUniforms, debugVolume?: boolean, open?: boolean): RawShaderMaterial;
+export { ENABLE_LOG_DEPTH };
+//# sourceMappingURL=materials.d.ts.map

package/dist/types/lib/ground/materials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materials.d.ts","sourceRoot":"","sources":["../../../../src/lib/ground/materials.ts"],"names":[],"mappings":"AASA,OAAO,EAUN,iBAAiB,EAGjB,KAAK,IAAI,EACT,KAAK,SAAS,EACd,MAAM,OAAO,CAAC;AAqBf,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAkB9C,QAAA,MAAM,gBAAgB,OAAO,CAAC;AA4X9B;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAmF3D;AA6LD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,SAAS,EACvB,IAAI,EAAE,MAAM,GACV,iBAAiB,CA8BnB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,GAAI,iBAAiB,CA6CxG;AAyED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,cAAc,EACxB,YAAY,EAAE,OAAO,GACnB,iBAAiB,CA2CnB;AAsSD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,cAAc,EACxB,WAAW,UAAQ,GACjB,iBAAiB,CAmCnB;AA0MD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,cAAc,EACxB,WAAW,UAAQ,EACnB,IAAI,UAAQ,GACV,iBAAiB,CAgCnB;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/types/lib/ground/math/cartographic.d.ts

@@ -0,0 +1,27 @@
+/**
+ * WGS84 地理坐标三元组,经纬度以弧度表示,高度以米表示。
+ *
+ * 与 Cesium `Cartographic` 字段名 / 字段顺序完全一致,以便外部代码
+ * 1:1 迁移。本类型故意不带 prototype 方法,所有操作放在自由函数中,
+ * 便于 scratch 复用与 tree-shaking。
+ */
+export interface Cartographic {
+    /** 经度,弧度(范围 [-π, π],跨 IDL 时需调用方自行规整) */
+    longitude: number;
+    /** 纬度,弧度(范围 [-π/2, π/2]) */
+    latitude: number;
+    /** 椭球面以上高度,米(可以为负,表示椭球面以下) */
+    height: number;
+}
+/**
+ * 创建一个 Cartographic 实例(plain object)。
+ *
+ * 三个参数都有默认值 0,便于模块级 scratch 在顶部声明时初始化。
+ *
+ * @param longitude 经度,弧度。默认 0。
+ * @param latitude  纬度,弧度。默认 0。
+ * @param height    高度,米。默认 0(椭球表面)。
+ * @returns Cartographic 实例(独立对象,无共享引用)。
+ */
+export declare function createCartographic(longitude?: number, latitude?: number, height?: number): Cartographic;
+//# sourceMappingURL=cartographic.d.ts.map

package/dist/types/lib/ground/math/cartographic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cartographic.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ground/math/cartographic.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC5B,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IAEjB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CACjC,SAAS,SAAM,EACf,QAAQ,SAAM,EACd,MAAM,SAAM,GACV,YAAY,CAEd"}

package/dist/types/lib/ground/math/constants.d.ts

@@ -0,0 +1,20 @@
+export declare const WGS84_RADII_X = 6378137;
+export declare const WGS84_RADII_Y = 6378137;
+export declare const WGS84_RADII_Z = 6356752.314245179;
+export declare const WGS84_RADII_X_SQ: number;
+export declare const WGS84_RADII_Y_SQ: number;
+export declare const WGS84_RADII_Z_SQ: number;
+export declare const WGS84_ONE_OVER_RADII_X: number;
+export declare const WGS84_ONE_OVER_RADII_Y: number;
+export declare const WGS84_ONE_OVER_RADII_Z: number;
+export declare const WGS84_ONE_OVER_RADII_X_SQ: number;
+export declare const WGS84_ONE_OVER_RADII_Y_SQ: number;
+export declare const WGS84_ONE_OVER_RADII_Z_SQ: number;
+export declare const EPSILON1 = 0.1;
+export declare const EPSILON10 = 1e-10;
+export declare const EPSILON12 = 1e-12;
+export declare const EPSILON14 = 1e-14;
+export declare const CENTER_TOLERANCE_SQUARED = 0.1;
+export declare const RECTANGLE_DEFAULT_GRANULARITY: number;
+export declare const NEWTON_MAX_ITERATIONS = 100;
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/lib/ground/math/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ground/math/constants.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,aAAa,UAAY,CAAC;AAGvC,eAAO,MAAM,aAAa,UAAY,CAAC;AAGvC,eAAO,MAAM,aAAa,oBAAqB,CAAC;AAGhD,eAAO,MAAM,gBAAgB,QAAgC,CAAC;AAC9D,eAAO,MAAM,gBAAgB,QAAgC,CAAC;AAC9D,eAAO,MAAM,gBAAgB,QAAgC,CAAC;AAG9D,eAAO,MAAM,sBAAsB,QAAsB,CAAC;AAC1D,eAAO,MAAM,sBAAsB,QAAsB,CAAC;AAC1D,eAAO,MAAM,sBAAsB,QAAsB,CAAC;AAG1D,eAAO,MAAM,yBAAyB,QAAyB,CAAC;AAChE,eAAO,MAAM,yBAAyB,QAAyB,CAAC;AAChE,eAAO,MAAM,yBAAyB,QAAyB,CAAC;AAOhE,eAAO,MAAM,QAAQ,MAAM,CAAC;AAC5B,eAAO,MAAM,SAAS,QAAU,CAAC;AACjC,eAAO,MAAM,SAAS,QAAU,CAAC;AACjC,eAAO,MAAM,SAAS,QAAU,CAAC;AAIjC,eAAO,MAAM,wBAAwB,MAAW,CAAC;AAIjD,eAAO,MAAM,6BAA6B,QAAyB,CAAC;AAIpE,eAAO,MAAM,qBAAqB,MAAM,CAAC"}