gltf-parser-plugin 1.1.6 → 1.1.8

package/build/gltf-parser-plugin.module.js

@@ -1,23 +1,68 @@
-import { Box2, Box3, BufferAttribute, BufferGeometry, Color, CustomBlending, DataTexture, DoubleSide, EdgesGeometry, EventDispatcher, Float32BufferAttribute, FrontSide, Group, InstancedMesh, LineSegments, Loader, Matrix2, Matrix3, Matrix4, Mesh, MeshBasicMaterial, MeshStandardMaterial, OneFactor, OrthographicCamera, Quaternion, RGBAFormat, SRGBColorSpace, Scene, ShaderMaterial, Texture, Triangle, UnsignedByteType, Vector2, Vector3, Vector4, WebGLRenderTarget, WebGLRenderer, ZeroFactor } from "three";
-//#region src/mesh-helper/FeatureIdUniforms.ts
-var FeatureIdUniforms = class {
-	mesh;
-	plugin;
-	constructor(mesh, plugin) {
-		this.mesh = mesh;
-		this.plugin = plugin;
-	}
-	get value() {
-		const idMap = this.mesh.userData.idMap;
-		if (!idMap) return new Array(this.plugin.getFeatureIdCount()).fill(-1);
-		const result = new Array(this.plugin.getFeatureIdCount()).fill(-1);
-		for (let i = 0; i < this.plugin.oids.length; i++) {
-			const featureId = idMap[this.plugin.oids[i]];
-			result[i] = featureId !== void 0 ? featureId : -1;
-		}
-		return result;
+import { Box2, Box3, BufferAttribute, BufferGeometry, Color, CustomBlending, DataTexture, DoubleSide, EdgesGeometry, Euler, EventDispatcher, Float32BufferAttribute, FrontSide, Group, InstancedMesh, LineSegments, Loader, Material, Matrix2, Matrix3, Matrix4, Mesh, MeshBasicMaterial, MeshStandardMaterial, OneFactor, OrthographicCamera, Quaternion, RGBAFormat, SRGBColorSpace, Scene, ShaderMaterial, Texture, Triangle, UnsignedByteType, Vector2, Vector3, Vector4, WebGLRenderTarget, WebGLRenderer, ZeroFactor } from "three";
+//#region src/mesh-helper/index-visibility.ts
+/** 从 mesh 的 idMap 和 hiddenOids 构建需要隐藏的 feature ID 集合 */
+function getHiddenFeatureIds(mesh, hiddenOids) {
+	const idMap = mesh.userData?.idMap;
+	if (!idMap) return /* @__PURE__ */ new Set();
+	const hidden = /* @__PURE__ */ new Set();
+	for (const oid of hiddenOids) {
+		const fid = idMap[oid];
+		if (fid !== void 0) hidden.add(fid);
+	}
+	return hidden;
+}
+/** 对单个 mesh 应用可见性过滤（通过修改 index 排除隐藏的三角形） */
+function applyVisibilityToMesh(mesh, hiddenOids) {
+	const { meshFeatures } = mesh.userData;
+	if (!meshFeatures) return;
+	const geometry = mesh.geometry;
+	const index = geometry.index;
+	const featureIdAttr = geometry.getAttribute("_feature_id_0");
+	if (!index || !featureIdAttr) return;
+	const hiddenFeatureIds = getHiddenFeatureIds(mesh, hiddenOids);
+	if (hiddenFeatureIds.size === 0) {
+		restoreMeshIndex(mesh);
+		return;
+	}
+	if (!mesh.userData._originalIndex) mesh.userData._originalIndex = index.array.slice(0);
+	const originalArray = mesh.userData._originalIndex;
+	const filtered = originalArray instanceof Uint32Array ? new Uint32Array(originalArray.length) : new Uint16Array(originalArray.length);
+	let writeOffset = 0;
+	for (let i = 0; i < originalArray.length; i += 3) {
+		const fid = featureIdAttr.getX(originalArray[i]);
+		if (hiddenFeatureIds.has(fid)) continue;
+		filtered[writeOffset++] = originalArray[i];
+		filtered[writeOffset++] = originalArray[i + 1];
+		filtered[writeOffset++] = originalArray[i + 2];
+	}
+	const filteredArray = filtered.subarray(0, writeOffset);
+	geometry.setIndex(new BufferAttribute(filteredArray, 1));
+	geometry.index.needsUpdate = true;
+}
+/** 恢复 mesh 的原始 index */
+function restoreMeshIndex(mesh) {
+	const original = mesh.userData?._originalIndex;
+	if (!original) return;
+	const geometry = mesh.geometry;
+	if (!geometry?.index) return;
+	geometry.setIndex(new BufferAttribute(original, 1));
+	geometry.index.needsUpdate = true;
+}
+/** 遍历 scene 中所有 tile mesh，应用可见性过滤 */
+function applyVisibilityToScene(scene, hiddenOids) {
+	const oidSet = hiddenOids;
+	if (oidSet.size === 0) {
+		scene.traverse((obj) => {
+			const mesh = obj;
+			if (mesh.userData?.meshFeatures && !mesh.userData?.isSplit) restoreMeshIndex(mesh);
+		});
+		return;
 	}
-};
+	scene.traverse((obj) => {
+		const mesh = obj;
+		if (mesh.userData?.meshFeatures && mesh.userData?.structuralMetadata && !mesh.userData?.isSplit) applyVisibilityToMesh(mesh, oidSet);
+	});
+}
 //#endregion
 //#region src/mesh-helper/idmap.ts
 var FEATURE_INDEX = 0;
@@ -108,87 +153,143 @@ function queryFeatureFromIntersection(hit) {
 //#endregion
 //#region src/mesh-helper/mesh.ts
 /**
-* 预建featureId到顶点索引的映射表，提高查询性能
+* 合并多个 feature 的三角形为单一 BufferGeometry（共享顶点属性，index 为并集）
 */
-function buildFeatureIdIndexMap(featureIdAttr) {
-	const featureIdMap = /* @__PURE__ */ new Map();
-	for (let i = 0; i < featureIdAttr.count; i++) {
-		const featureId = featureIdAttr.getX(i);
-		if (!featureIdMap.has(featureId)) featureIdMap.set(featureId, /* @__PURE__ */ new Set());
-		featureIdMap.get(featureId).add(i);
-	}
-	return featureIdMap;
-}
-/**
-* Create a geometry for a specified feature ID
-*/
-function createGeometryForFeatureId(originalGeometry, featureIdMap, targetFeatureId) {
+function createGeometryForFeatureIdSet(originalGeometry, featureIdAttr, targetFids) {
+	if (targetFids.size === 0 || !originalGeometry.index) return null;
 	const newGeometry = new BufferGeometry();
-	const targetVertexIndices = featureIdMap.get(targetFeatureId);
-	if (!targetVertexIndices || targetVertexIndices.size === 0) return null;
 	const attributes = originalGeometry.attributes;
 	for (const attributeName in attributes) newGeometry.setAttribute(attributeName, attributes[attributeName]);
-	if (originalGeometry.index) {
-		const originalIndex = originalGeometry.index.array;
-		const newIndices = [];
-		for (let i = 0; i < originalIndex.length; i += 3) {
-			const a = originalIndex[i];
-			const b = originalIndex[i + 1];
-			const c = originalIndex[i + 2];
-			if (targetVertexIndices.has(a) && targetVertexIndices.has(b) && targetVertexIndices.has(c)) newIndices.push(a, b, c);
-		}
-		if (newIndices.length > 0) newGeometry.setIndex(newIndices);
-	}
+	const originalIndex = originalGeometry.index.array;
+	const newIndices = [];
+	for (let i = 0; i < originalIndex.length; i += 3) {
+		const a = originalIndex[i];
+		const b = originalIndex[i + 1];
+		const c = originalIndex[i + 2];
+		const fa = featureIdAttr.getX(a);
+		if (fa === featureIdAttr.getX(b) && fa === featureIdAttr.getX(c) && targetFids.has(fa)) newIndices.push(a, b, c);
+	}
+	if (newIndices.length === 0) return null;
+	newGeometry.setIndex(newIndices);
 	return newGeometry;
 }
 /**
-* Function to split mesh by feature ID
+* 将同一瓦片 mesh 内、属于给定 OID 集合的所有 feature 合并为 **单个** Mesh（每瓦片最多一个）
 */
-function splitMeshByOid(originalMesh, oid) {
+function splitMeshByOidsMerged(originalMesh, oidSet) {
+	if (oidSet.size === 0) return null;
+	const idMap = originalMesh.userData?.idMap;
+	if (!idMap) return null;
 	const { meshFeatures, structuralMetadata } = originalMesh.userData;
 	const { geometry, featureIds } = meshFeatures;
 	const featureId = featureIds[0];
 	const featureIdAttr = geometry.getAttribute(`_feature_id_${featureId.attribute}`);
 	if (!featureIdAttr) {
 		console.warn("No feature ID attribute found");
-		return [];
-	}
-	const featureIdMap = buildFeatureIdIndexMap(featureIdAttr);
-	const currentBatchMeshes = [];
-	for (const [fid] of featureIdMap) try {
-		let _oid = null;
-		let propertyData = null;
-		if (structuralMetadata) try {
-			propertyData = structuralMetadata.getPropertyTableData(featureId.propertyTable, fid);
-			_oid = propertyData?._oid;
-			if (_oid === oid) {
-				const newGeometry = createGeometryForFeatureId(geometry, featureIdMap, fid);
-				if (newGeometry && newGeometry.attributes.position.count > 0) {
-					const newMesh = new Mesh(newGeometry, originalMesh.material.clone());
-					newMesh.parent = originalMesh.parent;
-					newMesh.position.copy(originalMesh.position);
-					newMesh.rotation.copy(originalMesh.rotation);
-					newMesh.scale.copy(originalMesh.scale);
-					newMesh.matrixWorld.copy(originalMesh.matrixWorld);
-					newMesh.userData = {
-						...originalMesh.userData,
-						featureId: fid,
-						oid,
-						originalMesh,
-						propertyData,
-						isSplit: true
-					};
-					newMesh.name = `feature_${fid}_${oid || ""}`;
-					currentBatchMeshes.push(newMesh);
-				}
-			}
-		} catch (e) {
-			console.warn(`Failed to get property data for feature ${fid}:`, e);
+		return null;
+	}
+	const targetFids = /* @__PURE__ */ new Set();
+	const oidsOnMesh = [];
+	for (const oid of oidSet) {
+		const fid = idMap[oid];
+		if (fid !== void 0) {
+			targetFids.add(fid);
+			oidsOnMesh.push(oid);
 		}
-	} catch (error) {
-		console.warn(`Error creating mesh for feature ${fid}:`, error);
 	}
-	return currentBatchMeshes;
+	if (targetFids.size === 0) return null;
+	const newGeometry = createGeometryForFeatureIdSet(geometry, featureIdAttr, targetFids);
+	if (!newGeometry || newGeometry.attributes.position.count === 0) return null;
+	const newMesh = new Mesh(newGeometry, originalMesh.material.clone());
+	newMesh.parent = originalMesh.parent;
+	newMesh.position.copy(originalMesh.position);
+	newMesh.rotation.copy(originalMesh.rotation);
+	newMesh.scale.copy(originalMesh.scale);
+	newMesh.matrixWorld.copy(originalMesh.matrixWorld);
+	oidsOnMesh.sort((a, b) => a - b);
+	const primaryOid = oidsOnMesh[0];
+	let propertyData = null;
+	if (structuralMetadata && idMap[primaryOid] !== void 0) try {
+		propertyData = structuralMetadata.getPropertyTableData(featureId.propertyTable, idMap[primaryOid]);
+	} catch {}
+	newMesh.userData = {
+		...originalMesh.userData,
+		featureId: idMap[primaryOid],
+		oid: primaryOid,
+		collectorOids: oidsOnMesh,
+		originalMesh,
+		propertyData,
+		isSplit: true,
+		isMergedSplit: true
+	};
+	newMesh.name = `merged_features_${oidsOnMesh.length}_${primaryOid}`;
+	return newMesh;
+}
+/** 瓦片内原始 feature mesh（非 split 子网格） */
+function isFeatureSourceMesh(mesh) {
+	const u = mesh.userData;
+	return Boolean(u?.meshFeatures && u?.structuralMetadata && !u?.isSplit);
+}
+/**
+* 从瓦片中获取所有 OID
+*/
+function getAllOidsFromTiles(tiles) {
+	const oidSet = /* @__PURE__ */ new Set();
+	tiles.group.traverse((child) => {
+		const mesh = child;
+		if (!isFeatureSourceMesh(mesh)) return;
+		const idMap = mesh.userData.idMap;
+		if (!idMap) return;
+		for (const oid of Object.keys(idMap).map(Number)) oidSet.add(oid);
+	});
+	return Array.from(oidSet);
+}
+/**
+* 根据 OID 获取属性数据（从瓦片 structuralMetadata）
+*/
+function getPropertyDataByOid(tiles, oid) {
+	let result = null;
+	tiles.group.traverse((child) => {
+		if (result) return;
+		const mesh = child;
+		if (!isFeatureSourceMesh(mesh)) return;
+		const idMap = mesh.userData.idMap;
+		if (!idMap || idMap[oid] === void 0) return;
+		const { meshFeatures, structuralMetadata } = mesh.userData;
+		const featureId = meshFeatures.featureIds[0];
+		const fid = idMap[oid];
+		try {
+			result = structuralMetadata.getPropertyTableData(featureId.propertyTable, fid);
+		} catch {}
+	});
+	return result;
+}
+/**
+* 单次遍历场景构建 OID → 属性表数据。
+* 批量样式/筛选时使用，避免对每个 OID 重复 traverse（O(n×场景节点)）。
+*/
+function getPropertyDataMapFromTiles(tiles) {
+	const map = /* @__PURE__ */ new Map();
+	tiles.group.traverse((child) => {
+		const mesh = child;
+		if (!isFeatureSourceMesh(mesh)) return;
+		const idMap = mesh.userData.idMap;
+		if (!idMap) return;
+		const { meshFeatures, structuralMetadata } = mesh.userData;
+		const propertyTable = meshFeatures.featureIds[0].propertyTable;
+		for (const oid of Object.keys(idMap).map(Number)) {
+			if (map.has(oid)) continue;
+			const fid = idMap[oid];
+			if (fid === void 0) continue;
+			try {
+				const data = structuralMetadata.getPropertyTableData(propertyTable, fid);
+				map.set(oid, data);
+			} catch {
+				map.set(oid, null);
+			}
+		}
+	});
+	return map;
 }
 /**
 * 根据OID获取包含该OID的瓦片mesh
@@ -197,9 +298,7 @@ function getTileMeshesByOid(tiles, oid) {
 	const tileMeshes = [];
 	tiles.group.traverse((child) => {
 		const mesh = child;
-		if (mesh.userData.meshFeatures && mesh.userData.structuralMetadata && !mesh.userData.isSplit) {
-			if (checkMeshContainsOid(mesh, oid)) tileMeshes.push(mesh);
-		}
+		if (isFeatureSourceMesh(mesh) && checkMeshContainsOid(mesh, oid)) tileMeshes.push(mesh);
 	});
 	return tileMeshes;
 }
@@ -208,43 +307,74 @@ function checkMeshContainsOid(mesh, oid) {
 	if (!idMap) return false;
 	return idMap[oid] !== void 0;
 }
+//#endregion
+//#region src/MeshCollector.ts
+/** 去重并排序 OID */
+function normalizeMeshCollectorOids(oids) {
+	return [...new Set(oids)].sort((a, b) => a - b);
+}
 /**
-* 获取分割后的mesh
+* 与 MeshCollector.getCacheKey()、插件 collectorCache 键一致
 */
-function getSplitMeshesFromTile(tileMesh, oid) {
-	let meshes = [];
-	try {
-		const splitMeshes = splitMeshByOid(tileMesh, oid);
-		meshes = [...meshes, ...splitMeshes];
-	} catch (error) {
-		console.warn(`拆分mesh失败:`, error);
-	}
-	return meshes;
+function meshCollectorQueryCacheKey(query) {
+	const oidsNorm = normalizeMeshCollectorOids(query.oids ?? []);
+	const oidPart = oidsNorm.length > 0 ? oidsNorm.join(",") : "*";
+	const condRaw = query.condition?.trim() ?? "";
+	return `${oidPart}@@${condRaw === "" ? "_" : encodeURIComponent(condRaw)}`;
+}
+/** @deprecated 请使用 meshCollectorQueryCacheKey({ oids }) */
+function meshCollectorGroupKey(oids) {
+	return meshCollectorQueryCacheKey({ oids });
 }
-//#endregion
-//#region src/MeshCollector.ts
 /**
-* MeshCollector - 用于监听和收集特定 oid 对应的 mesh
-* 随着瓦片变化，会自动更新 meshes 并触发 mesh-change 事件
+* MeshCollector - 按查询条件监听并收集 split mesh
 */
 var MeshCollector = class extends EventDispatcher {
-	oid;
+	queryOids;
+	condition;
+	cacheKey;
 	plugin;
 	_meshes = [];
 	_disposed = false;
-	constructor(oid, plugin) {
+	constructor(query, plugin) {
 		super();
-		this.oid = oid;
+		const oids = normalizeMeshCollectorOids(query.oids ?? []);
+		const condition = query.condition?.trim() || void 0;
+		if (oids.length === 0 && !condition) throw new Error("MeshCollector requires at least one OID in oids and/or a non-empty condition");
+		this.queryOids = oids;
+		this.condition = condition;
+		this.cacheKey = meshCollectorQueryCacheKey({
+			oids,
+			condition
+		});
 		this.plugin = plugin;
 		plugin._registerCollector(this);
 		this._updateMeshes();
 	}
+	getCacheKey() {
+		return this.cacheKey;
+	}
+	/** 查询里显式传入的 OID（规范化后）；仅用 condition 筛选时可能为空数组 */
+	getOids() {
+		return this.queryOids;
+	}
+	/** 有显式 OID 时返回第一个；否则无意义（可能为 undefined） */
+	getOid() {
+		return this.queryOids[0];
+	}
 	get meshes() {
 		return this._meshes;
 	}
+	/** 与 setStyle 一致的条件表达式（若有） */
+	getCondition() {
+		return this.condition;
+	}
 	_updateMeshes() {
 		if (this._disposed) return;
-		const newMeshes = this.plugin._getMeshesByOidInternal(this.oid);
+		const newMeshes = this.plugin._getMeshesForCollectorQueryInternal({
+			oids: this.queryOids,
+			condition: this.condition
+		});
 		if (newMeshes.length !== this._meshes.length || newMeshes.some((mesh, i) => mesh !== this._meshes[i])) {
 			this._meshes = newMeshes;
 			this.dispatchEvent({
@@ -253,9 +383,6 @@ var MeshCollector = class extends EventDispatcher {
 			});
 		}
 	}
-	getOid() {
-		return this.oid;
-	}
 	dispose() {
 		if (this._disposed) return;
 		this._disposed = true;
@@ -264,6 +391,51 @@ var MeshCollector = class extends EventDispatcher {
 	}
 };
 //#endregion
+//#region src/plugin/style-condition-eval.ts
+/**
+* 与 StyleHelper 中 `show`、`conditions` 条件项的表达式求值一致
+* 在 propertyData 的键作为变量名的上下文中执行 `Boolean(expr)`
+*
+* 实现：对每个表达式字符串只编译一次 `new Function('data', 'with(d){...}')`，
+* 避免按「表达式 × 属性键集合」重复编译，也避免每次求值排序/拼接 cacheKey。
+*/
+var compiledCache = /* @__PURE__ */ new Map();
+var MAX_CACHE_ENTRIES = 512;
+function getCompiled(expr) {
+	let fn = compiledCache.get(expr);
+	if (fn) return fn;
+	try {
+		fn = new Function("data", `var d = data != null && typeof data === "object" ? data : {};
+with (d) { return Boolean(${expr}); }`);
+	} catch {
+		return null;
+	}
+	if (compiledCache.size >= MAX_CACHE_ENTRIES) {
+		const first = compiledCache.keys().next().value;
+		if (first !== void 0) compiledCache.delete(first);
+	}
+	compiledCache.set(expr, fn);
+	return fn;
+}
+/**
+* 清空表达式编译缓存（热更新或单测可调用）
+*/
+function clearStyleConditionCache() {
+	compiledCache.clear();
+}
+function evaluateStyleCondition(expr, propertyData) {
+	if (expr === true) return true;
+	if (expr === false) return false;
+	if (typeof expr !== "string" || !expr.trim()) return true;
+	const fn = getCompiled(expr.trim());
+	if (!fn) return false;
+	try {
+		return fn(propertyData ?? {});
+	} catch {
+		return false;
+	}
+}
+//#endregion
 //#region src/utils/build-textures.ts
 /**
 * Build textures from GLTF data
@@ -566,15 +738,24 @@ function polygonIntersectsRect(polygon, minX, minY, maxX, maxY) {
 	return false;
 }
 /**
+* 将 structure 中的 bbox 数组转为 Box3。
+* 约定与 `selectByBox` 一致：`[minX, minY, minZ, maxX, maxY, maxZ]`，至少 6 个数。
+*/
+function bboxArrayToBox3(bbox) {
+	if (!bbox || bbox.length < 6) return null;
+	const box = new Box3();
+	box.min.set(bbox[0], bbox[1], bbox[2]);
+	box.max.set(bbox[3], bbox[4], bbox[5]);
+	return box;
+}
+/**
 * 从 OID 节点映射中按 Box3 范围筛选构件
 */
 function selectByBoxFromOidMap(oidNodeMap, box) {
 	const result = [];
-	const nodeBox = new Box3();
 	for (const [oid, node] of oidNodeMap) {
-		if (!node.bbox || node.bbox.length < 6) continue;
-		nodeBox.min.set(node.bbox[0], node.bbox[1], node.bbox[2]);
-		nodeBox.max.set(node.bbox[3], node.bbox[4], node.bbox[5]);
+		const nodeBox = bboxArrayToBox3(node.bbox);
+		if (!nodeBox) continue;
 		if (box.intersectsBox(nodeBox)) result.push(oid);
 	}
 	return result;
@@ -619,7 +800,394 @@ function selectByPolygonFromOidMap(oidNodeMap, polygon, axis = "xz") {
 	return result;
 }
 //#endregion
-//#region node_modules/.pnpm/3d-tiles-renderer@0.4.22_three@0.183.2/node_modules/3d-tiles-renderer/build/constants-Cj07Qhs1.js
+//#region src/utils/color-input.ts
+function toColor(value) {
+	return value instanceof Color ? value : new Color(value);
+}
+//#endregion
+//#region node_modules/.pnpm/fflate@0.8.2/node_modules/fflate/esm/browser.js
+var u8 = Uint8Array, u16 = Uint16Array, i32 = Int32Array;
+var fleb = new u8([
+	0,
+	0,
+	0,
+	0,
+	0,
+	0,
+	0,
+	0,
+	1,
+	1,
+	1,
+	1,
+	2,
+	2,
+	2,
+	2,
+	3,
+	3,
+	3,
+	3,
+	4,
+	4,
+	4,
+	4,
+	5,
+	5,
+	5,
+	5,
+	0,
+	0,
+	0,
+	0
+]);
+var fdeb = new u8([
+	0,
+	0,
+	0,
+	0,
+	1,
+	1,
+	2,
+	2,
+	3,
+	3,
+	4,
+	4,
+	5,
+	5,
+	6,
+	6,
+	7,
+	7,
+	8,
+	8,
+	9,
+	9,
+	10,
+	10,
+	11,
+	11,
+	12,
+	12,
+	13,
+	13,
+	0,
+	0
+]);
+var clim = new u8([
+	16,
+	17,
+	18,
+	0,
+	8,
+	7,
+	9,
+	6,
+	10,
+	5,
+	11,
+	4,
+	12,
+	3,
+	13,
+	2,
+	14,
+	1,
+	15
+]);
+var freb = function(eb, start) {
+	var b = new u16(31);
+	for (var i = 0; i < 31; ++i) b[i] = start += 1 << eb[i - 1];
+	var r = new i32(b[30]);
+	for (var i = 1; i < 30; ++i) for (var j = b[i]; j < b[i + 1]; ++j) r[j] = j - b[i] << 5 | i;
+	return {
+		b,
+		r
+	};
+};
+var _a = freb(fleb, 2), fl = _a.b, revfl = _a.r;
+fl[28] = 258, revfl[258] = 28;
+var fd = freb(fdeb, 0).b;
+var rev = new u16(32768);
+for (var i = 0; i < 32768; ++i) {
+	var x = (i & 43690) >> 1 | (i & 21845) << 1;
+	x = (x & 52428) >> 2 | (x & 13107) << 2;
+	x = (x & 61680) >> 4 | (x & 3855) << 4;
+	rev[i] = ((x & 65280) >> 8 | (x & 255) << 8) >> 1;
+}
+var hMap = (function(cd, mb, r) {
+	var s = cd.length;
+	var i = 0;
+	var l = new u16(mb);
+	for (; i < s; ++i) if (cd[i]) ++l[cd[i] - 1];
+	var le = new u16(mb);
+	for (i = 1; i < mb; ++i) le[i] = le[i - 1] + l[i - 1] << 1;
+	var co;
+	if (r) {
+		co = new u16(1 << mb);
+		var rvb = 15 - mb;
+		for (i = 0; i < s; ++i) if (cd[i]) {
+			var sv = i << 4 | cd[i];
+			var r_1 = mb - cd[i];
+			var v = le[cd[i] - 1]++ << r_1;
+			for (var m = v | (1 << r_1) - 1; v <= m; ++v) co[rev[v] >> rvb] = sv;
+		}
+	} else {
+		co = new u16(s);
+		for (i = 0; i < s; ++i) if (cd[i]) co[i] = rev[le[cd[i] - 1]++] >> 15 - cd[i];
+	}
+	return co;
+});
+var flt = new u8(288);
+for (var i = 0; i < 144; ++i) flt[i] = 8;
+for (var i = 144; i < 256; ++i) flt[i] = 9;
+for (var i = 256; i < 280; ++i) flt[i] = 7;
+for (var i = 280; i < 288; ++i) flt[i] = 8;
+var fdt = new u8(32);
+for (var i = 0; i < 32; ++i) fdt[i] = 5;
+var flrm = /* @__PURE__ */ hMap(flt, 9, 1), fdrm = /* @__PURE__ */ hMap(fdt, 5, 1);
+var max = function(a) {
+	var m = a[0];
+	for (var i = 1; i < a.length; ++i) if (a[i] > m) m = a[i];
+	return m;
+};
+var bits = function(d, p, m) {
+	var o = p / 8 | 0;
+	return (d[o] | d[o + 1] << 8) >> (p & 7) & m;
+};
+var bits16 = function(d, p) {
+	var o = p / 8 | 0;
+	return (d[o] | d[o + 1] << 8 | d[o + 2] << 16) >> (p & 7);
+};
+var shft = function(p) {
+	return (p + 7) / 8 | 0;
+};
+var slc = function(v, s, e) {
+	if (s == null || s < 0) s = 0;
+	if (e == null || e > v.length) e = v.length;
+	return new u8(v.subarray(s, e));
+};
+var ec = [
+	"unexpected EOF",
+	"invalid block type",
+	"invalid length/literal",
+	"invalid distance",
+	"stream finished",
+	"no stream handler",
+	,
+	"no callback",
+	"invalid UTF-8 data",
+	"extra field too long",
+	"date not in range 1980-2099",
+	"filename too long",
+	"stream finishing",
+	"invalid zip data"
+];
+var err = function(ind, msg, nt) {
+	var e = new Error(msg || ec[ind]);
+	e.code = ind;
+	if (Error.captureStackTrace) Error.captureStackTrace(e, err);
+	if (!nt) throw e;
+	return e;
+};
+var inflt = function(dat, st, buf, dict) {
+	var sl = dat.length, dl = dict ? dict.length : 0;
+	if (!sl || st.f && !st.l) return buf || new u8(0);
+	var noBuf = !buf;
+	var resize = noBuf || st.i != 2;
+	var noSt = st.i;
+	if (noBuf) buf = new u8(sl * 3);
+	var cbuf = function(l) {
+		var bl = buf.length;
+		if (l > bl) {
+			var nbuf = new u8(Math.max(bl * 2, l));
+			nbuf.set(buf);
+			buf = nbuf;
+		}
+	};
+	var final = st.f || 0, pos = st.p || 0, bt = st.b || 0, lm = st.l, dm = st.d, lbt = st.m, dbt = st.n;
+	var tbts = sl * 8;
+	do {
+		if (!lm) {
+			final = bits(dat, pos, 1);
+			var type = bits(dat, pos + 1, 3);
+			pos += 3;
+			if (!type) {
+				var s = shft(pos) + 4, l = dat[s - 4] | dat[s - 3] << 8, t = s + l;
+				if (t > sl) {
+					if (noSt) err(0);
+					break;
+				}
+				if (resize) cbuf(bt + l);
+				buf.set(dat.subarray(s, t), bt);
+				st.b = bt += l, st.p = pos = t * 8, st.f = final;
+				continue;
+			} else if (type == 1) lm = flrm, dm = fdrm, lbt = 9, dbt = 5;
+			else if (type == 2) {
+				var hLit = bits(dat, pos, 31) + 257, hcLen = bits(dat, pos + 10, 15) + 4;
+				var tl = hLit + bits(dat, pos + 5, 31) + 1;
+				pos += 14;
+				var ldt = new u8(tl);
+				var clt = new u8(19);
+				for (var i = 0; i < hcLen; ++i) clt[clim[i]] = bits(dat, pos + i * 3, 7);
+				pos += hcLen * 3;
+				var clb = max(clt), clbmsk = (1 << clb) - 1;
+				var clm = hMap(clt, clb, 1);
+				for (var i = 0; i < tl;) {
+					var r = clm[bits(dat, pos, clbmsk)];
+					pos += r & 15;
+					var s = r >> 4;
+					if (s < 16) ldt[i++] = s;
+					else {
+						var c = 0, n = 0;
+						if (s == 16) n = 3 + bits(dat, pos, 3), pos += 2, c = ldt[i - 1];
+						else if (s == 17) n = 3 + bits(dat, pos, 7), pos += 3;
+						else if (s == 18) n = 11 + bits(dat, pos, 127), pos += 7;
+						while (n--) ldt[i++] = c;
+					}
+				}
+				var lt = ldt.subarray(0, hLit), dt = ldt.subarray(hLit);
+				lbt = max(lt);
+				dbt = max(dt);
+				lm = hMap(lt, lbt, 1);
+				dm = hMap(dt, dbt, 1);
+			} else err(1);
+			if (pos > tbts) {
+				if (noSt) err(0);
+				break;
+			}
+		}
+		if (resize) cbuf(bt + 131072);
+		var lms = (1 << lbt) - 1, dms = (1 << dbt) - 1;
+		var lpos = pos;
+		for (;; lpos = pos) {
+			var c = lm[bits16(dat, pos) & lms], sym = c >> 4;
+			pos += c & 15;
+			if (pos > tbts) {
+				if (noSt) err(0);
+				break;
+			}
+			if (!c) err(2);
+			if (sym < 256) buf[bt++] = sym;
+			else if (sym == 256) {
+				lpos = pos, lm = null;
+				break;
+			} else {
+				var add = sym - 254;
+				if (sym > 264) {
+					var i = sym - 257, b = fleb[i];
+					add = bits(dat, pos, (1 << b) - 1) + fl[i];
+					pos += b;
+				}
+				var d = dm[bits16(dat, pos) & dms], dsym = d >> 4;
+				if (!d) err(3);
+				pos += d & 15;
+				var dt = fd[dsym];
+				if (dsym > 3) {
+					var b = fdeb[dsym];
+					dt += bits16(dat, pos) & (1 << b) - 1, pos += b;
+				}
+				if (pos > tbts) {
+					if (noSt) err(0);
+					break;
+				}
+				if (resize) cbuf(bt + 131072);
+				var end = bt + add;
+				if (bt < dt) {
+					var shift = dl - dt, dend = Math.min(dt, end);
+					if (shift + bt < 0) err(3);
+					for (; bt < dend; ++bt) buf[bt] = dict[shift + bt];
+				}
+				for (; bt < end; ++bt) buf[bt] = buf[bt - dt];
+			}
+		}
+		st.l = lm, st.p = lpos, st.b = bt, st.f = final;
+		if (lm) final = 1, st.m = lbt, st.d = dm, st.n = dbt;
+	} while (!final);
+	return bt != buf.length && noBuf ? slc(buf, 0, bt) : buf.subarray(0, bt);
+};
+var et = /* @__PURE__ */ new u8(0);
+var gzs = function(d) {
+	if (d[0] != 31 || d[1] != 139 || d[2] != 8) err(6, "invalid gzip data");
+	var flg = d[3];
+	var st = 10;
+	if (flg & 4) st += (d[10] | d[11] << 8) + 2;
+	for (var zs = (flg >> 3 & 1) + (flg >> 4 & 1); zs > 0; zs -= !d[st++]);
+	return st + (flg & 2);
+};
+var gzl = function(d) {
+	var l = d.length;
+	return (d[l - 4] | d[l - 3] << 8 | d[l - 2] << 16 | d[l - 1] << 24) >>> 0;
+};
+/**
+* Expands GZIP data
+* @param data The data to decompress
+* @param opts The decompression options
+* @returns The decompressed version of the data
+*/
+function gunzipSync(data, opts) {
+	var st = gzs(data);
+	if (st + 8 > data.length) err(6, "invalid gzip data");
+	return inflt(data.subarray(st, -8), { i: 2 }, opts && opts.out || new u8(gzl(data)), opts && opts.dictionary);
+}
+var td = typeof TextDecoder != "undefined" && /* @__PURE__ */ new TextDecoder();
+try {
+	td.decode(et, { stream: true });
+} catch (e) {}
+//#endregion
+//#region src/utils/tileset-structure-uri.ts
+/** 从 tileset 取内嵌 structure 的 data URI（优先 MapTalks：`asset.extras.maptalks.structureUri`） */
+function getStructureDataUriFromTileset(root) {
+	if (!root) return null;
+	const maptalks = (root.asset?.extras)?.maptalks;
+	if (maptalks && typeof maptalks === "object") {
+		const uri = maptalks.structureUri;
+		if (typeof uri === "string" && uri.trim()) return uri.trim();
+	}
+	const legacy = root.structureUri;
+	if (typeof legacy === "string" && legacy.trim()) return legacy.trim();
+	return null;
+}
+function base64ToUint8Array(b64) {
+	const clean = b64.replace(/\s/g, "");
+	if (typeof globalThis.atob === "function") {
+		const bin = globalThis.atob(clean);
+		const out = new Uint8Array(bin.length);
+		for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
+		return out;
+	}
+	if (typeof Buffer !== "undefined") return new Uint8Array(Buffer.from(clean, "base64"));
+	throw new Error("[tileset-structure-uri] No base64 decoder available");
+}
+/**
+* 同步解析 `data:application/x-gzip;base64,...`：base64 → 二进制 → gunzip → UTF-8 文本。
+*/
+function decodeGzipBase64DataUriSync(dataUri) {
+	const comma = dataUri.indexOf(",");
+	if (comma < 0) throw new Error("[tileset-structure-uri] Invalid data URI: missing comma");
+	if (!dataUri.slice(0, comma).toLowerCase().includes("base64")) throw new Error("[tileset-structure-uri] Expected base64 data URI (e.g. data:application/x-gzip;base64,...)");
+	const raw = gunzipSync(base64ToUint8Array(dataUri.slice(comma + 1)));
+	return new TextDecoder("utf-8").decode(raw);
+}
+/**
+* 从已加载的根 tileset 读取内嵌 structure（`asset.extras.maptalks.structureUri`，
+* 若无则回退根级 `structureUri`），同步解码并解析。
+* - 无有效 URI 或解析失败时返回 `null`（不抛错）。
+*/
+function parseEmbeddedStructureDataFromTilesSync(tiles) {
+	const uri = getStructureDataUriFromTileset(tiles.rootTileset);
+	if (!uri) return null;
+	try {
+		const text = decodeGzipBase64DataUriSync(uri);
+		return JSON.parse(text);
+	} catch (e) {
+		console.warn("[GLTFParserPlugin] Failed to decode tileset structureUri:", e);
+		return null;
+	}
+}
+//#endregion
+//#region node_modules/.pnpm/3d-tiles-renderer@0.4.23_three@0.183.2/node_modules/3d-tiles-renderer/build/constants-D7SEibTb.js
 var N = 6378137;
 //#endregion
 //#region node_modules/.pnpm/three@0.183.2/node_modules/three/examples/jsm/postprocessing/Pass.js
@@ -700,22 +1268,22 @@ var FullScreenQuad = class {
 function q(a, e, t) {
 	return a && e in a ? a[e] : t;
 }
-function bn(a) {
+function An(a) {
 	return a !== "BOOLEAN" && a !== "STRING" && a !== "ENUM";
 }
-function Vi(a) {
+function qi(a) {
 	return /^FLOAT/.test(a);
 }
-function Ve(a) {
+function He(a) {
 	return /^VEC/.test(a);
 }
-function Fe(a) {
+function qe(a) {
 	return /^MAT/.test(a);
 }
-function _n(a, e, t, s = null) {
-	return Fe(t) || Ve(t) ? s.fromArray(a, e) : a[e];
+function In(a, e, t, s = null) {
+	return qe(t) || He(t) ? s.fromArray(a, e) : a[e];
 }
-function Vt(a) {
+function Gt(a) {
 	const { type: e, componentType: t } = a;
 	switch (e) {
 		case "SCALAR": return t === "INT64" ? 0n : 0;
@@ -730,7 +1298,7 @@ function Vt(a) {
 		case "ENUM": return 0;
 	}
 }
-function ys(a, e) {
+function Ts(a, e) {
 	if (e == null) return !1;
 	switch (a) {
 		case "SCALAR": return typeof e == "number" || typeof e == "bigint";
@@ -746,7 +1314,7 @@ function ys(a, e) {
 	}
 	throw new Error("ClassProperty: invalid type.");
 }
-function De(a, e = null) {
+function Fe(a, e = null) {
 	switch (a) {
 		case "INT8": return Int8Array;
 		case "INT16": return Int16Array;
@@ -765,16 +1333,16 @@ function De(a, e = null) {
 	}
 	throw new Error("ClassProperty: invalid type.");
 }
-function Fi(a, e = null) {
+function Wi(a, e = null) {
 	if (a.array) {
 		e = e && Array.isArray(e) ? e : [], e.length = a.count;
-		for (let s = 0, n = e.length; s < n; s++) e[s] = nt(a, e[s]);
-	} else e = nt(a, e);
+		for (let s = 0, n = e.length; s < n; s++) e[s] = at(a, e[s]);
+	} else e = at(a, e);
 	return e;
 }
-function nt(a, e = null) {
+function at(a, e = null) {
 	const t = a.default, s = a.type;
-	if (e = e || Vt(a), t === null) {
+	if (e = e || Gt(a), t === null) {
 		switch (s) {
 			case "SCALAR": return 0;
 			case "VEC2": return e.set(0, 0);
@@ -788,31 +1356,31 @@ function nt(a, e = null) {
 			case "ENUM": return "";
 		}
 		throw new Error("ClassProperty: invalid type.");
-	} else if (Fe(s)) e.fromArray(t);
-	else if (Ve(s)) e.fromArray(t);
+	} else if (qe(s)) e.fromArray(t);
+	else if (He(s)) e.fromArray(t);
 	else return t;
 }
-function ki(a, e) {
+function ji(a, e) {
 	if (a.noData === null) return e;
 	const t = a.noData, s = a.type;
 	if (Array.isArray(e)) for (let r = 0, o = e.length; r < o; r++) e[r] = n(e[r]);
 	else e = n(e);
 	return e;
 	function n(r) {
-		return i(r) && (r = nt(a, r)), r;
+		return i(r) && (r = at(a, r)), r;
 	}
 	function i(r) {
-		if (Fe(s)) {
+		if (qe(s)) {
 			const o = r.elements;
 			for (let l = 0, c = t.length; l < c; l++) if (t[l] !== o[l]) return !1;
 			return !0;
-		} else if (Ve(s)) {
+		} else if (He(s)) {
 			for (let o = 0, l = t.length; o < l; o++) if (t[o] !== r.getComponent(o)) return !1;
 			return !0;
 		} else return t === r;
 	}
 }
-function Gi(a, e) {
+function Xi(a, e) {
 	switch (a) {
 		case "INT8": return Math.max(e / 127, -1);
 		case "INT16": return Math.max(e, 32767, -1);
@@ -824,13 +1392,13 @@ function Gi(a, e) {
 		case "UINT64": return Number(e) / 0x10000000000000000;
 	}
 }
-function zi(a, e) {
+function Yi(a, e) {
 	const { type: t, componentType: s, scale: n, offset: i, normalized: r } = a;
 	if (Array.isArray(e)) for (let h = 0, d = e.length; h < d; h++) e[h] = o(e[h]);
 	else e = o(e);
 	return e;
 	function o(h) {
-		return Fe(t) ? h = c(h) : Ve(t) ? h = l(h) : h = u(h), h;
+		return qe(t) ? h = c(h) : He(t) ? h = l(h) : h = u(h), h;
 	}
 	function l(h) {
 		return h.x = u(h.x), h.y = u(h.y), "z" in h && (h.z = u(h.z)), "w" in h && (h.w = u(h.w)), h;
@@ -841,24 +1409,24 @@ function zi(a, e) {
 		return h;
 	}
 	function u(h) {
-		return r && (h = Gi(s, h)), (r || Vi(s)) && (h = h * n + i), h;
+		return r && (h = Xi(s, h)), (r || qi(s)) && (h = h * n + i), h;
 	}
 }
-function $t(a, e, t = null) {
+function Zt(a, e, t = null) {
 	if (a.array) {
 		Array.isArray(e) || (e = new Array(a.count || 0)), e.length = t !== null ? t : a.count;
-		for (let s = 0, n = e.length; s < n; s++) ys(a.type, e[s]) || (e[s] = Vt(a));
-	} else ys(a.type, e) || (e = Vt(a));
+		for (let s = 0, n = e.length; s < n; s++) Ts(a.type, e[s]) || (e[s] = Gt(a));
+	} else Ts(a.type, e) || (e = Gt(a));
 	return e;
 }
-function it(a, e) {
+function lt(a, e) {
 	for (const t in e) t in a || delete e[t];
 	for (const t in a) {
 		const s = a[t];
-		e[t] = $t(s, e[t]);
+		e[t] = Zt(s, e[t]);
 	}
 }
-function Hi(a) {
+function $i(a) {
 	switch (a) {
 		case "ENUM": return 1;
 		case "SCALAR": return 1;
@@ -873,21 +1441,21 @@ function Hi(a) {
 		default: return -1;
 	}
 }
-var ht = class {
+var mt = class {
 	constructor(e, t, s = null) {
 		this.name = t.name || null, this.description = t.description || null, this.type = t.type, this.componentType = t.componentType || null, this.enumType = t.enumType || null, this.array = t.array || !1, this.count = t.count || 0, this.normalized = t.normalized || !1, this.offset = t.offset || 0, this.scale = q(t, "scale", 1), this.max = q(t, "max", Infinity), this.min = q(t, "min", -Infinity), this.required = t.required || !1, this.noData = q(t, "noData", null), this.default = q(t, "default", null), this.semantic = q(t, "semantic", null), this.enumSet = null, this.accessorProperty = s, s && (this.offset = q(s, "offset", this.offset), this.scale = q(s, "scale", this.scale), this.max = q(s, "max", this.max), this.min = q(s, "min", this.min)), t.type === "ENUM" && (this.enumSet = e[this.enumType], this.componentType === null && (this.componentType = q(this.enumSet, "valueType", "UINT16")));
 	}
 	shapeToProperty(e, t = null) {
-		return $t(this, e, t);
+		return Zt(this, e, t);
 	}
 	resolveDefaultElement(e) {
-		return nt(this, e);
+		return at(this, e);
 	}
 	resolveDefault(e) {
-		return Fi(this, e);
+		return Wi(this, e);
 	}
 	resolveNoData(e) {
-		return ki(this, e);
+		return ji(this, e);
 	}
 	resolveEnumsToStrings(e) {
 		const t = this.enumSet;
@@ -900,10 +1468,10 @@ var ht = class {
 		}
 	}
 	adjustValueScaleOffset(e) {
-		return bn(this.type) ? zi(this, e) : e;
+		return An(this.type) ? Yi(this, e) : e;
 	}
 };
-var Qt = class {
+var Jt = class {
 	constructor(e, t = {}, s = {}, n = null) {
 		this.definition = e, this.class = t[e.class], this.className = e.class, this.enums = s, this.data = n, this.name = "name" in e ? e.name : null, this.properties = null;
 	}
@@ -914,24 +1482,24 @@ var Qt = class {
 		return !!this.definition.properties[e];
 	}
 	dispose() {}
-	_initProperties(e = ht) {
+	_initProperties(e = mt) {
 		const t = {};
 		for (const s in this.class.properties) t[s] = new e(this.enums, this.class.properties[s], this.definition.properties[s]);
 		this.properties = t;
 	}
 };
-var qi = class extends ht {
+var Qi = class extends mt {
 	constructor(e, t, s = null) {
 		super(e, t, s), this.attribute = (s == null ? void 0 : s.attribute) ?? null;
 	}
 };
-var Wi = class extends Qt {
+var Zi = class extends Jt {
 	constructor(...e) {
-		super(...e), this.isPropertyAttributeAccessor = !0, this._initProperties(qi);
+		super(...e), this.isPropertyAttributeAccessor = !0, this._initProperties(Qi);
 	}
 	getData(e, t, s = {}) {
 		const n = this.properties;
-		it(n, s);
+		lt(n, s);
 		for (const i in n) s[i] = this.getPropertyValue(i, e, t, s[i]);
 		return s;
 	}
@@ -943,23 +1511,23 @@ var Wi = class extends Qt {
 		} else throw new Error("PropertyAttributeAccessor: Requested class property does not exist.");
 		n = i.shapeToProperty(n);
 		const o = s.getAttribute(i.attribute.toLowerCase());
-		if (Fe(r)) {
+		if (qe(r)) {
 			const l = n.elements;
 			for (let c = 0, u = l.length; c < u;) l[c] = o.getComponent(t, c);
-		} else if (Ve(r)) n.fromBufferAttribute(o, t);
+		} else if (He(r)) n.fromBufferAttribute(o, t);
 		else if (r === "SCALAR" || r === "ENUM") n = o.getX(t);
 		else throw new Error("StructuredMetadata.PropertyAttributeAccessor: BOOLEAN and STRING types are not supported by property attributes.");
 		return n = i.adjustValueScaleOffset(n), n = i.resolveEnumsToStrings(n), n = i.resolveNoData(n), n;
 	}
 };
-var ji = class extends ht {
+var Ji = class extends mt {
 	constructor(e, t, s = null) {
-		super(e, t, s), this.values = (s == null ? void 0 : s.values) ?? null, this.valueLength = Hi(this.type), this.arrayOffsets = q(s, "arrayOffsets", null), this.stringOffsets = q(s, "stringOffsets", null), this.arrayOffsetType = q(s, "arrayOffsetType", "UINT32"), this.stringOffsetType = q(s, "stringOffsetType", "UINT32");
+		super(e, t, s), this.values = (s == null ? void 0 : s.values) ?? null, this.valueLength = $i(this.type), this.arrayOffsets = q(s, "arrayOffsets", null), this.stringOffsets = q(s, "stringOffsets", null), this.arrayOffsetType = q(s, "arrayOffsetType", "UINT32"), this.stringOffsetType = q(s, "stringOffsetType", "UINT32");
 	}
 	getArrayLengthFromId(e, t) {
 		let s = this.count;
 		if (this.arrayOffsets !== null) {
-			const { arrayOffsets: n, arrayOffsetType: i } = this, o = new (De(i))(e[n]);
+			const { arrayOffsets: n, arrayOffsetType: i } = this, o = new (Fe(i))(e[n]);
 			s = o[t + 1] - o[t];
 		}
 		return s;
@@ -968,29 +1536,29 @@ var ji = class extends ht {
 		let s = t;
 		if (this.arrayOffsets) {
 			const { arrayOffsets: n, arrayOffsetType: i } = this;
-			s = new (De(i))(e[n])[s];
+			s = new (Fe(i))(e[n])[s];
 		} else this.array && (s *= this.count);
 		return s;
 	}
 };
-var Yi = class extends Qt {
+var Ki = class extends Jt {
 	constructor(...e) {
-		super(...e), this.isPropertyTableAccessor = !0, this.count = this.definition.count, this._initProperties(ji);
+		super(...e), this.isPropertyTableAccessor = !0, this.count = this.definition.count, this._initProperties(Ji);
 	}
 	getData(e, t = {}) {
 		const s = this.properties;
-		it(s, t);
+		lt(s, t);
 		for (const n in s) t[n] = this.getPropertyValue(n, e, t[n]);
 		return t;
 	}
 	_readValueAtIndex(e, t, s, n = null) {
-		const i = this.properties[e], { componentType: r, type: o } = i, l = this.data, c = l[i.values], h = new (De(r, o))(c), d = i.getIndexOffsetFromId(l, t);
-		if (bn(o) || o === "ENUM") return _n(h, (d + s) * i.valueLength, o, n);
+		const i = this.properties[e], { componentType: r, type: o } = i, l = this.data, c = l[i.values], h = new (Fe(r, o))(c), d = i.getIndexOffsetFromId(l, t);
+		if (An(o) || o === "ENUM") return In(h, (d + s) * i.valueLength, o, n);
 		if (o === "STRING") {
 			let m = d + s, f = 0;
 			if (i.stringOffsets !== null) {
-				const { stringOffsets: g, stringOffsetType: y } = i, S = new (De(y))(l[g]);
-				f = S[m + 1] - S[m], m = S[m];
+				const { stringOffsets: g, stringOffsetType: y } = i, b = new (Fe(y))(l[g]);
+				f = b[m + 1] - b[m], m = b[m];
 			}
 			const p = new Uint8Array(h.buffer, m, f);
 			n = new TextDecoder().decode(p);
@@ -1012,8 +1580,8 @@ var Yi = class extends Qt {
 		return s = n.adjustValueScaleOffset(s), s = n.resolveEnumsToStrings(s), s = n.resolveNoData(s), s;
 	}
 };
-var ve = /* @__PURE__ */ new Box2();
-var xs = class {
+var Pe = /* @__PURE__ */ new Box2();
+var bs = class {
 	constructor() {
 		this._renderer = new WebGLRenderer(), this._target = new WebGLRenderTarget(1, 1), this._texTarget = new WebGLRenderTarget(), this._quad = new FullScreenQuad(new ShaderMaterial({
 			blending: CustomBlending,
@@ -1055,56 +1623,56 @@ var xs = class {
 	}
 	renderPixelToTarget(e, t, s) {
 		const { _renderer: n, _target: i } = this;
-		ve.min.copy(t), ve.max.copy(t), ve.max.x += 1, ve.max.y += 1, n.initRenderTarget(i), n.copyTextureToTexture(e, i.texture, ve, s, 0);
+		Pe.min.copy(t), Pe.max.copy(t), Pe.max.x += 1, Pe.max.y += 1, n.initRenderTarget(i), n.copyTextureToTexture(e, i.texture, Pe, s, 0);
 	}
 };
-var he = /* @__PURE__ */ new class {
+var de = /* @__PURE__ */ new class {
 	constructor() {
 		let a = null;
-		Object.getOwnPropertyNames(xs.prototype).forEach((e) => {
-			e !== "constructor" && (this[e] = (...t) => (a = a || new xs(), a[e](...t)));
+		Object.getOwnPropertyNames(bs.prototype).forEach((e) => {
+			e !== "constructor" && (this[e] = (...t) => (a = a || new bs(), a[e](...t)));
 		});
 	}
-}(), Ts = /* @__PURE__ */ new Vector2(), bs = /* @__PURE__ */ new Vector2(), _s = /* @__PURE__ */ new Vector2();
-function Xi(a, e) {
+}(), _s = /* @__PURE__ */ new Vector2(), Ss = /* @__PURE__ */ new Vector2(), Ms = /* @__PURE__ */ new Vector2();
+function er(a, e) {
 	return e === 0 ? a.getAttribute("uv") : a.getAttribute(`uv${e}`);
 }
-function Sn(a, e, t = new Array(3)) {
+function vn(a, e, t = new Array(3)) {
 	let s = 3 * e, n = 3 * e + 1, i = 3 * e + 2;
 	return a.index && (s = a.index.getX(s), n = a.index.getX(n), i = a.index.getX(i)), t[0] = s, t[1] = n, t[2] = i, t;
 }
-function Mn(a, e, t, s, n) {
-	const [i, r, o] = s, l = Xi(a, e);
-	Ts.fromBufferAttribute(l, i), bs.fromBufferAttribute(l, r), _s.fromBufferAttribute(l, o), n.set(0, 0, 0).addScaledVector(Ts, t.x).addScaledVector(bs, t.y).addScaledVector(_s, t.z);
+function Ln(a, e, t, s, n) {
+	const [i, r, o] = s, l = er(a, e);
+	_s.fromBufferAttribute(l, i), Ss.fromBufferAttribute(l, r), Ms.fromBufferAttribute(l, o), n.set(0, 0, 0).addScaledVector(_s, t.x).addScaledVector(Ss, t.y).addScaledVector(Ms, t.z);
 }
-function Cn(a, e, t, s) {
+function En(a, e, t, s) {
 	const n = a.x - Math.floor(a.x), i = a.y - Math.floor(a.y), r = Math.floor(n * e % e), o = Math.floor(i * t % t);
 	return s.set(r, o), s;
 }
-var Ss = /* @__PURE__ */ new Vector2(), Ms = /* @__PURE__ */ new Vector2(), Cs = /* @__PURE__ */ new Vector2();
-var $i = class extends ht {
+var Cs = /* @__PURE__ */ new Vector2(), As = /* @__PURE__ */ new Vector2(), Is = /* @__PURE__ */ new Vector2();
+var tr = class extends mt {
 	constructor(e, t, s = null) {
 		super(e, t, s), this.channels = q(s, "channels", [0]), this.index = q(s, "index", null), this.texCoord = q(s, "texCoord", null), this.valueLength = parseInt(this.type.replace(/[^0-9]/g, "")) || 1;
 	}
 	readDataFromBuffer(e, t, s = null) {
 		const n = this.type;
 		if (n === "BOOLEAN" || n === "STRING") throw new Error("PropertyTextureAccessor: BOOLEAN and STRING types not supported.");
-		return _n(e, t * this.valueLength, n, s);
+		return In(e, t * this.valueLength, n, s);
 	}
 };
-var Qi = class extends Qt {
+var sr = class extends Jt {
 	constructor(...e) {
-		super(...e), this.isPropertyTextureAccessor = !0, this._asyncRead = !1, this._initProperties($i);
+		super(...e), this.isPropertyTextureAccessor = !0, this._asyncRead = !1, this._initProperties(tr);
 	}
 	getData(e, t, s, n = {}) {
 		const i = this.properties;
-		it(i, n);
+		lt(i, n);
 		const r = Object.keys(i), o = r.map((l) => n[l]);
 		return this.getPropertyValuesAtTexel(r, e, t, s, o), r.forEach((l, c) => n[l] = o[c]), n;
 	}
 	async getDataAsync(e, t, s, n = {}) {
 		const i = this.properties;
-		it(i, n);
+		lt(i, n);
 		const r = Object.keys(i), o = r.map((l) => n[l]);
 		return await this.getPropertyValuesAtTexelAsync(r, e, t, s, o), r.forEach((l, c) => n[l] = o[c]), n;
 	}
@@ -1115,30 +1683,30 @@ var Qi = class extends Qt {
 	}
 	getPropertyValuesAtTexel(e, t, s, n, i = []) {
 		for (; i.length < e.length;) i.push(null);
-		i.length = e.length, he.increaseSizeTo(i.length);
-		const r = this.data, o = this.definition.properties, l = this.properties, c = Sn(n, t);
+		i.length = e.length, de.increaseSizeTo(i.length);
+		const r = this.data, o = this.definition.properties, l = this.properties, c = vn(n, t);
 		for (let d = 0, m = e.length; d < m; d++) {
 			const f = e[d];
 			if (!o[f]) continue;
 			const p = l[f], g = r[p.index];
-			Mn(n, p.texCoord, s, c, Ss), Cn(Ss, g.image.width, g.image.height, Ms), Cs.set(d, 0), he.renderPixelToTarget(g, Ms, Cs);
+			Ln(n, p.texCoord, s, c, Cs), En(Cs, g.image.width, g.image.height, As), Is.set(d, 0), de.renderPixelToTarget(g, As, Is);
 		}
 		const u = new Uint8Array(e.length * 4);
-		if (this._asyncRead) return he.readDataAsync(u).then(() => (h.call(this), i));
-		return he.readData(u), h.call(this), i;
+		if (this._asyncRead) return de.readDataAsync(u).then(() => (h.call(this), i));
+		return de.readData(u), h.call(this), i;
 		function h() {
 			for (let d = 0, m = e.length; d < m; d++) {
 				const f = e[d], p = l[f], g = p.type;
-				if (i[d] = $t(p, i[d]), p) {
+				if (i[d] = Zt(p, i[d]), p) {
 					if (!o[f]) {
 						i[d] = p.resolveDefault(i);
 						continue;
 					}
 				} else throw new Error("PropertyTextureAccessor: Requested property does not exist.");
-				const y = p.valueLength * (p.count || 1), x = p.channels.map((_) => u[4 * d + _]), S = p.componentType, M = new (De(S, g))(y);
+				const y = p.valueLength * (p.count || 1), x = p.channels.map((S) => u[4 * d + S]), b = p.componentType, M = new (Fe(b, g))(y);
 				if (new Uint8Array(M.buffer).set(x), p.array) {
-					const _ = i[d];
-					for (let C = 0, v = _.length; C < v; C++) _[C] = p.readDataFromBuffer(M, C, _[C]);
+					const S = i[d];
+					for (let C = 0, v = S.length; C < v; C++) S[C] = p.readDataFromBuffer(M, C, S[C]);
 				} else i[d] = p.readDataFromBuffer(M, 0, i[d]);
 				i[d] = p.adjustValueScaleOffset(i[d]), i[d] = p.resolveEnumsToStrings(i[d]), i[d] = p.resolveNoData(i[d]);
 			}
@@ -1150,25 +1718,37 @@ var Qi = class extends Qt {
 		});
 	}
 };
-var As = class {
+var vs = class {
 	constructor(e, t, s, n = null, i = null) {
-		const { schema: r, propertyTables: o = [], propertyTextures: l = [], propertyAttributes: c = [] } = e, { enums: u, classes: h } = r, d = o.map((p) => new Yi(p, h, u, s));
+		const { schema: r, propertyTables: o = [], propertyTextures: l = [], propertyAttributes: c = [] } = e, { enums: u, classes: h } = r, d = o.map((p) => new Ki(p, h, u, s));
 		let m = [], f = [];
-		n && (n.propertyTextures && (m = n.propertyTextures.map((p) => new Qi(l[p], h, u, t))), n.propertyAttributes && (f = n.propertyAttributes.map((p) => new Wi(c[p], h, u)))), this.schema = r, this.tableAccessors = d, this.textureAccessors = m, this.attributeAccessors = f, this.object = i, this.textures = t, this.nodeMetadata = n;
+		n && (n.propertyTextures && (m = n.propertyTextures.map((p) => new sr(l[p], h, u, t))), n.propertyAttributes && (f = n.propertyAttributes.map((p) => new Zi(c[p], h, u)))), this.schema = r, this.tableAccessors = d, this.textureAccessors = m, this.attributeAccessors = f, this.object = i, this.textures = t, this.nodeMetadata = n;
 	}
+	/**
+	* Returns data from one or more property tables. Pass a single table index and row ID to
+	* get one object, or parallel arrays of table indices and row IDs to get an array of
+	* results. Each returned object conforms to the structure class referenced in the schema.
+	* @param {number|Array<number>} tableIndices Table index or array of table indices.
+	* @param {number|Array<number>} ids Row ID or array of row IDs.
+	* @param {Object|Array|null} [target=null] Optional target object or array to write into.
+	* @returns {Object|Array}
+	*/
 	getPropertyTableData(e, t, s = null) {
 		if (!Array.isArray(e) || !Array.isArray(t)) s = s || {}, s = this.tableAccessors[e].getData(t, s);
 		else {
 			s = s || [];
 			const n = Math.min(e.length, t.length);
 			s.length = n;
-			for (let i = 0; i < n; i++) {
-				const r = this.tableAccessors[e[i]];
-				s[i] = r.getData(t[i], s[i]);
-			}
+			for (let i = 0; i < n; i++) s[i] = this.tableAccessors[e[i]].getData(t[i], s[i]);
 		}
 		return s;
 	}
+	/**
+	* Returns name and class information for one or more property tables. Defaults to all
+	* tables when `tableIndices` is `null`.
+	* @param {Array<number>|null} [tableIndices=null]
+	* @returns {Array<{name: string, className: string}>|{name: string, className: string}}
+	*/
 	getPropertyTableInfo(e = null) {
 		if (e === null && (e = this.tableAccessors.map((t, s) => s)), Array.isArray(e)) return e.map((t) => {
 			const s = this.tableAccessors[t];
@@ -1185,12 +1765,29 @@ var As = class {
 			};
 		}
 	}
+	/**
+	* Returns data from property textures at the given point on the mesh. Takes the triangle
+	* index and barycentric coordinate from a raycast result. See `MeshFeatures.getFeatures`
+	* for how to obtain these values.
+	* @param {number} triangle Triangle index from a raycast hit.
+	* @param {Vector3} barycoord Barycentric coordinate of the hit point.
+	* @param {Array} [target=[]] Optional target array to write into.
+	* @returns {Array}
+	*/
 	getPropertyTextureData(e, t, s = []) {
 		const n = this.textureAccessors;
 		s.length = n.length;
 		for (let i = 0; i < n.length; i++) s[i] = n[i].getData(e, t, this.object.geometry, s[i]);
 		return s;
 	}
+	/**
+	* Returns the same data as `getPropertyTextureData` but performs texture reads
+	* asynchronously.
+	* @param {number} triangle Triangle index from a raycast hit.
+	* @param {Vector3} barycoord Barycentric coordinate of the hit point.
+	* @param {Array} [target=[]] Optional target array to write into.
+	* @returns {Promise<Array>}
+	*/
 	async getPropertyTextureDataAsync(e, t, s = []) {
 		const n = this.textureAccessors;
 		s.length = n.length;
@@ -1203,30 +1800,48 @@ var As = class {
 		}
 		return await Promise.all(i), s;
 	}
+	/**
+	* Returns information about the property texture accessors, including their class names
+	* and per-property channel/texcoord mappings.
+	* @returns {Array<{name: string, className: string, properties: Object}>}
+	*/
 	getPropertyTextureInfo() {
 		return this.textureAccessors;
 	}
+	/**
+	* Returns data stored as property attributes for the given vertex index.
+	* @param {number} attributeIndex Vertex index.
+	* @param {Array} [target=[]] Optional target array to write into.
+	* @returns {Array}
+	*/
 	getPropertyAttributeData(e, t = []) {
 		const s = this.attributeAccessors;
 		t.length = s.length;
 		for (let n = 0; n < s.length; n++) t[n] = s[n].getData(e, this.object.geometry, t[n]);
 		return t;
 	}
+	/**
+	* Returns name and class information for all property attribute accessors.
+	* @returns {Array<{name: string, className: string}>}
+	*/
 	getPropertyAttributeInfo() {
 		return this.attributeAccessors.map((e) => ({
 			name: e.name,
 			className: e.definition.class
 		}));
 	}
+	/**
+	* Disposes all texture, table, and attribute accessors.
+	*/
 	dispose() {
 		this.textureAccessors.forEach((e) => e.dispose()), this.tableAccessors.forEach((e) => e.dispose()), this.attributeAccessors.forEach((e) => e.dispose());
 	}
 };
-var Is = /* @__PURE__ */ new Vector2(), vs = /* @__PURE__ */ new Vector2(), Ls = /* @__PURE__ */ new Vector2();
-function er(a) {
+var Ls = /* @__PURE__ */ new Vector2(), Es = /* @__PURE__ */ new Vector2(), ws = /* @__PURE__ */ new Vector2();
+function or(a) {
 	return a.x > a.y && a.x > a.z ? 0 : a.y > a.z ? 1 : 2;
 }
-var tr = class {
+var ar = class {
 	constructor(e, t, s) {
 		this.geometry = e, this.textures = t, this.data = s, this._asyncRead = !1, this.featureIds = s.featureIds.map((n) => {
 			const { texture: i, ...r } = n, o = {
@@ -1242,26 +1857,48 @@ var tr = class {
 			}), o;
 		});
 	}
+	/**
+	* Returns an indexed list of all textures used by features in the extension.
+	* @returns {Array<Texture>}
+	*/
 	getTextures() {
 		return this.textures;
 	}
+	/**
+	* Returns the feature ID info for each feature set defined on this primitive.
+	* @returns {Array<FeatureInfo>}
+	*/
 	getFeatureInfo() {
 		return this.featureIds;
 	}
+	/**
+	* Performs the same function as `getFeatures` but reads texture data asynchronously.
+	* @param {number} triangle Triangle index from a raycast hit.
+	* @param {Vector3} barycoord Barycentric coordinate of the hit point.
+	* @returns {Promise<Array<number|null>>}
+	*/
 	getFeaturesAsync(...e) {
 		this._asyncRead = !0;
 		const t = this.getFeatures(...e);
 		return this._asyncRead = !1, t;
 	}
+	/**
+	* Returns the list of feature IDs at the given point on the mesh. Takes the triangle
+	* index from a raycast result and a barycentric coordinate. Results are indexed in the
+	* same order as the feature info returned by `getFeatureInfo()`.
+	* @param {number} triangle Triangle index from a raycast hit.
+	* @param {Vector3} barycoord Barycentric coordinate of the hit point.
+	* @returns {Array<number|null>}
+	*/
 	getFeatures(e, t) {
 		const { geometry: s, textures: n, featureIds: i } = this, r = new Array(i.length).fill(null), o = i.length;
-		he.increaseSizeTo(o);
-		const l = Sn(s, e), c = l[er(t)];
+		de.increaseSizeTo(o);
+		const l = vn(s, e), c = l[or(t)];
 		for (let d = 0, m = i.length; d < m; d++) {
 			const f = i[d], p = "nullFeatureId" in f ? f.nullFeatureId : null;
 			if ("texture" in f) {
 				const g = n[f.texture.index];
-				Mn(s, f.texture.texCoord, t, l, Is), Cn(Is, g.image.width, g.image.height, vs), Ls.set(d, 0), he.renderPixelToTarget(n[f.texture.index], vs, Ls);
+				Ln(s, f.texture.texCoord, t, l, Ls), En(Ls, g.image.width, g.image.height, Es), ws.set(d, 0), de.renderPixelToTarget(n[f.texture.index], Es, ws);
 			} else if ("attribute" in f) {
 				const y = s.getAttribute(`_feature_id_${f.attribute}`).getX(c);
 				y !== p && (r[d] = y);
@@ -1271,8 +1908,8 @@ var tr = class {
 			}
 		}
 		const u = new Uint8Array(o * 4);
-		if (this._asyncRead) return he.readDataAsync(u).then(() => (h(), r));
-		return he.readData(u), h(), r;
+		if (this._asyncRead) return de.readDataAsync(u).then(() => (h(), r));
+		return de.readData(u), h(), r;
 		function h() {
 			const d = new Uint32Array(1);
 			for (let m = 0, f = i.length; m < f; m++) {
@@ -1280,12 +1917,15 @@ var tr = class {
 				if ("texture" in p) {
 					const { channels: y } = p.texture, x = y.map((T) => u[4 * m + T]);
 					new Uint8Array(d.buffer).set(x);
-					const S = d[0];
-					S !== g && (r[m] = S);
+					const b = d[0];
+					b !== g && (r[m] = b);
 				}
 			}
 		}
 	}
+	/**
+	* Disposes all textures used by this instance.
+	*/
 	dispose() {
 		this.textures.forEach((e) => {
 			e && (e.dispose(), e.image instanceof ImageBitmap && e.image.close());
@@ -1293,13 +1933,13 @@ var tr = class {
 	}
 };
 new FullScreenQuad(new MeshBasicMaterial());
-var Ft = new DataTexture(new Uint8Array([
+var zt = new DataTexture(new Uint8Array([
 	255,
 	255,
 	255,
 	255
 ]), 1, 1);
-Ft.needsUpdate = !0;
+zt.needsUpdate = !0;
 Object.freeze({
 	NONE: 0,
 	SCREEN_ERROR: 1,
@@ -1472,7 +2112,7 @@ var GLTFWorkerLoader = class extends Loader {
 		if (hasStructuralMetadata && data.structuralMetadata) {
 			const rootExtension = data.json?.extensions?.[EXT_STRUCTURAL_METADATA];
 			if (rootExtension) {
-				rootMetadata = new As({
+				rootMetadata = new vs({
 					schema: data.structuralMetadata.schema,
 					propertyTables: data.structuralMetadata.propertyTables || [],
 					propertyTextures: rootExtension.propertyTextures || [],
@@ -1495,7 +2135,7 @@ var GLTFWorkerLoader = class extends Loader {
 				const primMetadataExt = extensions?.[EXT_STRUCTURAL_METADATA];
 				if (primMetadataExt) {
 					const rootExtension = data.json?.extensions?.[EXT_STRUCTURAL_METADATA];
-					if (rootExtension) child.userData.structuralMetadata = new As({
+					if (rootExtension) child.userData.structuralMetadata = new vs({
 						schema: data.structuralMetadata.schema,
 						propertyTables: data.structuralMetadata.propertyTables || [],
 						propertyTextures: rootExtension.propertyTextures || [],
@@ -1505,17 +2145,13 @@ var GLTFWorkerLoader = class extends Loader {
 			}
 			if (hasMeshFeatures) {
 				const meshFeaturesExt = extensions?.[EXT_MESH_FEATURES];
-				if (meshFeaturesExt) child.userData.meshFeatures = new tr(child.geometry, textures, meshFeaturesExt);
+				if (meshFeaturesExt) child.userData.meshFeatures = new ar(child.geometry, textures, meshFeaturesExt);
 			}
 		});
 	}
 };
 //#endregion
 //#region src/plugin/PartColorHelper.ts
-function ensureColor$1(color) {
-	if (color instanceof Color) return color;
-	return new Color(color);
-}
 function getMaterials(mesh) {
 	const mat = mesh.material;
 	if (!mat) return [];
@@ -1533,7 +2169,7 @@ function getMaterialForColor(color) {
 }
 var materialCache = /* @__PURE__ */ new Map();
 /**
-* 构件着色/透明度辅助器，参考 example 逻辑：hideByOids -> 修改材质 -> scene.add -> mesh-change 监听
+* 构件着色/透明度辅助器，参考 example 逻辑：hidePartsByOids -> 修改材质 -> scene.add -> mesh-change 监听
 * 由 GLTFParserPlugin 内部使用，scene 通过 tiles.group 获取
 */
 var PartColorHelper = class {
@@ -1573,7 +2209,7 @@ var PartColorHelper = class {
 	setPartColorByOids(oids, color) {
 		const scene = this.context.getScene();
 		if (!scene) return;
-		const material = getMaterialForColor(ensureColor$1(color));
+		const material = getMaterialForColor(toColor(color));
 		for (const oid of oids) {
 			this.coloredOids.add(oid);
 			this.materialByOid.set(oid, material);
@@ -1589,7 +2225,7 @@ var PartColorHelper = class {
 				collector.addEventListener("mesh-change", handler);
 			}
 		}
-		this.context.hideByOids(this.getAllModifiedOids());
+		this.context.hidePartsByOids(this.getAllModifiedOids());
 	}
 	/**
 	* 恢复指定构件的颜色
@@ -1624,7 +2260,7 @@ var PartColorHelper = class {
 				}
 			}
 		}
-		this.context.unhideByOids(oids);
+		this.context.showPartsByOids(oids);
 	}
 	/**
 	* 根据 oid 数组设置构件透明度
@@ -1662,7 +2298,7 @@ var PartColorHelper = class {
 				collector.addEventListener("mesh-change", handler);
 			}
 		}
-		this.context.hideByOids(this.getAllModifiedOids());
+		this.context.hidePartsByOids(this.getAllModifiedOids());
 	}
 	/**
 	* 恢复指定构件的透明度
@@ -1694,18 +2330,14 @@ var PartColorHelper = class {
 				}
 			}
 		}
-		this.context.unhideByOids(oids);
+		this.context.showPartsByOids(oids);
 	}
 };
 //#endregion
 //#region src/plugin/PartBlinkHelper.ts
-function ensureColor(color) {
-	if (color instanceof Color) return color;
-	return new Color(color);
-}
 /**
 * 构件闪烁强调辅助器
-* 通过 hideByOids + split mesh + emissive 动画实现闪烁效果
+* 通过 hidePartsByOids + split mesh + emissive 动画实现闪烁效果
 */
 var PartBlinkHelper = class {
 	blinkOids = /* @__PURE__ */ new Set();
@@ -1778,7 +2410,7 @@ var PartBlinkHelper = class {
 			this.meshChangeHandlers.set(oid, handler);
 			collector.addEventListener("mesh-change", handler);
 		}
-		this.context.hideByOids(Array.from(this.blinkOids));
+		this.context.hidePartsByOids(Array.from(this.blinkOids));
 		if (this.blinkOids.size > 0) this.startAnimation();
 	}
 	/**
@@ -1786,7 +2418,7 @@ var PartBlinkHelper = class {
 	* @param color 颜色值，支持 hex 数字、颜色字符串（如 "#ff0000"）、THREE.Color 对象
 	*/
 	setBlinkColor(color) {
-		const c = ensureColor(color);
+		const c = toColor(color);
 		this.blinkColor.copy(c);
 		this.blinkMaterial.color.copy(c);
 		this.blinkMaterial.emissive.copy(c);
@@ -1823,7 +2455,7 @@ var PartBlinkHelper = class {
 			}
 		}
 		this.blinkOids.clear();
-		this.context.unhideByOids(oidsToUnhide);
+		this.context.showPartsByOids(oidsToUnhide);
 	}
 	dispose() {
 		this.clearAllBlinkParts();
@@ -1833,41 +2465,54 @@ var PartBlinkHelper = class {
 //#region src/plugin/PartFrameHelper.ts
 /**
 * 构件线框显示辅助器
-* 通过 hideByOids + split mesh + 填充材质 + EdgesGeometry 实现线框效果
+* 通过 hidePartsByOids + split mesh + 填充材质 + EdgesGeometry 实现线框效果
 */
+var DEFAULT_FRAME_COLOR = 54442;
 var PartFrameHelper = class {
 	frameOids = /* @__PURE__ */ new Set();
 	originalMaterialByMesh = /* @__PURE__ */ new Map();
 	frameDataByOid = /* @__PURE__ */ new Map();
 	meshChangeHandlers = /* @__PURE__ */ new Map();
-	fillMaterial;
-	edgeMaterial;
+	fillColorByOid = /* @__PURE__ */ new Map();
+	edgeColorByOid = /* @__PURE__ */ new Map();
+	fillMaterialCache = /* @__PURE__ */ new Map();
+	edgeMaterialCache = /* @__PURE__ */ new Map();
 	edgeThreshold;
 	constructor(context) {
 		this.context = context;
-		this.fillMaterial = new MeshBasicMaterial({
-			color: 54442,
+		this.edgeThreshold = 15;
+	}
+	getFillMaterial(hex) {
+		if (!this.fillMaterialCache.has(hex)) this.fillMaterialCache.set(hex, new MeshBasicMaterial({
+			color: hex,
 			transparent: true,
 			opacity: .3,
 			side: DoubleSide,
 			depthWrite: false
-		});
-		this.edgeMaterial = new MeshBasicMaterial({
-			color: 54442,
+		}));
+		return this.fillMaterialCache.get(hex);
+	}
+	getEdgeMaterial(hex) {
+		if (!this.edgeMaterialCache.has(hex)) this.edgeMaterialCache.set(hex, new MeshBasicMaterial({
+			color: hex,
 			transparent: true,
 			opacity: .8
-		});
-		this.edgeThreshold = 15;
+		}));
+		return this.edgeMaterialCache.get(hex);
 	}
-	createWireframeForMeshes(meshes, scene) {
+	createWireframeForMeshes(meshes, scene, oid) {
+		const fillHex = this.fillColorByOid.get(oid) ?? DEFAULT_FRAME_COLOR;
+		const edgeHex = this.edgeColorByOid.get(oid) ?? DEFAULT_FRAME_COLOR;
+		const fillMaterial = this.getFillMaterial(fillHex);
+		const edgeMaterial = this.getEdgeMaterial(edgeHex);
 		const frameMeshes = [];
 		const lines = [];
 		for (const mesh of meshes) {
 			if (!this.originalMaterialByMesh.has(mesh.uuid)) this.originalMaterialByMesh.set(mesh.uuid, mesh.material);
-			mesh.material = this.fillMaterial;
+			mesh.material = fillMaterial;
 			scene.add(mesh);
 			frameMeshes.push(mesh);
-			const line = new LineSegments(new EdgesGeometry(mesh.geometry, this.edgeThreshold), this.edgeMaterial);
+			const line = new LineSegments(new EdgesGeometry(mesh.geometry, this.edgeThreshold), edgeMaterial);
 			line.matrix.copy(mesh.matrixWorld);
 			line.matrixAutoUpdate = false;
 			scene.add(line);
@@ -1898,7 +2543,7 @@ var PartFrameHelper = class {
 		const collector = this.context.getMeshCollectorByOid(oid);
 		const oldData = this.frameDataByOid.get(oid);
 		if (oldData) this.removeFrameData(oldData, scene);
-		const newData = this.createWireframeForMeshes(collector.meshes, scene);
+		const newData = this.createWireframeForMeshes(collector.meshes, scene, oid);
 		this.frameDataByOid.set(oid, newData);
 	}
 	/**
@@ -1912,13 +2557,13 @@ var PartFrameHelper = class {
 		for (const oid of oids) {
 			this.frameOids.add(oid);
 			const collector = this.context.getMeshCollectorByOid(oid);
-			const data = this.createWireframeForMeshes(collector.meshes, scene);
+			const data = this.createWireframeForMeshes(collector.meshes, scene, oid);
 			this.frameDataByOid.set(oid, data);
 			const handler = () => this.applyFrameToOid(oid);
 			this.meshChangeHandlers.set(oid, handler);
 			collector.addEventListener("mesh-change", handler);
 		}
-		this.context.hideByOids(Array.from(this.frameOids));
+		this.context.hidePartsByOids(Array.from(this.frameOids));
 	}
 	/**
 	* 清除所有线框显示构件
@@ -1940,20 +2585,484 @@ var PartFrameHelper = class {
 			}
 		}
 		this.frameOids.clear();
-		this.context.unhideByOids(oidsToUnhide);
+		this.fillColorByOid.clear();
+		this.edgeColorByOid.clear();
+		this.context.showPartsByOids(oidsToUnhide);
+	}
+	/**
+	* 设置指定构件的线框填充颜色
+	* @param oids 构件 OID 数组
+	* @param color 颜色值，支持 hex 数字、颜色字符串（如 "#ff0000"）、THREE.Color 对象
+	*/
+	setFrameFillColor(oids, color) {
+		const hex = toColor(color).getHex();
+		for (const oid of oids) {
+			if (!this.frameOids.has(oid)) continue;
+			this.fillColorByOid.set(oid, hex);
+			this.applyFrameToOid(oid);
+		}
+	}
+	/**
+	* 设置指定构件的线框边框颜色
+	* @param oids 构件 OID 数组
+	* @param color 颜色值，支持 hex 数字、颜色字符串（如 "#ff0000"）、THREE.Color 对象
+	*/
+	setFrameEdgeColor(oids, color) {
+		const hex = toColor(color).getHex();
+		for (const oid of oids) {
+			if (!this.frameOids.has(oid)) continue;
+			this.edgeColorByOid.set(oid, hex);
+			this.applyFrameToOid(oid);
+		}
 	}
 	dispose() {
 		this.clearAllFrameParts();
+		this.fillMaterialCache.forEach((m) => m.dispose());
+		this.fillMaterialCache.clear();
+		this.edgeMaterialCache.forEach((m) => m.dispose());
+		this.edgeMaterialCache.clear();
+	}
+};
+//#endregion
+//#region src/plugin/style-appearance-shared.ts
+function vec3Key(v) {
+	if (v === void 0) return "";
+	if (Array.isArray(v)) return `${v[0] ?? 0},${v[1] ?? 0},${v[2] ?? 0}`;
+	const p = v;
+	return `${p.x},${p.y},${p.z}`;
+}
+function eulerKey(r) {
+	if (r === void 0) return "";
+	if (Array.isArray(r)) return `${r[0] ?? 0},${r[1] ?? 0},${r[2] ?? 0},${r.length >= 4 && typeof r[3] === "string" ? r[3] : "XYZ"}`;
+	const e = r;
+	return `${e.x},${e.y},${e.z},${e.order}`;
+}
+function applyVec3(target, input) {
+	if (Array.isArray(input)) target.set(input[0] ?? 0, input[1] ?? 0, input[2] ?? 0);
+	else target.copy(input);
+}
+function applyEuler(target, input) {
+	if (Array.isArray(input)) if (input.length >= 4 && typeof input[3] === "string") target.set(input[0] ?? 0, input[1] ?? 0, input[2] ?? 0, input[3]);
+	else target.set(input[0] ?? 0, input[1] ?? 0, input[2] ?? 0, "XYZ");
+	else target.copy(input);
+}
+function appearanceGroupKey(a) {
+	return `${a.material.uuid}|${vec3Key(a.translation)}|${vec3Key(a.scale)}|${eulerKey(a.rotation)}|${vec3Key(a.origin)}`;
+}
+function buildPivotStyleMatrix(pivot, sx, sy, sz, euler) {
+	const m = new Matrix4().makeTranslation(-pivot.x, -pivot.y, -pivot.z);
+	m.premultiply(new Matrix4().makeScale(sx, sy, sz));
+	m.premultiply(new Matrix4().makeRotationFromEuler(euler));
+	m.premultiply(new Matrix4().makeTranslation(pivot.x, pivot.y, pivot.z));
+	return m;
+}
+function resolveConditionsAppearance(conditions, propertyData) {
+	if (!conditions?.length) return null;
+	for (const [cond, value] of conditions) if (evaluateStyleCondition(cond, propertyData)) return value;
+	return null;
+}
+function resolveStyleAppearance(conditions, propertyData) {
+	return resolveConditionsAppearance(conditions, propertyData);
+}
+/** 与 setStyle 相同的 OID 分组逻辑（show + conditions → 外观分组 + 被 show 隐藏的 OID） */
+function buildAppearanceGroupsFromPropertyMap(propertyByOid, config) {
+	const hiddenOidsList = [];
+	const groups = /* @__PURE__ */ new Map();
+	const conditions = config.conditions ?? [];
+	for (const [oid, propertyData] of propertyByOid) {
+		if (propertyData == null) continue;
+		if (config.show) {
+			if (!evaluateStyleCondition(config.show, propertyData)) {
+				hiddenOidsList.push(oid);
+				continue;
+			}
+		}
+		const appearance = resolveStyleAppearance(conditions, propertyData);
+		if (!appearance) continue;
+		const gkey = appearanceGroupKey(appearance);
+		let g = groups.get(gkey);
+		if (!g) {
+			g = {
+				appearance,
+				oids: []
+			};
+			groups.set(gkey, g);
+		}
+		g.oids.push(oid);
+	}
+	return {
+		hiddenOidsList,
+		groups
+	};
+}
+function restoreMeshAppearanceMaps(mesh, maps) {
+	const original = maps.originalMaterialByMesh.get(mesh.uuid);
+	if (original) {
+		mesh.material = original;
+		maps.originalMaterialByMesh.delete(mesh.uuid);
+	}
+	const origT = maps.originalTransformByMesh.get(mesh.uuid);
+	if (origT) {
+		mesh.position.copy(origT.position);
+		mesh.scale.copy(origT.scale);
+		mesh.rotation.copy(origT.rotation);
+		maps.originalTransformByMesh.delete(mesh.uuid);
+	}
+}
+/**
+* 将 StyleAppearance 应用到 mesh（与 StyleHelper.applyAppearanceToCollector 一致）
+*/
+function applyStyleAppearanceToMesh(mesh, appearance, scene, maps) {
+	if (!maps.originalMaterialByMesh.has(mesh.uuid)) maps.originalMaterialByMesh.set(mesh.uuid, mesh.material);
+	mesh.material = appearance.material;
+	if (appearance.translation !== void 0 || appearance.scale !== void 0 || appearance.rotation !== void 0) {
+		if (!maps.originalTransformByMesh.has(mesh.uuid)) maps.originalTransformByMesh.set(mesh.uuid, {
+			position: mesh.position.clone(),
+			scale: mesh.scale.clone(),
+			rotation: mesh.rotation.clone()
+		});
+		const bt = maps.originalTransformByMesh.get(mesh.uuid);
+		mesh.position.copy(bt.position);
+		mesh.scale.copy(bt.scale);
+		mesh.rotation.copy(bt.rotation);
+		if (appearance.scale !== void 0 || appearance.rotation !== void 0) {
+			const pivot = new Vector3();
+			if (appearance.origin !== void 0) applyVec3(pivot, appearance.origin);
+			else pivot.set(0, 0, 0);
+			let sx = 1;
+			let sy = 1;
+			let sz = 1;
+			if (appearance.scale !== void 0) if (Array.isArray(appearance.scale)) {
+				sx = appearance.scale[0] ?? 1;
+				sy = appearance.scale[1] ?? 1;
+				sz = appearance.scale[2] ?? 1;
+			} else {
+				const sc = appearance.scale;
+				sx = sc.x;
+				sy = sc.y;
+				sz = sc.z;
+			}
+			const euler = new Euler();
+			if (appearance.rotation !== void 0) applyEuler(euler, appearance.rotation);
+			else euler.set(0, 0, 0);
+			const styleM = buildPivotStyleMatrix(pivot, sx, sy, sz, euler);
+			mesh.updateMatrix();
+			mesh.matrix.multiply(styleM);
+			mesh.matrix.decompose(mesh.position, mesh.quaternion, mesh.scale);
+		}
+		if (appearance.translation !== void 0) applyVec3(mesh.position, appearance.translation);
+	}
+	mesh.updateMatrixWorld();
+	scene.add(mesh);
+}
+//#endregion
+//#region src/plugin/StyleHelper.ts
+/**
+* 构件样式辅助器
+* 通过 show 表达式控制可见性，通过 conditions 应用条件材质与可选位姿
+*/
+var StyleHelper = class {
+	/** 当前样式配置，可通过 plugin.style 获取 */
+	style = null;
+	styledOids = /* @__PURE__ */ new Set();
+	hiddenOids = /* @__PURE__ */ new Set();
+	originalMaterialByMesh = /* @__PURE__ */ new Map();
+	originalTransformByMesh = /* @__PURE__ */ new Map();
+	/** 按材质分组后的收集器，key 与 collector.getCacheKey() 一致 */
+	meshChangeHandlers = /* @__PURE__ */ new Map();
+	/** 当前样式占用的收集器（用于 clearStyle / 下次 applyStyle 前卸载监听） */
+	styleCollectors = [];
+	constructor(context) {
+		this.context = context;
+	}
+	/**
+	* 设置样式
+	* @param style 样式配置，传 null 或空对象清除样式
+	*/
+	setStyle(style) {
+		this.clearStyle();
+		this.style = style;
+		if (!style || !style.show && (!style.conditions || style.conditions.length === 0)) return;
+		this.applyStyle();
+	}
+	/**
+	* 清除样式，恢复默认显示
+	*/
+	clearStyle() {
+		const styledOidsList = Array.from(this.styledOids);
+		const hiddenOidsList = Array.from(this.hiddenOids);
+		for (const collector of this.styleCollectors) {
+			collector.meshes.forEach((mesh) => {
+				const original = this.originalMaterialByMesh.get(mesh.uuid);
+				if (original) {
+					mesh.material = original;
+					this.originalMaterialByMesh.delete(mesh.uuid);
+				}
+				const origT = this.originalTransformByMesh.get(mesh.uuid);
+				if (origT) {
+					mesh.position.copy(origT.position);
+					mesh.scale.copy(origT.scale);
+					mesh.rotation.copy(origT.rotation);
+					this.originalTransformByMesh.delete(mesh.uuid);
+				}
+				mesh.removeFromParent();
+			});
+			const handler = this.meshChangeHandlers.get(collector.getCacheKey());
+			if (handler) collector.removeEventListener("mesh-change", handler);
+		}
+		this.meshChangeHandlers.clear();
+		this.styleCollectors = [];
+		this.style = null;
+		this.styledOids.clear();
+		this.hiddenOids.clear();
+		this.context.showPartsByOids([...styledOidsList, ...hiddenOidsList]);
+	}
+	applyStyle() {
+		const style = this.style;
+		if (!style) return;
+		if (!this.context.getScene()) return;
+		const tiles = this.context.getTiles();
+		if (!tiles) return;
+		const propertyByOid = getPropertyDataMapFromTiles(tiles);
+		for (const collector of this.styleCollectors) {
+			const h = this.meshChangeHandlers.get(collector.getCacheKey());
+			if (h) collector.removeEventListener("mesh-change", h);
+		}
+		this.styleCollectors = [];
+		this.meshChangeHandlers.clear();
+		const { hiddenOidsList, groups } = buildAppearanceGroupsFromPropertyMap(propertyByOid, {
+			show: style.show,
+			conditions: style.conditions ?? []
+		});
+		for (const { oids } of groups.values()) for (const oid of oids) this.styledOids.add(oid);
+		this.hiddenOids = new Set(hiddenOidsList);
+		const oidsToHide = [...hiddenOidsList];
+		for (const { oids } of groups.values()) oidsToHide.push(...oids);
+		const maps = {
+			originalMaterialByMesh: this.originalMaterialByMesh,
+			originalTransformByMesh: this.originalTransformByMesh
+		};
+		for (const { appearance, oids } of groups.values()) {
+			const sortedOids = normalizeMeshCollectorOids(oids);
+			const collector = this.context.getMeshCollectorByCondition({ oids: sortedOids });
+			this.styleCollectors.push(collector);
+			const cacheKey = collector.getCacheKey();
+			const handler = () => {
+				const s = this.context.getScene();
+				if (!s) return;
+				collector.meshes.forEach((mesh) => {
+					applyStyleAppearanceToMesh(mesh, appearance, s, maps);
+				});
+			};
+			this.meshChangeHandlers.set(cacheKey, handler);
+			collector.addEventListener("mesh-change", handler);
+			handler();
+		}
+		this.context.hidePartsByOids(oidsToHide);
+	}
+	/**
+	* 瓦片加载完成后重新应用样式（由插件调用）
+	*/
+	onTilesLoadEnd() {
+		if (this.style) this.applyStyle();
+	}
+	dispose() {
+		this.clearStyle();
+	}
+};
+//#endregion
+//#region src/plugin/PartHighlightHelper.ts
+var highlightMaterialCache = /* @__PURE__ */ new Map();
+function getMaterialForHighlight(style) {
+	const color = style.color != null ? toColor(style.color) : new Color(16776960);
+	const opacity = style.opacity != null ? Math.max(0, Math.min(1, style.opacity)) : 1;
+	const key = `${color.getHex()}_${opacity}`;
+	if (!highlightMaterialCache.has(key)) {
+		const mat = new MeshStandardMaterial({
+			color: color.clone(),
+			roughness: .5,
+			metalness: .1,
+			opacity,
+			transparent: opacity < 1
+		});
+		highlightMaterialCache.set(key, mat);
+	}
+	return highlightMaterialCache.get(key);
+}
+function toMaterial(value) {
+	if (value instanceof Material) return value;
+	return getMaterialForHighlight(value);
+}
+function toStyleAppearance(ha) {
+	return {
+		material: toMaterial(ha.material),
+		translation: ha.translation,
+		scale: ha.scale,
+		rotation: ha.rotation,
+		origin: ha.origin
+	};
+}
+/**
+* 构件高亮辅助器
+* 与 setStyle 相同的 show / conditions / 位姿语义，多组命名高亮；底层通过 hidePartsByOids + split mesh 实现
+*/
+var PartHighlightHelper = class {
+	highlightGroups = /* @__PURE__ */ new Map();
+	originalMaterialByMesh = /* @__PURE__ */ new Map();
+	originalTransformByMesh = /* @__PURE__ */ new Map();
+	meshChangeHandlers = /* @__PURE__ */ new Map();
+	highlightCollectors = [];
+	/** 上次 hidePartsByOids 传入的 OID 列表，用于重新应用前 showParts */
+	lastHiddenOids = [];
+	constructor(context) {
+		this.context = context;
+	}
+	getMaps() {
+		return {
+			originalMaterialByMesh: this.originalMaterialByMesh,
+			originalTransformByMesh: this.originalTransformByMesh
+		};
+	}
+	/**
+	* 合并多组命名高亮：按 Map 插入顺序，后写入的组覆盖同一 OID 的外观
+	*/
+	mergeAppearanceByOid(propertyByOid) {
+		const appearanceByOid = /* @__PURE__ */ new Map();
+		for (const [, hl] of this.highlightGroups) {
+			const conditions = (hl.conditions ?? []).map(([c, h]) => [c, toStyleAppearance(h)]);
+			for (const [oid, propertyData] of propertyByOid) {
+				if (propertyData == null) continue;
+				if (hl.oids && !hl.oids.includes(oid)) continue;
+				if (hl.show && !evaluateStyleCondition(hl.show, propertyData)) continue;
+				const app = resolveConditionsAppearance(conditions, propertyData);
+				if (!app) continue;
+				appearanceByOid.set(oid, app);
+			}
+		}
+		return appearanceByOid;
+	}
+	/** 各组 show 失败需隐藏的 OID（与 setStyle 一致：show 不满足则隐藏原片） */
+	collectUnionShowHide(propertyByOid) {
+		const unionHide = /* @__PURE__ */ new Set();
+		for (const [, hl] of this.highlightGroups) for (const [oid, propertyData] of propertyByOid) {
+			if (propertyData == null) continue;
+			if (hl.oids && !hl.oids.includes(oid)) continue;
+			if (hl.show && !evaluateStyleCondition(hl.show, propertyData)) unionHide.add(oid);
+		}
+		return unionHide;
+	}
+	clearCollectorsAndRestoreMeshes() {
+		const maps = this.getMaps();
+		for (const collector of this.highlightCollectors) {
+			collector.meshes.forEach((mesh) => {
+				restoreMeshAppearanceMaps(mesh, maps);
+				mesh.removeFromParent();
+			});
+			const handler = this.meshChangeHandlers.get(collector.getCacheKey());
+			if (handler) collector.removeEventListener("mesh-change", handler);
+		}
+		this.meshChangeHandlers.clear();
+		this.highlightCollectors = [];
+	}
+	reapplyAll() {
+		this.clearCollectorsAndRestoreMeshes();
+		if (this.lastHiddenOids.length > 0) this.context.showPartsByOids(this.lastHiddenOids);
+		if (this.highlightGroups.size === 0) {
+			this.lastHiddenOids = [];
+			return;
+		}
+		const tiles = this.context.getTiles();
+		const scene = this.context.getScene();
+		if (!tiles || !scene) return;
+		const propertyByOid = getPropertyDataMapFromTiles(tiles);
+		const appearanceByOid = this.mergeAppearanceByOid(propertyByOid);
+		const unionHide = this.collectUnionShowHide(propertyByOid);
+		const oidsToHide = [...new Set([...appearanceByOid.keys(), ...unionHide])];
+		this.lastHiddenOids = oidsToHide;
+		const groups = /* @__PURE__ */ new Map();
+		for (const [oid, app] of appearanceByOid) {
+			const gkey = appearanceGroupKey(app);
+			let g = groups.get(gkey);
+			if (!g) {
+				g = {
+					appearance: app,
+					oids: []
+				};
+				groups.set(gkey, g);
+			}
+			g.oids.push(oid);
+		}
+		const maps = this.getMaps();
+		for (const { appearance, oids } of groups.values()) {
+			const sortedOids = normalizeMeshCollectorOids(oids);
+			const collector = this.context.getMeshCollectorByCondition({ oids: sortedOids });
+			this.highlightCollectors.push(collector);
+			const cacheKey = collector.getCacheKey();
+			const handler = () => {
+				const s = this.context.getScene();
+				if (!s) return;
+				collector.meshes.forEach((mesh) => {
+					applyStyleAppearanceToMesh(mesh, appearance, s, maps);
+				});
+			};
+			this.meshChangeHandlers.set(cacheKey, handler);
+			collector.addEventListener("mesh-change", handler);
+			handler();
+		}
+		this.context.hidePartsByOids(oidsToHide);
+	}
+	/**
+	* 高亮指定构件（语义与 setStyle 一致，多 name 参数）
+	*/
+	highlight(options) {
+		const { name, show, conditions, oids } = options;
+		if (!show && (!conditions || conditions.length === 0)) {
+			this.cancelHighlight(name);
+			return;
+		}
+		this.highlightGroups.set(name, {
+			show,
+			conditions,
+			oids
+		});
+		this.reapplyAll();
+	}
+	/**
+	* 取消指定名称的高亮
+	*/
+	cancelHighlight(name) {
+		if (!this.highlightGroups.has(name)) return;
+		this.highlightGroups.delete(name);
+		this.reapplyAll();
+	}
+	/**
+	* 取消所有高亮
+	*/
+	cancelAllHighlight() {
+		this.highlightGroups.clear();
+		this.reapplyAll();
+	}
+	/**
+	* 瓦片加载完成后重新应用高亮（由插件调用）
+	*/
+	onTilesLoadEnd() {
+		if (this.highlightGroups.size === 0) return;
+		this.reapplyAll();
+	}
+	dispose() {
+		this.cancelAllHighlight();
 	}
 };
 //#endregion
 //#region src/plugin/InteractionFilter.ts
 /**
-* 冻结与隔离逻辑：管理构件的交互过滤及 getMeshCollectorByOid 获取的 mesh 在场景中的显隐
+* 冻结与隔离逻辑：管理构件的交互过滤及 MeshCollector 获取的 mesh 在场景中的显隐
+* split mesh 使用 userData.oid（单 feature）或 userData.collectorOids（合并 mesh）：任一相关 OID 被冻结/隔离规则命中则整 mesh 脱离场景
 */
 var InteractionFilter = class {
 	frozenOids = /* @__PURE__ */ new Set();
 	isolatedOids = /* @__PURE__ */ new Set();
+	/** 按 collector 分组键追踪 mesh */
 	trackedMeshes = /* @__PURE__ */ new Map();
 	meshListeners = /* @__PURE__ */ new Map();
 	isPluginRemoving = false;
@@ -1965,12 +3074,19 @@ var InteractionFilter = class {
 		if (this.isolatedOids.size > 0 && !this.isolatedOids.has(oid)) return true;
 		return false;
 	}
-	trackMesh(mesh, oid) {
+	/** 合并 split：任一 collector OID 被 block 则整 mesh 视为应隐藏 */
+	isMeshInteractionBlocked(mesh) {
+		const coids = mesh.userData?.collectorOids;
+		if (coids && coids.length > 0) return coids.some((oid) => this.isOidBlocked(oid));
+		const oid = mesh.userData?.oid;
+		return oid !== void 0 && this.isOidBlocked(oid);
+	}
+	trackMesh(mesh) {
 		if (this.meshListeners.has(mesh)) return;
 		const onAdded = () => {
 			if (this.isPluginRemoving) return;
 			mesh.userData._detachedParent = null;
-			if (this.isOidBlocked(oid) && mesh.parent) {
+			if (this.isMeshInteractionBlocked(mesh) && mesh.parent) {
 				const parent = mesh.parent;
 				this.isPluginRemoving = true;
 				mesh.userData._detachedParent = parent;
@@ -1998,8 +3114,8 @@ var InteractionFilter = class {
 		}
 		mesh.userData._detachedParent = null;
 	}
-	onCollectorMeshChange(oid, newMeshes) {
-		const tracked = this.trackedMeshes.get(oid);
+	onCollectorMeshChange(groupKey, newMeshes) {
+		const tracked = this.trackedMeshes.get(groupKey);
 		const newSet = new Set(newMeshes);
 		if (tracked) {
 			for (const mesh of tracked) if (!newSet.has(mesh)) {
@@ -2009,39 +3125,36 @@ var InteractionFilter = class {
 		}
 		const trackSet = tracked || /* @__PURE__ */ new Set();
 		for (const mesh of newMeshes) if (!trackSet.has(mesh)) {
-			this.trackMesh(mesh, oid);
+			this.trackMesh(mesh);
 			trackSet.add(mesh);
 		}
-		this.trackedMeshes.set(oid, trackSet);
+		this.trackedMeshes.set(groupKey, trackSet);
 	}
 	syncCollectorMeshes() {
 		this.isPluginRemoving = true;
-		for (const [oid, collector] of this.context.getCollectorCache()) {
-			const blocked = this.isOidBlocked(oid);
-			for (const mesh of collector.meshes) {
-				if (!this.meshListeners.has(mesh)) continue;
-				if (blocked) {
-					if (mesh.parent && !mesh.userData._detachedParent) {
-						const parent = mesh.parent;
-						mesh.userData._detachedParent = parent;
-						parent.remove(mesh);
-					}
-				} else {
-					const storedParent = mesh.userData._detachedParent;
-					if (storedParent && !mesh.parent) {
-						storedParent.add(mesh);
-						mesh.userData._detachedParent = null;
-					}
+		for (const [, collector] of this.context.getCollectorCache()) for (const mesh of collector.meshes) {
+			if (!this.meshListeners.has(mesh)) continue;
+			if (this.isMeshInteractionBlocked(mesh)) {
+				if (mesh.parent && !mesh.userData._detachedParent) {
+					const parent = mesh.parent;
+					mesh.userData._detachedParent = parent;
+					parent.remove(mesh);
+				}
+			} else {
+				const storedParent = mesh.userData._detachedParent;
+				if (storedParent && !mesh.parent) {
+					storedParent.add(mesh);
+					mesh.userData._detachedParent = null;
 				}
 			}
 		}
 		this.isPluginRemoving = false;
 	}
-	onUnregisterCollector(oid) {
-		const tracked = this.trackedMeshes.get(oid);
+	onUnregisterCollector(groupKey) {
+		const tracked = this.trackedMeshes.get(groupKey);
 		if (tracked) {
 			for (const mesh of tracked) this.untrackMesh(mesh);
-			this.trackedMeshes.delete(oid);
+			this.trackedMeshes.delete(groupKey);
 		}
 	}
 	freezeByOids(oids) {
@@ -2049,16 +3162,14 @@ var InteractionFilter = class {
 		this.syncCollectorMeshes();
 	}
 	freezeByOid(oid) {
-		this.frozenOids.add(oid);
-		this.syncCollectorMeshes();
+		this.freezeByOids([oid]);
 	}
 	unfreezeByOids(oids) {
 		for (const oid of oids) this.frozenOids.delete(oid);
 		this.syncCollectorMeshes();
 	}
 	unfreezeByOid(oid) {
-		this.frozenOids.delete(oid);
-		this.syncCollectorMeshes();
+		this.unfreezeByOids([oid]);
 	}
 	unfreeze() {
 		this.frozenOids.clear();
@@ -2080,8 +3191,7 @@ var InteractionFilter = class {
 		this.syncCollectorMeshes();
 	}
 	unisolateByOid(oid) {
-		this.isolatedOids.delete(oid);
-		this.syncCollectorMeshes();
+		this.unisolateByOids([oid]);
 	}
 	unisolate() {
 		this.isolatedOids.clear();
@@ -2193,18 +3303,23 @@ var GLTFParserPlugin = class {
 	_options;
 	_structureData = null;
 	_oidNodeMap = /* @__PURE__ */ new Map();
-	_structurePromise = null;
+	/** rootTileset 已存在且已尝试过内嵌解析后仍为 null，则不再重复 gunzip */
+	_structureEmbedResolved = false;
 	_modelInfo = null;
 	_modelInfoPromise = null;
 	_interactionFilter;
 	_partColorHelper = null;
 	_partBlinkHelper = null;
 	_partFrameHelper = null;
+	_styleHelper = null;
+	_partHighlightHelper = null;
 	oids = [];
-	renderer = null;
+	/** WebGLRenderer 实例，用于 mesh helper 等扩展 */
+	get renderer() {
+		return this._renderer;
+	}
+	_renderer = null;
 	splitMeshCache = /* @__PURE__ */ new Map();
-	maxUniformVectors = 1024;
-	featureIdCount = 32;
 	collectors = /* @__PURE__ */ new Set();
 	collectorCache = /* @__PURE__ */ new Map();
 	/**
@@ -2218,7 +3333,7 @@ var GLTFParserPlugin = class {
 			useIndexedDB: false,
 			...options
 		};
-		if (options?.renderer) this.renderer = options.renderer;
+		if (options?.renderer) this._renderer = options.renderer;
 		this._interactionFilter = new InteractionFilter({ getCollectorCache: () => this.collectorCache });
 		setMaxWorkers(this._options.maxWorkers);
 	}
@@ -2227,38 +3342,43 @@ var GLTFParserPlugin = class {
 	*/
 	init(tiles) {
 		this.tiles = tiles;
-		this._partColorHelper = new PartColorHelper({
-			hideByOids: (oids) => this.hideByOids(oids),
-			unhideByOids: (oids) => this.unhideByOids(oids),
-			getMeshCollectorByOid: (oid) => this.getMeshCollectorByOid(oid),
-			getScene: () => this.tiles?.group ?? null
-		});
-		this._partBlinkHelper = new PartBlinkHelper({
-			hideByOids: (oids) => this.hideByOids(oids),
-			unhideByOids: (oids) => this.unhideByOids(oids),
-			getMeshCollectorByOid: (oid) => this.getMeshCollectorByOid(oid),
-			getScene: () => this.tiles?.group ?? null
-		});
-		this._partFrameHelper = new PartFrameHelper({
-			hideByOids: (oids) => this.hideByOids(oids),
-			unhideByOids: (oids) => this.unhideByOids(oids),
-			getMeshCollectorByOid: (oid) => this.getMeshCollectorByOid(oid),
-			getScene: () => this.tiles?.group ?? null
+		const partFx = this._createPartEffectHost();
+		this._partColorHelper = new PartColorHelper(partFx);
+		this._partBlinkHelper = new PartBlinkHelper(partFx);
+		this._partFrameHelper = new PartFrameHelper(partFx);
+		this._styleHelper = new StyleHelper({
+			getTiles: () => this.tiles,
+			hidePartsByOids: partFx.hidePartsByOids,
+			showPartsByOids: partFx.showPartsByOids,
+			getMeshCollectorByCondition: partFx.getMeshCollectorByCondition,
+			getScene: partFx.getScene
 		});
+		this._partHighlightHelper = new PartHighlightHelper(partFx);
 		this._loader = new GLTFWorkerLoader(tiles.manager, {
 			metadata: this._options.metadata,
 			materialBuilder: this._options.materialBuilder
 		});
 		tiles.manager.addHandler(this._gltfRegex, this._loader);
-		if (this.renderer) this._updateWebGLLimits();
 		tiles.addEventListener("load-model", this._onLoadModelCB);
 		tiles.addEventListener("tiles-load-end", this._onTilesLoadEndCB);
+		tiles.addEventListener("load-root-tileset", this._onLoadRootTilesetCB);
+		this._syncStructureFromTileset();
 		tiles.traverse((tile) => {
 			const tileWithCache = tile;
-			if (tileWithCache.cached?.scene) this._onLoadModel(tileWithCache.cached.scene);
+			if (tileWithCache.engineData?.scene) this._onLoadModel(tileWithCache.engineData.scene);
 			return true;
 		}, null);
 	}
+	_createPartEffectHost() {
+		return {
+			getTiles: () => this.tiles ?? null,
+			hidePartsByOids: (oids) => this.hidePartsByOids(oids),
+			showPartsByOids: (oids) => this.showPartsByOids(oids),
+			getMeshCollectorByOid: (oid) => this.getMeshCollectorByOid(oid),
+			getMeshCollectorByCondition: (q) => this.getMeshCollectorByCondition(q),
+			getScene: () => this.tiles?.group ?? null
+		};
+	}
 	/**
 	* Fetch tile data with IndexedDB caching support
 	*/
@@ -2290,56 +3410,51 @@ var GLTFParserPlugin = class {
 		if (this._options.beforeParseTile) buffer = await this._options.beforeParseTile(buffer, tile, extension, uri, abortSignal);
 		return this.tiles.parseTile(buffer, tile, extension, uri, abortSignal);
 	}
-	_getStructureUrl() {
+	/** 与 tileset 同目录的侧车 JSON，如 structure.json / modelInfo.json */
+	_sidecarJsonUrl(fileName) {
 		const rootURL = this.tiles?.rootURL;
 		if (!rootURL) return null;
-		return rootURL.replace(/[^/]+$/, "structure.json");
+		return rootURL.replace(/[^/]+$/, fileName);
 	}
 	_buildOidNodeMap(node, map) {
 		if (node.id !== void 0) map.set(node.id, node);
 		if (node.children) for (const child of node.children) this._buildOidNodeMap(child, map);
 	}
-	async _fetchStructureData() {
-		const url = this._getStructureUrl();
-		if (!url) {
-			console.warn("[GLTFParserPlugin] Cannot derive structure.json URL: tiles not initialized");
-			return null;
-		}
-		try {
-			const response = await fetch(url);
-			if (!response.ok) {
-				console.warn(`[GLTFParserPlugin] Failed to fetch structure.json: ${response.status}`);
-				return null;
-			}
-			const data = await response.json();
-			this._structureData = data;
-			this._oidNodeMap.clear();
-			if (data.trees) for (const tree of data.trees) this._buildOidNodeMap(tree, this._oidNodeMap);
-			return data;
-		} catch (error) {
-			console.error("[GLTFParserPlugin] Error loading structure.json:", error);
-			return null;
-		}
-	}
-	async _ensureStructureLoaded() {
+	/** 仅根 tileset 变化时重解析 structureUri（子 tileset 的 load-tileset 不会触发） */
+	_onLoadRootTilesetCB = () => {
+		this._structureData = null;
+		this._oidNodeMap.clear();
+		this._structureEmbedResolved = false;
+		this._syncStructureFromTileset();
+	};
+	/**
+	* 从已加载根 tileset 的内嵌 structure（优先 asset.extras.maptalks.structureUri）同步解压并建索引。
+	* rootTileset 尚未就绪时返回 null，可稍后再次调用；已成功或已判定无内嵌数据后见 _structureEmbedResolved。
+	*/
+	_syncStructureFromTileset() {
 		if (this._structureData) return this._structureData;
-		if (!this._structurePromise) this._structurePromise = this._fetchStructureData();
-		return this._structurePromise;
+		if (this._structureEmbedResolved) return null;
+		if (!this.tiles?.rootTileset) return null;
+		const embedded = parseEmbeddedStructureDataFromTilesSync(this.tiles);
+		this._structureEmbedResolved = true;
+		if (!embedded) return null;
+		this._structureData = embedded;
+		this._oidNodeMap.clear();
+		if (embedded.trees) for (const tree of embedded.trees) this._buildOidNodeMap(tree, this._oidNodeMap);
+		return embedded;
 	}
 	/**
-	* 根据 oid 获取 structure.json 中对应的节点树数据
-	* 包含 bbox、children、name 等完整结构信息
-	* 首次调用时会自动从 tileset URL 推导并请求 structure.json
+	* 根据 oid 获取结构树节点（数据来自 tileset 内嵌 structureUri 同步解压）
 	*/
-	async getNodeTreeByOid(oid) {
-		await this._ensureStructureLoaded();
+	getNodeTreeByOid(oid) {
+		this._syncStructureFromTileset();
 		return this._oidNodeMap.get(oid) ?? null;
 	}
 	/**
-	* 根据 oid 数组批量获取 structure.json 中对应的节点树数据
+	* 根据 oid 数组批量获取结构树节点
 	*/
-	async getNodeTreeByOids(oids) {
-		await this._ensureStructureLoaded();
+	getNodeTreeByOids(oids) {
+		this._syncStructureFromTileset();
 		const result = /* @__PURE__ */ new Map();
 		for (const oid of oids) {
 			const node = this._oidNodeMap.get(oid);
@@ -2348,41 +3463,58 @@ var GLTFParserPlugin = class {
 		return result;
 	}
 	/**
-	* 获取完整的 structure.json 数据
-	* 首次调用时会自动请求
+	* 根据 oid 从结构数据取轴对齐包围盒（`bbox` 为 `[minX,minY,minZ,maxX,maxY,maxZ]`，与 `selectByBox` 一致）
+	* @returns 无对应节点或缺少有效 bbox 时返回 `null`
+	*/
+	getBoundingBoxByOid(oid) {
+		this._syncStructureFromTileset();
+		return bboxArrayToBox3(this._oidNodeMap.get(oid)?.bbox);
+	}
+	/**
+	* 计算给定 OID 集合的几何中心（世界坐标系与结构 bbox / 瓦片 mesh 一致）。
+	* 优先合并结构树中的轴对齐 bbox；若无有效 bbox 则合并对应 split mesh 的世界包围盒。
+	*/
+	getCenterByOids(oids) {
+		if (!this.tiles || oids.length === 0) return null;
+		const unique = [...new Set(oids)];
+		if (unique.length === 0) return null;
+		return this._getCenterFromOidList(unique);
+	}
+	/**
+	* 按属性条件筛选构件（语义同 `setStyle` 的 `show` / conditions 中的表达式字符串），
+	* 返回筛选结果的整体中心点；合并方式同 {@link getCenterByOids}。
+	*/
+	getCenterByCondition(condition) {
+		if (!this.tiles) return null;
+		const cond = condition.trim();
+		if (!cond) return null;
+		const targetOids = [];
+		for (const oid of getAllOidsFromTiles(this.tiles)) if (evaluateStyleCondition(cond, getPropertyDataByOid(this.tiles, oid))) targetOids.push(oid);
+		if (targetOids.length === 0) return null;
+		return this._getCenterFromOidList(targetOids);
+	}
+	/**
+	* 完整结构数据（与内嵌 structure JSON 一致）
 	*/
-	async getStructureData() {
-		return this._ensureStructureLoaded();
+	getStructureData() {
+		return this._syncStructureFromTileset();
 	}
 	/**
-	* 选择包围盒范围内的构件（包含相交和包含两种情况）
-	* @param box 查询用的 Box3 范围，坐标系与 structure.json 中 bbox 一致
-	* @returns 范围内所有构件的 oid 数组
+	* 选择包围盒范围内的构件（坐标系与结构 bbox 一致）
 	*/
-	async selectByBox(box) {
-		await this._ensureStructureLoaded();
+	selectByBox(box) {
+		this._syncStructureFromTileset();
 		return selectByBoxFromOidMap(this._oidNodeMap, box);
 	}
 	/**
-	* 选择多边形（平面投影）范围内的构件（包含相交和包含两种情况）
-	* @param polygon 多边形顶点数组（Vector3），按顺序连接构成闭合多边形
-	* @param axis 投影平面，决定使用 bbox 的哪两个轴做 2D 判定
-	*   - 'xz'（默认）：俯视图，取 bbox 的 x/z 坐标
-	*   - 'xy'：正视图，取 bbox 的 x/y 坐标
-	*   - 'yz'：侧视图，取 bbox 的 y/z 坐标
-	* @returns 范围内所有构件的 oid 数组
+	* 选择多边形（平面投影）范围内的构件
 	*/
-	async selectByPolygon(polygon, axis = "xz") {
-		await this._ensureStructureLoaded();
+	selectByPolygon(polygon, axis = "xz") {
+		this._syncStructureFromTileset();
 		return selectByPolygonFromOidMap(this._oidNodeMap, polygon, axis);
 	}
-	_getModelInfoUrl() {
-		const rootURL = this.tiles?.rootURL;
-		if (!rootURL) return null;
-		return rootURL.replace(/[^/]+$/, "modelInfo.json");
-	}
 	async _fetchModelInfo() {
-		const url = this._getModelInfoUrl();
+		const url = this._sidecarJsonUrl("modelInfo.json");
 		if (!url) {
 			console.warn("[GLTFParserPlugin] Cannot derive modelInfo.json URL: tiles not initialized");
 			return null;
@@ -2432,83 +3564,41 @@ var GLTFParserPlugin = class {
 		scene.traverse((c) => {
 			if (c.material) this._setupMaterial(c);
 		});
+		applyVisibilityToScene(scene, new Set(this.oids));
 	}
 	_notifyCollectors() {
 		for (const collector of this.collectors) collector._updateMeshes();
+		this._styleHelper?.onTilesLoadEnd();
 	}
 	_registerCollector(collector) {
 		this.collectors.add(collector);
 	}
 	_unregisterCollector(collector) {
-		const oid = collector.getOid();
+		const key = collector.getCacheKey();
 		this.collectors.delete(collector);
-		this.collectorCache.delete(oid);
-		this._interactionFilter.onUnregisterCollector(oid);
-	}
-	_updateWebGLLimits() {
-		const gl = this.renderer.getContext();
-		this.maxUniformVectors = gl.getParameter(gl.MAX_FRAGMENT_UNIFORM_VECTORS);
+		this.collectorCache.delete(key);
+		this._interactionFilter.onUnregisterCollector(key);
 	}
 	/**
-	* Dynamically calculate FEATURE_ID_COUNT based on WebGL limits and current oid count
+	* 遍历所有已加载瓦片，应用可见性过滤
 	*/
-	_calculateFeatureIdCount() {
-		const maxUniformVectors = this.maxUniformVectors;
-		const currentOidCount = this.oids.length;
-		if (currentOidCount > maxUniformVectors) throw new Error(`The number of OIDs to hide (${currentOidCount}) exceeds the WebGL MAX_FRAGMENT_UNIFORM_VECTORS limit (${maxUniformVectors}).`);
-		const minFeatureIdCount = 32;
-		if (currentOidCount <= minFeatureIdCount) return minFeatureIdCount;
-		const powerOf2 = Math.ceil(Math.log2(currentOidCount));
-		return Math.pow(2, powerOf2);
+	_applyVisibilityToAllTiles() {
+		if (!this.tiles) return;
+		const hiddenSet = new Set(this.oids);
+		this.tiles.traverse((tile) => {
+			const tileWithCache = tile;
+			if (tileWithCache.engineData?.scene) applyVisibilityToScene(tileWithCache.engineData.scene, hiddenSet);
+			return true;
+		}, null);
 	}
 	/**
-	* Set up shader modification for hiding specific features
+	* 设置材质（DoubleSide 等基础配置）
 	*/
 	_setupMaterial(mesh) {
 		const material = mesh.material;
 		if (material.userData._meshHelperSetup) return;
 		material.userData._meshHelperSetup = true;
 		material.side = DoubleSide;
-		const previousOnBeforeCompile = material.onBeforeCompile;
-		if (!material.defines) material.defines = {};
-		material.userData._materialFeatureIdCount = this.featureIdCount;
-		Object.defineProperty(material.defines, "FEATURE_ID_COUNT", {
-			get: () => {
-				if (material.userData._materialFeatureIdCount !== this.featureIdCount) {
-					material.userData._materialFeatureIdCount = this.featureIdCount;
-					material.needsUpdate = true;
-				}
-				return material.userData._materialFeatureIdCount;
-			},
-			enumerable: true,
-			configurable: true
-		});
-		material.onBeforeCompile = (shader, renderer) => {
-			previousOnBeforeCompile?.call(material, shader, renderer);
-			if (shader.vertexShader.includes("varying float vFeatureId;")) return;
-			shader.uniforms.hiddenFeatureIds = new FeatureIdUniforms(mesh, this);
-			shader.vertexShader = shader.vertexShader.replace("#include <common>", `#include <common>
-             attribute float _feature_id_0;
-             varying float vFeatureId;`);
-			shader.vertexShader = shader.vertexShader.replace("#include <begin_vertex>", `#include <begin_vertex>
-             vFeatureId = _feature_id_0;`);
-			shader.fragmentShader = shader.fragmentShader.replace("#include <common>", `#include <common>
-             uniform float hiddenFeatureIds[FEATURE_ID_COUNT];
-             varying float vFeatureId;
-      
-             bool shouldHideFeature(float featureId) {
-               for(int i = 0; i < FEATURE_ID_COUNT; i++) {
-                 if(abs(hiddenFeatureIds[i] - featureId) < 0.001) {
-                   return true;
-                 }
-               }
-               return false;
-             }`);
-			shader.fragmentShader = shader.fragmentShader.replace("void main() {", `void main() {
-           if(shouldHideFeature(vFeatureId)) {
-             discard;
-           }`);
-		};
 	}
 	/**
 	* Query feature information from intersection
@@ -2561,52 +3651,120 @@ var GLTFParserPlugin = class {
 		return this._interactionFilter.getIsolatedOids();
 	}
 	/**
-	* 内部方法：根据 oid 获取 mesh 数组
+	* 合并 OID 列表对应的结构 bbox；若无可用 bbox 则使用 split mesh 世界包围盒并求中心。
 	*/
-	_getMeshesByOidInternal(oid) {
-		const tileMeshes = getTileMeshesByOid(this.tiles, oid);
-		const allSplitMeshes = [];
-		for (const tileMesh of tileMeshes) {
-			const cacheKey = `${oid}_${tileMesh.uuid}`;
-			let splitMeshes = this.splitMeshCache.get(cacheKey);
-			if (!splitMeshes) {
-				splitMeshes = getSplitMeshesFromTile(tileMesh, oid);
-				this.splitMeshCache.set(cacheKey, splitMeshes);
+	_getCenterFromOidList(oids) {
+		this._syncStructureFromTileset();
+		const union = new Box3();
+		let hasStructureBox = false;
+		for (const oid of oids) {
+			const b = this.getBoundingBoxByOid(oid);
+			if (b && !b.isEmpty()) if (!hasStructureBox) {
+				union.copy(b);
+				hasStructureBox = true;
+			} else union.union(b);
+		}
+		if (hasStructureBox && !union.isEmpty()) return union.getCenter(new Vector3());
+		const meshes = this._getMeshesByOidsInternal(oids);
+		if (meshes.length === 0) return null;
+		const meshBox = new Box3();
+		for (const mesh of meshes) {
+			mesh.updateMatrixWorld(true);
+			meshBox.expandByObject(mesh);
+		}
+		if (meshBox.isEmpty()) return null;
+		return meshBox.getCenter(new Vector3());
+	}
+	/**
+	* 按 OID 集合：每个瓦片 mesh 只生成 **一个** 合并后的 split mesh（同一组 oid / condition 一条几何）
+	*/
+	_getMergedSplitMeshesForOidSet(oidSet) {
+		if (!this.tiles || oidSet.size === 0) return [];
+		const sortedKey = [...oidSet].sort((a, b) => a - b).join(",");
+		const result = [];
+		const candidateTiles = /* @__PURE__ */ new Set();
+		for (const oid of oidSet) for (const tm of getTileMeshesByOid(this.tiles, oid)) candidateTiles.add(tm);
+		for (const tileMesh of candidateTiles) {
+			const cacheKey = `merged|${tileMesh.uuid}|${sortedKey}`;
+			let cached = this.splitMeshCache.get(cacheKey);
+			if (!cached) {
+				const m = splitMeshByOidsMerged(tileMesh, oidSet);
+				cached = m ? [m] : [];
+				this.splitMeshCache.set(cacheKey, cached);
 			}
-			allSplitMeshes.push(...splitMeshes);
+			result.push(...cached);
 		}
-		return allSplitMeshes;
+		return result;
 	}
 	/**
-	* 根据 oid 获取 MeshCollector
-	* MeshCollector 会监听瓦片变化，自动更新 meshes 并触发 mesh-change 事件
-	* 内部缓存：相同 oid 多次调用会返回同一个 collector 实例
+	* 内部方法：根据单个 oid 获取 split mesh（每瓦片合并为一条）
 	*/
-	getMeshCollectorByOid(oid) {
-		const existing = this.collectorCache.get(oid);
+	_getMeshesByOidInternal(oid) {
+		return this._getMergedSplitMeshesForOidSet(new Set([oid]));
+	}
+	/**
+	* 内部方法：根据多个 oid 获取合并 split mesh（每瓦片一条，而非每 oid 一条）
+	*/
+	_getMeshesByOidsInternal(oids) {
+		return this._getMergedSplitMeshesForOidSet(new Set(oids));
+	}
+	/**
+	* 按查询收集 mesh：可只传 oids、只传 condition（全场景 OID 上筛选）、或两者组合
+	* condition 与 setStyle 的 show / conditions 中字符串表达式语义一致
+	*/
+	_getMeshesForCollectorQueryInternal(params) {
+		if (!this.tiles) return [];
+		const cond = params.condition?.trim();
+		let targetOids;
+		if (!cond) {
+			if (params.oids.length === 0) return [];
+			targetOids = [...new Set(params.oids)].sort((a, b) => a - b);
+		} else {
+			const candidate = params.oids.length === 0 ? getAllOidsFromTiles(this.tiles) : [...new Set(params.oids)];
+			targetOids = [];
+			for (const oid of candidate) if (evaluateStyleCondition(cond, getPropertyDataByOid(this.tiles, oid))) targetOids.push(oid);
+			targetOids.sort((a, b) => a - b);
+		}
+		return this._getMeshesByOidsInternal(targetOids);
+	}
+	/**
+	* 根据查询获取 MeshCollector（oids + 可选 condition，缓存键相同则复用实例）
+	*/
+	getMeshCollectorByCondition(query) {
+		const hasOids = normalizeMeshCollectorOids(query.oids ?? []).length > 0;
+		const hasCond = Boolean(query.condition?.trim());
+		if (!hasOids && !hasCond) throw new Error("getMeshCollectorByCondition requires non-empty oids and/or a condition string");
+		const key = meshCollectorQueryCacheKey(query);
+		const existing = this.collectorCache.get(key);
 		if (existing) return existing;
-		const collector = new MeshCollector(oid, this);
-		this.collectorCache.set(oid, collector);
-		this._interactionFilter.onCollectorMeshChange(oid, collector.meshes);
+		const collector = new MeshCollector(query, this);
+		this.collectorCache.set(key, collector);
+		this._interactionFilter.onCollectorMeshChange(key, collector.meshes);
 		collector.addEventListener("mesh-change", (event) => {
-			this._interactionFilter.onCollectorMeshChange(oid, event.meshes);
+			this._interactionFilter.onCollectorMeshChange(key, event.meshes);
 		});
 		return collector;
 	}
 	/**
+	* 根据单个 oid 获取 MeshCollector（等价于 getMeshCollectorByCondition({ oids: [oid] })）
+	*/
+	getMeshCollectorByOid(oid) {
+		return this.getMeshCollectorByCondition({ oids: [oid] });
+	}
+	/**
 	* Hide the corresponding part of the original mesh according to the OID array
 	*/
-	hideByOids(oids) {
+	hidePartsByOids(oids) {
 		this.oids = oids;
-		this.featureIdCount = this._calculateFeatureIdCount();
+		this._applyVisibilityToAllTiles();
 	}
 	/**
 	* Restore the display of the corresponding mesh according to the OID array
 	*/
-	unhideByOids(oids) {
+	showPartsByOids(oids) {
 		const oidSet = new Set(oids);
 		this.oids = this.oids.filter((existingOid) => !oidSet.has(existingOid));
-		this.featureIdCount = this._calculateFeatureIdCount();
+		this._applyVisibilityToAllTiles();
 	}
 	/**
 	* 根据 oid 数组设置构件颜色
@@ -2619,7 +3777,7 @@ var GLTFParserPlugin = class {
 	}
 	/**
 	* 恢复指定构件的颜色
-	* 从场景移除 split mesh，unhide 原 mesh
+	* 从场景移除 split mesh，恢复原 mesh 显示
 	* @param oids 构件 OID 数组
 	*/
 	restorePartColorByOids(oids) {
@@ -2681,17 +3839,72 @@ var GLTFParserPlugin = class {
 		this._partFrameHelper?.clearAllFrameParts();
 	}
 	/**
+	* 设置指定构件的线框填充颜色
+	* @param oids 构件 OID 数组
+	* @param color 颜色值，支持 hex 数字、颜色字符串（如 "#ff0000"）、THREE.Color 对象
+	*/
+	setFrameFillColor(oids, color) {
+		this._partFrameHelper?.setFrameFillColor(oids, color);
+	}
+	/**
+	* 设置指定构件的线框边框颜色
+	* @param oids 构件 OID 数组
+	* @param color 颜色值，支持 hex 数字、颜色字符串（如 "#ff0000"）、THREE.Color 对象
+	*/
+	setFrameEdgeColor(oids, color) {
+		this._partFrameHelper?.setFrameEdgeColor(oids, color);
+	}
+	/**
+	* 设置构件样式（条件可见性 + 条件材质）
+	* @param style 样式配置，传 null 清除样式
+	*/
+	setStyle(style) {
+		this._styleHelper?.setStyle(style);
+	}
+	/**
+	* 当前样式配置，只读
+	*/
+	get style() {
+		return this._styleHelper?.style ?? null;
+	}
+	/**
+	* 清除构件样式
+	*/
+	clearStyle() {
+		this._styleHelper?.clearStyle();
+	}
+	/**
+	* 高亮指定构件（语义与 setStyle 一致：show、conditions、可选 oids，另需 name 标识分组）
+	* @param options 高亮配置
+	*/
+	highlight(options) {
+		this._partHighlightHelper?.highlight(options);
+	}
+	/**
+	* 取消指定名称的高亮
+	* @param name 高亮组名称
+	*/
+	cancelHighlight(name) {
+		this._partHighlightHelper?.cancelHighlight(name);
+	}
+	/**
+	* 取消所有高亮
+	*/
+	cancelAllHighlight() {
+		this._partHighlightHelper?.cancelAllHighlight();
+	}
+	/**
 	* Restore the original materials of the mesh
 	*/
-	unhide() {
+	showAllParts() {
 		this.oids = [];
-		this.featureIdCount = this._calculateFeatureIdCount();
+		this._applyVisibilityToAllTiles();
 	}
 	/**
-	* Get the current feature ID count
+	* 获取当前隐藏的 OID 数量（兼容旧 API）
 	*/
 	getFeatureIdCount() {
-		return this.featureIdCount;
+		return this.oids.length;
 	}
 	/**
 	* Plugin disposal
@@ -2701,6 +3914,7 @@ var GLTFParserPlugin = class {
 			this.tiles.manager.removeHandler(this._gltfRegex);
 			this.tiles.removeEventListener("load-model", this._onLoadModelCB);
 			this.tiles.removeEventListener("tiles-load-end", this._onTilesLoadEndCB);
+			this.tiles.removeEventListener("load-root-tileset", this._onLoadRootTilesetCB);
 		}
 		if (this._loader) this._loader.removeListeners();
 		for (const collector of this.collectors) collector.dispose();
@@ -2709,7 +3923,7 @@ var GLTFParserPlugin = class {
 		this.splitMeshCache.clear();
 		this._structureData = null;
 		this._oidNodeMap.clear();
-		this._structurePromise = null;
+		this._structureEmbedResolved = false;
 		this._modelInfo = null;
 		this._modelInfoPromise = null;
 		this._interactionFilter.dispose();
@@ -2718,11 +3932,15 @@ var GLTFParserPlugin = class {
 		this._partBlinkHelper = null;
 		this._partFrameHelper?.dispose();
 		this._partFrameHelper = null;
+		this._styleHelper?.dispose();
+		this._styleHelper = null;
+		this._partHighlightHelper?.dispose();
+		this._partHighlightHelper = null;
 		this._loader = null;
 		this.tiles = null;
 	}
 };
 //#endregion
-export { GLTFParserPlugin, MeshCollector };
+export { GLTFParserPlugin, MeshCollector, clearStyleConditionCache, decodeGzipBase64DataUriSync, evaluateStyleCondition, getStructureDataUriFromTileset, meshCollectorGroupKey, meshCollectorQueryCacheKey, normalizeMeshCollectorOids, parseEmbeddedStructureDataFromTilesSync };
 
 //# sourceMappingURL=gltf-parser-plugin.module.js.map