three-base 2.0.142 → 2.0.166

package/DirectionalLight.d.ts

@@ -1,6 +1,6 @@
-import { DirectionalLight as THREEDirectionalLight, Group, Object3DEventMap } from "three";
-/** 平行光（dev 模式显示方向箭头 + 阴影范围线框） */
-export default class DirectionalLight extends THREEDirectionalLight {
-    constructor(color?: string, intensity?: number);
-    _devGroup: Group<Object3DEventMap> | false;
-}
+import { DirectionalLight as THREEDirectionalLight, Group, Object3DEventMap } from "three";
+/** 平行光（dev 模式显示方向箭头 + 阴影范围线框） */
+export default class DirectionalLight extends THREEDirectionalLight {
+    constructor(color?: string, intensity?: number);
+    _devGroup: Group<Object3DEventMap> | false;
+}

package/DirectionalLight.js

@@ -1,68 +1,68 @@
-/*
- * @Author: xiaosihan
- * @Date: 2024-06-08 14:00:00
- * @Last Modified by: xiaosihan
- * @Last Modified time: 2024-06-08 14:00:00
- */
-import { DirectionalLight as THREEDirectionalLight, Group, BufferGeometry, BufferAttribute, LineBasicMaterial, LineSegments, ConeGeometry, MeshBasicMaterial, Mesh } from "three";
-import threeUtils from "./threeUtils";
-import SpriteText from "./SpriteText";
-/** 平行光（dev 模式显示方向箭头 + 阴影范围线框） */
-export default class DirectionalLight extends THREEDirectionalLight {
-    constructor(color = "#fff", intensity = 1) {
-        super(color, intensity);
-    }
-    /* ============ dev 模式可视化 ============ */
-    _devGroup = threeUtils.isDev && (() => {
-        const group = new Group();
-        // ——— 方向箭头 ———
-        const arrVerts = new Float32Array([
-            0, 0, 0.3, 0, 0, -2,
-            0, 0, -2, -0.2, 0, -1.6,
-            0, 0, -2, 0.2, 0, -1.6,
-        ]);
-        const arrGeo = new BufferGeometry();
-        arrGeo.setAttribute("position", new BufferAttribute(arrVerts, 3));
-        const arrLine = new LineSegments(arrGeo, new LineBasicMaterial({
-            color: this.color, depthTest: false,
-        }));
-        group.add(arrLine);
-        // ——— 阴影范围线框 ———
-        const half = 2;
-        const rectVerts = new Float32Array([
-            -half, -half, -2.2, half, -half, -2.2,
-            half, -half, -2.2, half, half, -2.2,
-            half, half, -2.2, -half, half, -2.2,
-            -half, half, -2.2, -half, -half, -2.2,
-        ]);
-        const rectGeo = new BufferGeometry();
-        rectGeo.setAttribute("position", new BufferAttribute(rectVerts, 3));
-        const rectLine = new LineSegments(rectGeo, new LineBasicMaterial({
-            color: this.color, depthTest: false,
-        }));
-        group.add(rectLine);
-        // ——— 小锥体箭头头部 ———
-        const cone = new Mesh(new ConeGeometry(0.15, 0.35, 6), new MeshBasicMaterial({ color: this.color, depthTest: false }));
-        cone.position.set(0, 0, -2);
-        cone.rotation.x = Math.PI / 2;
-        group.add(cone);
-        // ——— 标签 ———
-        const label = new SpriteText("平行光\n\n");
-        label.renderOrder = Infinity;
-        label.padding = 4;
-        label.strokeColor = "#333";
-        label.strokeWidth = 2;
-        label.position.set(0, -0.5, 0);
-        label.visible = false;
-        label.material.color = this.color;
-        label.material.sizeAttenuation = false;
-        label.scale.multiplyScalar(0.003);
-        group.add(label);
-        // ——— 交互 ———
-        group.userData = { cursor: "pointer" };
-        group.addEventListener("mouseenter", () => { label.visible = true; });
-        group.addEventListener("mouseleave", () => { label.visible = false; });
-        this.add(group);
-        return group;
-    })();
-}
+/*
+ * @Author: xiaosihan
+ * @Date: 2024-06-08 14:00:00
+ * @Last Modified by: xiaosihan
+ * @Last Modified time: 2024-06-08 14:00:00
+ */
+import { DirectionalLight as THREEDirectionalLight, Group, BufferGeometry, BufferAttribute, LineBasicMaterial, LineSegments, ConeGeometry, MeshBasicMaterial, Mesh } from "three";
+import threeUtils from "./threeUtils";
+import SpriteText from "./SpriteText";
+/** 平行光（dev 模式显示方向箭头 + 阴影范围线框） */
+export default class DirectionalLight extends THREEDirectionalLight {
+    constructor(color = "#fff", intensity = 1) {
+        super(color, intensity);
+    }
+    /* ============ dev 模式可视化 ============ */
+    _devGroup = threeUtils.isDev && (() => {
+        const group = new Group();
+        // ——— 方向箭头 ———
+        const arrVerts = new Float32Array([
+            0, 0, 0.3, 0, 0, -2,
+            0, 0, -2, -0.2, 0, -1.6,
+            0, 0, -2, 0.2, 0, -1.6,
+        ]);
+        const arrGeo = new BufferGeometry();
+        arrGeo.setAttribute("position", new BufferAttribute(arrVerts, 3));
+        const arrLine = new LineSegments(arrGeo, new LineBasicMaterial({
+            color: this.color, depthTest: false,
+        }));
+        group.add(arrLine);
+        // ——— 阴影范围线框 ———
+        const half = 2;
+        const rectVerts = new Float32Array([
+            -half, -half, -2.2, half, -half, -2.2,
+            half, -half, -2.2, half, half, -2.2,
+            half, half, -2.2, -half, half, -2.2,
+            -half, half, -2.2, -half, -half, -2.2,
+        ]);
+        const rectGeo = new BufferGeometry();
+        rectGeo.setAttribute("position", new BufferAttribute(rectVerts, 3));
+        const rectLine = new LineSegments(rectGeo, new LineBasicMaterial({
+            color: this.color, depthTest: false,
+        }));
+        group.add(rectLine);
+        // ——— 小锥体箭头头部 ———
+        const cone = new Mesh(new ConeGeometry(0.15, 0.35, 6), new MeshBasicMaterial({ color: this.color, depthTest: false }));
+        cone.position.set(0, 0, -2);
+        cone.rotation.x = Math.PI / 2;
+        group.add(cone);
+        // ——— 标签 ———
+        const label = new SpriteText("平行光\n\n");
+        label.renderOrder = Infinity;
+        label.padding = 4;
+        label.strokeColor = "#333";
+        label.strokeWidth = 2;
+        label.position.set(0, -0.5, 0);
+        label.visible = false;
+        label.material.color = this.color;
+        label.material.sizeAttenuation = false;
+        label.scale.multiplyScalar(0.003);
+        group.add(label);
+        // ——— 交互 ———
+        group.userData = { cursor: "pointer" };
+        group.addEventListener("mouseenter", () => { label.visible = true; });
+        group.addEventListener("mouseleave", () => { label.visible = false; });
+        this.add(group);
+        return group;
+    })();
+}

package/EventMap.d.ts

@@ -1,103 +1,103 @@
-import type { Object3DEventMap, Vector3 } from "three";
-export interface LoadedEvent {
-    type: "loaded";
-}
-export interface LoadingEvent {
-    type: "loadding";
-}
-export interface OnLoadEvent {
-    type: "onLoad";
-}
-export interface BeforeRenderEvent {
-    type: "beforeRender";
-}
-export interface AfterRenderEvent {
-    type: "afterRender";
-}
-export interface RAFEvent {
-    type: "requestAnimationFrame";
-    timeTemp: number;
-    accumulate: number;
-}
-export interface KeyAddEvent {
-    type: "add";
-    [key: string]: unknown;
-}
-export interface KeyDeleteEvent {
-    type: "delete";
-    [key: string]: unknown;
-}
-export interface KeyEnterEvent {
-    type: "enter";
-    [key: string]: unknown;
-}
-export interface KeyChangeEvent {
-    type: "change";
-    direction: Vector3;
-}
-export interface FPSJumpStartEvent {
-    type: "jump_start";
-}
-export interface FPSJumpEndEvent {
-    type: "jump_end";
-}
-export interface FPSMoveStartEvent {
-    type: "move_start";
-}
-export interface FPSMoveEndEvent {
-    type: "move_end";
-}
-export interface MeshBaseEventMap extends Object3DEventMap {
-    "loaded": LoadedEvent;
-}
-export interface ThreeLoaderEventMap extends Object3DEventMap {
-    "loadding": LoadingEvent;
-    "onLoad": OnLoadEvent;
-}
-export interface ThreeBaseEventTypeMap extends Object3DEventMap {
-    "loadding": LoadingEvent;
-    "onLoad": OnLoadEvent;
-    "beforeRender": BeforeRenderEvent;
-    "afterRender": AfterRenderEvent;
-}
-export interface ThreeUtilsEventTypeMap extends Object3DEventMap {
-    "requestAnimationFrame": RAFEvent;
-}
-export interface KeyControlsEventTypeMap extends Object3DEventMap {
-    "add": KeyAddEvent;
-    "delete": KeyDeleteEvent;
-    "enter": KeyEnterEvent;
-    "change": KeyChangeEvent;
-}
-export interface FPScontrolEventTypeMap extends Object3DEventMap {
-    "jump_start": FPSJumpStartEvent;
-    "jump_end": FPSJumpEndEvent;
-    "move_start": FPSMoveStartEvent;
-    "move_end": FPSMoveEndEvent;
-}
-export interface SpriteWithHtmlEventMap extends Object3DEventMap {
-    "loaded": LoadedEvent;
-}
-export interface PlaneWithHtmlEventMap extends Object3DEventMap {
-    "loaded": LoadedEvent;
-}
-export interface InstancedMeshBaseEventMap extends Object3DEventMap {
-    "loaded": LoadedEvent;
-}
-/**
- * Dispatch a custom-typed event on any Three.js object.
- *
- * Why a helper instead of overriding `dispatchEvent` on every class?
- * Three.js `Object3D.dispatchEvent` is declared as:
- *   <T extends keyof Object3DEventMap>(event: BaseEvent<T> & …) => void
- * Overriding it to accept `{ type: "foo" }` breaks the method signature
- * and causes cascading errors.  This helper sidesteps the issue cleanly
- * by doing a single type assertion internally.
- */
-export declare function dispatchCustomEvent<TEvt extends {
-    type: string;
-}>(target: {
-    dispatchEvent(event: {
-        type: string;
-    }): void;
-}, event: TEvt): void;
+import type { Object3DEventMap, Vector3 } from "three";
+export interface LoadedEvent {
+    type: "loaded";
+}
+export interface LoadingEvent {
+    type: "loadding";
+}
+export interface OnLoadEvent {
+    type: "onLoad";
+}
+export interface BeforeRenderEvent {
+    type: "beforeRender";
+}
+export interface AfterRenderEvent {
+    type: "afterRender";
+}
+export interface RAFEvent {
+    type: "requestAnimationFrame";
+    timeTemp: number;
+    accumulate: number;
+}
+export interface KeyAddEvent {
+    type: "add";
+    [key: string]: unknown;
+}
+export interface KeyDeleteEvent {
+    type: "delete";
+    [key: string]: unknown;
+}
+export interface KeyEnterEvent {
+    type: "enter";
+    [key: string]: unknown;
+}
+export interface KeyChangeEvent {
+    type: "change";
+    direction: Vector3;
+}
+export interface FPSJumpStartEvent {
+    type: "jump_start";
+}
+export interface FPSJumpEndEvent {
+    type: "jump_end";
+}
+export interface FPSMoveStartEvent {
+    type: "move_start";
+}
+export interface FPSMoveEndEvent {
+    type: "move_end";
+}
+export interface MeshBaseEventMap extends Object3DEventMap {
+    "loaded": LoadedEvent;
+}
+export interface ThreeLoaderEventMap extends Object3DEventMap {
+    "loadding": LoadingEvent;
+    "onLoad": OnLoadEvent;
+}
+export interface ThreeBaseEventTypeMap extends Object3DEventMap {
+    "loadding": LoadingEvent;
+    "onLoad": OnLoadEvent;
+    "beforeRender": BeforeRenderEvent;
+    "afterRender": AfterRenderEvent;
+}
+export interface ThreeUtilsEventTypeMap extends Object3DEventMap {
+    "requestAnimationFrame": RAFEvent;
+}
+export interface KeyControlsEventTypeMap extends Object3DEventMap {
+    "add": KeyAddEvent;
+    "delete": KeyDeleteEvent;
+    "enter": KeyEnterEvent;
+    "change": KeyChangeEvent;
+}
+export interface FPScontrolEventTypeMap extends Object3DEventMap {
+    "jump_start": FPSJumpStartEvent;
+    "jump_end": FPSJumpEndEvent;
+    "move_start": FPSMoveStartEvent;
+    "move_end": FPSMoveEndEvent;
+}
+export interface SpriteWithHtmlEventMap extends Object3DEventMap {
+    "loaded": LoadedEvent;
+}
+export interface PlaneWithHtmlEventMap extends Object3DEventMap {
+    "loaded": LoadedEvent;
+}
+export interface InstancedMeshBaseEventMap extends Object3DEventMap {
+    "loaded": LoadedEvent;
+}
+/**
+ * Dispatch a custom-typed event on any Three.js object.
+ *
+ * Why a helper instead of overriding `dispatchEvent` on every class?
+ * Three.js `Object3D.dispatchEvent` is declared as:
+ *   <T extends keyof Object3DEventMap>(event: BaseEvent<T> & …) => void
+ * Overriding it to accept `{ type: "foo" }` breaks the method signature
+ * and causes cascading errors.  This helper sidesteps the issue cleanly
+ * by doing a single type assertion internally.
+ */
+export declare function dispatchCustomEvent<TEvt extends {
+    type: string;
+}>(target: {
+    dispatchEvent(event: {
+        type: string;
+    }): void;
+}, event: TEvt): void;

package/EventMap.js

@@ -1,17 +1,17 @@
-// ───────────────────────────────────────
-// Helper: type-safe custom-event dispatch
-// ───────────────────────────────────────
-/**
- * Dispatch a custom-typed event on any Three.js object.
- *
- * Why a helper instead of overriding `dispatchEvent` on every class?
- * Three.js `Object3D.dispatchEvent` is declared as:
- *   <T extends keyof Object3DEventMap>(event: BaseEvent<T> & …) => void
- * Overriding it to accept `{ type: "foo" }` breaks the method signature
- * and causes cascading errors.  This helper sidesteps the issue cleanly
- * by doing a single type assertion internally.
- */
-export function dispatchCustomEvent(target, event) {
-    // Single type assertion - unavoidable because Three.js types are strict
-    target.dispatchEvent(event);
-}
+// ───────────────────────────────────────
+// Helper: type-safe custom-event dispatch
+// ───────────────────────────────────────
+/**
+ * Dispatch a custom-typed event on any Three.js object.
+ *
+ * Why a helper instead of overriding `dispatchEvent` on every class?
+ * Three.js `Object3D.dispatchEvent` is declared as:
+ *   <T extends keyof Object3DEventMap>(event: BaseEvent<T> & …) => void
+ * Overriding it to accept `{ type: "foo" }` breaks the method signature
+ * and causes cascading errors.  This helper sidesteps the issue cleanly
+ * by doing a single type assertion internally.
+ */
+export function dispatchCustomEvent(target, event) {
+    // Single type assertion - unavoidable because Three.js types are strict
+    target.dispatchEvent(event);
+}

package/EventMesh.d.ts

@@ -1,18 +1,18 @@
-import { BoxGeometry, BufferGeometry, CylinderGeometry, Material, Mesh, MeshNormalMaterial } from "three";
-export declare enum CollisionShaere {
-    cube = "cube",
-    cylinder = "cylinder"
-}
-/**
- * 碰撞检测用的模型
- */
-export default class EventMesh extends Mesh<BufferGeometry, Material> {
-    constructor(type?: CollisionShaere);
-    static type: typeof CollisionShaere;
-    static material: MeshNormalMaterial;
-    renderOrder: number;
-    static cubeGeo: BoxGeometry;
-    static cylinderGeo: CylinderGeometry;
-    isEventMesh: boolean;
-    setType(type: CollisionShaere): void;
-}
+import { BoxGeometry, BufferGeometry, CylinderGeometry, Material, Mesh, MeshNormalMaterial } from "three";
+export declare enum CollisionShaere {
+    cube = "cube",// 正方体
+    cylinder = "cylinder"
+}
+/**
+ * 碰撞检测用的模型
+ */
+export default class EventMesh extends Mesh<BufferGeometry, Material> {
+    constructor(type?: CollisionShaere);
+    static type: typeof CollisionShaere;
+    static material: MeshNormalMaterial;
+    renderOrder: number;
+    static cubeGeo: BoxGeometry;
+    static cylinderGeo: CylinderGeometry;
+    isEventMesh: boolean;
+    setType(type: CollisionShaere): void;
+}

package/EventMesh.js

@@ -1,59 +1,59 @@
-/*
- * @Author: xiaosihan
- * @Date: 2022-03-20 12:55:37
- * @Last Modified by: xiaosihan
- * @Last Modified time: 2023-02-07 11:19:56
- */
-import { BoxGeometry, CylinderGeometry, DoubleSide, Mesh, MeshBasicMaterial, MeshNormalMaterial } from "three";
-import threeUtils from "./threeUtils";
-// 碰撞的形状
-export var CollisionShaere;
-(function (CollisionShaere) {
-    CollisionShaere["cube"] = "cube";
-    CollisionShaere["cylinder"] = "cylinder"; // 圆柱体
-})(CollisionShaere || (CollisionShaere = {}));
-/**
- * 碰撞检测用的模型
- */
-export default class EventMesh extends Mesh {
-    constructor(type = CollisionShaere.cube) {
-        super();
-        this.material = EventMesh.material;
-        this.setType(type);
-        // 生产环境 不用渲染
-        if (threeUtils.isProd) {
-            this.material = new MeshBasicMaterial({
-                side: DoubleSide,
-                transparent: true,
-                opacity: 0.25,
-                alphaTest: 1
-            });
-        }
-    }
-    static type = CollisionShaere;
-    static material = new MeshNormalMaterial({
-        side: DoubleSide,
-        transparent: true,
-        opacity: 0.3,
-    });
-    renderOrder = 99;
-    // 正方体 网格模型
-    static cubeGeo = new BoxGeometry(1, 1, 1, 1, 1, 1);
-    // 圆柱体 网格模型
-    static cylinderGeo = new CylinderGeometry(1, 1, 1, 50, 1, false, 0, Math.PI * 2);
-    // 是否是碰撞检测专用的模型
-    isEventMesh = true;
-    setType(type) {
-        switch (type) {
-            case EventMesh.type.cube:
-                this.geometry = EventMesh.cubeGeo;
-                break;
-            case EventMesh.type.cylinder:
-                this.geometry = EventMesh.cylinderGeo;
-                break;
-            default:
-                break;
-        }
-        this.geometry.computeVertexNormals();
-    }
-}
+/*
+ * @Author: xiaosihan
+ * @Date: 2022-03-20 12:55:37
+ * @Last Modified by: xiaosihan
+ * @Last Modified time: 2023-02-07 11:19:56
+ */
+import { BoxGeometry, CylinderGeometry, DoubleSide, Mesh, MeshBasicMaterial, MeshNormalMaterial } from "three";
+import threeUtils from "./threeUtils";
+// 碰撞的形状
+export var CollisionShaere;
+(function (CollisionShaere) {
+    CollisionShaere["cube"] = "cube";
+    CollisionShaere["cylinder"] = "cylinder"; // 圆柱体
+})(CollisionShaere || (CollisionShaere = {}));
+/**
+ * 碰撞检测用的模型
+ */
+export default class EventMesh extends Mesh {
+    constructor(type = CollisionShaere.cube) {
+        super();
+        this.material = EventMesh.material;
+        this.setType(type);
+        // 生产环境 不用渲染
+        if (threeUtils.isProd) {
+            this.material = new MeshBasicMaterial({
+                side: DoubleSide,
+                transparent: true,
+                opacity: 0.25,
+                alphaTest: 1
+            });
+        }
+    }
+    static type = CollisionShaere;
+    static material = new MeshNormalMaterial({
+        side: DoubleSide,
+        transparent: true,
+        opacity: 0.3,
+    });
+    renderOrder = 99;
+    // 正方体 网格模型
+    static cubeGeo = new BoxGeometry(1, 1, 1, 1, 1, 1);
+    // 圆柱体 网格模型
+    static cylinderGeo = new CylinderGeometry(1, 1, 1, 50, 1, false, 0, Math.PI * 2);
+    // 是否是碰撞检测专用的模型
+    isEventMesh = true;
+    setType(type) {
+        switch (type) {
+            case EventMesh.type.cube:
+                this.geometry = EventMesh.cubeGeo;
+                break;
+            case EventMesh.type.cylinder:
+                this.geometry = EventMesh.cylinderGeo;
+                break;
+            default:
+                break;
+        }
+        this.geometry.computeVertexNormals();
+    }
+}