cesium-to-three 0.1.0

package/dist/types/cesium-three-ground.d.ts

@@ -0,0 +1,2 @@
+export * from './lib/ground';
+//# sourceMappingURL=cesium-three-ground.d.ts.map

package/dist/types/cesium-three-ground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cesium-three-ground.d.ts","sourceRoot":"","sources":["../../src/cesium-three-ground.ts"],"names":[],"mappings":"AAQA,cAAc,cAAc,CAAC"}

package/dist/types/lib/arrow/arrow-curves.d.ts

@@ -0,0 +1,73 @@
+import type { LonLatPoint } from './arrow-types';
+/**
+ * Centripetal Catmull-Rom 样条采样。
+ *
+ * 算法步骤:
+ *   1. 对原始控制点序列两端各 mirror 一个虚拟点,使两端段也能用 CR 公式。
+ *      镜像点 = `2 * P_endpoint - P_neighbor`,效果等价于"端点处切线与
+ *      首/末段平行",视觉上箭头不会在端点处突然偏离方向。
+ *   2. 对每相邻 4 个点 P0 P1 P2 P3 计算从 P1 到 P2 的 CR 段,共 N 段。
+ *   3. 每段内按"中心向参数化"(centripetal,α = 0.5)的 t 间隔均匀采样
+ *      `segmentSamples + 1` 个点(含端点,排除下段重复)。
+ *   4. 在段间共享端点(不重复),最后追加最后一个原始控制点。
+ *
+ * 输出长度公式:
+ *   `1 + (controlPoints.length - 1) * segmentSamples`
+ * 例:5 个控制点 × 12 段采样 = 1 + 4*12 = 49 个输出点。
+ *
+ * @param controlPoints 控制点序列,至少 2 个;少于 2 时原样返回。
+ * @param segmentSamples 每相邻控制点之间额外采样的点数(不含端点),≥ 1。
+ * @returns 平滑曲线点序列,严格通过所有原始控制点。
+ */
+export declare function centripetalCatmullRomSamples(controlPoints: readonly LonLatPoint[], segmentSamples: number): LonLatPoint[];
+/**
+ * 三次 Bézier 曲线段采样(用于 CurvedArrow 的脊线)。
+ *
+ * 公式 B(t) = (1-t)³·P0 + 3(1-t)²t·C1 + 3(1-t)t²·C2 + t³·P3
+ *
+ * 与 cesium-plot-js 的 getCubicValue 一致,这里只是单段采样;
+ * 整条 Bézier 链需要调用方在每段间用同样的控制点连接(C1 连续由
+ * 调用方保证控制点对称即可)。
+ *
+ * @param p0 起点。
+ * @param c1 第一个控制点。
+ * @param c2 第二个控制点。
+ * @param p3 终点。
+ * @param samples 段内采样数(不含两端),≥ 1。
+ * @returns 包含两端点的采样点序列,长度 samples + 1。
+ */
+export declare function cubicBezierSegmentSamples(p0: LonLatPoint, c1: LonLatPoint, c2: LonLatPoint, p3: LonLatPoint, samples: number): LonLatPoint[];
+/**
+ * 沿一条折线/曲线计算每点处的切线方向(单位向量)。
+ *
+ * 用于按 perpendicular offset 生成"等宽线条"的左右两条平行线。
+ * 中间点用中央差分(前后邻居距离归一),端点用前向/后向差分。
+ *
+ * @param points 至少 2 个点。
+ * @returns 与输入等长的单位切向量数组,每个元素 [tx, ty]。
+ */
+export declare function computeTangents(points: readonly LonLatPoint[]): [number, number][];
+/**
+ * 沿折线/曲线从末尾回退给定弧长,定位精确截断点。
+ *
+ * 用于 attack/swallowtail/curved 三类箭头里"把 spine 在 neck 处剪开"的需求:
+ *   - body 部分用 spine[0..k] + 截断点
+ *   - head 部分由调用方独立构造
+ *
+ * 算法:从最末样本开始往回累加段长,直到累加值刚好覆盖 distanceFromEnd。
+ * 截断点落在最后那个跨越阈值的线段内,用线性插值得到精确坐标。
+ *
+ * @param samples 至少 2 个点的密采折线/曲线。
+ * @param distanceFromEnd 截断点距 samples 末点的弧长。
+ *                        ≤ 0 时截断点即末点(localT = 1.0);
+ *                        ≥ totalLen 时返回 null(头部比脊线还长)。
+ * @returns 截断点 segmentIdx (起点索引)、 localT (∈[0,1])、 point (坐标)
+ *          的对象;距离不可达时返回 null。
+ */
+export interface PolylineCutPoint {
+    segmentIdx: number;
+    localT: number;
+    point: LonLatPoint;
+}
+export declare function findPointAlongPolylineFromEnd(samples: readonly LonLatPoint[], distanceFromEnd: number): PolylineCutPoint | null;
+//# sourceMappingURL=arrow-curves.d.ts.map

package/dist/types/lib/arrow/arrow-curves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrow-curves.d.ts","sourceRoot":"","sources":["../../../../src/lib/arrow/arrow-curves.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,4BAA4B,CAC3C,aAAa,EAAE,SAAS,WAAW,EAAE,EACrC,cAAc,EAAE,MAAM,GACpB,WAAW,EAAE,CAiEf;AA2ED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACxC,EAAE,EAAE,WAAW,EACf,EAAE,EAAE,WAAW,EACf,EAAE,EAAE,WAAW,EACf,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,MAAM,GACb,WAAW,EAAE,CAgBf;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC9B,MAAM,EAAE,SAAS,WAAW,EAAE,GAC5B,CAAE,MAAM,EAAE,MAAM,CAAE,EAAE,CAgCtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;CACnB;AAED,wBAAgB,6BAA6B,CAC5C,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,eAAe,EAAE,MAAM,GACrB,gBAAgB,GAAG,IAAI,CA2CzB"}

package/dist/types/lib/arrow/arrow-geometry.d.ts

@@ -0,0 +1,140 @@
+import type { LonLatPoint } from './arrow-types';
+/**
+ * 在局部 WGS84 east/north 米制平面中运行箭头生成器。
+ *
+ * 箭头公式是欧氏几何:宽度、长度、角度必须共享同一单位。公开调用方传入
+ * WGS84 度制坐标,所以本辅助函数会先把控制点投影到局部米制坐标框架中
+ * 构造形状,再把输出环转换回 lon/lat 度。
+ *
+ * @param controlPoints 公开 WGS84 [lon, lat] 控制点,单位度。
+ * @param createLocalRing 消费局部 [east, north] 米制坐标的工厂函数。
+ * @returns 转换回 WGS84 度制后的工厂输出。
+ */
+export declare function createArrowInLocalMeterPlane(controlPoints: readonly LonLatPoint[], createLocalRing: (localPoints: readonly LonLatPoint[]) => readonly LonLatPoint[]): LonLatPoint[];
+/**
+ * 两点的欧氏距离(度坐标空间)。
+ *
+ * 注:经纬度被当成平面坐标,**不是**地球表面真实距离。本模块的箭头默认
+ * 跨度较小(< 数十公里),平面近似带来的形变可以忽略。如需长距离贴地
+ * 绘图,应改用大地线插值后再调用本函数。
+ *
+ * @param p1 第一个点 [lon°, lat°]。
+ * @param p2 第二个点 [lon°, lat°]。
+ * @returns  距离,度;两点重合时返回 0,不返回 NaN。
+ */
+export declare function mathDistance(p1: LonLatPoint, p2: LonLatPoint): number;
+/**
+ * 点序列的总折线长度(相邻点距离之和)。
+ *
+ * @param points 至少 1 个点。
+ * @returns      累积距离,度;单点序列返回 0。
+ */
+export declare function wholeDistance(points: readonly LonLatPoint[]): number;
+/**
+ * 基准长度 = 总折线长 ** 0.99。
+ *
+ * 与 cesium-plot-js 完全一致——指数 0.99 让长箭头的宽度增长稍慢于线性,
+ * 即"大的箭头不至于按比例同样粗"。指数 1.0 也能用,但视觉上长箭头会
+ * 显得"过粗"。
+ *
+ * @param points 控制点序列。
+ * @returns      基准长度(度的 0.99 次幂);空/单点返回 0。
+ */
+export declare function getBaseLength(points: readonly LonLatPoint[]): number;
+/**
+ * 两点的中点。
+ *
+ * @param p1 第一个点。
+ * @param p2 第二个点。
+ * @returns  新数组,两点坐标的算术平均。
+ */
+export declare function mid(p1: LonLatPoint, p2: LonLatPoint): LonLatPoint;
+/**
+ * 沿 startPnt → endPnt 反方向(即从 endPnt 看向 startPnt)的极角,弧度。
+ *
+ * 这是 cesium-plot-js 原 getAzimuth 的语义:`(cos α, sin α)` 是从 endPnt
+ * **指向** startPnt 的单位向量,而不是 start 到 end 的方向。
+ *
+ * 内部实现用 `Math.atan2(start.y - end.y, start.x - end.x)`,自然处理所有
+ * 四个象限以及轴对齐输入,返回范围 [-π, π]。
+ *
+ * 这与原项目用 asin + 四个 if 分支的实现等价但更稳健 —— 原实现在
+ *   dx = 0 且 dy = 0 时 distance = 0 → asin(0/0) = NaN,
+ *   或 dx = 0 时四个分支没有覆盖到边界值,
+ * 都会让下游 getThirdPoint 返回 NaN,导致整个箭头消失或自交。
+ *
+ * @param startPnt 起点(在公式语义中代表"目标方向")。
+ * @param endPnt   终点(下游 getThirdPoint 会以此为锚点)。
+ * @returns        极角,弧度,范围 [-π, π];两点重合时返回 0(任意方向)。
+ */
+export declare function azimuthBackward(startPnt: LonLatPoint, endPnt: LonLatPoint): number;
+/**
+ * 三点共线判定:p1 → p2 → p3 是否顺时针。
+ *
+ * 用叉积符号判定:`(p2 - p1) × (p3 - p1) < 0` 时为顺时针(右手系)。
+ * 共线(叉积 = 0)时返回 false,与原 cesium-plot-js 行为一致。
+ *
+ * @param p1 第一个点。
+ * @param p2 第二个点。
+ * @param p3 第三个点。
+ * @returns  true 表示顺时针,false 表示逆时针或共线。
+ */
+export declare function isClockWise(p1: LonLatPoint, p2: LonLatPoint, p3: LonLatPoint): boolean;
+/**
+ * 在 endPnt 处,沿 endPnt → startPnt 方向旋转 ±angle 弧度,前进 distance 距离。
+ *
+ * 这是箭头几何中最核心的工具——尾翼、颈部、翼尖等所有特殊位置都靠它从
+ * 一对参考点出发计算出来。
+ *
+ * 几何含义:
+ *   1. 取从 endPnt 看向 startPnt 的方向作为基准方向(azimuthBackward)。
+ *   2. clockwise = true 时顺时针(+angle)旋转,false 时逆时针(-angle)旋转。
+ *   3. 沿旋转后的方向从 endPnt 走 distance 度,返回到达的点。
+ *
+ * @param startPnt  起点(决定基准方向)。
+ * @param endPnt    终点(也是输出点的几何锚点)。
+ * @param angle     从基准方向偏转的角度,弧度,非负。
+ * @param distance  从 endPnt 出发的距离,度。
+ * @param clockwise 旋转方向:true = 顺时针,false = 逆时针。
+ * @returns         新数组,目标点 [lon°, lat°];输入含 NaN/无穷时返回 endPnt 副本。
+ */
+export declare function getThirdPoint(startPnt: LonLatPoint, endPnt: LonLatPoint, angle: number, distance: number, clockwise: boolean): LonLatPoint;
+/**
+ * 三点形成的内角(B 顶点处)。
+ *
+ * 用 azimuthBackward 而不是 atan2 的差,确保和原 cesium-plot-js 的
+ * `getAngleOfThreePoints` 在所有合法输入上数值一致。
+ *
+ * 返回的角度归一化到 [0, 2π) ——这一点对体部宽度计算的 sin(angle/2)
+ * 至关重要,如果返回负值会导致 sin 为负 → 宽度方向反转。
+ *
+ * @param a 第一个端点。
+ * @param b 中间顶点。
+ * @param c 第二个端点。
+ * @returns 角 ABC 的大小,弧度,范围 [0, 2π);任意点退化时返回 π(直线)。
+ */
+export declare function getAngleOfThreePoints(a: LonLatPoint, b: LonLatPoint, c: LonLatPoint): number;
+/**
+ * p2 处的"内向角平分线"方向向量(未归一化)。
+ *
+ * 几何含义:p1→p2 和 p3→p2 各自单位向量之和,指向 p2 内角的平分线方向。
+ * 共线时长度趋近于 0,调用方需检查长度判断退化。
+ *
+ * 主要用于曲线插值中确定 Bézier 控制点的偏移方向。
+ *
+ * @param p1 前一个点。
+ * @param p2 中间点(法向量从此处发出)。
+ * @param p3 后一个点。
+ * @returns  [dx, dy] 法向量分量;p1 或 p3 与 p2 重合时返回 [0, 0]。
+ */
+export declare function getNormalVector(p1: LonLatPoint, p2: LonLatPoint, p3: LonLatPoint): [number, number];
+/**
+ * 把一个角度归一化到 [0, 2π)。
+ *
+ * 用于角度差运算后保证范围一致,避免后续 sin/cos 因周期性导致符号错误。
+ *
+ * @param angle 任意实数角度,弧度。
+ * @returns     归一化后角度,[0, 2π);输入 NaN 时返回 0。
+ */
+export declare function normalizeAngle(angle: number): number;
+//# sourceMappingURL=arrow-geometry.d.ts.map

package/dist/types/lib/arrow/arrow-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrow-geometry.d.ts","sourceRoot":"","sources":["../../../../src/lib/arrow/arrow-geometry.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAkBjD;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC3C,aAAa,EAAE,SAAS,WAAW,EAAE,EACrC,eAAe,EAAE,CAAE,WAAW,EAAE,SAAS,WAAW,EAAE,KAAM,SAAS,WAAW,EAAE,GAChF,WAAW,EAAE,CA2Df;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,GAAI,MAAM,CAKvE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAE,MAAM,EAAE,SAAS,WAAW,EAAE,GAAI,MAAM,CAMtE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAE,MAAM,EAAE,SAAS,WAAW,EAAE,GAAI,MAAM,CAGtE;AAED;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,GAAI,WAAW,CAEnE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAC9B,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,WAAW,GACjB,MAAM,CASR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAC1B,EAAE,EAAE,WAAW,EACf,EAAE,EAAE,WAAW,EACf,EAAE,EAAE,WAAW,GACb,OAAO,CAmBT;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,GAChB,WAAW,CAiBb;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACpC,CAAC,EAAE,WAAW,EACd,CAAC,EAAE,WAAW,EACd,CAAC,EAAE,WAAW,GACZ,MAAM,CAgBR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC9B,EAAE,EAAE,WAAW,EACf,EAAE,EAAE,WAAW,EACf,EAAE,EAAE,WAAW,GACb,CAAE,MAAM,EAAE,MAAM,CAAE,CAYpB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAE,KAAK,EAAE,MAAM,GAAI,MAAM,CAStD"}

package/dist/types/lib/arrow/arrow-polygon.d.ts

@@ -0,0 +1,87 @@
+import type { LonLatPoint } from './arrow-types';
+/**
+ * 顶点上限——给 MAX_POLYGON_STYLE_VERTICES(128) 留出 8 个 buffer。
+ *
+ * 留 buffer 的原因:渲染管线可能在内部 stroke / 闭合时追加 1-2 个顶点,
+ * 严格压到 128 容易在边界 case 触发"polygon supports at most 128 points"
+ * 异常。
+ */
+export declare const ARROW_OUTPUT_MAX_VERTICES = 120;
+/**
+ * 去除连续重复顶点(同时检查首尾闭合重复)。
+ *
+ * 注:不去重"非连续"的重复——多边形中段如果出现两个同坐标顶点,通常意味着
+ * 形状自交,简单去重会改变拓扑;此情况留给 ensurePolygonValid(可选)处理。
+ *
+ * @param ring 原始环。
+ * @returns 新数组,连续重复点已合并。
+ */
+export declare function dedupeConsecutivePoints(ring: readonly LonLatPoint[]): LonLatPoint[];
+/**
+ * 用 Shoelace 公式计算多边形的有向面积(度的平方)。
+ *
+ * 公式:`A = 0.5 * Σ (x_i * y_{i+1} - x_{i+1} * y_i)`,索引模 n。
+ * `A > 0` 时顶点 CCW(逆时针),`A < 0` 时 CW(顺时针)。
+ *
+ * @param ring 至少 3 个点,首尾不重复。
+ * @returns 有向面积;ring.length < 3 时返回 0。
+ */
+export declare function signedAreaShoelace(ring: readonly LonLatPoint[]): number;
+/**
+ * 强制把环调整为 CCW(逆时针)绕向。
+ *
+ * CesiumGroundPolygonPrimitive 的着色器与 polygon-rings.ts 的 winding 处理
+ * 默认外环 CCW,若输入是 CW 会导致填充方向错(以洞当外、或翻面)。
+ *
+ * @param ring 已经去重的环。
+ * @returns 新数组,保证 CCW;若输入已经 CCW 则只是浅拷贝。
+ */
+export declare function ensureCounterClockwise(ring: readonly LonLatPoint[]): LonLatPoint[];
+/**
+ * 均匀降采样到指定上限,严格保留首尾点。
+ *
+ * 算法:从 [0, n-1] 区间按 (maxCount-1) 段均匀步进取整数索引。这样
+ * 首点 (i=0) 与末点 (i=maxCount-1 对应 ring.length-1) 永远入选,中间
+ * 视形状均匀分布。
+ *
+ * 注:严格的"保形降采样"应该用 Visvalingam–Whyatt 之类的算法,根据三角形
+ * 面积优先级删除冗余点。但本模块的箭头由 Catmull-Rom 平滑生成,任意位置
+ * 的曲率分布都比较均匀,简单步进足够保形 + 实现简单。
+ *
+ * @param ring 输入环。
+ * @param maxCount 目标点数上限,≥ 4。
+ * @returns 长度 ≤ maxCount 的新数组;输入已满足上限时浅拷贝返回。
+ */
+export declare function clampVertexCount(ring: readonly LonLatPoint[], maxCount: number): LonLatPoint[];
+/**
+ * 移除 hairpin 顶点(转角 > 阈值的近 180° U-turn)。
+ *
+ * 箭头脊线在急转弯处经 Catmull-Rom 平滑后会出现 sample 聚集 + perp 方向
+ * 急速旋转,Frenet 偏移产生的 leftSide / rightSide 在 cluster 内部出现
+ * 「短退一步 → 反向冲出」的 cusp(转角接近 180°)。多边形拓扑上虽然不
+ * 自交,但视觉上是一根「针尖」 — fragment shader 的 point-in-polygon 测试
+ * 在 cusp 附近边密集 + 浮点边界判断,容易把 cusp 周围一小片像素误判成外部
+ * (用户截图的三角凹口正是这种 cusp 产生的视觉物)。
+ *
+ * 算法:每轮扫描,凡 |turn| > π − threshold(默认 30°,即 turn > 150°)
+ * 的顶点直接删除。继续迭代直到没有更多 hairpin 或剩余顶点 < 4。
+ *
+ * @param ring 已去重的多边形环。
+ * @param thresholdRad hairpin 阈值(弧度),默认 30° = π/6。turn 接近 π
+ *                    (180°)说明前后两条边几乎反向。
+ * @returns 移除 hairpin 后的环。
+ */
+export declare function removeHairpinVertices(ring: readonly LonLatPoint[], thresholdRad?: number): LonLatPoint[];
+/**
+ * 一站式正规化:**去重 → 移除 hairpin → 强制 CCW → 降采样 ≤ maxCount**。
+ *
+ * 所有箭头生成器最后一步都应调用此函数,确保输出符合
+ * CesiumGroundPolygonPrimitive 的契约(3-128 顶点、闭合、CCW、无重复)。
+ *
+ * @param rawRing 拼接出来的原始环(可能含重复、CW、超长)。
+ * @param maxCount 顶点上限,默认 ARROW_OUTPUT_MAX_VERTICES = 120。
+ * @returns 干净的多边形环;若输入太退化(去重后 < 3 点)返回空数组。
+ * @throws  从不抛错;非法输入返回空数组,由调用方决定如何反馈。
+ */
+export declare function finalizePolygon(rawRing: readonly LonLatPoint[], maxCount?: number): LonLatPoint[];
+//# sourceMappingURL=arrow-polygon.d.ts.map

package/dist/types/lib/arrow/arrow-polygon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrow-polygon.d.ts","sourceRoot":"","sources":["../../../../src/lib/arrow/arrow-polygon.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAU7C;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAE,IAAI,EAAE,SAAS,WAAW,EAAE,GAAI,WAAW,EAAE,CA2BrF;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAE,IAAI,EAAE,SAAS,WAAW,EAAE,GAAI,MAAM,CAYzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAE,IAAI,EAAE,SAAS,WAAW,EAAE,GAAI,WAAW,EAAE,CAapF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,SAAS,WAAW,EAAE,EAC5B,QAAQ,EAAE,MAAM,GACd,WAAW,EAAE,CAef;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,SAAS,WAAW,EAAE,EAC5B,YAAY,GAAE,MAAoB,GAChC,WAAW,EAAE,CAgCf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC9B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,QAAQ,GAAE,MAAkC,GAC1C,WAAW,EAAE,CAoBf"}

package/dist/types/lib/arrow/arrow-types.d.ts

@@ -0,0 +1,152 @@
+import type { LonLatPoint } from '../ground/types';
+export type { LonLatPoint };
+/**
+ * 细箭头(FineArrow)生成选项。
+ *
+ * 细箭头由两个端点定义,呈"窄尾 → 渐宽颈部 → 三角箭头"的填充多边形。
+ * 所有比例因子相对于 `(|p1 p2|) ** 0.99`(基准长度)度量,因此长度变化时
+ * 整体形状成比例缩放。
+ */
+export interface FineArrowOptions {
+    /** 尾部宽度因子(基准长度的倍数)。默认 0.10 */
+    tailWidthFactor?: number;
+    /** 颈部宽度因子。默认 0.20 */
+    neckWidthFactor?: number;
+    /** 翼展宽度因子。默认 0.25 */
+    headWidthFactor?: number;
+    /** 翼展张开角(弧度)。默认 π/8.5 ≈ 0.370 rad ≈ 21.18° */
+    headAngleRadians?: number;
+    /** 颈部夹角(弧度)。默认 π/13 ≈ 0.242 rad ≈ 13.85° */
+    neckAngleRadians?: number;
+}
+/**
+ * 突击方向箭头(AssaultDirectionArrow)生成选项。
+ *
+ * 与 FineArrow 同形但更"窄长"——尾部更细、翼展更小,适合表示局部突击方向。
+ * 内部计算时还会把基准长度放大 1.5 倍以让箭头看起来更修长。
+ */
+export interface AssaultDirectionArrowOptions {
+    /** 基准长度倍率(影响整体大小)。默认 1.5 */
+    lengthScale?: number;
+    /** 尾部宽度因子。默认 0.08 */
+    tailWidthFactor?: number;
+    /** 颈部宽度因子。默认 0.10 */
+    neckWidthFactor?: number;
+    /** 翼展宽度因子。默认 0.13 */
+    headWidthFactor?: number;
+    /** 翼展张开角(弧度)。默认 π/4 = 45° */
+    headAngleRadians?: number;
+    /** 颈部夹角(弧度)。默认 0.5575 rad ≈ 31.94°(原 π*0.17741) */
+    neckAngleRadians?: number;
+}
+/**
+ * 攻击箭头(AttackArrow)生成选项。
+ *
+ * 攻击箭头至少 3 个控制点:前 2 个定义尾部宽度,从第 3 个开始定义脊线。
+ * 体部沿脊线渐变(从尾宽到颈宽),末端是五点三角箭头。
+ *
+ * 鲁棒性参数(`minBodyHalfAngleRadians` / `bodyWidthMargin`)用于防止
+ * 锐角脊线导致体部宽度爆炸(原 cesium-plot-js 的 4+ 控制点 bug)。
+ */
+export interface AttackArrowOptions {
+    /** 头部高度相对脊线基准长度的因子。默认 0.18 */
+    headHeightFactor?: number;
+    /** 翼展宽度相对头部高度的因子。默认 0.30 */
+    headWidthFactor?: number;
+    /** 颈部高度相对头部高度的因子。默认 0.85 */
+    neckHeightFactor?: number;
+    /** 颈部宽度相对头部高度的因子。默认 0.15 */
+    neckWidthFactor?: number;
+    /** 头部高度不超过尾宽的此倍数,防止头部过大。默认 0.80 */
+    headTailFactor?: number;
+    /**
+     * 体部宽度计算中,脊线半角的最小值(弧度)。
+     * w = (tailWidth/2 - dropoff) / sin(halfAngle)
+     * 当 halfAngle → 0 时 w 发散,这里下限保证 sin ≥ sin(π/12) ≈ 0.259,
+     * 即 w ≤ ~3.86 倍正常值,不会让体部翻出。
+     * 默认 π/12 ≈ 15°(即原始夹角 30° 以下被钳制)。
+     */
+    minBodyHalfAngleRadians?: number;
+    /**
+     * 体部宽度上限相对尾宽半值的倍数。
+     * 即使 minBodyHalfAngleRadians 触发了 clamp,最终 w 也不会超过
+     * `tailWidth/2 * bodyWidthMargin`,确保体部永远在尾部宽度之内。
+     * 默认 1.05(留 5% 余量给视觉过渡)。
+     */
+    bodyWidthMargin?: number;
+    /**
+     * Catmull-Rom 平滑每段控制点之间的采样数(不含两端点)。
+     * 较小的值(8-16)足以让体部边缘视觉平滑,较大的值会增加最终多边形
+     * 顶点数,有命中 MAX_POLYGON_STYLE_VERTICES = 128 上限的风险。
+     * 默认 12。
+     */
+    bodySmoothingSegments?: number;
+}
+/**
+ * 燕尾攻击箭头(SwallowtailAttackArrow)生成选项。
+ *
+ * 比 AttackArrow 多一个"燕尾"凹口——在尾部中点向脊线相反方向凸出一个点。
+ * 燕尾因子越大,尾部凹口越深。其它字段含义与 AttackArrowOptions 完全相同。
+ */
+export interface SwallowtailAttackArrowOptions extends AttackArrowOptions {
+    /**
+     * 燕尾凸出深度因子(相对 tailWidthFactor × baseLength)。默认 1.0。
+     * 0 表示退化为普通 AttackArrow,>1 表示凸出更深。
+     */
+    swallowtailFactor?: number;
+    /**
+     * 燕尾凸出参考宽度因子(相对脊线基准长度)。默认 0.10。
+     * 与 swallowtailFactor 共同决定凸出距离。
+     */
+    tailWidthFactor?: number;
+}
+/**
+ * 曲线箭头(CurvedArrow)生成选项。
+ *
+ * 曲线箭头由 2+ 个控制点定义一条平滑曲线,沿曲线两侧偏移给定宽度后
+ * 闭合成填充多边形,末端附加三角箭头。当只有 2 个控制点时退化为
+ * 直线版本(FineArrow 的窄长变体)。
+ *
+ * 注:与 cesium-plot-js 的 CurvedArrow(line type)不同,本实现产出
+ * **闭合多边形**,以适配本项目仅有 polygon primitive 的渲染管线。
+ */
+export interface CurvedArrowOptions {
+    /**
+     * 体部线宽因子(相对曲线总长度)。默认 0.05。
+     * 越大则线条越粗。
+     */
+    bodyWidthFactor?: number;
+    /**
+     * 头部翼展宽度因子(相对曲线总长度)。默认 0.16。
+     */
+    headWidthFactor?: number;
+    /**
+     * 头部长度因子(相对曲线总长度)。默认 0.12。
+     * 决定箭头从尖端向后延伸多远。
+     */
+    headLengthFactor?: number;
+    /**
+     * 颈部宽度因子(相对头部翼展)。默认 0.50。
+     * 必须 < 1,否则颈部比翼尖宽,箭头形状反转。
+     */
+    neckWidthRelativeToHead?: number;
+    /**
+     * Catmull-Rom 平滑每段控制点之间的采样数。默认 16。
+     */
+    curveSmoothingSegments?: number;
+    /**
+     * 体部从尾到颈的宽度收窄比(0 = 不收窄;0.5 = 颈部宽度是尾部的 50%)。
+     * 默认 0.0(等宽线条)。
+     */
+    bodyTaperRatio?: number;
+}
+/**
+ * 所有箭头生成器统一的输出契约:
+ * 一个**闭合的、CCW(逆时针)绕向、无连续重复顶点**的经纬度环。
+ *
+ * 可以直接作为 `CesiumGroundPolygonPrimitive` 构造选项的 `points` 字段使用。
+ * 长度上限受 `MAX_POLYGON_STYLE_VERTICES = 128` 约束,本模块所有生成器
+ * 都在内部 clamp 到 ≤120 以留出余量。
+ */
+export type ArrowPolygon = LonLatPoint[];
+//# sourceMappingURL=arrow-types.d.ts.map

package/dist/types/lib/arrow/arrow-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrow-types.d.ts","sourceRoot":"","sources":["../../../../src/lib/arrow/arrow-types.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAChC,8BAA8B;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,4BAA4B;IAC5C,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IAClC,8BAA8B;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4BAA4B;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4BAA4B;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4BAA4B;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,6BAA8B,SAAQ,kBAAkB;IACxE;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IAClC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC;;OAEG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,EAAE,CAAC"}

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

@@ -0,0 +1,8 @@
+export { createFineArrow } from './shapes/fine-arrow';
+export { createAssaultDirectionArrow } from './shapes/assault-direction-arrow';
+export { createAttackArrow } from './shapes/attack-arrow';
+export { createSwallowtailAttackArrow } from './shapes/swallowtail-attack-arrow';
+export { createCurvedArrow } from './shapes/curved-arrow';
+export type { ArrowPolygon, LonLatPoint, FineArrowOptions, AssaultDirectionArrowOptions, AttackArrowOptions, SwallowtailAttackArrowOptions, CurvedArrowOptions, } from './arrow-types';
+export { ARROW_OUTPUT_MAX_VERTICES } from './arrow-polygon';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/arrow/index.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAI1D,YAAY,EACX,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,4BAA4B,EAC5B,kBAAkB,EAClB,6BAA6B,EAC7B,kBAAkB,GAClB,MAAM,eAAe,CAAC;AAKvB,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/lib/arrow/shapes/assault-direction-arrow.d.ts

@@ -0,0 +1,20 @@
+import type { ArrowPolygon, AssaultDirectionArrowOptions, LonLatPoint } from '../arrow-types';
+/**
+ * 生成突击方向箭头多边形(单笔 CCW 周界遍历)。
+ *
+ * 与 createFineArrow 的差异仅在默认比例与 lengthScale,几何步骤完全相同:
+ *   1. spineDir = (p2 - p1) / |p2 - p1|;perp_CCW = ( -spineDir.y, spineDir.x )
+ *   2. baseLen = |p1 p2|^0.99 × lengthScale,派生 tail/neck/head 三个 halfWidth
+ *   3. 颈 / 翼的"轴 + 法向"偏移由 cos(angle) × halfWidth 和 sin(angle) × halfWidth
+ *      给出
+ *   4. 按 CCW 顺序逐顶点排列 8 个点:
+ *        p1 → tailRight → neckRight → headRight → p2 → headLeft → neckLeft → tailLeft
+ *   5. 交给 finalizePolygon 去重 + CCW 校正 + 顶点上限 clamp。
+ *
+ * @param p1 尾部端点。
+ * @param p2 头部端点。
+ * @param options 可选比例覆盖。
+ * @returns 8 顶点闭合多边形;p1 与 p2 重合时返回空数组。
+ */
+export declare function createAssaultDirectionArrow(p1: LonLatPoint, p2: LonLatPoint, options?: AssaultDirectionArrowOptions): ArrowPolygon;
+//# sourceMappingURL=assault-direction-arrow.d.ts.map

package/dist/types/lib/arrow/shapes/assault-direction-arrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assault-direction-arrow.d.ts","sourceRoot":"","sources":["../../../../../src/lib/arrow/shapes/assault-direction-arrow.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EACX,YAAY,EACZ,4BAA4B,EAC5B,WAAW,EACX,MAAM,gBAAgB,CAAC;AAWxB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,2BAA2B,CAC1C,EAAE,EAAE,WAAW,EACf,EAAE,EAAE,WAAW,EACf,OAAO,GAAE,4BAAiC,GACxC,YAAY,CASd"}

package/dist/types/lib/arrow/shapes/attack-arrow.d.ts

@@ -0,0 +1,56 @@
+import type { ArrowPolygon, AttackArrowOptions, LonLatPoint } from '../arrow-types';
+/**
+ * 攻击箭头骨架。
+ *
+ * 暴露给 swallowtail-attack-arrow.ts 复用,后者只需要在尾部多加一个燕尾
+ * 凸点,体部 / 头部几何与本文件 100% 一致。
+ */
+export interface AttackArrowSkeleton {
+    /** 脊线左侧带,leftSide[0] = tailLeft、leftSide[last] = neckLeft。 */
+    leftSide: LonLatPoint[];
+    /** 脊线右侧带,rightSide[0] = tailRight、rightSide[last] = neckRight。 */
+    rightSide: LonLatPoint[];
+    /** 左翼尖(在 neck 处沿法线外扩 headHalfWidth)。 */
+    headLeft: LonLatPoint;
+    /** 右翼尖。 */
+    headRight: LonLatPoint;
+    /** 箭尖(与用户控制点 controlPoints[n-1] 严格一致)。 */
+    tip: LonLatPoint;
+    /** 尾左角(与 leftSide[0] 严格一致)。 */
+    tailLeft: LonLatPoint;
+    /** 尾右角(与 rightSide[0] 严格一致)。 */
+    tailRight: LonLatPoint;
+    /** 尾中点(燕尾箭头里用作"燕尾凸出方向"的参考)。 */
+    midTail: LonLatPoint;
+    /** 脊线第二个控制点(燕尾箭头里用作"燕尾凸出方向"的参考)。 */
+    spineSecond: LonLatPoint;
+    /**
+     * 整条脊线(含 midTail + 全部 controlPoints[2..n-1])的基准长度
+     * = wholeDistance(spineControlPoints) ** 0.99。
+     * 燕尾箭头里"燕尾凸出深度"的尺度来自这个值,与原版一致。
+     */
+    spineBaseLen: number;
+}
+/**
+ * 构造攻击箭头(Frenet 带状)。
+ *
+ * @param controlPoints 控制点序列,至少 3 个。少于 3 时:
+ *   - controlPoints.length === 2 → 退化为 createFineArrow(与原版兼容)
+ *   - controlPoints.length < 2 → 返回空数组
+ * @param options 可选比例与平滑参数。
+ * @returns 闭合多边形;输入退化时可能返回空数组。
+ */
+export declare function createAttackArrow(controlPoints: readonly LonLatPoint[], options?: AttackArrowOptions): ArrowPolygon;
+/**
+ * 构造攻击箭头骨架(脊线 + 左右带 + 头部 3 点)。
+ *
+ * 把 spine、左右带、头部 3 点暴露给 swallowtail-attack-arrow.ts 复用,
+ * 详细几何步骤见文件顶部的"几何步骤"注释。
+ * 任何输入退化(脊线少于 2 点、长度为 0 等)时返回 null。
+ *
+ * @param controlPoints 控制点序列,至少 3 个(由调用方校验)。
+ * @param options       AttackArrow 选项;未传字段使用本文件默认值。
+ * @returns 骨架对象;输入退化时返回 null。
+ */
+export declare function buildAttackArrowSkeleton(controlPoints: readonly LonLatPoint[], options: AttackArrowOptions): AttackArrowSkeleton | null;
+//# sourceMappingURL=attack-arrow.d.ts.map

package/dist/types/lib/arrow/shapes/attack-arrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attack-arrow.d.ts","sourceRoot":"","sources":["../../../../../src/lib/arrow/shapes/attack-arrow.ts"],"names":[],"mappings":"AAwEA,OAAO,KAAK,EACX,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,MAAM,gBAAgB,CAAC;AAkBxB;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IACnC,8DAA8D;IAC9D,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,kEAAkE;IAClE,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,wCAAwC;IACxC,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW;IACX,SAAS,EAAE,WAAW,CAAC;IACvB,0CAA0C;IAC1C,GAAG,EAAE,WAAW,CAAC;IACjB,+BAA+B;IAC/B,QAAQ,EAAE,WAAW,CAAC;IACtB,gCAAgC;IAChC,SAAS,EAAE,WAAW,CAAC;IACvB,+BAA+B;IAC/B,OAAO,EAAE,WAAW,CAAC;IACrB,oCAAoC;IACpC,WAAW,EAAE,WAAW,CAAC;IACzB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAChC,aAAa,EAAE,SAAS,WAAW,EAAE,EACrC,OAAO,GAAE,kBAAuB,GAC9B,YAAY,CAKd;AAyCD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACvC,aAAa,EAAE,SAAS,WAAW,EAAE,EACrC,OAAO,EAAE,kBAAkB,GACzB,mBAAmB,GAAG,IAAI,CAgM5B"}

package/dist/types/lib/arrow/shapes/curved-arrow.d.ts

@@ -0,0 +1,10 @@
+import type { ArrowPolygon, CurvedArrowOptions, LonLatPoint } from '../arrow-types';
+/**
+ * 生成曲线箭头(沿曲线的填充多边形)。
+ *
+ * @param controlPoints 控制点序列,至少 2 个;最末点为箭头尖端。
+ * @param options 体型与平滑参数。
+ * @returns 闭合多边形;输入退化(< 2 点或所有点重合)时返回空数组。
+ */
+export declare function createCurvedArrow(controlPoints: readonly LonLatPoint[], options?: CurvedArrowOptions): ArrowPolygon;
+//# sourceMappingURL=curved-arrow.d.ts.map

package/dist/types/lib/arrow/shapes/curved-arrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"curved-arrow.d.ts","sourceRoot":"","sources":["../../../../../src/lib/arrow/shapes/curved-arrow.ts"],"names":[],"mappings":"AAoDA,OAAO,KAAK,EACX,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,MAAM,gBAAgB,CAAC;AAgBxB;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAChC,aAAa,EAAE,SAAS,WAAW,EAAE,EACrC,OAAO,GAAE,kBAAuB,GAC9B,YAAY,CAKd"}

package/dist/types/lib/arrow/shapes/fine-arrow.d.ts

@@ -0,0 +1,23 @@
+import type { ArrowPolygon, FineArrowOptions, LonLatPoint } from '../arrow-types';
+/**
+ * 生成细箭头多边形(单笔 CCW 周界遍历)。
+ *
+ * 几何步骤:
+ *   1. 计算 spineDir = (p2 - p1) / |p2 - p1|;
+ *      perp_CCW = ( -spineDir.y, spineDir.x )(在 +y 朝北的右手系下指向"逻辑左")。
+ *   2. 基准长度 L = |p1 p2|^0.99,派生 tailHalfWidth / neckHalfWidth / headHalfWidth。
+ *      每个 *HalfWidth 就是该处脊线到对应顶点的**垂直距离**(原版用 tailWidth/
+ *      neckWidth/headWidth 命名,实际上都是 half-width)。
+ *   3. 颈/翼的纵向位置(从 p2 向 p1 方向回退多少)= cos(angle) × halfWidth;
+ *      横向位置(垂直脊线偏离多少)= sin(angle) × halfWidth。
+ *   4. 按 CCW 顺序逐顶点排列 8 个点:
+ *        p1 → tailRight → neckRight → headRight → p2 → headLeft → neckLeft → tailLeft
+ *   5. 交给 finalizePolygon 去重 + CCW 校正 + 顶点上限 clamp。
+ *
+ * @param p1 尾部端点 [lon°, lat°]。
+ * @param p2 头部端点(尖端)[lon°, lat°]。
+ * @param options 可选比例覆盖。
+ * @returns 8(去重后可能更少)顶点的闭合多边形;p1 与 p2 重合时返回空数组。
+ */
+export declare function createFineArrow(p1: LonLatPoint, p2: LonLatPoint, options?: FineArrowOptions): ArrowPolygon;
+//# sourceMappingURL=fine-arrow.d.ts.map

package/dist/types/lib/arrow/shapes/fine-arrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fine-arrow.d.ts","sourceRoot":"","sources":["../../../../../src/lib/arrow/shapes/fine-arrow.ts"],"names":[],"mappings":"AA2CA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAWlF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAC9B,EAAE,EAAE,WAAW,EACf,EAAE,EAAE,WAAW,EACf,OAAO,GAAE,gBAAqB,GAC5B,YAAY,CASd"}

package/dist/types/lib/arrow/shapes/swallowtail-attack-arrow.d.ts

@@ -0,0 +1,12 @@
+import type { ArrowPolygon, LonLatPoint, SwallowtailAttackArrowOptions } from '../arrow-types';
+/**
+ * 构造燕尾攻击箭头(Frenet 带状 + 尾部 V 形凹口)。
+ *
+ * @param controlPoints 控制点序列,至少 3 个。少于 3 时:
+ *   - 2 个点 → 退化为 createFineArrow(与 attack-arrow 保持一致)
+ *   - < 2 → 返回空数组
+ * @param options 比例与平滑参数(继承 AttackArrowOptions + 燕尾两项)。
+ * @returns 闭合多边形;输入退化时可能返回空数组。
+ */
+export declare function createSwallowtailAttackArrow(controlPoints: readonly LonLatPoint[], options?: SwallowtailAttackArrowOptions): ArrowPolygon;
+//# sourceMappingURL=swallowtail-attack-arrow.d.ts.map

package/dist/types/lib/arrow/shapes/swallowtail-attack-arrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swallowtail-attack-arrow.d.ts","sourceRoot":"","sources":["../../../../../src/lib/arrow/shapes/swallowtail-attack-arrow.ts"],"names":[],"mappings":"AAgDA,OAAO,KAAK,EACX,YAAY,EACZ,WAAW,EACX,6BAA6B,EAC7B,MAAM,gBAAgB,CAAC;AAWxB;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC3C,aAAa,EAAE,SAAS,WAAW,EAAE,EACrC,OAAO,GAAE,6BAAkC,GACzC,YAAY,CAKd"}