s3m-three 0.3.0 → 0.3.1

package/src/vendor/crunch_decoder.module.js

@@ -2,8 +2,14 @@
 // crunch / CRN 解码器（wasm 内联为 base64，无外部资源）
 // 来源：SuperMap iClient3D S3M SDK · S3MTiles/ThirdParty/crunch.{js,wasm}
 // 许可：Apache-2.0（与 s3m-spec 一致）
-// 改动：只把 wasm 加载方式从「按 URL fetch」换成「内联字节」——在 wasmBinary
-//       赋值处注入 __s3mCrunchWasmBytes()，其余原样保留。
+// 改动（相对官方 SDK 原件）：
+//   1. wasm 加载从「按 URL fetch」换成「内联字节」——在 wasmBinary 赋值处注入
+//      __s3mCrunchWasmBytes()；
+//   2. Node 分支的 read_ 原来用裸 require("fs"/"path")，ESM 里取不到（Node ESM 没有
+//      require），且 wasm 已内联、这条路径根本不会走 —— 改成直接抛错；
+//   3. 删掉 `module["exports"] = Module`：本文件有 export default，在任何环境下都是
+//      ESM，裸 module 只会让打包器报 COMMONJS_VARIABLE_IN_ESM，实际是死代码。
+// 其余原样保留。
 // 用法：import 后等 Module.calledRun / onRuntimeInitialized，再调 _malloc / _crn_*。
 // ---------------------------------------------------------------------------
 
@@ -521,32 +527,20 @@ if (typeof WebAssembly !== 'undefined') {
 		return scriptDirectory + path
 	}
 	var read_, readAsync, readBinary, setWindowTitle;
-	var nodeFS;
-	var nodePath;
 	if (ENVIRONMENT_IS_NODE) {
-		// wasm 已内联，不需要按路径读文件；Node ESM 下也没有 __dirname
+		// wasm 已内联，不需要按路径读文件；Node ESM 下也没有 __dirname、没有 require。
+		// 保留签名只为兼容调用点，真走到这里说明用法不对，直接抛。
 		scriptDirectory = typeof __dirname !== "undefined" ? __dirname + "/" : "";
 		read_ = function shell_read(filename, binary) {
-			if (!nodeFS)nodeFS = require("fs");
-			if (!nodePath)nodePath = require("path");
-			filename = nodePath["normalize"](filename);
-			return nodeFS["readFileSync"](filename, binary ? null : "utf8")
+			throw new Error("crunch_decoder: wasm 已内联，不支持按路径读取（" + filename + "）")
 		};
 		readBinary = function readBinary(filename) {
-			var ret = read_(filename, true);
-			if (!ret.buffer) {
-				ret = new Uint8Array(ret)
-			}
-			assert(ret.buffer);
-			return ret
+			return read_(filename, true)
 		};
 		if (process["argv"].length > 1) {
 			thisProgram = process["argv"][1].replace(/\\/g, "/")
 		}
 		arguments_ = process["argv"].slice(2);
-		if (typeof module !== "undefined") {
-			module["exports"] = Module
-		}
 		process["on"]("uncaughtException", function (ex) {
 			if (!(ex instanceof ExitStatus)) {
 				throw ex

package/src/vendor/draco_decoder.module.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Draco 几何解码器（google/draco，wasm 内联）的类型声明
+ *
+ * 只声明 S3M 用到的部分。两个坑：
+ *   1. `draco.Decoder` 的属性取值接口只接受 embind 的 `Draco*Array`，
+ *      直接传 JS TypedArray 会被 embind 当成对象指针，解出来全是 0。
+ *   2. 解码产物是 embind 包装的 C++ 对象，用完要 `draco.destroy()`，
+ *      否则 wasm 堆只涨不降。
+ *
+ * draco 的枚举常量（POSITION=0 / NORMAL=1 / COLOR=2 / TEX_COORD=3 / GENERIC=4，
+ * DT_FLOAT32=9 / DT_UINT8=2 / DT_UINT16=4 / DT_UINT32=6，POINT_CLOUD=0 /
+ * TRIANGULAR_MESH=1）在模块实例上，本文件不重复导出——避免被当成
+ * 可从 .js 引入的值。
+ */
+
+export interface DracoAttributeTransformData {
+  transform_type(): number;
+  quantization_bits(): number;
+  /** 仅量化变换有效：第 index 个分量的最小值 */
+  min_value(index: number): number;
+  range(): number;
+  __destroy__(): void;
+}
+
+export interface DracoPointAttribute {
+  attribute_type(): number;
+  data_type(): number;
+  num_components(): number;
+  normalized(): boolean;
+  byte_stride(): number;
+  byte_offset(): number;
+  unique_id(): number;
+  size(): number;
+  GetAttributeTransformData(): DracoAttributeTransformData;
+  __destroy__(): void;
+}
+
+export interface DracoPointCloud {
+  num_points(): number;
+  num_attributes(): number;
+  __destroy__(): void;
+}
+
+export interface DracoStatus {
+  ok(): boolean;
+  error_msg(): string;
+}
+
+export interface DracoDecoder {
+  /** 传入的是 draco 字节流开头（至少 5 字节的 "DRACO" magic） */
+  GetEncodedGeometryType(data: Uint8Array): number;
+  DecodeArrayToPointCloud(
+    data: Uint8Array,
+    byteLength: number,
+    out: DracoPointCloud
+  ): DracoStatus;
+  /** 按属性在几何里的序号取 */
+  GetAttribute(pc: DracoPointCloud, index: number): DracoPointAttribute;
+  /** 按 unique_id 取；不存在时返回 null */
+  GetAttributeByUniqueId(pc: DracoPointCloud, uniqueId: number): DracoPointAttribute | null;
+  GetAttributeFloatForAllPoints(pc: DracoPointCloud, attr: DracoPointAttribute, out: DracoFloat32Array): boolean;
+  GetAttributeFloatArrayForAllPoints(
+    pc: DracoPointCloud,
+    attr: DracoPointAttribute,
+    out: DracoFloat32Array
+  ): boolean;
+  GetAttributeInt8ForAllPoints(pc: DracoPointCloud, attr: DracoPointAttribute, out: DracoInt8Array): boolean;
+  GetAttributeUInt8ForAllPoints(pc: DracoPointCloud, attr: DracoPointAttribute, out: DracoUInt8Array): boolean;
+  GetAttributeInt16ForAllPoints(pc: DracoPointCloud, attr: DracoPointAttribute, out: DracoInt16Array): boolean;
+  GetAttributeUInt16ForAllPoints(pc: DracoPointCloud, attr: DracoPointAttribute, out: DracoUInt16Array): boolean;
+  GetAttributeInt32ForAllPoints(pc: DracoPointCloud, attr: DracoPointAttribute, out: DracoInt32Array): boolean;
+  GetAttributeUInt32ForAllPoints(pc: DracoPointCloud, attr: DracoPointAttribute, out: DracoUInt32Array): boolean;
+  __destroy__(): void;
+}
+
+/** embind 的定长数组包装：取值必须逐个 GetValue */
+export interface DracoFloat32Array {
+  size(): number;
+  GetValue(index: number): number;
+  __destroy__(): void;
+}
+export interface DracoInt8Array {
+  size(): number;
+  GetValue(index: number): number;
+  __destroy__(): void;
+}
+export interface DracoUInt8Array {
+  size(): number;
+  GetValue(index: number): number;
+  __destroy__(): void;
+}
+export interface DracoInt16Array {
+  size(): number;
+  GetValue(index: number): number;
+  __destroy__(): void;
+}
+export interface DracoUInt16Array {
+  size(): number;
+  GetValue(index: number): number;
+  __destroy__(): void;
+}
+export interface DracoInt32Array {
+  size(): number;
+  GetValue(index: number): number;
+  __destroy__(): void;
+}
+export interface DracoUInt32Array {
+  size(): number;
+  GetValue(index: number): number;
+  __destroy__(): void;
+}
+
+export interface DracoModule {
+  Decoder: new () => DracoDecoder;
+  PointCloud: new () => DracoPointCloud;
+  DracoFloat32Array: new () => DracoFloat32Array;
+  DracoInt8Array: new () => DracoInt8Array;
+  DracoUInt8Array: new () => DracoUInt8Array;
+  DracoInt16Array: new () => DracoInt16Array;
+  DracoUInt16Array: new () => DracoUInt16Array;
+  DracoInt32Array: new () => DracoInt32Array;
+  DracoUInt32Array: new () => DracoUInt32Array;
+  /** 释放 embind 对象占用的 wasm 堆 */
+  destroy(obj: unknown): void;
+}
+
+declare function loadDracoModule(): Promise<DracoModule>;
+export default loadDracoModule;