s3m-three 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,58 @@
-# Temporary Holding Version
+# s3m-three
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+SuperMap S3M 三维模型格式的 **three.js 渲染内核**（宿主无关）。
+
+浏览器内直接解析 `.s3mb` 瓦片，不需要预先转成 3D Tiles，也不需要 SuperMap 的 WebGL 客户端：
+
+- `core/` 纯解析（无 three 依赖，Node 可跑）
+- `tileset/` 瓦片树 + LOD + 加载调度
+- `render/S3MViewer` 宿主无关场景查看器：多数据集叠加、白膜 / 按高度 / 按单体 / 动态扫描着色、单体级 GPU 拾取、选中描边、单体样式与业务字段专题着色
+
+## 安装
+
+```bash
+npm install s3m-three three
+```
+
+`three` 是 peer 依赖（`>=0.168.0`）。
+
+## 30 秒上手
+
+```js
+import * as THREE from 'three';
+import { S3MViewer } from 's3m-three';
+
+const renderer = new THREE.WebGLRenderer({ antialias: true });
+document.body.appendChild(renderer.domElement);
+
+const viewer = new S3MViewer({ configUrl: 'https://host/.../config' });
+viewer.mount(renderer.domElement, renderer.getContext());
+
+const camera = new THREE.PerspectiveCamera(55, innerWidth / innerHeight, 1, 60000);
+const mvp = new THREE.Matrix4();
+
+function tick() {
+  // 你自己的相机与投影矩阵；viewer 只负责把 S3M 瓦片画进去
+  camera.updateProjectionMatrix();
+  camera.updateMatrixWorld(true);
+  mvp.multiplyMatrices(camera.projectionMatrix, camera.matrixWorldInverse);
+  viewer.renderFrame({
+    mvp: mvp.elements,
+    cameraEnu: [camera.position.x, -camera.position.z, camera.position.y], // three(y↑) → ENU(z↑)
+    fovRad: THREE.MathUtils.degToRad(camera.fov),
+    canvasHeight: renderer.domElement.height,
+  });
+  requestAnimationFrame(tick);
+}
+tick();
+```
+
+地理坐标通过可注入的 `GeoAdapter` 接口适配（默认标准 Web 墨卡托兜底）；
+接 MapLibre / Mapbox 请改用 [`s3m-maplibre`](https://www.npmjs.com/package/s3m-maplibre) 的 `S3MLayer`。
+
+完整 API 见 **[docs/API.md](./docs/API.md)**（样式系统、字段着色、底层解析、性能调优）；
+架构说明与在线演示见 <https://github.com/joo1es/s3m-maplibre>。
+
+## 许可
+
+Apache-2.0

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/core/BinaryReader.d.ts

@@ -0,0 +1,38 @@
+/**
+ * S3M 二进制读取器
+ *
+ * 约定全部来自 SuperMap/s3m-spec 的 S3ModelParser.js（Apache-2.0）：
+ *   - 小端字节序
+ *   - String = uint32 字节长度 + UTF-8 字节（无结尾 0）
+ *   - 多处需要按 4 字节对齐，且对齐基准点不同（绝对偏移 / 流起点）
+ */
+import type { BoundingBox, Vec3 } from './types.js';
+export declare class BinaryReader {
+    readonly buffer: ArrayBuffer;
+    readonly base: number;
+    readonly view: DataView;
+    offset: number;
+    private readonly _decoder;
+    constructor(buffer: ArrayBuffer, byteOffset?: number, byteLength?: number);
+    get remaining(): number;
+    u8(): number;
+    u16(): number;
+    u32(): number;
+    i32(): number;
+    f32(): number;
+    f64(): number;
+    /** 返回原始字节视图（不拷贝，生命周期绑定底层 buffer） */
+    bytes(n: number): Uint8Array;
+    /** 返回拷贝，用于纹理等需要脱离源 buffer 的数据 */
+    bytesCopy(n: number): Uint8Array;
+    string(): string;
+    skip(n: number): void;
+    /**
+     * 4 字节对齐。rel 是对齐基准在流中的偏移，默认 0（即整个流起点）。
+     * 纹理流用的是「纹理流起点」而不是文件起点，所以要显式传。
+     */
+    align4(rel?: number): void;
+    vec3f64(): Vec3;
+    boundingBox(): BoundingBox;
+}
+//# sourceMappingURL=BinaryReader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BinaryReader.d.ts","sourceRoot":"","sources":["../../src/core/BinaryReader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEpD,qBAAa,YAAY;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IAEf,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;gBAEzC,MAAM,EAAE,WAAW,EAAE,UAAU,SAAI,EAAE,UAAU,CAAC,EAAE,MAAM;IAWpE,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,EAAE,IAAI,MAAM;IAMZ,GAAG,IAAI,MAAM;IAMb,GAAG,IAAI,MAAM;IAMb,GAAG,IAAI,MAAM;IAMb,GAAG,IAAI,MAAM;IAMb,GAAG,IAAI,MAAM;IAMb,oCAAoC;IACpC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU;IAM5B,iCAAiC;IACjC,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU;IAMhC,MAAM,IAAI,MAAM;IAOhB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAIrB;;;OAGG;IACH,MAAM,CAAC,GAAG,SAAI,GAAG,IAAI;IAKrB,OAAO,IAAI,IAAI;IAIf,WAAW,IAAI,WAAW;CAQ3B"}