@vyr/three 0.0.32 → 0.0.35

package/src/descriptor/animation/AnimationAction.ts

@@ -0,0 +1,82 @@
+import { Descriptor, DeserializationObject } from "@vyr/engine";
+
+/**
+ * ActionLoop枚举
+ * 动画循环模式枚举
+ * 
+ * 作用：定义动画的循环行为模式
+ */
+export enum ActionLoop {
+    /**只播放一次 */
+    LoopOnce = 2200,
+    /**重复播放 */
+    LoopRepeat = 2201,
+    /**往返播放 */
+    LoopPingPong = 2202,
+}
+
+/**
+ * ActionBlendMode枚举
+ * 动画混合模式枚举
+ * 
+ * 作用：定义动画的混合方式
+ */
+export enum ActionBlendMode {
+    /**正常混合模式 */
+    NormalAnimationBlendMode = 2500,
+    /** additive混合模式 */
+    AdditiveAnimationBlendMode = 2501,
+}
+
+/**
+ * AnimationAction类
+ * 动画动作类，用于控制动画的播放行为
+ * 
+ * 作用：创建和管理动画动作实例，支持设置循环模式、混合模式、播放状态等属性
+ * 注意：该类只能作为`Model`的子节点，`clip`属性只能设置为模型自带的动画名
+ */
+export class AnimationAction extends Descriptor {
+    /**类类型标识 */
+    static type = 'AnimationAction'
+    /**动画剪辑引用，指向动画资源的唯一标识 @default "" */
+    clip: string
+    /**是否自动播放 @default false */
+    play: boolean
+    /**动画持续时间，-1表示使用剪辑的原始时长 @default -1 */
+    duration: number
+    /**动画混合模式 @default ActionBlendMode.NormalAnimationBlendMode */
+    blendMode: ActionBlendMode
+    /**动画循环模式 @default ActionLoop.LoopRepeat */
+    loop: ActionLoop
+    /**动画重复次数 @default Infinity */
+    repetitions: number
+    /**动画开始时间 @default 0 */
+    startTime: number
+    /**动画权重 @default 1 */
+    weight: number
+    /**是否启用 @default true */
+    enabled: boolean
+    /**动画时间缩放 @default 1 */
+    timeScale: number
+    /**是否在结束时使用零斜率 @default true */
+    zeroSlopeAtEnd: boolean
+    /**是否在开始时使用零斜率 @default true */
+    zeroSlopeAtStart: boolean
+
+    constructor(descriptor: Partial<DeserializationObject<AnimationAction>> = {}) {
+        super(descriptor)
+        this.clip = descriptor.clip ?? ''
+        this.play = descriptor.play ?? false
+        this.duration = descriptor.duration ?? -1
+        this.blendMode = descriptor.blendMode ?? ActionBlendMode.NormalAnimationBlendMode
+        this.loop = descriptor.loop ?? ActionLoop.LoopRepeat
+        this.repetitions = descriptor.repetitions ?? Infinity
+        this.startTime = descriptor.startTime ?? 0
+        this.weight = descriptor.weight ?? 1
+        this.enabled = descriptor.enabled ?? true
+        this.timeScale = descriptor.timeScale ?? 1
+        this.zeroSlopeAtEnd = descriptor.zeroSlopeAtEnd ?? true
+        this.zeroSlopeAtStart = descriptor.zeroSlopeAtStart ?? true
+    }
+}
+Descriptor.register(AnimationAction)

package/src/descriptor/geometry/BoxGeometry.ts

@@ -0,0 +1,38 @@
+import { DeserializationObject, Descriptor } from '@vyr/engine'
+import { Geometry } from "./Geometry"
+
+/**
+ * BoxGeometry类
+ * 立方体几何体类
+ * 
+ * 作用：创建和管理立方体几何体实例，支持设置尺寸和分段数
+ */
+export class BoxGeometry extends Descriptor implements Geometry {
+    /**类类型标识 */
+    static type = 'BoxGeometry'
+    /**几何标识 */
+    readonly isGeometry = true
+    /**立方体宽度 @default 1 */
+    width: number
+    /**立方体高度 @default 1 */
+    height: number
+    /**立方体深度 @default 1 */
+    depth: number
+    /**宽度方向的分段数 @default 1 */
+    widthSegments: number
+    /**高度方向的分段数 @default 1 */
+    heightSegments: number
+    /**深度方向的分段数 @default 1 */
+    depthSegments: number
+
+    constructor(descriptor: Partial<DeserializationObject<BoxGeometry>> = {}) {
+        super(descriptor)
+        this.width = descriptor.width ?? 1
+        this.height = descriptor.height ?? 1
+        this.depth = descriptor.depth ?? 1
+        this.widthSegments = descriptor.widthSegments ?? 1
+        this.heightSegments = descriptor.heightSegments ?? 1
+        this.depthSegments = descriptor.depthSegments ?? 1
+    }
+}
+Descriptor.register(BoxGeometry)

package/src/descriptor/geometry/BufferGeometry.ts

@@ -0,0 +1,23 @@
+import { DeserializationObject, Descriptor } from '@vyr/engine'
+import { Geometry } from "./Geometry"
+
+/**
+ * BufferGeometry类
+ * 缓冲几何体类
+ * 
+ * 作用：创建和管理缓冲几何体实例，支持通过缓冲区数据定义几何体
+ */
+export class BufferGeometry extends Descriptor implements Geometry {
+    /**类类型标识 */
+    static type = 'BufferGeometry'
+    /**几何标识 */
+    readonly isGeometry = true
+    /**缓冲区数据引用，使用`Store`的URL作为有效值 @default "" */
+    buffer: string
+
+    constructor(descriptor: Partial<DeserializationObject<BufferGeometry>> = {}) {
+        super(descriptor)
+        this.buffer = descriptor.buffer ?? ''
+    }
+}
+Descriptor.register(BufferGeometry)

package/src/descriptor/geometry/CircleGeometry.ts

@@ -0,0 +1,32 @@
+import { DeserializationObject, Descriptor } from '@vyr/engine'
+import { Geometry } from "./Geometry"
+
+/**
+ * CircleGeometry类
+ * 圆形几何体类
+ * 
+ * 作用：创建和管理圆形几何体实例，支持设置半径、分段数和角度范围
+ */
+export class CircleGeometry extends Descriptor implements Geometry {
+    /**类类型标识 */
+    static type = 'CircleGeometry'
+    /**几何标识 */
+    readonly isGeometry = true
+    /**圆的半径 @default 1 */
+    radius: number
+    /**圆的分段数，影响平滑度 @default 32 */
+    segments: number
+    /**起始角度（弧度） @default 0 */
+    thetaStart: number
+    /**角度范围（弧度） @default Math.PI * 2 */
+    thetaLength: number
+
+    constructor(descriptor: Partial<DeserializationObject<CircleGeometry>> = {}) {
+        super(descriptor)
+        this.radius = descriptor.radius ?? 1
+        this.segments = descriptor.segments ?? 32
+        this.thetaStart = descriptor.thetaStart ?? 0
+        this.thetaLength = descriptor.thetaLength ?? Math.PI * 2
+    }
+}
+Descriptor.register(CircleGeometry)

package/src/descriptor/geometry/CylinderGeometry.ts

@@ -0,0 +1,44 @@
+import { DeserializationObject, Descriptor } from "@vyr/engine"
+import { Geometry } from "./Geometry"
+
+/**
+ * CylinderGeometry类
+ * 圆柱体几何体类
+ * 
+ * 作用：创建和管理圆柱体几何体实例，支持设置顶部半径、底部半径、高度和分段数等属性
+ */
+export class CylinderGeometry extends Descriptor implements Geometry {
+    /**类类型标识 */
+    static type = 'CylinderGeometry'
+    /**几何标识 */
+    readonly isGeometry = true
+    /**顶部半径 @default 1 */
+    radiusTop: number
+    /**底部半径 @default 1 */
+    radiusBottom: number
+    /**圆柱体高度 @default 1 */
+    height: number
+    /**径向分段数，影响圆周平滑度 @default 32 */
+    radialSegments: number
+    /**高度分段数，影响高度方向平滑度 @default 1 */
+    heightSegments: number
+    /**是否为开口圆柱体 @default false */
+    openEnded: boolean
+    /**起始角度（弧度） @default 0 */
+    thetaStart: number
+    /**角度范围（弧度） @default Math.PI * 2 */
+    thetaLength: number
+
+    constructor(descriptor: Partial<DeserializationObject<CylinderGeometry>> = {}) {
+        super(descriptor)
+        this.radiusTop = descriptor.radiusTop ?? 1
+        this.radiusBottom = descriptor.radiusBottom ?? 1
+        this.height = descriptor.height ?? 1
+        this.radialSegments = descriptor.radialSegments ?? 32
+        this.heightSegments = descriptor.heightSegments ?? 1
+        this.openEnded = descriptor.openEnded ?? false
+        this.thetaStart = descriptor.thetaStart ?? 0
+        this.thetaLength = descriptor.thetaLength ?? Math.PI * 2
+    }
+}
+Descriptor.register(CylinderGeometry)

package/src/descriptor/geometry/ExtrudeGeometry.ts

@@ -0,0 +1,53 @@
+import { DeserializationObject, Descriptor, Vector2 } from "@vyr/engine"
+import { Geometry } from "./Geometry"
+
+/**
+ * ExtrudeGeometry类
+ * 拉伸几何体类
+ * 
+ * 作用：创建和管理拉伸几何体实例，支持通过2D形状创建3D拉伸模型
+ */
+export class ExtrudeGeometry extends Descriptor implements Geometry {
+    /**类类型标识 */
+    static type = 'ExtrudeGeometry'
+    /**几何标识 */
+    readonly isGeometry = true
+    /**形状数据引用，使用`Store`的URL作为有效值 @default "" */
+    shapes: string
+    /**偏移量 @default new Vector2() */
+    offset: Vector2
+    /**是否将UV展平到平面 @default false */
+    flattenUVsToPlane: boolean
+    /**曲线分段数，影响平滑度 @default 12 */
+    curveSegments: number
+    /**拉伸方向的步数 @default 1 */
+    steps: number
+    /**拉伸深度 @default 1 */
+    depth: number
+    /**是否启用倒角 @default true */
+    bevelEnabled: boolean
+    /**倒角厚度 @default 0.2 */
+    bevelThickness: number
+    /**倒角大小 @default 0.1 */
+    bevelSize: number
+    /**倒角偏移 @default 0 */
+    bevelOffset: number
+    /**倒角分段数 @default 3 */
+    bevelSegments: number
+
+    constructor(descriptor: Partial<DeserializationObject<ExtrudeGeometry>> = {}) {
+        super(descriptor)
+        this.shapes = descriptor.shapes ?? ''
+        this.offset = descriptor.offset ? Descriptor.deepClone(descriptor.offset) : new Vector2()
+        this.flattenUVsToPlane = descriptor.flattenUVsToPlane ?? false
+        this.curveSegments = descriptor.curveSegments ?? 12
+        this.steps = descriptor.steps ?? 1
+        this.depth = descriptor.depth ?? 1
+        this.bevelEnabled = descriptor.bevelEnabled ?? true
+        this.bevelThickness = descriptor.bevelThickness ?? 0.2
+        this.bevelSize = descriptor.bevelSize ?? 0.1
+        this.bevelOffset = descriptor.bevelOffset ?? 0
+        this.bevelSegments = descriptor.bevelSegments ?? 3
+    }
+}
+Descriptor.register(ExtrudeGeometry)

package/src/descriptor/geometry/Geometry.ts

@@ -0,0 +1,12 @@
+import { Descriptor } from '@vyr/engine'
+
+/**
+ * Geometry接口
+ * 几何体接口
+ * 
+ * 作用：定义几何体的基本标识属性，所有几何体类都应实现此接口
+ */
+export interface Geometry extends Descriptor {
+    /**几何标识，用于标识对象是否为几何体 */
+    readonly isGeometry: boolean
+}

package/src/descriptor/geometry/PlaneGeometry.ts

@@ -0,0 +1,32 @@
+import { DeserializationObject, Descriptor } from "@vyr/engine"
+import { Geometry } from "./Geometry"
+
+/**
+ * PlaneGeometry类
+ * 平面几何体类
+ * 
+ * 作用：创建和管理平面几何体实例，支持设置宽度、高度和分段数
+ */
+export class PlaneGeometry extends Descriptor implements Geometry {
+    /**类类型标识 */
+    static type = 'PlaneGeometry'
+    /**几何标识 */
+    readonly isGeometry = true
+    /**平面宽度 @default 1 */
+    width: number
+    /**平面高度 @default 1 */
+    height: number
+    /**宽度方向的分段数 @default 1 */
+    widthSegments: number
+    /**高度方向的分段数 @default 1 */
+    heightSegments: number
+
+    constructor(descriptor: Partial<DeserializationObject<PlaneGeometry>> = {}) {
+        super(descriptor)
+        this.width = descriptor.width ?? 1
+        this.height = descriptor.height ?? 1
+        this.widthSegments = descriptor.widthSegments ?? 1
+        this.heightSegments = descriptor.heightSegments ?? 1
+    }
+}
+Descriptor.register(PlaneGeometry)

package/src/descriptor/geometry/RingGeometry.ts

@@ -0,0 +1,38 @@
+import { DeserializationObject, Descriptor } from "@vyr/engine"
+import { Geometry } from "./Geometry"
+
+/**
+ * RingGeometry类
+ * 圆环几何体类
+ * 
+ * 作用：创建和管理圆环几何体实例，支持设置内外半径、分段数和角度范围
+ */
+export class RingGeometry extends Descriptor implements Geometry {
+    /**类类型标识 */
+    static type = 'RingGeometry'
+    /**几何标识 */
+    readonly isGeometry = true
+    /**圆环内半径 @default 0.5 */
+    innerRadius: number
+    /**圆环外半径 @default 1 */
+    outerRadius: number
+    /**圆周方向的分段数，影响平滑度 @default 32 */
+    thetaSegments: number
+    /**径向的分段数 @default 1 */
+    phiSegments: number
+    /**起始角度（弧度） @default 0 */
+    thetaStart: number
+    /**角度范围（弧度） @default Math.PI * 2 */
+    thetaLength: number
+
+    constructor(descriptor: Partial<DeserializationObject<RingGeometry>> = {}) {
+        super(descriptor)
+        this.innerRadius = descriptor.innerRadius ?? 0.5
+        this.outerRadius = descriptor.outerRadius ?? 1
+        this.thetaSegments = descriptor.thetaSegments ?? 32
+        this.phiSegments = descriptor.phiSegments ?? 1
+        this.thetaStart = descriptor.thetaStart ?? 0
+        this.thetaLength = descriptor.thetaLength ?? Math.PI * 2
+    }
+}
+Descriptor.register(RingGeometry)

package/src/descriptor/geometry/SphereGeometry.ts

@@ -0,0 +1,41 @@
+import { DeserializationObject, Descriptor } from "@vyr/engine"
+import { Geometry } from "./Geometry"
+
+/**
+ * SphereGeometry类
+ * 球体几何体类
+ * 
+ * 作用：创建和管理球体几何体实例，支持设置半径、分段数和角度范围
+ */
+export class SphereGeometry extends Descriptor implements Geometry {
+    /**类类型标识 */
+    static type = 'SphereGeometry'
+    /**几何标识 */
+    readonly isGeometry = true
+    /**球体半径 @default 1 */
+    radius: number
+    /**水平方向的分段数，影响平滑度 @default 32 */
+    widthSegments: number
+    /**垂直方向的分段数，影响平滑度 @default 16 */
+    heightSegments: number
+    /**水平方向起始角度（弧度） @default 0 */
+    phiStart: number
+    /**水平方向角度范围（弧度） @default Math.PI * 2 */
+    phiLength: number
+    /**垂直方向起始角度（弧度） @default 0 */
+    thetaStart: number
+    /**垂直方向角度范围（弧度） @default Math.PI */
+    thetaLength: number
+
+    constructor(descriptor: Partial<DeserializationObject<SphereGeometry>> = {}) {
+        super(descriptor)
+        this.radius = descriptor.radius ?? 1
+        this.widthSegments = descriptor.widthSegments ?? 32
+        this.heightSegments = descriptor.heightSegments ?? 16
+        this.phiStart = descriptor.phiStart ?? 0
+        this.phiLength = descriptor.phiLength ?? Math.PI * 2
+        this.thetaStart = descriptor.thetaStart ?? 0
+        this.thetaLength = descriptor.thetaLength ?? Math.PI
+    }
+}
+Descriptor.register(SphereGeometry)

package/src/descriptor/geometry/SurfaceGeometry.ts

@@ -0,0 +1,21 @@
+import { DeserializationObject, Descriptor } from "@vyr/engine"
+import { ExtrudeGeometry } from "./ExtrudeGeometry"
+
+/**
+ * SurfaceGeometry类
+ * 表面几何体类
+ * 
+ * 作用：创建和管理表面几何体实例，支持通过2D形状创建3D表面模型
+ */
+export class SurfaceGeometry extends ExtrudeGeometry {
+    /**类类型标识 */
+    static type = 'SurfaceGeometry'
+    /**表面半径 @default 1 */
+    radius: number
+
+    constructor(descriptor: Partial<DeserializationObject<SurfaceGeometry>> = {}) {
+        super(descriptor)
+        this.radius = descriptor.radius ?? 1
+    }
+}
+Descriptor.register(SurfaceGeometry)

package/src/descriptor/geometry/TubeGeometry.ts

@@ -0,0 +1,38 @@
+import { DeserializationObject, Descriptor, Vector2 } from "@vyr/engine"
+import { Geometry } from "./Geometry"
+
+/**
+ * TubeGeometry类
+ * 管状几何体类
+ * 
+ * 作用：创建和管理管状几何体实例，支持通过路径创建3D管状模型
+ */
+export class TubeGeometry extends Descriptor implements Geometry {
+    /**类类型标识 */
+    static type = 'TubeGeometry'
+    /**几何标识 */
+    readonly isGeometry = true
+    /**路径数据引用，使用`Store`的URL作为有效值 @default "" */
+    track: string
+    /**偏移量 @default new Vector2() */
+    offset: Vector2
+    /**管状分段数，影响路径平滑度 @default 64 */
+    tubularSegments: number
+    /**管半径 @default 1 */
+    radius: number
+    /**径向分段数，影响管截面平滑度 @default 8 */
+    radialSegments: number
+    /**是否闭合 @default false */
+    closed: boolean
+
+    constructor(descriptor: Partial<DeserializationObject<TubeGeometry>> = {}) {
+        super(descriptor)
+        this.track = descriptor.track ?? ''
+        this.offset = descriptor.offset ? Descriptor.deepClone(descriptor.offset) : new Vector2()
+        this.tubularSegments = descriptor.tubularSegments ?? 64
+        this.radius = descriptor.radius ?? 1
+        this.radialSegments = descriptor.radialSegments ?? 8
+        this.closed = descriptor.closed ?? false
+    }
+}
+Descriptor.register(TubeGeometry)

package/src/descriptor/helper/AxesHelper.ts

@@ -0,0 +1,13 @@
+import { Node } from "@vyr/engine";
+
+/**
+ * AxesHelper类
+ * 坐标轴辅助类
+ * 
+ * 作用：创建和管理坐标轴辅助实例，用于在场景中显示三维坐标轴
+ */
+export class AxesHelper extends Node {
+    /**类类型标识 */
+    static type = 'AxesHelper'
+}
+Node.register(AxesHelper)

package/src/descriptor/index.ts

@@ -1,45 +1,45 @@
-export * from './geometry/GeometryDescriptor'
-export * from './geometry/BoxGeometryDescriptor'
-export * from './geometry/CircleGeometryDescriptor'
-export * from './geometry/CylinderGeometryDescriptor'
-export * from './geometry/PlaneGeometryDescriptor'
-export * from './geometry/RingGeometryDescriptor'
-export * from './geometry/SphereGeometryDescriptor'
-export * from './geometry/ExtrudeGeometryDescriptor'
-export * from './geometry/SurfaceGeometryDescriptor'
-export * from './geometry/TubeGeometryDescriptor'
-export * from './geometry/BufferGeometryDescriptor'
-export * from './material/MaterialDescriptor'
-export * from './material/MeshBasicMaterialDescriptor'
-export * from './material/MeshPhongMaterialDescriptor'
-export * from './material/MeshStandardMaterialDescriptor'
-export * from './material/PointsMaterialDescriptor'
-export * from './material/SpriteMaterialDescriptor'
-export * from './material/ShadowMaterialDescriptor'
-export * from './material/ShaderMaterialDescriptor'
-export * from './texture/TextureDescriptor'
-export * from './animation/AnimationActionDescriptor'
-export * from './light/LightDescriptor'
-export * from './light/AmbientLightDescriptor'
-export * from './light/DirectionalLightDescriptor'
-export * from './light/HemisphereLightDescriptor'
-export * from './light/PointLightDescriptor'
-export * from './light/RectAreaLightDescriptor'
-export * from './light/SpotLightDescriptor'
-export * from './MeshDescriptor'
-export * from './InstancedMeshDescriptor'
-export * from './TextDescriptor'
-export * from './PointsDescriptor'
-export * from './ParticleDescriptor'
-export * from './SpriteDescriptor'
-export * from './HTMLConvertDescriptor'
-export * from './GeoMapDescriptor'
-export * from './ModelDescriptor'
-export * from './OrthographicCameraDescriptor'
-export * from './PerspectiveCameraDescriptor'
-export * from './OrbitControllerDescriptor'
-export * from './TransformControllerDescriptor'
-export * from './helper/AxesHelperDescriptor'
-export * from './SceneServiceDescriptor'
-// export * from './ComposerServiceDescriptor'
-// export * from './PassDescriptor'
+export * from './geometry/Geometry'
+export * from './geometry/BoxGeometry'
+export * from './geometry/CircleGeometry'
+export * from './geometry/CylinderGeometry'
+export * from './geometry/PlaneGeometry'
+export * from './geometry/RingGeometry'
+export * from './geometry/SphereGeometry'
+export * from './geometry/ExtrudeGeometry'
+export * from './geometry/SurfaceGeometry'
+export * from './geometry/TubeGeometry'
+export * from './geometry/BufferGeometry'
+export * from './material/Material'
+export * from './material/MeshBasicMaterial'
+export * from './material/MeshPhongMaterial'
+export * from './material/MeshStandardMaterial'
+export * from './material/PointsMaterial'
+export * from './material/SpriteMaterial'
+export * from './material/ShadowMaterial'
+export * from './material/ShaderMaterial'
+export * from './texture/Texture'
+export * from './animation/AnimationAction'
+export * from './light/Light'
+export * from './light/AmbientLight'
+export * from './light/DirectionalLight'
+export * from './light/HemisphereLight'
+export * from './light/PointLight'
+export * from './light/RectAreaLight'
+export * from './light/SpotLight'
+export * from './Mesh'
+export * from './InstancedMesh'
+export * from './Text3D'
+export * from './Points'
+export * from './Particle'
+export * from './Sprite'
+export * from './HTMLConvert'
+export * from './GeoMap'
+export * from './Model'
+export * from './OrthographicCamera'
+export * from './PerspectiveCamera'
+export * from './OrbitController'
+export * from './TransformController'
+export * from './helper/AxesHelper'
+export * from './Scene3DService'
+export * from './ComposerService'
+export * from './Pass'

package/src/descriptor/light/AmbientLight.ts

@@ -0,0 +1,26 @@
+import { DeserializationObject, Descriptor, Node } from "@vyr/engine";
+import { Light } from "./Light";
+
+/**
+ * AmbientLight类
+ * 环境光类
+ * 
+ * 作用：创建和管理环境光实例，用于提供场景的基础照明
+ */
+export class AmbientLight extends Node implements Light {
+    /**类类型标识 */
+    static type = 'AmbientLight'
+    /**光源标识 */
+    readonly isLight = true
+    /**光源颜色，使用十六进制颜色值 @default "#ffffff" */
+    color: string
+    /**光源强度 @default 1 */
+    intensity: number
+
+    constructor(descriptor: Partial<DeserializationObject<AmbientLight>> = {}) {
+        super(descriptor)
+        this.color = descriptor.color ?? '#ffffff'
+        this.intensity = descriptor.intensity ?? 1
+    }
+}
+Node.register(AmbientLight)

package/src/descriptor/light/DirectionalLight.ts

@@ -0,0 +1,62 @@
+import { DeserializationObject, Descriptor, Node, Vector2 } from "@vyr/engine";
+import { Light } from "./Light";
+
+/**
+ * DirectionalCamera接口
+ * 平行光相机接口
+ * 
+ * 作用：定义平行光阴影相机的参数
+ */
+export interface DirectionalCamera {
+    /**近裁剪面 @default 0.5 */
+    near: number;
+    /**远裁剪面 @default 500 */
+    far: number
+    /**左边界 @default -5 */
+    left: number
+    /**右边界 @default 5 */
+    right: number
+    /**上边界 @default 5 */
+    top: number
+    /**下边界 @default -5 */
+    bottom: number
+}
+
+/**
+ * DirectionalLight类
+ * 平行光类
+ * 
+ * 作用：创建和管理平行光实例，用于提供方向性照明和阴影
+ */
+export class DirectionalLight extends Node implements Light {
+    /**类类型标识 */
+    static type = 'DirectionalLight'
+    /**光源标识 */
+    readonly isLight = true
+    /**光源颜色，使用十六进制颜色值 @default "#ffffff" */
+    color: string
+    /**光源强度 @default 1 */
+    intensity: number
+    /**光源目标引用 @default "" */
+    target: string
+    /**阴影偏移 @default 0 */
+    bias: number
+    /**法线偏移 @default 0 */
+    normalBias: number
+    /**阴影贴图尺寸 @default {x:512, y:512} */
+    mapSize: Vector2
+    /**平行光相机参数 @default { near: 0.5, far: 500, left: -5, right: 5, top: 5, bottom: -5 } */
+    camera: DirectionalCamera
+
+    constructor(descriptor: Partial<DeserializationObject<DirectionalLight>> = {}) {
+        super(descriptor)
+        this.color = descriptor.color ?? '#ffffff'
+        this.intensity = descriptor.intensity ?? 1
+        this.target = descriptor.target ?? ''
+        this.bias = descriptor.bias ?? 0
+        this.normalBias = descriptor.normalBias ?? 0
+        this.mapSize = descriptor.mapSize ? Vector2.create(descriptor.mapSize) : Vector2.create(512, 512)
+        this.camera = descriptor.camera ? Descriptor.deepClone(descriptor.camera) : { near: 0.5, far: 500, left: -5, right: 5, top: 5, bottom: -5 }
+    }
+}
+Node.register(DirectionalLight)