three-base 2.0.142 → 2.0.166

package/GLTFDracoLoader.ts

@@ -357,7 +357,7 @@ export default class GLTFDracoLoader extends GLTFLoader {
 
         const ptr = draco._malloc(byteLength);
         decoder.GetAttributeDataArrayForAllPoints(dracoGeometry, attribute, dataType, byteLength, ptr);
-        const array = new attributeType(draco.HEAPF32.buffer, ptr, numValues).slice();
+        const array = new attributeType(draco.HEAPF32.buffer as ArrayBuffer, ptr, numValues).slice();
         draco._free(ptr);
 
         return {

package/Grass/Grass.d.ts

@@ -1,8 +1,8 @@
-import { Mesh, MeshLambertMaterial, PlaneGeometry, Texture } from "three";
-export default class Grass extends Mesh {
-    constructor();
-    geometry: PlaneGeometry;
-    map: Texture;
-    material: MeshLambertMaterial;
-    setSize(width: number, height: number): void;
-}
+import { Mesh, MeshLambertMaterial, PlaneGeometry, Texture } from "three";
+export default class Grass extends Mesh {
+    constructor();
+    geometry: PlaneGeometry;
+    map: Texture;
+    material: MeshLambertMaterial;
+    setSize(width: number, height: number): void;
+}

package/Grass/Grass.js

@@ -1,38 +1,38 @@
-/*
- * @Author: xiaosihan
- * @Date: 2024-09-14 22:58:16
- * @Last Modified by: xiaosihan
- * @Last Modified time: 2024-09-14 23:20:39
- */
-import { DoubleSide, MathUtils, Mesh, MeshLambertMaterial, PlaneGeometry, RepeatWrapping, TextureLoader, } from "three";
-import grassJPG from "./grass.jpg";
-// 草地Mesh
-export default class Grass extends Mesh {
-    constructor() {
-        super();
-    }
-    geometry = (() => {
-        const geometry = new PlaneGeometry(1, 1, 1, 1);
-        geometry.rotateX(MathUtils.degToRad(90));
-        return geometry;
-    })();
-    map = (() => {
-        const map = new TextureLoader().load(grassJPG);
-        map.wrapS = map.wrapT = RepeatWrapping;
-        map.repeat.set(1, 1);
-        return map;
-    })();
-    material = (() => {
-        const material = new MeshLambertMaterial({
-            map: this.map,
-            side: DoubleSide,
-        });
-        return material;
-    })();
-    // 设置尺寸
-    setSize(width, height) {
-        this.scale.set(width, 1, height);
-        this.map.repeat.set(width, height);
-        // this.material.uniforms.size.value.set(width * 0.001, height * 0.001);
-    }
-}
+/*
+ * @Author: xiaosihan
+ * @Date: 2024-09-14 22:58:16
+ * @Last Modified by: xiaosihan
+ * @Last Modified time: 2024-09-14 23:20:39
+ */
+import { DoubleSide, MathUtils, Mesh, MeshLambertMaterial, PlaneGeometry, RepeatWrapping, TextureLoader, } from "three";
+import grassJPG from "./grass.jpg";
+// 草地Mesh
+export default class Grass extends Mesh {
+    constructor() {
+        super();
+    }
+    geometry = (() => {
+        const geometry = new PlaneGeometry(1, 1, 1, 1);
+        geometry.rotateX(MathUtils.degToRad(90));
+        return geometry;
+    })();
+    map = (() => {
+        const map = new TextureLoader().load(grassJPG);
+        map.wrapS = map.wrapT = RepeatWrapping;
+        map.repeat.set(1, 1);
+        return map;
+    })();
+    material = (() => {
+        const material = new MeshLambertMaterial({
+            map: this.map,
+            side: DoubleSide,
+        });
+        return material;
+    })();
+    // 设置尺寸
+    setSize(width, height) {
+        this.scale.set(width, 1, height);
+        this.map.repeat.set(width, height);
+        // this.material.uniforms.size.value.set(width * 0.001, height * 0.001);
+    }
+}

package/Grass/index.d.ts

@@ -1,2 +1,2 @@
-export { default } from "./Grass";
-export * from "./Grass";
+export { default } from "./Grass";
+export * from "./Grass";

package/Grass/index.js

@@ -1,2 +1,2 @@
-export { default } from "./Grass";
-export * from "./Grass";
+export { default } from "./Grass";
+export * from "./Grass";

package/Ground1/Ground1.d.ts

@@ -1,10 +1,10 @@
-import { Matrix4, Mesh, PlaneGeometry, ShaderMaterial } from "three";
-/** 装饰地板（随机渐变的深灰、不透明） */
-export default class Ground1 extends Mesh {
-    tempMatrix: Matrix4;
-    constructor();
-    renderOrder: number;
-    geometry: PlaneGeometry;
-    setSize(width: number, height: number): void;
-    material: ShaderMaterial;
-}
+import { Matrix4, Mesh, PlaneGeometry, ShaderMaterial } from "three";
+/** 装饰地板（随机渐变的深灰、不透明） */
+export default class Ground1 extends Mesh {
+    tempMatrix: Matrix4;
+    constructor();
+    renderOrder: number;
+    geometry: PlaneGeometry;
+    setSize(width: number, height: number): void;
+    material: ShaderMaterial;
+}

package/Ground1/Ground1.js

@@ -1,65 +1,65 @@
-/*
- * @Author: xiaosihan
- * @Date: 2022-09-20 23:06:00
- * @Last Modified by: xiaosihan
- * @Last Modified time: 2024-08-17 02:16:56
- *
- * ⭐ 2026-09-20 皇上旨两改：
- *   ① 原「科技感装饰地板」（三张格子贴图 + 紫色扩散动画 `#8D108E` + 格子线 `#263C56`）
- *      → 深灰地板（每帧 3 次贴图采样、贴图平铺无各向异性 → 摩尔纹 + home 页卡顿元凶之一）。
- *   ② 皇上再旨「地板就是**随机渐变**的深灰色、**不透明**」：
- *      → 深灰区间内用 **value noise 做随机渐变**（无贴图、零采样，天然无摩尔纹）；
- *      → `transparent: false`、alpha 恒 1（不透明）。
- *
- *   ⚠️ 不透明带来的变化与对策：
- *   - 原靠「径向 alpha 淡出」柔化 500×500 地板的边界；不透明后改用**径向压暗**（乘 0.72~1.0）
- *     弱化硬边 —— 若哪天皇上要「边界完全消失」，只能改回 alpha 淡出（即恢复 transparent）。
- *   - 调试线（FPScontrol）两条口径分家（2026-09-25 皇上逐条定案）：**10 条射线辅助线开深度测试**，
- *     正是靠本地板「不透明 + depthWrite:true」才挡得住埋进地里的那半截线；**8/9 两条回弹向量线
- *     保持穿透显示**（关深度测试 + renderOrder:9999），照旧常显在最前。
- *     ⚠️ 若哪天把本地板改回 transparent + depthWrite:false，射线辅助线会重新穿地浮出来。
- *
- *   ⚠️ 改动红线（这几条被别处依赖，**不许顺手改**）：
- *   - `userData.fpsCollision = true`：FPScontrol 把地板当碰撞体（见 FPScontrol.ts 地面处理段）。
- *   - `userData.aoFloor = true`：ssao_pass / debugExcludedShader 的「地板类半透明」特例按此标记走
- *     （默认不写进可见深度图；物体落在地板上仍有接触 AO）。
- *   - ShaderMaterial 必须含 logdepthbuf chunk；linear 输出必须 `#include <colorspace_fragment>`；
- *     否则末端 sRGB 编码会二次编码 → 发白。
- */
-import { Color, DoubleSide, Matrix4, Mesh, PlaneGeometry, ShaderChunk, ShaderMaterial } from "three";
-import { MathUtils } from "three";
-const { degToRad } = MathUtils;
-/** 装饰地板（随机渐变的深灰、不透明） */
-export default class Ground1 extends Mesh {
-    tempMatrix = new Matrix4();
-    constructor() {
-        super();
-        // 标记为自己参与 FPS 碰撞检测
-        this.userData.fpsCollision = true;
-        // 标记为"地板类半透明"：参与世界空间 AO（物体落在它上需要接触 AO），
-        // 但透过它看到的物体（如从下方透视）仍照常显示描边/辉光、且不被它的接触 AO 乘黑。
-        // 见 three-base/pass/ssao_pass.ts 的复合守卫说明。
-        this.userData.aoFloor = true;
-    }
-    renderOrder = -1;
-    geometry = (() => {
-        const geo = new PlaneGeometry(1, 1, 1, 1);
-        geo.rotateX(degToRad(-90));
-        return geo;
-    })();
-    // 设置尺寸
-    setSize(width, height) {
-        this.scale.set(width, 1, height);
-    }
-    material = new ShaderMaterial({
-        uniforms: {
-            /** 随机渐变的**暗端**深灰（three 的 Color 存 linear，末端 colorspace_fragment 编码回 sRGB） */
-            colorDark: { value: new Color("#2A2E33") },
-            /** 随机渐变的**亮端**深灰 */
-            colorLight: { value: new Color("#3D434B") },
-            /** 低频噪声格数（越大斑块越碎；9 → 500×500 地板上每块约 55m 的大块渐变） */
-            noiseScale: { value: 9 },
-        },
+/*
+ * @Author: xiaosihan
+ * @Date: 2022-09-20 23:06:00
+ * @Last Modified by: xiaosihan
+ * @Last Modified time: 2024-08-17 02:16:56
+ *
+ * ⭐ 2026-09-20 皇上旨两改：
+ *   ① 原「科技感装饰地板」（三张格子贴图 + 紫色扩散动画 `#8D108E` + 格子线 `#263C56`）
+ *      → 深灰地板（每帧 3 次贴图采样、贴图平铺无各向异性 → 摩尔纹 + home 页卡顿元凶之一）。
+ *   ② 皇上再旨「地板就是**随机渐变**的深灰色、**不透明**」：
+ *      → 深灰区间内用 **value noise 做随机渐变**（无贴图、零采样，天然无摩尔纹）；
+ *      → `transparent: false`、alpha 恒 1（不透明）。
+ *
+ *   ⚠️ 不透明带来的变化与对策：
+ *   - 原靠「径向 alpha 淡出」柔化 500×500 地板的边界；不透明后改用**径向压暗**（乘 0.72~1.0）
+ *     弱化硬边 —— 若哪天皇上要「边界完全消失」，只能改回 alpha 淡出（即恢复 transparent）。
+ *   - 调试线（FPScontrol）两条口径分家（2026-09-25 皇上逐条定案）：**10 条射线辅助线开深度测试**，
+ *     正是靠本地板「不透明 + depthWrite:true」才挡得住埋进地里的那半截线；**8/9 两条回弹向量线
+ *     保持穿透显示**（关深度测试 + renderOrder:9999），照旧常显在最前。
+ *     ⚠️ 若哪天把本地板改回 transparent + depthWrite:false，射线辅助线会重新穿地浮出来。
+ *
+ *   ⚠️ 改动红线（这几条被别处依赖，**不许顺手改**）：
+ *   - `userData.fpsCollision = true`：FPScontrol 把地板当碰撞体（见 FPScontrol.ts 地面处理段）。
+ *   - `userData.aoFloor = true`：ssao_pass / debugExcludedShader 的「地板类半透明」特例按此标记走
+ *     （默认不写进可见深度图；物体落在地板上仍有接触 AO）。
+ *   - ShaderMaterial 必须含 logdepthbuf chunk；linear 输出必须 `#include <colorspace_fragment>`；
+ *     否则末端 sRGB 编码会二次编码 → 发白。
+ */
+import { Color, DoubleSide, Matrix4, Mesh, PlaneGeometry, ShaderChunk, ShaderMaterial } from "three";
+import { MathUtils } from "three";
+const { degToRad } = MathUtils;
+/** 装饰地板（随机渐变的深灰、不透明） */
+export default class Ground1 extends Mesh {
+    tempMatrix = new Matrix4();
+    constructor() {
+        super();
+        // 标记为自己参与 FPS 碰撞检测
+        this.userData.fpsCollision = true;
+        // 标记为"地板类半透明"：参与世界空间 AO（物体落在它上需要接触 AO），
+        // 但透过它看到的物体（如从下方透视）仍照常显示描边/辉光、且不被它的接触 AO 乘黑。
+        // 见 three-base/pass/ssao_pass.ts 的复合守卫说明。
+        this.userData.aoFloor = true;
+    }
+    renderOrder = -1;
+    geometry = (() => {
+        const geo = new PlaneGeometry(1, 1, 1, 1);
+        geo.rotateX(degToRad(-90));
+        return geo;
+    })();
+    // 设置尺寸
+    setSize(width, height) {
+        this.scale.set(width, 1, height);
+    }
+    material = new ShaderMaterial({
+        uniforms: {
+            /** 随机渐变的**暗端**深灰（three 的 Color 存 linear，末端 colorspace_fragment 编码回 sRGB） */
+            colorDark: { value: new Color("#2A2E33") },
+            /** 随机渐变的**亮端**深灰 */
+            colorLight: { value: new Color("#3D434B") },
+            /** 低频噪声格数（越大斑块越碎；9 → 500×500 地板上每块约 55m 的大块渐变） */
+            noiseScale: { value: 9 },
+        },
         vertexShader: `
             ${ShaderChunk.common}
             ${ShaderChunk.logdepthbuf_pars_vertex}
@@ -69,7 +69,7 @@ export default class Ground1 extends Mesh {
                 gl_Position = projectionMatrix * modelViewMatrix * vec4( position, 1.0 );
                 ${ShaderChunk.logdepthbuf_vertex}
             }
-        `,
+        `,
         fragmentShader: `
             ${ShaderChunk.logdepthbuf_pars_fragment}
             uniform vec3 colorDark;
@@ -103,11 +103,11 @@ export default class Ground1 extends Mesh {
                 ${ShaderChunk.logdepthbuf_fragment}
                 #include <colorspace_fragment>
             }
-        `,
-        depthTest: true,
-        depthWrite: true,
-        // ⭐ 皇上 2026-09-20 旨：地板**不透明**
-        transparent: false,
-        side: DoubleSide,
-    });
-}
+        `,
+        depthTest: true,
+        depthWrite: true,
+        // ⭐ 皇上 2026-09-20 旨：地板**不透明**
+        transparent: false,
+        side: DoubleSide,
+    });
+}

package/Ground1/index.d.ts

@@ -1 +1 @@
-export { default } from "./Ground1";
+export { default } from "./Ground1";

package/Ground1/index.js

@@ -1 +1 @@
-export { default } from "./Ground1";
+export { default } from "./Ground1";

package/MeshBase.d.ts

@@ -1,36 +1,36 @@
-import { AnimationAction, AnimationMixer, Clock, Group, Mesh, Object3D, Vector3 } from "three";
-export default class MeshBase extends Group {
-    constructor(url?: string);
-    url: string;
-    static models: Map<string, Object3D>;
-    static loadModeling: Map<string, boolean>;
-    loaded: boolean;
-    hasAnimation: boolean;
-    mixer?: AnimationMixer;
-    animationActions: {
-        [key: string]: AnimationAction;
-    };
-    getSuffix(filename: string): string;
-    reset(...object: Object3D[]): this;
-    protected ensureNormals(root: Object3D): void;
-    loadModel(url: string | File | Array<File>, filename?: string): Promise<void>;
-    frustumCulled: boolean;
-    castShadow: boolean;
-    receiveShadow: boolean;
-    resoles: Array<(value: void | PromiseLike<void>) => void>;
-    awaitLoaded(): Promise<void>;
-    traverseMesh(callback: (mesh: Mesh) => void): Promise<void>;
-    clock: Clock;
-    setClipActionWeight(weights?: {
-        [key: string]: number;
-    }): Promise<void>;
-    getAnimas(): string[];
-    setAnimas(anima?: string): void;
-    stop(): void;
-    updateMatrix(): void;
-    getSize(): Promise<Vector3>;
-    center(): Promise<void>;
-    alignBottom(y?: number): Promise<void>;
-    scaleTo(size?: number, key?: Array<"x" | "y" | "z">): Promise<void>;
-    expandBynormal(length: number): void;
-}
+import { AnimationAction, AnimationMixer, Clock, Group, Mesh, Object3D, Vector3 } from "three";
+export default class MeshBase extends Group {
+    constructor(url?: string);
+    url: string;
+    static models: Map<string, Object3D>;
+    static loadModeling: Map<string, boolean>;
+    loaded: boolean;
+    hasAnimation: boolean;
+    mixer?: AnimationMixer;
+    animationActions: {
+        [key: string]: AnimationAction;
+    };
+    getSuffix(filename: string): string;
+    reset(...object: Object3D[]): this;
+    protected ensureNormals(root: Object3D): void;
+    loadModel(url: string | File | Array<File>, filename?: string): Promise<void>;
+    frustumCulled: boolean;
+    castShadow: boolean;
+    receiveShadow: boolean;
+    resoles: Array<(value: void | PromiseLike<void>) => void>;
+    awaitLoaded(): Promise<void>;
+    traverseMesh(callback: (mesh: Mesh) => void): Promise<void>;
+    clock: Clock;
+    setClipActionWeight(weights?: {
+        [key: string]: number;
+    }): Promise<void>;
+    getAnimas(): string[];
+    setAnimas(anima?: string): void;
+    stop(): void;
+    updateMatrix(): void;
+    getSize(): Promise<Vector3>;
+    center(): Promise<void>;
+    alignBottom(y?: number): Promise<void>;
+    scaleTo(size?: number, key?: Array<"x" | "y" | "z">): Promise<void>;
+    expandBynormal(length: number): void;
+}