s3m-maplibre 0.2.4 → 0.2.5

package/README.md

@@ -2,7 +2,8 @@
 
 **在 MapLibre GL JS 里原生渲染 SuperMap S3M 三维模型** —— 浏览器直接解析 `.s3mb` 瓦片，不需要预先转成 3D Tiles，也不需要 SuperMap 的 WebGL 客户端。
 
-[![npm](https://img.shields.io/badge/npm-0.1.0-blue)](https://www.npmjs.com/)
+[![npm](https://img.shields.io/npm/v/s3m-maplibre?color=blue&label=npm)](https://www.npmjs.com/package/s3m-maplibre)
+[![demo](https://img.shields.io/badge/demo-online-2ea44f)](https://joo1es.github.io/s3m-maplibre/demo/index.html)
 [![license](https://img.shields.io/badge/license-Apache--2.0-green)](./LICENSE)
 [![types](https://img.shields.io/badge/types-included-blue)](./src/index.ts)
 
@@ -39,6 +40,8 @@ iServer / 本地目录  →  .scp 配置 + .s3mb 瓦片
 | 白膜 / 单色 | ✅ | |
 | 按高度 / 按楼层着色 | ✅ | 高度范围自动统计 |
 | 按单体着色 | ✅ | 基于 S3M 单体化信息 |
+| 按业务字段着色 | ✅ | 走 iServer 数据服务查 SMID 属性，分类 / 色带 / 分级，见 [docs/API.md](./docs/API.md#按业务字段着色) |
+| 按业务字段过滤 / 抬高 | ✅ | 区间 / 取值 / 谓词过滤，字段值映射成抬高米数，同样只改一张一维纹理 |
 | 动态扫描 | ✅ | 扫描线沿高度循环 |
 | 透明度 | ✅ | 实时，不重编译着色器 |
 | 选中高亮 + 描边 | ✅ | 单体级 |
@@ -48,10 +51,11 @@ iServer / 本地目录  →  .scp 配置 + .s3mb 瓦片
 | 瓦片同材质合批 | ✅ | 倾斜摄影大瓦片自动合批，大幅降低 DrawCall |
 | 纹理变换与寻址 | ✅ | 支持 `texmodmatrix` 仿射变换与 `addressmode` |
 | DXT / WebP 纹理 | ✅ | |
-| Draco 压缩几何 | ❌ | 遇到会抛明确错误 |
-| KTX2 / CRN | ❌ | |
 | 骨骼动画 | ❌ | 已解析未驱动 |
 | 地形遮挡 | ❌ | |
+| Draco 压缩几何 | ❌ | 能识别、不能解码，遇到抛明确错误；接法见[未支持的格式](#未支持的格式draco--crn--ktx2) |
+| CRN 纹理（pixelFormat 26 / 27） | ❌ | 官方 SDK 是 crunch.js 转 DXT5 再解码，接口位置已留好 |
+| KTX2 纹理 | — | S3M 官方 `pixelFormat` 枚举里没有这个值，属于「不会遇到」而不是「不支持」 |
 
 ---
 
@@ -61,7 +65,9 @@ iServer / 本地目录  →  .scp 配置 + .s3mb 瓦片
 npm install s3m-maplibre three
 ```
 
-`three` 是 peer 依赖（`>=0.168.0`）。`maplibre-gl` 不是依赖——图层只是一个符合 `CustomLayerInterface` 的普通对象，MapLibre / Mapbox 都能挂。
+包在 npm 上是 [s3m-maplibre](https://www.npmjs.com/package/s3m-maplibre)，当前 `0.2.5`。
+
+`three` 是 peer 依赖（`>=0.168.0`）。`maplibre-gl` 不是依赖——图层只是一个符合 `CustomLayerInterface` 的普通对象，MapLibre / Mapbox 都能挂；不用地图时也能只用解析和瓦片层（见「纯 three.js 使用」）。
 
 类型随包发布（`dist/index.d.ts`，由源码直接生成）。three `>=0.168` 自带类型，更老的版本需要自己装 `@types/three`。
 
@@ -132,13 +138,90 @@ map.on('click', (e) => {
 
 ## 演示
 
-仓库内 `demo/` 是一个完整示例，接了上海某区的真实 iServer 服务（5 个数据集叠加，45 万三角面）：
+在线跑（GitHub Pages，数据随仓库一起发布）：
+
+- **MapLibre 版** — <https://joo1es.github.io/s3m-maplibre/demo/index.html>
+- **纯 three.js 版** — <https://joo1es.github.io/s3m-maplibre/demo/three.html>
+
+（<https://joo1es.github.io/s3m-maplibre/> 是入口页，两个示例都能进）
+
+本地跑：
 
 ```bash
-npm run demo     # http://localhost:8123/s3m-maplibre/demo/index.html
+npm run dev      # 开发模式：tsc -w + 静态服务，保存源码后浏览器自动刷新
+npm run demo     # 一次性编译后起静态服务（不做监听）
+```
+
+两个命令都指向 http://localhost:8123/s3m-maplibre/demo/index.html ，`demo/three.html` 是同一台服务器上的纯 three 版。
+
+演示自带两份样例数据（北京 CBD 的 CCTV、comModel），也可以在地址栏输入框里填任意 iServer `realspace` 服务根地址、`datas` 集合或具体的 `.scp`，自动列出数据集并默认勾选第一个。
+
+演示包含：数据集叠加开关、着色模式、透明度、平面/平滑着色、选中描边（棱线 / 外扩两种画法，粗细可调）、全局棱线、点击属性卡；右侧面板还能填 iServer 数据服务地址，按业务字段（KEYID / SmMaxZ…）上色出图例、按区间过滤、按字段值抬高。
+
+---
+
+## 纯 three.js 使用（不用 MapLibre）
+
+可以。图层本身只是把三层粘到地图上，这三层都是宿主无关的：
+
+| 层 | 需要什么 | 与地图的关系 |
+|---|---|---|
+| `core/` 解析 | 一个 `ArrayBuffer` | 完全无关，Node 里也能跑 |
+| `tileset/` 瓦片树 | `fetch` + 一个 `three.Group` 当容器 | 只要喂相机位置算 LOD |
+| `render/` 几何 | WebGL 上下文 | 只产出 `THREE.Group` / `Mesh` |
+
+```js
+import * as THREE from 'three';
+import { S3MTileset, createSharedUniforms, STYLE } from 's3m-maplibre';
+
+const uniforms = createSharedUniforms();       // 材质 uniform 全局共享
+uniforms.uMode.value = STYLE.TEXTURE;          // 改这一行就是切样式
+
+const root = new THREE.Group();
+root.rotation.x = -Math.PI / 2;                // S3M 顶点是 ENU（z 朝上），three 是 y 朝上
+scene.add(root);
+
+const tileset = new S3MTileset({
+  configUrl: '.../jingmo.scp',
+  uniforms,
+  onTile: (node) => root.add(node.group),      // node.group 就是这片瓦片拼好的 Group（米制局部坐标）
+});
+await tileset.init();                          // 返回时首棵瓦片已就绪
+
+// 每帧：把相机位置换算回 ENU 喂给 LOD 调度，父子瓦片自己按需细分
+function tick() {
+  const p = camera.position;
+  tileset.update([p.x, -p.z, p.y], THREE.MathUtils.degToRad(camera.fov), renderer.domElement.height);
+  renderer.render(scene, camera);
+  requestAnimationFrame(tick);
+}
 ```
 
-演示包含：数据集叠加开关、7 种着色模式、透明度、平面/平滑着色、选中描边、全局棱线、点击属性卡。
+完整可运行版本见 [`demo/three.js`](./demo/three.js)（一个文件，含轨道控制、切片统计、样式切换）。
+
+自己搭宿主时需要补的几件事，`S3MLayer` 不会代劳：
+
+- **光照**：`MeshStandardMaterial` 的标准光照，自己加 `HemisphereLight` + `DirectionalLight`；
+- **多数据集对齐**：每份数据有各自的锚点，`S3MLayer` 会按墨卡托算锚点差、写进数据集 `Group.position`（米），纯 three 里需要自己算一次；
+- **贴地 / 经纬度**：不接地图就没有「贴在地球上」这一步，只有局部米制坐标；
+- **拾取 / 选中描边 / 样式切换 UI**：`Picker`、等宽棱线、`setStyle` 都是 `S3MLayer` 上的，纯 three 用法需要直接操作 `uniforms` 与 Mesh。
+
+---
+
+## 未支持的格式：Draco / CRN / KTX2
+
+这三个常被问到，结论分别不同：
+
+**Draco 压缩几何 —— 能解决，缺的是样本。**
+官方 SDK 里有 `S3MParser/S3MDracoDecode.js` + `draco_decode.module.js`（对 `DecodeBufferToPointCloud` 的封装，POSITION / NORMAL / TEX_COORD 三个属性，再按 `compressOptions` 分支处理）。接法与本项目的 MeshOpt 完全一致：内联 wasm 解码器、只在遇到 `VertexTag.DRACO` 时动态 `import`、解码后走同一套 attribute 组装 + 量化还原。真正的成本不在写代码，而在**标定容器**——MeshOpt 当时就是靠 60 个真实瓦片逐字节对齐才做对的，Draco 的 attribute 映射、`compressOptions` 与实际数据是否一致也必须拿样例验。仓库里没有 Draco 瓦片，所以现在是「识别到就抛明确错误」。
+
+**CRN 纹理（`pixelFormat` 26 / 27）—— 能解决，纯接解码器。**
+SuperMap 自己的做法是 `crunch.js` 把 CRN 转码成 DXT5 字节，再走普通 DXT 上传。本项目的 `TextureFactory` 在 DXT 那条路上已经完整（DXT1/3/4/5 都解到 RGBA8），所以只要在 `decodeTexture` 里加一个 CRN 分支：crunch 转 DXT5 → 复用现成解码。工作量约一个解码器文件 + 一个分支，同样需要一份 CRN 纹理样例来验字节。
+
+**KTX2 —— 不是「不支持」，是 S3M 里基本不会出现。**
+官方 `S3MPixelFormat` 枚举（`1/2/3/4/5/6/7/10/11/12/13/14/17…21/25/26/27/28`）里没有 KTX2 / Basis 的条目，iServer 也不会发。真要支持，得自己引入 `basis_transcoder.wasm` 并把 KTX2 容器转成 RGBA32 或 DXT，但那是给「别人转成 KTX2 再塞进 S3M」的场景准备的，没有数据样本可测。
+
+两者的共同前提：**要有样例数据**。手头有 Draco 压缩的瓦片或带 CRN 纹理的服务地址，把 `.s3mb` 或服务地址给我，就能按 MeshOpt 那套方式标定 + 实现 + 回归。
 
 ---
 
@@ -228,9 +311,10 @@ S3M 顶点（数据集局部 ENU，米）
 
 ## 已知限制
 
-- **Draco 压缩几何**未实现。MeshOpt 已支持；遇到 Draco 会抛带说明的错误。
+- **Draco 压缩几何 / CRN 纹理**未实现（可解，缺样例数据），见[未支持的格式](#未支持的格式draco--crn--ktx2)。
 - **地形遮挡**未实现：MapLibre 的地形深度没进 custom layer 的深度缓冲，建筑不会被地形裁掉。
 - 跨城市量级的数据集叠加会重新引入 float32 精度问题。
+- MVT 式的「按需懒加载 + 卸载」没有做：已加载的瓦片常驻，只受 `maxTiles` 限制。
 
 ---
 
@@ -249,11 +333,14 @@ src/
     S3MLayer.ts          图层主体（多数据集 / 样式 / 拾取）
     GeometryBuilder.ts   几何与材质组装
     StyleMaterial.ts     着色器注入的着色系统
+    EdgeLines.ts         屏幕空间等宽棱线（选中描边 / 全局棱线）
     Picker.ts            GPU 拾取
     TextureFactory.ts    纹理解码
   vendor/    meshoptimizer 解码器（wasm 内联，原样保留）
-demo/        演示
-tools/       自检脚本（解析校验、MeshOpt 回归、静态服务）
+demo/
+  index.html / main.js   MapLibre 完整示例（控制面板 + 属性卡）
+  three.html / three.js  纯 three.js 示例（无地图）
+tools/       自检脚本（解析校验、MeshOpt 回归、带热更新的静态服务）
 ```
 
 ---

package/dist/core/AttributeQuery.d.ts

@@ -0,0 +1,97 @@
+/**
+ * iServer 数据服务属性查询
+ *
+ * S3M 瓦片里**只有单体 ID**（`MonomerIDInfo.id`，即 SmID）和顶点区间，没有任何业务字段；
+ * 业务属性在 iServer 的「数据服务」里：同一份数据源被发布成 `data-xxx/rest/data` 的那个服务。
+ *
+ * 这里的职责只有一件事：按 SmID 批量取字段值。字段表、分片、缓存、去重都在内部消化，
+ * 上层（`S3MLayer.colorByField`）只关心「拿到值之后怎么算颜色」。
+ *
+ * 实测（iServer 2026，GEOMODEL3D 数据集）：
+ *   - `queryOption: 'ATTRIBUTE'` 被忽略：放 body、放 query string、大小写都没用，
+ *     2D / 3D 数据集都照样返回几何；模型数据集还会给每条要素带上 `geometry.model`
+ *     —— 那是 deflate 压缩后的 S3M 模型字节，约 2.5KB/条，占整个响应的 90%；
+ *   - 没有「只取属性」的接口。想省带宽只能逐条 GET `/rest/data/feature/{a}-{b}-{idx}.json`
+ *     （957B/条，model 为 null），但那是拿请求数换带宽：300 条并发 16 反而比一次 POST 慢；
+ *   - `.fastjson` 比 `.json` 少 40%：model 用 hex（2 字符/字节）而不是数字数组（3~4 字符/字节）。
+ *     代价是它不是严格 JSON（`0.0D`、`1L`、`x'ABCD'` 都是 Java 字面量），要先清洗；
+ *   - `maxFeatures` 生效，`fromIndex` / `toIndex` 不生效 —— 只能切前 N 条，不能翻页；
+ *   - 同一份数据如果另外发布了二维数据源（`DataSource_erwei`），查它只有 1/5 的体积；
+ *   - CORS 是开的（`Access-Control-Allow-Origin: *`），浏览器里可以直接 POST。
+ *
+ * 所以默认策略：`.fastjson` + 一次性把**全部字段**取回来（字段名很便宜，model 才是大头），
+ * 这样换专题字段时全部命中缓存，不再发请求。
+ */
+export interface AttributeQueryOptions {
+    /** 数据服务根地址，形如 https://host/iserver/services/data-xxx/rest/data */
+    dataServiceUrl: string;
+    /** 数据集，支持 "DataSource:zhoubian" 或只写 "zhoubian"（默认补 DataSource:） */
+    datasetName: string;
+    /** 与 S3M 单体 ID 对应的字段，默认 SmID（对应 scp 里的 idFieldName） */
+    idField?: string;
+    /** 只取这些字段，默认取字段表里除几何/索引外的全部（推荐留空，全字段进缓存后换字段零请求） */
+    fields?: string[];
+    /** 每次请求带多少个 id，默认 200 */
+    chunkSize?: number;
+    /** 响应格式，默认 'auto'：模型数据集用 fastjson（模型是 byte[]，hex 比数字数组省 43%），
+     *  二维数据集用 json（坐标是 double，hex 反而更胖）。也可以强制指定 */
+    format?: 'auto' | 'fastjson' | 'json';
+    /** 便于测试时替换，默认用全局 fetch */
+    fetchImpl?: typeof fetch;
+}
+export interface AttributeField {
+    name: string;
+    type?: string;
+    alias?: string;
+}
+export type AttributeRow = Record<string, string | number>;
+/** 一次查询的代价，用来在 UI 上展示「查了多大、发了几个请求」 */
+export interface AttributeQueryStats {
+    requests: number;
+    bytes: number;
+    ms: number;
+}
+export declare class AttributeQuery {
+    readonly dataServiceUrl: string;
+    readonly datasourceName: string;
+    readonly datasetName: string;
+    readonly idField: string;
+    private readonly _fields;
+    private readonly _chunkSize;
+    private readonly _formatOption;
+    private readonly _fetch;
+    private readonly _cache;
+    private _schema;
+    private _resolvedFields;
+    private _format;
+    private _stats;
+    constructor(options: AttributeQueryOptions);
+    /** 数据集的 REST 路径：.../datasources/name/{ds}/datasets/name/{name} */
+    get datasetPath(): string;
+    /** 累计的请求代价（不清零，用来观察整体开销） */
+    get stats(): AttributeQueryStats;
+    /** 字段表（顺手也用来判断「这个数据集到底有没有属性表」） */
+    loadSchema(): Promise<AttributeField[]>;
+    /** 已经缓存过、不需要再请求的 id */
+    hasCached(smid: number): boolean;
+    clearCache(): void;
+    /**
+     * 按 SmID 批量取属性。自动跳过已缓存的、按 chunkSize 分片，并丢弃几何。
+     * 缓存的是**整行**（全部字段），所以换专题字段时不会再发请求。
+     */
+    queryBySmids(smids: number[]): Promise<Map<number, AttributeRow>>;
+    private _resolveFields;
+    /**
+     * 选响应格式。
+     *
+     * 模型数据集的体积几乎全是 `geometry.model`（byte[]），fastjson 用 hex 表示只要 2 字符/字节，
+     * json 是十进制数字数组（3~4 字符/字节），所以 fastjson 又快又小；
+     * 二维数据集的几何是坐标数组（double），hex 反而比十进制更胖（实测 3.9KB vs 2.4KB/条），
+     * 这种就留在 json。用 `features.json` 返回的 geometryType 判断，一次几十字节，跟着实例缓存。
+     */
+    private _resolveFormat;
+    private _queryChunk;
+    private _post;
+    private _parse;
+}
+//# sourceMappingURL=AttributeQuery.d.ts.map

package/dist/core/AttributeQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttributeQuery.d.ts","sourceRoot":"","sources":["../../src/core/AttributeQuery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAOH,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;mDAC+C;IAC/C,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IACtC,0BAA0B;IAC1B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAE3D,sCAAsC;AACtC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ;AAwBD,qBAAa,cAAc;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+B;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,MAAM,CAAyD;gBAE3D,OAAO,EAAE,qBAAqB;IAgB1C,kEAAkE;IAClE,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,4BAA4B;IAC5B,IAAI,KAAK,IAAI,mBAAmB,CAE/B;IAED,kCAAkC;IAC5B,UAAU,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAU7C,uBAAuB;IACvB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC,UAAU,IAAI,IAAI;IAKlB;;;OAGG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YAuBzD,cAAc;IAY5B;;;;;;;OAOG;YACW,cAAc;YAgBd,WAAW;YAsCX,KAAK;IAenB,OAAO,CAAC,MAAM;CAGf"}

package/dist/core/AttributeQuery.js

@@ -0,0 +1,221 @@
+/**
+ * iServer 数据服务属性查询
+ *
+ * S3M 瓦片里**只有单体 ID**（`MonomerIDInfo.id`，即 SmID）和顶点区间，没有任何业务字段；
+ * 业务属性在 iServer 的「数据服务」里：同一份数据源被发布成 `data-xxx/rest/data` 的那个服务。
+ *
+ * 这里的职责只有一件事：按 SmID 批量取字段值。字段表、分片、缓存、去重都在内部消化，
+ * 上层（`S3MLayer.colorByField`）只关心「拿到值之后怎么算颜色」。
+ *
+ * 实测（iServer 2026，GEOMODEL3D 数据集）：
+ *   - `queryOption: 'ATTRIBUTE'` 被忽略：放 body、放 query string、大小写都没用，
+ *     2D / 3D 数据集都照样返回几何；模型数据集还会给每条要素带上 `geometry.model`
+ *     —— 那是 deflate 压缩后的 S3M 模型字节，约 2.5KB/条，占整个响应的 90%；
+ *   - 没有「只取属性」的接口。想省带宽只能逐条 GET `/rest/data/feature/{a}-{b}-{idx}.json`
+ *     （957B/条，model 为 null），但那是拿请求数换带宽：300 条并发 16 反而比一次 POST 慢；
+ *   - `.fastjson` 比 `.json` 少 40%：model 用 hex（2 字符/字节）而不是数字数组（3~4 字符/字节）。
+ *     代价是它不是严格 JSON（`0.0D`、`1L`、`x'ABCD'` 都是 Java 字面量），要先清洗；
+ *   - `maxFeatures` 生效，`fromIndex` / `toIndex` 不生效 —— 只能切前 N 条，不能翻页；
+ *   - 同一份数据如果另外发布了二维数据源（`DataSource_erwei`），查它只有 1/5 的体积；
+ *   - CORS 是开的（`Access-Control-Allow-Origin: *`），浏览器里可以直接 POST。
+ *
+ * 所以默认策略：`.fastjson` + 一次性把**全部字段**取回来（字段名很便宜，model 才是大头），
+ * 这样换专题字段时全部命中缓存，不再发请求。
+ */
+const DEFAULT_ID_FIELD = 'SmID';
+const DEFAULT_CHUNK_SIZE = 200;
+/** 几何/索引字段取回来没用，还特别占带宽 */
+const SKIP_FIELDS = new Set(['smgeometry', 'smindexkey', 'smgeoposition']);
+/**
+ * fastjson 不是严格 JSON，服务端会把 Java 字面量直接吐出来：
+ *   `"model":x'D7A34040...'`（byte[] 的 hex）、`"rotationX":0.0D`、`"id":423L`
+ * 这些在 JSON.parse 里全是语法错误。model 恰好是我们唯一不想要的东西（占 90% 体积），
+ * 直接在字符串上抹掉，连解析都省了。
+ */
+function sanitizeFastjson(text) {
+    return text
+        .replace(/x'[0-9A-Fa-f]*'/g, 'null')
+        .replace(/(\d)[dDlLfF](?=\s*[,}\]])/g, '$1');
+}
+export class AttributeQuery {
+    dataServiceUrl;
+    datasourceName;
+    datasetName;
+    idField;
+    _fields;
+    _chunkSize;
+    _formatOption;
+    _fetch;
+    _cache = new Map();
+    _schema = null;
+    _resolvedFields = null;
+    _format = null;
+    _stats = { requests: 0, bytes: 0, ms: 0 };
+    constructor(options) {
+        if (!options?.dataServiceUrl)
+            throw new Error('[s3m] AttributeQuery 缺少 dataServiceUrl');
+        const full = options.datasetName?.includes(':') ? options.datasetName : `DataSource:${options.datasetName ?? ''}`;
+        const [ds, name] = full.split(':');
+        if (!name)
+            throw new Error(`[s3m] datasetName 格式应为 "数据源:数据集"，收到 "${options.datasetName}"`);
+        this.dataServiceUrl = options.dataServiceUrl.replace(/\/+$/, '');
+        this.datasourceName = ds;
+        this.datasetName = name;
+        this.idField = options.idField ?? DEFAULT_ID_FIELD;
+        this._fields = options.fields?.length ? options.fields : null;
+        this._chunkSize = Math.max(1, options.chunkSize ?? DEFAULT_CHUNK_SIZE);
+        this._formatOption = options.format ?? 'auto';
+        this._fetch = options.fetchImpl ?? globalThis.fetch.bind(globalThis);
+    }
+    /** 数据集的 REST 路径：.../datasources/name/{ds}/datasets/name/{name} */
+    get datasetPath() {
+        return `${this.dataServiceUrl}/datasources/name/${encodeURIComponent(this.datasourceName)}/datasets/name/${encodeURIComponent(this.datasetName)}`;
+    }
+    /** 累计的请求代价（不清零，用来观察整体开销） */
+    get stats() {
+        return { ...this._stats };
+    }
+    /** 字段表（顺手也用来判断「这个数据集到底有没有属性表」） */
+    async loadSchema() {
+        if (this._schema)
+            return this._schema;
+        const res = await this._fetch(`${this.datasetPath}/fields.json`);
+        this._stats.requests++;
+        if (!res.ok)
+            throw new Error(`[s3m] 读取字段表失败 ${res.status}：${this.datasetPath}/fields.json`);
+        const json = (await res.json());
+        this._schema = (json.fieldNames ?? []).map((name) => ({ name }));
+        return this._schema;
+    }
+    /** 已经缓存过、不需要再请求的 id */
+    hasCached(smid) {
+        return this._cache.has(smid);
+    }
+    clearCache() {
+        this._cache.clear();
+        this._stats = { requests: 0, bytes: 0, ms: 0 };
+    }
+    /**
+     * 按 SmID 批量取属性。自动跳过已缓存的、按 chunkSize 分片，并丢弃几何。
+     * 缓存的是**整行**（全部字段），所以换专题字段时不会再发请求。
+     */
+    async queryBySmids(smids) {
+        const ids = [...new Set(smids.filter((n) => Number.isFinite(n)))];
+        const result = new Map();
+        for (const id of ids) {
+            const hit = this._cache.get(id);
+            if (hit)
+                result.set(id, hit);
+        }
+        const todo = ids.filter((id) => !this._cache.has(id));
+        if (!todo.length)
+            return result;
+        const fields = await this._resolveFields();
+        for (let i = 0; i < todo.length; i += this._chunkSize) {
+            const chunk = todo.slice(i, i + this._chunkSize);
+            const rows = await this._queryChunk(chunk, fields);
+            for (const [id, row] of rows) {
+                this._cache.set(id, row);
+                result.set(id, row);
+            }
+        }
+        return result;
+    }
+    async _resolveFields() {
+        if (this._resolvedFields)
+            return this._resolvedFields;
+        if (this._fields) {
+            this._resolvedFields = this._fields;
+            return this._resolvedFields;
+        }
+        const schema = await this.loadSchema();
+        const fields = schema.map((f) => f.name).filter((n) => !SKIP_FIELDS.has(n.toLowerCase()));
+        this._resolvedFields = fields.length ? fields : [this.idField];
+        return this._resolvedFields;
+    }
+    /**
+     * 选响应格式。
+     *
+     * 模型数据集的体积几乎全是 `geometry.model`（byte[]），fastjson 用 hex 表示只要 2 字符/字节，
+     * json 是十进制数字数组（3~4 字符/字节），所以 fastjson 又快又小；
+     * 二维数据集的几何是坐标数组（double），hex 反而比十进制更胖（实测 3.9KB vs 2.4KB/条），
+     * 这种就留在 json。用 `features.json` 返回的 geometryType 判断，一次几十字节，跟着实例缓存。
+     */
+    async _resolveFormat() {
+        if (this._format)
+            return this._format;
+        if (this._formatOption !== 'auto')
+            return (this._format = this._formatOption);
+        try {
+            const res = await this._fetch(`${this.datasetPath}/features.json?fromIndex=0&toIndex=1`);
+            this._stats.requests++;
+            const json = (await res.json());
+            const isModel = String(json.geometryType ?? '').toUpperCase().includes('MODEL');
+            this._format = isModel ? 'fastjson' : 'json';
+        }
+        catch {
+            // 探测失败就当模型数据集处理：S3M 场景下这是绝大多数
+            this._format = 'fastjson';
+        }
+        return this._format;
+    }
+    async _queryChunk(ids, fields) {
+        const body = {
+            getFeatureMode: 'SQL',
+            datasetNames: [`${this.datasourceName}:${this.datasetName}`],
+            // 服务端会忽略它，但留着：将来遇到真的听话的版本就能省下全部几何
+            queryOption: 'ATTRIBUTE',
+            queryParameter: {
+                attributeFilter: `${this.idField} IN (${ids.join(',')})`,
+                fields,
+            },
+        };
+        const format = await this._resolveFormat();
+        const raw = await this._post(body, format);
+        let json;
+        try {
+            json = this._parse(raw);
+        }
+        catch (e) {
+            // fastjson 的方言没吃透时留一条退路，别让一次格式变更把功能整个弄挂
+            if (format !== 'fastjson')
+                throw e;
+            json = this._parse(await this._post(body, 'json'));
+        }
+        if (json.error)
+            throw new Error(`[s3m] 属性查询失败：${json.error.errorMsg ?? '未知错误'}`);
+        const out = new Map();
+        for (const f of json.features ?? []) {
+            const names = f.fieldNames ?? [];
+            const values = f.fieldValues ?? [];
+            const row = {};
+            for (let i = 0; i < names.length; i++)
+                row[names[i]] = values[i];
+            // 优先用 idField（SmID）关联，拿不到才退回要素 ID
+            const rawId = row[this.idField] ?? f.ID;
+            const id = Number(rawId);
+            if (Number.isFinite(id))
+                out.set(id, row);
+        }
+        return out;
+    }
+    async _post(body, format) {
+        const t0 = performance.now();
+        const res = await this._fetch(`${this.dataServiceUrl}/featureResults.${format}?returnContent=true`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        const text = await res.text();
+        this._stats.requests++;
+        this._stats.bytes += text.length;
+        this._stats.ms += Math.round(performance.now() - t0);
+        if (!res.ok)
+            throw new Error(`[s3m] 属性查询失败 ${res.status}：${text.slice(0, 200)}`);
+        return text;
+    }
+    _parse(text) {
+        return JSON.parse(text.includes("x'") || /\d[dDlL](?=\s*[,}\]])/.test(text) ? sanitizeFastjson(text) : text);
+    }
+}
+//# sourceMappingURL=AttributeQuery.js.map

package/dist/core/AttributeQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttributeQuery.js","sourceRoot":"","sources":["../../src/core/AttributeQuery.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -12,11 +12,13 @@ export { parseS3MB, S3M_VERSION, VertexTag, VertexTagV3 } from './core/S3MBParse
 export type { ParseOptions, InflateFn } from './core/S3MBParser.js';
 export { BinaryReader } from './core/BinaryReader.js';
 export { resolveFeature, measureSegments, buildAttributes, DEFAULT_FLOOR_HEIGHT } from './core/FeatureInfo.js';
+export { AttributeQuery } from './core/AttributeQuery.js';
+export type { AttributeQueryOptions, AttributeField, AttributeRow, } from './core/AttributeQuery.js';
 export type { Vec3, BoundingBox, AttrDType, VertexAttribute, IndexPackage, VertexPackage, PickSegment, PickEntry, GeoPackageEntry, Geode, PageLOD, GroupNode, S3MTexture, ParsedTile, Anchor, Stats, FeatureAttributes, SegmentBox, StyleUniforms, } from './core/types.js';
 export { S3MTileset } from './tileset/S3MTileset.js';
 export type { TileNode, BuildTileFn, S3MTilesetOptions } from './tileset/S3MTileset.js';
 export { S3MLayer, DEFAULT_STYLE, STYLE, STYLE_LABELS, SELECT_MODE, SELECT_MODE_LABELS } from './render/S3MLayer.js';
-export type { S3MLayerOptions, S3MStyle, SelectMode, FeatureStyle, S3MFilter, S3MDatasetOptions, S3MDatasetEntry, PickResult, MapLike, MapMouseEventLike, } from './render/S3MLayer.js';
+export type { S3MLayerOptions, S3MStyle, SelectMode, FeatureStyle, S3MFilter, S3MDatasetOptions, S3MDatasetEntry, PickResult, MapLike, MapMouseEventLike, ColorByFieldOptions, ThematicLegendEntry, ThematicResult, FieldFilterOptions, FieldFilterResult, FieldElevationOptions, FieldElevationResult, } from './render/S3MLayer.js';
 export { buildTileObjects } from './render/GeometryBuilder.js';
 export type { BuildTileOptions, BuildTileResult, TileBuildStats } from './render/GeometryBuilder.js';
 export { createTexture, PixelFormat, setMaxAnisotropy } from './render/TextureFactory.js';
@@ -25,5 +27,7 @@ export { createSharedUniforms, createStyledMaterial, createOutlineMaterial } fro
 export type { StyleMode, StyledMaterial, StyledMaterialOptions, OutlineMaterial } from './render/StyleMaterial.js';
 export { Picker } from './render/Picker.js';
 export type { PickHit } from './render/Picker.js';
+export { createThickLineMaterial, createLineSharedUniforms, buildThickLineGeometry, buildFeatureEdgeSegments, } from './render/EdgeLines.js';
+export type { ThickLineMaterial, LineSharedUniforms, EdgeVertexRange } from './render/EdgeLines.js';
 export { S3MLayer as default } from './render/S3MLayer.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACtF,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAG/G,YAAY,EACV,IAAI,EACJ,WAAW,EACX,SAAS,EACT,eAAe,EACf,YAAY,EACZ,aAAa,EACb,WAAW,EACX,SAAS,EACT,eAAe,EACf,KAAK,EACL,OAAO,EACP,SAAS,EACT,UAAU,EACV,UAAU,EACV,MAAM,EACN,KAAK,EACL,iBAAiB,EACjB,UAAU,EACV,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGxF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACrH,YAAY,EACV,eAAe,EACf,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,OAAO,EACP,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAErG,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAC9G,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEnH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACtF,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC/G,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,YAAY,EACV,qBAAqB,EACrB,cAAc,EACd,YAAY,GACb,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,IAAI,EACJ,WAAW,EACX,SAAS,EACT,eAAe,EACf,YAAY,EACZ,aAAa,EACb,WAAW,EACX,SAAS,EACT,eAAe,EACf,KAAK,EACL,OAAO,EACP,SAAS,EACT,UAAU,EACV,UAAU,EACV,MAAM,EACN,KAAK,EACL,iBAAiB,EACjB,UAAU,EACV,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGxF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACrH,YAAY,EACV,eAAe,EACf,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,OAAO,EACP,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAErG,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAC9G,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEnH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEpG,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -12,6 +12,7 @@
 export { parseS3MB, S3M_VERSION, VertexTag, VertexTagV3 } from './core/S3MBParser.js';
 export { BinaryReader } from './core/BinaryReader.js';
 export { resolveFeature, measureSegments, buildAttributes, DEFAULT_FLOOR_HEIGHT } from './core/FeatureInfo.js';
+export { AttributeQuery } from './core/AttributeQuery.js';
 // —— 瓦片层
 export { S3MTileset } from './tileset/S3MTileset.js';
 // —— 渲染层
@@ -20,5 +21,6 @@ export { buildTileObjects } from './render/GeometryBuilder.js';
 export { createTexture, PixelFormat, setMaxAnisotropy } from './render/TextureFactory.js';
 export { createSharedUniforms, createStyledMaterial, createOutlineMaterial } from './render/StyleMaterial.js';
 export { Picker } from './render/Picker.js';
+export { createThickLineMaterial, createLineSharedUniforms, buildThickLineGeometry, buildFeatureEdgeSegments, } from './render/EdgeLines.js';
 export { S3MLayer as default } from './render/S3MLayer.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,oCAAoC;AACpC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEtF,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAyB/G,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD,SAAS;AACT,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAcrH,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG1F,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAG9G,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,oCAAoC;AACpC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEtF,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC/G,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AA8B1D,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD,SAAS;AACT,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAqBrH,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG1F,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAG9G,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/render/EdgeLines.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 屏幕空间等宽棱线
+ *
+ * 为什么不用 `LineBasicMaterial`：WebGL 下 `linewidth` 在绝大多数平台被忽略，
+ * 线宽恒定 1px，想「调粗细」是做不到的。所以要自己把每条线段摊成一条面向屏幕的四边形：
+ * 每条棱 4 个顶点，顶点着色器里把两端点投到屏幕空间，沿屏幕法线方向撑开 `uWidth` 个像素，
+ * 再沿线段方向各外延半线宽，把相邻棱线的接缝盖住，避免拐角处出现缺口。
+ *
+ * 顶点布局（每段 4 个顶点，2 个三角形）：
+ *   v0 = A 端, aSide = -1      v1 = A 端, aSide = +1
+ *   v2 = B 端, aSide = +1      v3 = B 端, aSide = -1
+ * B 端的 side 之所以反号，是因为着色器里方向向量统一取「aOther → position」，
+ * B 端算出来的法线正好和 A 端相反，反号一次才能拼成同一个四边形。
+ */
+import * as THREE from 'three';
+/** 所有等宽线材质共享的分辨率 uniform（每帧更新一次即可） */
+export interface LineSharedUniforms {
+    uResolution: {
+        value: THREE.Vector2;
+    };
+    uDpr: {
+        value: number;
+    };
+}
+export interface ThickLineMaterial extends THREE.ShaderMaterial {
+    uniforms: LineSharedUniforms & {
+        uColor: {
+            value: THREE.Color;
+        };
+        uOpacity: {
+            value: number;
+        };
+        uWidth: {
+            value: number;
+        };
+        uElevation: {
+            value: number;
+        };
+        [uniform: string]: THREE.IUniform;
+    };
+}
+export declare function createLineSharedUniforms(): LineSharedUniforms;
+export declare function createThickLineMaterial(shared: LineSharedUniforms, opts?: {
+    color?: THREE.ColorRepresentation;
+    opacity?: number;
+    width?: number;
+    elevation?: number;
+}): ThickLineMaterial;
+/**
+ * 线段对（每 6 个 float：x1 y1 z1 x2 y2 z2）→ 可绘制等宽线的几何体。
+ */
+export declare function buildThickLineGeometry(segments: ArrayLike<number>): THREE.BufferGeometry;
+export interface EdgeVertexRange {
+    vertexOffset: number;
+    vertexCount: number;
+}
+/**
+ * 从几何里只挑出「指定顶点区间」的棱线，作为线段对返回。
+ *
+ * `ranges` 为空表示整块网格。判定规则与 `THREE.EdgesGeometry` 一致：
+ *   - 只被一个三角形用到的边 → 边界边，保留；
+ *   - 被两个三角形共用、且两面夹角大于 `creaseAngle` → 折边，保留；
+ *   - 其余（共面内部边）→ 丢掉，否则平面会被切成三角网格。
+ *
+ * 非索引几何没有共享顶点，直接用顶点号去重会让每条边都被判成边界边。
+ * 所以这里先按位置量化把顶点归一化成 canonical id，再走同一套逻辑。
+ */
+export declare function buildFeatureEdgeSegments(geometry: THREE.BufferGeometry, ranges?: EdgeVertexRange[] | null, creaseAngle?: number): Float32Array | null;
+//# sourceMappingURL=EdgeLines.d.ts.map

package/dist/render/EdgeLines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgeLines.d.ts","sourceRoot":"","sources":["../../src/render/EdgeLines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAA;KAAE,CAAC;IACtC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACzB;AAED,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,cAAc;IAC7D,QAAQ,EAAE,kBAAkB,GAAG;QAC7B,MAAM,EAAE;YAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAA;SAAE,CAAC;QAC/B,QAAQ,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5B,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAC1B,UAAU,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAC9B,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC;KACnC,CAAC;CACH;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAK7D;AAkDD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,kBAAkB,EAC1B,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACrG,iBAAiB,CAsBnB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,cAAc,CA8DxF;AAID,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAOD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,MAAM,CAAC,EAAE,eAAe,EAAE,GAAG,IAAI,EACjC,WAAW,SAAK,GACf,YAAY,GAAG,IAAI,CAmIrB"}