three-base 2.0.134 → 2.0.142

package/MktMesh/types.d.ts

@@ -0,0 +1,75 @@
+import type { Matrix4 } from "three";
+/**
+ * 单个纹理的运行时信息：url + 世界矩阵（位置 + 旋转，缩放忽略）。
+ * 纹理矩阵的「位置」即墨卡托投影的中心点（shader 里以它为原点求方向向量）。
+ */
+export interface MktTextureInfo {
+    /** 纹理地址（相对路径，兼容 hash 路由与 OSS 子目录部署）。
+     *  ⚠️ 2026-09-20 起全景点改为「瓦片组合」（现行 横 8 × 竖 4 = 32 片，10-06 晚旨）：渲染优先用 tiles，
+     *  url 仅作兼容/回退（旧数据无 tiles 时按单张全图渲染）。 */
+    url: string;
+    /**
+     * 全景图名称（用户可编辑，用于标识这一张全景图；可留空）。
+     * 皇上旨 2026-09-19：「每一个全景图都需要一个 name 字段，并且可以编辑，放在 url 的上面」。
+     * ⚠️ 只是**标识**，不参与投影/渲染计算；留空时 UI 回落到「全景点 #索引」。
+     */
+    name?: string;
+    /**
+     * 真瓦片地址（与 tiled 判据 `mktPanoTiledFlag` 同约定）。
+     * ⭐ 皇上旨 2026-10-06 晚（逐字）「我希望一次能够展示 8 个全景纹理, 每个全景纹理由左右 2 个 RT 组成,
+     * 每个 RT 由 16 个全景瓦片组成, 所以, 全景图在上传的时候, 只需要拆分成 横 8 * 竖 4 = 32 个瓦片图就可以了」
+     * ⇒ **现行唯一形态 = 32 张（横 8 × 竖 4）**：行优先从图像左上开始，运行时由
+     * `PanoTileStitcher` 用 shader 逐格画进 **2 张 4096×4096** `WebGLRenderTarget`（左半幅 / 右半幅，每槽 4×4 格），
+     * 2 槽组成完整全景再喂 shader。⚠️ 同一天早些时候那道「8×8 = 64 片 / 4 张 4096×2048」**已作废**。
+     * ⚠️ 每片向四边**多带** `RT_STITCH_SEAM_MARGIN_PX` 像素的邻居余量（治内部接缝；采样窗口由
+     *   `rtStitchTileInset` 还原），所以片宽 ≠ 原图正好 1/8、片高 ≠ 正好 1/4。
+     * ⚠️ 只要有 1~32 条就整组交拼合器，缺的格子涂灰（数据不全一眼可见）；旧的 4 张（2×2）/16 张（4×4）
+     *   逐张、逐 4 片路径已删（皇上「我会重新上传」⇒ ⛔ 不做兼容层）。
+     * 为空数组/缺省时回退到 url（单张全图，兼容旧数据）。
+     */
+    tiles?: string[];
+    /** 纹理世界矩阵（位置 + 旋转） */
+    matrix: Matrix4;
+}
+/** 可序列化的单个纹理信息（矩阵展开为 16 元素数组） */
+export interface MktTextureData {
+    url: string;
+    /** 全景图名称（用户可编辑；可留空） */
+    name?: string;
+    /** 真瓦片地址：32 张（横 8 × 竖 4，行优先；见 `MktTextureInfo.tiles`）；缺省回退 url */
+    tiles?: string[];
+    matrix: number[];
+}
+/** 墙体正反面显示模式：正面(FrontSide) / 反面(BackSide) / 双面(DoubleSide) */
+export type WallSide = "front" | "back" | "double";
+/**
+ * MktMesh 导入 / 导出数据结构。
+ * 墙面（普通 Mesh）由一组地面折线点位（wallPoints，XZ 平面）挤出生成，
+ * 不再使用「实例矩阵」模型；故数据只含墙点位 + 墙高 + 是否闭合 + 纹理数组。
+ */
+export interface WallPoint {
+    /** 地面折线点的 X 坐标（世界） */
+    x: number;
+    /** 地面折线点的 Y 坐标（离地高度，默认 0；可调出阶梯/高低错落的墙基） */
+    y: number;
+    /** 地面折线点的 Z 坐标（世界） */
+    z: number;
+}
+export interface MktMeshData {
+    /** 墙体地面折线点位（XZ 平面，世界坐标），至少 2 个点才能生成墙体 */
+    wallPoints: WallPoint[];
+    /** 墙体高度（世界单位，沿 +Y 挤出） */
+    wallHeight: number;
+    /** 墙体折线是否闭合（首尾相连成环） */
+    wallClosed: boolean;
+    /** 墙体正反面显示：正面(FrontSide) / 反面(BackSide) / 双面(DoubleSide)，默认双面 */
+    wallSide: WallSide;
+    /**
+     * 全景「序号直接取」映射：每个三角面（faceIndex）→ 被指派的「全景全局序号」（-1=未设）。
+     * 仅发布态/预览/编辑态的「序号直接取模式」下使用，由着色器按 aPanoIndex 在 panoIndices 槽里找对应全景纹理。
+     * 缺省（旧存档/无映射）时回落到距离-夹角取图，保证旧工程仍可正常渲染。
+     */
+    panoFaceMapping?: number[];
+    /** 纹理数组 */
+    textures: MktTextureData[];
+}

package/MktMesh/types.js

@@ -0,0 +1 @@
+export {};

package/MktMesh/types.ts

@@ -0,0 +1,87 @@
+/*
+ * @Author: xiaosihan
+ * @Date: 2026-08-25
+ * @Description: MktMesh（墨卡托模型）的数据类型定义。
+ * - 运行时用 three 的 Matrix4（位置 + 旋转，缩放恒为 1）；
+ * - 导入/导出序列化时矩阵统一展开为 16 元素 number[]（列主序，同 Matrix4.toArray()）。
+ */
+import type { Matrix4 } from "three";
+
+/**
+ * 单个纹理的运行时信息：url + 世界矩阵（位置 + 旋转，缩放忽略）。
+ * 纹理矩阵的「位置」即墨卡托投影的中心点（shader 里以它为原点求方向向量）。
+ */
+export interface MktTextureInfo {
+    /** 纹理地址（相对路径，兼容 hash 路由与 OSS 子目录部署）。
+     *  ⚠️ 2026-09-20 起全景点改为「瓦片组合」（现行 横 8 × 竖 4 = 32 片，10-06 晚旨）：渲染优先用 tiles，
+     *  url 仅作兼容/回退（旧数据无 tiles 时按单张全图渲染）。 */
+    url: string;
+    /**
+     * 全景图名称（用户可编辑，用于标识这一张全景图；可留空）。
+     * 皇上旨 2026-09-19：「每一个全景图都需要一个 name 字段，并且可以编辑，放在 url 的上面」。
+     * ⚠️ 只是**标识**，不参与投影/渲染计算；留空时 UI 回落到「全景点 #索引」。
+     */
+    name?: string;
+    /**
+     * 真瓦片地址（与 tiled 判据 `mktPanoTiledFlag` 同约定）。
+     * ⭐ 皇上旨 2026-10-06 晚（逐字）「我希望一次能够展示 8 个全景纹理, 每个全景纹理由左右 2 个 RT 组成,
+     * 每个 RT 由 16 个全景瓦片组成, 所以, 全景图在上传的时候, 只需要拆分成 横 8 * 竖 4 = 32 个瓦片图就可以了」
+     * ⇒ **现行唯一形态 = 32 张（横 8 × 竖 4）**：行优先从图像左上开始，运行时由
+     * `PanoTileStitcher` 用 shader 逐格画进 **2 张 4096×4096** `WebGLRenderTarget`（左半幅 / 右半幅，每槽 4×4 格），
+     * 2 槽组成完整全景再喂 shader。⚠️ 同一天早些时候那道「8×8 = 64 片 / 4 张 4096×2048」**已作废**。
+     * ⚠️ 每片向四边**多带** `RT_STITCH_SEAM_MARGIN_PX` 像素的邻居余量（治内部接缝；采样窗口由
+     *   `rtStitchTileInset` 还原），所以片宽 ≠ 原图正好 1/8、片高 ≠ 正好 1/4。
+     * ⚠️ 只要有 1~32 条就整组交拼合器，缺的格子涂灰（数据不全一眼可见）；旧的 4 张（2×2）/16 张（4×4）
+     *   逐张、逐 4 片路径已删（皇上「我会重新上传」⇒ ⛔ 不做兼容层）。
+     * 为空数组/缺省时回退到 url（单张全图，兼容旧数据）。
+     */
+    tiles?: string[];
+    /** 纹理世界矩阵（位置 + 旋转） */
+    matrix: Matrix4;
+}
+
+/** 可序列化的单个纹理信息（矩阵展开为 16 元素数组） */
+export interface MktTextureData {
+    url: string;
+    /** 全景图名称（用户可编辑；可留空） */
+    name?: string;
+    /** 真瓦片地址：32 张（横 8 × 竖 4，行优先；见 `MktTextureInfo.tiles`）；缺省回退 url */
+    tiles?: string[];
+    matrix: number[];
+}
+
+/** 墙体正反面显示模式：正面(FrontSide) / 反面(BackSide) / 双面(DoubleSide) */
+export type WallSide = "front" | "back" | "double";
+
+/**
+ * MktMesh 导入 / 导出数据结构。
+ * 墙面（普通 Mesh）由一组地面折线点位（wallPoints，XZ 平面）挤出生成，
+ * 不再使用「实例矩阵」模型；故数据只含墙点位 + 墙高 + 是否闭合 + 纹理数组。
+ */
+export interface WallPoint {
+    /** 地面折线点的 X 坐标（世界） */
+    x: number;
+    /** 地面折线点的 Y 坐标（离地高度，默认 0；可调出阶梯/高低错落的墙基） */
+    y: number;
+    /** 地面折线点的 Z 坐标（世界） */
+    z: number;
+}
+
+export interface MktMeshData {
+    /** 墙体地面折线点位（XZ 平面，世界坐标），至少 2 个点才能生成墙体 */
+    wallPoints: WallPoint[];
+    /** 墙体高度（世界单位，沿 +Y 挤出） */
+    wallHeight: number;
+    /** 墙体折线是否闭合（首尾相连成环） */
+    wallClosed: boolean;
+    /** 墙体正反面显示：正面(FrontSide) / 反面(BackSide) / 双面(DoubleSide)，默认双面 */
+    wallSide: WallSide;
+    /**
+     * 全景「序号直接取」映射：每个三角面（faceIndex）→ 被指派的「全景全局序号」（-1=未设）。
+     * 仅发布态/预览/编辑态的「序号直接取模式」下使用，由着色器按 aPanoIndex 在 panoIndices 槽里找对应全景纹理。
+     * 缺省（旧存档/无映射）时回落到距离-夹角取图，保证旧工程仍可正常渲染。
+     */
+    panoFaceMapping?: number[];
+    /** 纹理数组 */
+    textures: MktTextureData[];
+}

package/MktMesh/wallCapTessellate.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 墙体上/下**封盖的三角形细分**（皇上旨 2026-10-07「上下封口的三角面能不能不要那么长 / 三角面再细分一下，
+ * 不要那么大」）。
+ *
+ * ## 为什么要切
+ * 封盖是用 `ShapeGeometry` 对墙的地面折线做**耳切三角化**得来的 —— 房间是矩形时，切出来常常是
+ * 两个横跨整个房间的细长大三角。而「序号映射 / 取图」是**逐三角面**指派的（`aPanoIndex`，一个面一个号）
+ * ⇒ 一块封盖三角面 = 一整片天花板或地面只能显示同一张全景，走到房间另一头也不换图。
+ * 切细之后：封盖上「一张全景」的区块变成若干米见方，天花板和地面终于能分区显示。
+ *
+ * ## 文件为什么单独一份
+ * ⭐ 与 `panoSlotRoster.ts` 同一套路：**零 import 的纯函数**，不碰 three、不碰 GL。
+ * ① 几何算法一处实现，`MktMesh` 只调一行；② 护栏测试可以单独转译本文件**真跑数字**
+ * （整个 `MktMesh` 要拉起 three 与一堆材质，太重、跑不动）。
+ */
+/**
+ * 上/下封盖三角化后，单个三角形的**水平最长边**上限（米）：超了就二分，直到每条边都不长于它。
+ * ⛔ 0 / 负数 / 非数 = **不细分** = 10-07 之前那一版（耳切大三角，一个能横跨整个房间）。
+ */
+export declare const WALL_CAP_MAX_EDGE_M = 2;
+/** 细分硬顶：单个封盖最多这么多三角形（防阈值填得太小把面数炸穿 ⇒ 改墙那一下卡死）。 */
+export declare const WALL_CAP_MAX_TRIS = 20000;
+/**
+ * 把一批共面三角形按**最长边二分**切开，直到每条边的**水平长度**都不长于 `maxEdge`。
+ *
+ * · 输入/输出都是扁平数组（每 9 个数一个三角形：a.xyz / b.xyz / c.xyz），输出**按输入三角形的顺序展开**
+ *   （第 i 个输入三角形切出来的那一批连在一起）⇒ 面序号与「未细分那一版」**逐块对应**，
+ *   存档里旧的逐面序号才能按块继承（`importData` 那句「按较小者逐面灌回」自动就对，无需第二套映射表）。
+ * · y 参与线性插值（中点取两端平均）：封盖顶点 y = 该处墙基高度，切出来的中点必须落在原平面上。
+ *   ⛔ 不能拿中点的 (x,z) 去反查点位高度 —— 内部点查不到会被打成 0 ⇒ 封盖塌下去。
+ * · ⛔ 只量**水平（XZ）**长度：封盖「大不大」看的是占地面积，墙基那点高低差不该把面切得更碎。
+ */
+export declare function subdivideCapTriangles(src: number[], maxEdge: number, maxTris?: number): number[];

package/MktMesh/wallCapTessellate.js

@@ -0,0 +1,97 @@
+/**
+ * 墙体上/下**封盖的三角形细分**（皇上旨 2026-10-07「上下封口的三角面能不能不要那么长 / 三角面再细分一下，
+ * 不要那么大」）。
+ *
+ * ## 为什么要切
+ * 封盖是用 `ShapeGeometry` 对墙的地面折线做**耳切三角化**得来的 —— 房间是矩形时，切出来常常是
+ * 两个横跨整个房间的细长大三角。而「序号映射 / 取图」是**逐三角面**指派的（`aPanoIndex`，一个面一个号）
+ * ⇒ 一块封盖三角面 = 一整片天花板或地面只能显示同一张全景，走到房间另一头也不换图。
+ * 切细之后：封盖上「一张全景」的区块变成若干米见方，天花板和地面终于能分区显示。
+ *
+ * ## 文件为什么单独一份
+ * ⭐ 与 `panoSlotRoster.ts` 同一套路：**零 import 的纯函数**，不碰 three、不碰 GL。
+ * ① 几何算法一处实现，`MktMesh` 只调一行；② 护栏测试可以单独转译本文件**真跑数字**
+ * （整个 `MktMesh` 要拉起 three 与一堆材质，太重、跑不动）。
+ */
+/**
+ * 上/下封盖三角化后，单个三角形的**水平最长边**上限（米）：超了就二分，直到每条边都不长于它。
+ * ⛔ 0 / 负数 / 非数 = **不细分** = 10-07 之前那一版（耳切大三角，一个能横跨整个房间）。
+ */
+export const WALL_CAP_MAX_EDGE_M = 2;
+/** 细分硬顶：单个封盖最多这么多三角形（防阈值填得太小把面数炸穿 ⇒ 改墙那一下卡死）。 */
+export const WALL_CAP_MAX_TRIS = 20000;
+/**
+ * 把一批共面三角形按**最长边二分**切开，直到每条边的**水平长度**都不长于 `maxEdge`。
+ *
+ * · 输入/输出都是扁平数组（每 9 个数一个三角形：a.xyz / b.xyz / c.xyz），输出**按输入三角形的顺序展开**
+ *   （第 i 个输入三角形切出来的那一批连在一起）⇒ 面序号与「未细分那一版」**逐块对应**，
+ *   存档里旧的逐面序号才能按块继承（`importData` 那句「按较小者逐面灌回」自动就对，无需第二套映射表）。
+ * · y 参与线性插值（中点取两端平均）：封盖顶点 y = 该处墙基高度，切出来的中点必须落在原平面上。
+ *   ⛔ 不能拿中点的 (x,z) 去反查点位高度 —— 内部点查不到会被打成 0 ⇒ 封盖塌下去。
+ * · ⛔ 只量**水平（XZ）**长度：封盖「大不大」看的是占地面积，墙基那点高低差不该把面切得更碎。
+ */
+export function subdivideCapTriangles(src, maxEdge, maxTris = WALL_CAP_MAX_TRIS) {
+    if (!(maxEdge > 0) || !isFinite(maxEdge))
+        return src.slice();
+    const maxE2 = maxEdge * maxEdge;
+    const out = [];
+    for (let i = 0; i < src.length; i += 9) {
+        // ⚠️ 每个输入三角形**单独**用一个栈 ⇒ 输出顺序 = 输入顺序展开（全局共用一个栈会把顺序打乱，
+        //    那样旧存档的逐面序号就对不上了）。
+        const local = [src.slice(i, i + 9)];
+        let made = 0;
+        while (local.length) {
+            const t = local.pop();
+            const e0 = (t[0] - t[3]) * (t[0] - t[3]) + (t[2] - t[5]) * (t[2] - t[5]);
+            const e1 = (t[3] - t[6]) * (t[3] - t[6]) + (t[5] - t[8]) * (t[5] - t[8]);
+            const e2 = (t[6] - t[0]) * (t[6] - t[0]) + (t[8] - t[2]) * (t[8] - t[2]);
+            const m = Math.max(e0, e1, e2);
+            // ⚠️ 硬顶看的是**最终面数** = 已出的 + 栈里待出的 + 手上这一个（刚 pop 出来、还没归位）：
+            //    只看「已出的」不算数 —— 栈里那一堆已切半的面照样会全倒出来 ⇒ 上限被穿成两三倍。
+            if (m <= maxE2 || out.length / 9 + local.length + 1 >= maxTris || made++ > 200000) {
+                out.push(t[0], t[1], t[2], t[3], t[4], t[5], t[6], t[7], t[8]);
+                continue;
+            }
+            // 最长边 = (a,b) / (b,c) / (c,a) 里的一条，它的两端记为 a、b，剩下那点记为 o
+            let ax, ay, az, bx, by, bz, ox, oy, oz;
+            if (m === e0) {
+                ax = t[0];
+                ay = t[1];
+                az = t[2];
+                bx = t[3];
+                by = t[4];
+                bz = t[5];
+                ox = t[6];
+                oy = t[7];
+                oz = t[8];
+            }
+            else if (m === e1) {
+                ax = t[3];
+                ay = t[4];
+                az = t[5];
+                bx = t[6];
+                by = t[7];
+                bz = t[8];
+                ox = t[0];
+                oy = t[1];
+                oz = t[2];
+            }
+            else {
+                ax = t[6];
+                ay = t[7];
+                az = t[8];
+                bx = t[0];
+                by = t[1];
+                bz = t[2];
+                ox = t[3];
+                oy = t[4];
+                oz = t[5];
+            }
+            const mx = (ax + bx) / 2, my = (ay + by) / 2, mz = (az + bz) / 2;
+            // 先出 A 半（a,m,o）再出 B 半（m,b,o）：栈后进先出 ⇒ 先压 B 再压 A
+            local.push([mx, my, mz, bx, by, bz, ox, oy, oz]);
+            local.push([ax, ay, az, mx, my, mz, ox, oy, oz]);
+        }
+    }
+    return out;
+}

package/MktMesh/wallCapTessellate.ts

@@ -0,0 +1,68 @@
+/**
+ * 墙体上/下**封盖的三角形细分**（皇上旨 2026-10-07「上下封口的三角面能不能不要那么长 / 三角面再细分一下，
+ * 不要那么大」）。
+ *
+ * ## 为什么要切
+ * 封盖是用 `ShapeGeometry` 对墙的地面折线做**耳切三角化**得来的 —— 房间是矩形时，切出来常常是
+ * 两个横跨整个房间的细长大三角。而「序号映射 / 取图」是**逐三角面**指派的（`aPanoIndex`，一个面一个号）
+ * ⇒ 一块封盖三角面 = 一整片天花板或地面只能显示同一张全景，走到房间另一头也不换图。
+ * 切细之后：封盖上「一张全景」的区块变成若干米见方，天花板和地面终于能分区显示。
+ *
+ * ## 文件为什么单独一份
+ * ⭐ 与 `panoSlotRoster.ts` 同一套路：**零 import 的纯函数**，不碰 three、不碰 GL。
+ * ① 几何算法一处实现，`MktMesh` 只调一行；② 护栏测试可以单独转译本文件**真跑数字**
+ * （整个 `MktMesh` 要拉起 three 与一堆材质，太重、跑不动）。
+ */
+
+/**
+ * 上/下封盖三角化后，单个三角形的**水平最长边**上限（米）：超了就二分，直到每条边都不长于它。
+ * ⛔ 0 / 负数 / 非数 = **不细分** = 10-07 之前那一版（耳切大三角，一个能横跨整个房间）。
+ */
+export const WALL_CAP_MAX_EDGE_M = 2;
+/** 细分硬顶：单个封盖最多这么多三角形（防阈值填得太小把面数炸穿 ⇒ 改墙那一下卡死）。 */
+export const WALL_CAP_MAX_TRIS = 20000;
+
+/**
+ * 把一批共面三角形按**最长边二分**切开，直到每条边的**水平长度**都不长于 `maxEdge`。
+ *
+ * · 输入/输出都是扁平数组（每 9 个数一个三角形：a.xyz / b.xyz / c.xyz），输出**按输入三角形的顺序展开**
+ *   （第 i 个输入三角形切出来的那一批连在一起）⇒ 面序号与「未细分那一版」**逐块对应**，
+ *   存档里旧的逐面序号才能按块继承（`importData` 那句「按较小者逐面灌回」自动就对，无需第二套映射表）。
+ * · y 参与线性插值（中点取两端平均）：封盖顶点 y = 该处墙基高度，切出来的中点必须落在原平面上。
+ *   ⛔ 不能拿中点的 (x,z) 去反查点位高度 —— 内部点查不到会被打成 0 ⇒ 封盖塌下去。
+ * · ⛔ 只量**水平（XZ）**长度：封盖「大不大」看的是占地面积，墙基那点高低差不该把面切得更碎。
+ */
+export function subdivideCapTriangles(src: number[], maxEdge: number, maxTris: number = WALL_CAP_MAX_TRIS): number[] {
+    if (!(maxEdge > 0) || !isFinite(maxEdge)) return src.slice();
+    const maxE2 = maxEdge * maxEdge;
+    const out: number[] = [];
+    for (let i = 0; i < src.length; i += 9) {
+        // ⚠️ 每个输入三角形**单独**用一个栈 ⇒ 输出顺序 = 输入顺序展开（全局共用一个栈会把顺序打乱，
+        //    那样旧存档的逐面序号就对不上了）。
+        const local: number[][] = [src.slice(i, i + 9)];
+        let made = 0;
+        while (local.length) {
+            const t = local.pop() as number[];
+            const e0 = (t[0] - t[3]) * (t[0] - t[3]) + (t[2] - t[5]) * (t[2] - t[5]);
+            const e1 = (t[3] - t[6]) * (t[3] - t[6]) + (t[5] - t[8]) * (t[5] - t[8]);
+            const e2 = (t[6] - t[0]) * (t[6] - t[0]) + (t[8] - t[2]) * (t[8] - t[2]);
+            const m = Math.max(e0, e1, e2);
+            // ⚠️ 硬顶看的是**最终面数** = 已出的 + 栈里待出的 + 手上这一个（刚 pop 出来、还没归位）：
+            //    只看「已出的」不算数 —— 栈里那一堆已切半的面照样会全倒出来 ⇒ 上限被穿成两三倍。
+            if (m <= maxE2 || out.length / 9 + local.length + 1 >= maxTris || made++ > 200000) {
+                out.push(t[0], t[1], t[2], t[3], t[4], t[5], t[6], t[7], t[8]);
+                continue;
+            }
+            // 最长边 = (a,b) / (b,c) / (c,a) 里的一条，它的两端记为 a、b，剩下那点记为 o
+            let ax: number, ay: number, az: number, bx: number, by: number, bz: number, ox: number, oy: number, oz: number;
+            if (m === e0) { ax = t[0]; ay = t[1]; az = t[2]; bx = t[3]; by = t[4]; bz = t[5]; ox = t[6]; oy = t[7]; oz = t[8]; }
+            else if (m === e1) { ax = t[3]; ay = t[4]; az = t[5]; bx = t[6]; by = t[7]; bz = t[8]; ox = t[0]; oy = t[1]; oz = t[2]; }
+            else { ax = t[6]; ay = t[7]; az = t[8]; bx = t[0]; by = t[1]; bz = t[2]; ox = t[3]; oy = t[4]; oz = t[5]; }
+            const mx = (ax + bx) / 2, my = (ay + by) / 2, mz = (az + bz) / 2;
+            // 先出 A 半（a,m,o）再出 B 半（m,b,o）：栈后进先出 ⇒ 先压 B 再压 A
+            local.push([mx, my, mz, bx, by, bz, ox, oy, oz]);
+            local.push([ax, ay, az, mx, my, mz, ox, oy, oz]);
+        }
+    }
+    return out;
+}

package/PipeMesh/PathGeometry.d.ts

@@ -1,44 +1,44 @@
-import { Usage } from 'three/src/constants.js';
-import type { PathPointList } from './PathPointList.js';
-import { BufferGeometry } from 'three/src/core/BufferGeometry.js';
-export interface Options {
-    radius?: number;
-    width?: number;
-    progress?: number;
-    radialSegments?: number;
-    startRad?: number;
-    arrow?: boolean;
-    side?: 'both' | 'left' | 'right';
-}
-export interface PathGeometryParam {
-    pathPointList: PathPointList;
-    options: Options;
-    usage: Usage;
-    transparent: boolean;
-}
-/**
- * PathGeometry
- */
-declare class PathGeometry extends BufferGeometry {
-    /**
-     * @param {Object|Number} initData - If initData is number, geometry init by empty data and set it as the max vertex. If initData is Object, it contains pathPointList and options.
-     * @param {Boolean} [generateUv2=false]
-     */
-    constructor(initData: PathGeometryParam, generateUv2?: boolean);
-    _initByMaxVertex(maxVertex: number, generateUv2: boolean): void;
-    _initByData(pathPointList: PathPointList, options: Options, usage: Usage, generateUv2: boolean): void;
-    /**
-     * Update geometry by PathPointList instance
-     * @param {PathPointList} pathPointList
-     * @param {Object} options
-     * @param {Number} [options.width=0.1]
-     * @param {Number} [options.progress=1]
-     * @param {Boolean} [options.arrow=true]
-     * @param {String} [options.side='both'] - "left"/"right"/"both"
-     */
-    update(pathPointList: PathPointList, options: Options): void;
-    _resizeAttribute(name: string, len: number): void;
-    _resizeIndex(len: number): void;
-    _updateAttributes(position: Array<number>, normal: Array<number>, uv: Array<number>, uv2: Array<number> | null, indices: Array<number>): void;
-}
-export { PathGeometry };
+import { Usage } from 'three/src/constants.js';
+import type { PathPointList } from './PathPointList.js';
+import { BufferGeometry } from 'three/src/core/BufferGeometry.js';
+export interface Options {
+    radius?: number;
+    width?: number;
+    progress?: number;
+    radialSegments?: number;
+    startRad?: number;
+    arrow?: boolean;
+    side?: 'both' | 'left' | 'right';
+}
+export interface PathGeometryParam {
+    pathPointList: PathPointList;
+    options: Options;
+    usage: Usage;
+    transparent: boolean;
+}
+/**
+ * PathGeometry
+ */
+declare class PathGeometry extends BufferGeometry {
+    /**
+     * @param {Object|Number} initData - If initData is number, geometry init by empty data and set it as the max vertex. If initData is Object, it contains pathPointList and options.
+     * @param {Boolean} [generateUv2=false]
+     */
+    constructor(initData: PathGeometryParam, generateUv2?: boolean);
+    _initByMaxVertex(maxVertex: number, generateUv2: boolean): void;
+    _initByData(pathPointList: PathPointList, options: Options, usage: Usage, generateUv2: boolean): void;
+    /**
+     * Update geometry by PathPointList instance
+     * @param {PathPointList} pathPointList
+     * @param {Object} options
+     * @param {Number} [options.width=0.1]
+     * @param {Number} [options.progress=1]
+     * @param {Boolean} [options.arrow=true]
+     * @param {String} [options.side='both'] - "left"/"right"/"both"
+     */
+    update(pathPointList: PathPointList, options: Options): void;
+    _resizeAttribute(name: string, len: number): void;
+    _resizeIndex(len: number): void;
+    _updateAttributes(position: Array<number>, normal: Array<number>, uv: Array<number>, uv2: Array<number> | null, indices: Array<number>): void;
+}
+export { PathGeometry };