gltf-parser-plugin 1.1.8 → 1.1.10

package/build/index.d.ts

@@ -1,4 +1,5 @@
 import { Box3 } from 'three';
+import { BufferGeometry } from 'three';
 import { Color } from 'three';
 import { Euler } from 'three';
 import { EventDispatcher } from 'three';
@@ -12,26 +13,30 @@ import { Vector3 } from 'three';
 import { WebGLRenderer } from 'three';
 
 /**
- * 与 StyleHelper 中 `show`、`conditions` 条件项的表达式求值一致
- * 在 propertyData 的键作为变量名的上下文中执行 `Boolean(expr)`
- *
- * 实现：对每个表达式字符串只编译一次 `new Function('data', 'with(d){...}')`，
- * 避免按「表达式 × 属性键集合」重复编译，也避免每次求值排序/拼接 cacheKey。
+ * 遍历 style 的 show 与 conditions，对每个出现过的字符串表达式只编译一次
  */
-/**
- * 清空表达式编译缓存（热更新或单测可调用）
- */
-export declare function clearStyleConditionCache(): void;
+export declare function buildStyleConditionEvaluatorMap(config: {
+    show?: string;
+    conditions?: StyleCondition[];
+}): Map<string, StyleConditionEvaluator>;
 
 /** 可解析为 THREE.Color 的输入 */
 export declare type ColorInput = number | string | Color;
 
+/**
+ * 编译单个表达式；失败返回 null（无模块级缓存）
+ */
+export declare function compileStyleCondition(expr: string): StyleConditionEvaluator | null;
+
 /**
  * 同步解析 `data:application/x-gzip;base64,...`：base64 → 二进制 → gunzip → UTF-8 文本。
  */
 export declare function decodeGzipBase64DataUriSync(dataUri: string): string;
 
-export declare function evaluateStyleCondition(expr: string | boolean, propertyData: Record<string, unknown> | null): boolean;
+export declare function evaluateStyleCondition(expr: string | boolean, propertyData: Record<string, unknown> | null, evaluators?: ReadonlyMap<string, StyleConditionEvaluator>): boolean;
+
+/** 从构件材质提取贴图，供 material 回调使用 */
+export declare function extractStyleMaterialMaps(material: Material): StyleMaterialMaps;
 
 /**
  * Hit object feature information interface
@@ -292,9 +297,10 @@ export declare class GLTFParserPlugin implements MeshHelperHost {
      */
     setStyle(style: StyleConfig | null): void;
     /**
-     * 当前样式配置，只读
+     * 当前样式配置。赋值与 `setStyle(...)` 等价，例如 `plugin.style = { show, conditions }`。
      */
     get style(): StyleConfig | null;
+    set style(style: StyleConfig | null);
     /**
      * 清除构件样式
      */
@@ -362,11 +368,17 @@ export declare interface GLTFParserPluginOptions {
      * @default false
      */
     useIndexedDB?: boolean;
+    /**
+     * 初始构件样式，语义与 `setStyle` / `plugin.style` 相同。
+     * 在 `init` 内会在已遍历到的瓦片场景就绪后应用；后续瓦片通过 `load-model` / `tiles-load-end` 触发收集器更新并重应用样式。
+     */
+    style?: StyleConfig | null;
 }
 
-/** 条件命中后的外观：材质可为简写，位姿与 setStyle 一致 */
+/** 条件命中后的外观：材质可为简写、函数或 Material；位姿与 setStyle 一致 */
 export declare interface HighlightAppearance {
-    material: HighlightMaterial;
+    material: HighlightMaterial | StyleMaterialResolver;
+    mesh?: StyleMeshFactory;
     translation?: StyleVec3Input;
     scale?: StyleVec3Input;
     rotation?: StyleEulerInput;
@@ -503,7 +515,13 @@ export declare interface StructureNode {
 
 /** 条件命中后的外观：材质必填，位姿可选（未传则不改对应分量） */
 export declare interface StyleAppearance {
-    material: Material;
+    /** 直接材质，或根据 {@link StyleMaterialMaps} 从原构件材质生成 */
+    material: Material | StyleMaterialResolver;
+    /**
+     * 可选：自定义 Mesh 构建；默认仅替换 geometry/material。
+     * 返回的 Mesh 会将其 geometry、material 写回当前 split mesh，uuid 不变。
+     */
+    mesh?: StyleMeshFactory;
     translation?: StyleVec3Input;
     scale?: StyleVec3Input;
     rotation?: StyleEulerInput;
@@ -514,6 +532,8 @@ export declare interface StyleAppearance {
 /** 条件项：[条件表达式或 true, 外观对象] */
 export declare type StyleCondition = [string | boolean, StyleAppearance];
 
+export declare type StyleConditionEvaluator = (data: Record<string, unknown>) => boolean;
+
 /** 样式配置 */
 export declare interface StyleConfig {
     show?: string;
@@ -523,6 +543,28 @@ export declare interface StyleConfig {
 /** 与 Euler 等价：Three 的 Euler，或 [x,y,z] / [x,y,z,order] */
 export declare type StyleEulerInput = Euler | readonly number[];
 
+/**
+ * 从构件原始材质上可读取的常见贴图（供 material 为函数时使用，如解构 { map, normalMap }）
+ */
+export declare interface StyleMaterialMaps {
+    map?: Texture | null;
+    normalMap?: Texture | null;
+    metalnessMap?: Texture | null;
+    roughnessMap?: Texture | null;
+    aoMap?: Texture | null;
+    emissiveMap?: Texture | null;
+}
+
+/**
+ * 基于原始贴图生成最终材质（与直接传入 Material 实例二选一）
+ */
+export declare type StyleMaterialResolver = (maps: StyleMaterialMaps) => Material;
+
+/**
+ * 用几何与（解析后的）材质构建 Mesh；返回值会合并回同一 mesh 实例以保持收集器引用
+ */
+export declare type StyleMeshFactory = (geometry: BufferGeometry, material: Material) => Mesh;
+
 /** 与 Vector3 等价：Three 的 Vector3 或长度≥3 的 [x,y,z] 数组 */
 export declare type StyleVec3Input = Vector3 | readonly number[];
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gltf-parser-plugin",
-  "version": "1.1.8",
+  "version": "1.1.10",
   "description": "A plugin for parsing GLTF files",
   "type": "module",
   "main": "./build/gltf-parser-plugin.module.js",
@@ -34,9 +34,9 @@
     "@typescript-eslint/parser": "^8.57.2",
     "eslint": "^10.1.0",
     "typescript": "^5.8.2",
-    "vite": "^8.0.2",
+    "vite": "^8.0.3",
     "vite-plugin-dts": "^4.5.4",
-    "vitest": "^4.1.1"
+    "vitest": "^4.1.2"
   },
   "dependencies": {
     "3d-tiles-renderer": "^0.4.23",