angular-three-soba 4.0.2 → 4.0.4

package/misc/README.md

@@ -8,6 +8,7 @@ This secondary entry point includes miscellaneous utilities and components for a
 - [fbo](#fbo)
 - [NgtsFBO](#ngtsfbo)
 - [NgtsBakeShadows](#ngtsbakeshadows)
+- [NgtsSoftShadows](#ngtssoftshadows)
 - [depthBuffer](#depthbuffer)
 - [NgtsSampler](#ngtssampler)
 - [surfaceSampler](#surfacesampler)
@@ -133,6 +134,24 @@ A directive that bakes shadows in your scene. It sets `gl.shadowMap.autoUpdate`
 <ngts-bake-shadows />
 ```
 
+## NgtsSoftShadows
+
+A directive that injects Percentage-Closer Soft Shadows (PCSS) into the scene. PCSS produces contact-hardening soft shadows where shadows are sharper near the contact point and softer further away, creating more realistic shadow effects.
+
+This works by patching Three.js's shadow shader chunk at runtime. When the directive is destroyed or options change, it restores the original shader and recompiles affected materials.
+
+```html
+<ngts-soft-shadows [options]="{ size: 25, samples: 10, focus: 0 }" />
+```
+
+### Options (NgtsSoftShadowsOptions)
+
+| Property  | Description                                                                                  | Default |
+| --------- | -------------------------------------------------------------------------------------------- | ------- |
+| `size`    | Size of the light source. The larger the value, the softer the shadows.                      | `25`    |
+| `samples` | Number of samples for shadow calculation. More samples = less noise but more expensive.      | `10`    |
+| `focus`   | Depth focus to shift the focal point where the shadow is sharpest. 0 means at the beginning. | `0`     |
+
 ## `depthBuffer`
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "angular-three-soba",
-	"version": "4.0.2",
+	"version": "4.0.4",
 	"publishConfig": {
 		"access": "public"
 	},

package/types/angular-three-soba-abstractions.d.ts

@@ -121,7 +121,7 @@ declare class NgtsLine {
      * Configuration options for the line appearance and behavior.
      */
     options: _angular_core.InputSignalWithTransform<NgtsLineOptions, "" | Partial<NgtsLineOptions>>;
-    protected parameters: _angular_core.Signal<Omit<NgtsLineOptions, "color" | "dashed" | "linewidth" | "vertexColors" | "lineWidth" | "segments">>;
+    protected parameters: _angular_core.Signal<Omit<NgtsLineOptions, "vertexColors" | "color" | "dashed" | "linewidth" | "lineWidth" | "segments">>;
     /**
      * Reference to the underlying Line2 or LineSegments2 Three.js object.
      */
@@ -313,43 +313,10 @@ declare class NgtsCatmullRomLine {
         }[T]) => void)>)) | undefined;
         dispose?: (((() => void) | Readonly<() => void> | null) & (((() => void) & (() => void)) | Readonly<(() => void) & (() => void)>)) | undefined;
         parameters?: ((Partial<three_stdlib.Line2> | Readonly<Partial<three_stdlib.Line2>>) & (Partial<three_stdlib.LineMaterial> | Readonly<Partial<three_stdlib.LineMaterial>>)) | undefined;
-        geometry?: three_stdlib.LineGeometry | Readonly<three_stdlib.LineGeometry | undefined>;
-        material?: three_stdlib.LineMaterial | Readonly<three_stdlib.LineMaterial | undefined>;
-        isLine2?: true | undefined;
-        isLineSegments2?: true | undefined;
-        computeLineDistances?: (() => three_stdlib.Line2) | Readonly<(() => three_stdlib.Line2) | undefined>;
-        isMesh?: true | undefined;
-        morphTargetInfluences?: number[] | Readonly<number[] | undefined>;
-        morphTargetDictionary?: {
-            [key: string]: number;
-        } | Readonly<{
-            [key: string]: number;
-        } | undefined>;
-        count?: Readonly<number | undefined>;
-        updateMorphTargets?: (() => void) | Readonly<(() => void) | undefined>;
-        getVertexPosition?: ((index: number, target: THREE.Vector3) => THREE.Vector3) | Readonly<((index: number, target: THREE.Vector3) => THREE.Vector3) | undefined>;
         color?: THREE.ColorRepresentation | undefined;
-        dashed?: boolean | undefined | undefined;
-        dashScale?: number | undefined | undefined;
-        dashSize?: number | undefined | undefined;
-        dashOffset?: number | undefined | undefined;
-        gapSize?: number | undefined | undefined;
-        opacity?: number | undefined;
-        isLineMaterial?: true | undefined;
-        linewidth?: number | undefined | undefined;
-        resolution?: (THREE.Vector2 & (number | THREE.Vector2 | [x: number, y: number] | Readonly<THREE.Vector2> | readonly [x: number, y: number])) | undefined;
-        alphaToCoverage?: boolean | undefined | undefined;
-        worldUnits?: boolean | undefined | undefined;
-        isShaderMaterial?: Readonly<boolean | undefined>;
-        setValues?: ((values?: THREE.ShaderMaterialParameters) => void) | Readonly<((values?: THREE.ShaderMaterialParameters) => void) | undefined>;
-        defines?: Record<string, unknown> | Readonly<Record<string, unknown> | undefined>;
-        isMaterial?: Readonly<boolean | undefined>;
-        version?: Readonly<number | undefined>;
-        onBeforeCompile?: ((parameters: THREE.WebGLProgramParametersWithUniforms, renderer: THREE.WebGLRenderer) => void) | Readonly<((parameters: THREE.WebGLProgramParametersWithUniforms, renderer: THREE.WebGLRenderer) => void) | undefined>;
-        customProgramCacheKey?: (() => string) | Readonly<(() => string) | undefined>;
-        needsUpdate?: Readonly<boolean | undefined>;
         blending?: 0 | 1 | 2 | 3 | 4 | 5 | undefined;
         side?: 0 | 1 | 2 | undefined;
+        opacity?: number | undefined;
         transparent?: boolean | undefined;
         alphaHash?: boolean | undefined;
         blendSrc?: 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 209 | 210 | 211 | 212 | 213 | 214 | undefined;
@@ -381,11 +348,45 @@ declare class NgtsCatmullRomLine {
         polygonOffsetFactor?: number | undefined;
         polygonOffsetUnits?: number | undefined;
         dithering?: boolean | undefined;
+        alphaToCoverage?: boolean | undefined | undefined;
         premultipliedAlpha?: boolean | undefined;
         forceSinglePass?: boolean | undefined;
         allowOverride?: boolean | undefined;
         toneMapped?: boolean | undefined;
         alphaTest?: number | undefined;
+        dashed?: boolean | undefined | undefined;
+        dashScale?: number | undefined | undefined;
+        dashSize?: number | undefined | undefined;
+        dashOffset?: number | undefined | undefined;
+        gapSize?: number | undefined | undefined;
+        linewidth?: number | undefined | undefined;
+        resolution?: (THREE.Vector2 & (number | THREE.Vector2 | [x: number, y: number] | Readonly<THREE.Vector2> | readonly [x: number, y: number])) | undefined;
+        wireframe?: boolean | undefined | undefined;
+        worldUnits?: boolean | undefined | undefined;
+        geometry?: three_stdlib.LineGeometry | Readonly<three_stdlib.LineGeometry | undefined>;
+        material?: three_stdlib.LineMaterial | Readonly<three_stdlib.LineMaterial | undefined>;
+        isLine2?: true | undefined;
+        isLineSegments2?: true | undefined;
+        computeLineDistances?: (() => three_stdlib.Line2) | Readonly<(() => three_stdlib.Line2) | undefined>;
+        isMesh?: true | undefined;
+        morphTargetInfluences?: number[] | Readonly<number[] | undefined>;
+        morphTargetDictionary?: {
+            [key: string]: number;
+        } | Readonly<{
+            [key: string]: number;
+        } | undefined>;
+        count?: Readonly<number | undefined>;
+        updateMorphTargets?: (() => void) | Readonly<(() => void) | undefined>;
+        getVertexPosition?: ((index: number, target: THREE.Vector3) => THREE.Vector3) | Readonly<((index: number, target: THREE.Vector3) => THREE.Vector3) | undefined>;
+        isLineMaterial?: true | undefined;
+        isShaderMaterial?: Readonly<boolean | undefined>;
+        setValues?: ((values?: THREE.ShaderMaterialParameters) => void) | Readonly<((values?: THREE.ShaderMaterialParameters) => void) | undefined>;
+        defines?: Record<string, unknown> | Readonly<Record<string, unknown> | undefined>;
+        isMaterial?: Readonly<boolean | undefined>;
+        version?: Readonly<number | undefined>;
+        onBeforeCompile?: ((parameters: THREE.WebGLProgramParametersWithUniforms, renderer: THREE.WebGLRenderer) => void) | Readonly<((parameters: THREE.WebGLProgramParametersWithUniforms, renderer: THREE.WebGLRenderer) => void) | undefined>;
+        customProgramCacheKey?: (() => string) | Readonly<(() => string) | undefined>;
+        needsUpdate?: Readonly<boolean | undefined>;
         uniforms?: {
             [uniform: string]: THREE.IUniform<any>;
         } | Readonly<{
@@ -394,7 +395,6 @@ declare class NgtsCatmullRomLine {
         uniformsGroups?: THREE.UniformsGroup[] | Readonly<THREE.UniformsGroup[] | undefined>;
         vertexShader?: Readonly<string | undefined>;
         fragmentShader?: Readonly<string | undefined>;
-        wireframe?: boolean | undefined | undefined;
         wireframeLinewidth?: Readonly<number | undefined>;
         fog?: Readonly<boolean | undefined>;
         lights?: Readonly<boolean | undefined>;
@@ -610,42 +610,10 @@ declare class NgtsEdges {
         dispose?: (((() => void) | Readonly<() => void> | null) & (((() => void) & (() => void)) | Readonly<(() => void) & (() => void)>)) | undefined;
         parameters?: ((Partial<THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>> | Readonly<Partial<THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>>) & ((Partial<three_stdlib.Line2> | Readonly<Partial<three_stdlib.Line2>>) & (Partial<three_stdlib.LineMaterial> | Readonly<Partial<three_stdlib.LineMaterial>>))) | undefined;
         __ngt_args__?: (([geometry?: THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap> | undefined, material?: THREE.Material | THREE.Material[] | undefined] | readonly [geometry?: THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap> | undefined, material?: THREE.Material | THREE.Material[] | undefined]) & (([geometry?: three_stdlib.LineGeometry | undefined, material?: three_stdlib.LineMaterial | undefined] | readonly [geometry?: three_stdlib.LineGeometry | undefined, material?: three_stdlib.LineMaterial | undefined]) & ([parameters?: LineMaterialParameters | undefined] | readonly [parameters?: LineMaterialParameters | undefined]))) | undefined;
-        material?: ((THREE.Material | THREE.Material[] | Readonly<THREE.Material> | readonly THREE.Material[]) & (three_stdlib.LineMaterial | Readonly<three_stdlib.LineMaterial>)) | undefined;
-        isLine2?: true | undefined;
-        isLineSegments2?: true | undefined;
-        computeLineDistances?: (() => three_stdlib.Line2) | Readonly<(() => three_stdlib.Line2) | undefined>;
-        isMesh?: true | undefined;
-        morphTargetInfluences?: number[] | Readonly<number[] | undefined>;
-        morphTargetDictionary?: {
-            [key: string]: number;
-        } | Readonly<{
-            [key: string]: number;
-        } | undefined>;
-        count?: Readonly<number | undefined>;
-        updateMorphTargets?: (() => void) | Readonly<(() => void) | undefined>;
-        getVertexPosition?: ((index: number, target: THREE.Vector3) => THREE.Vector3) | Readonly<((index: number, target: THREE.Vector3) => THREE.Vector3) | undefined>;
         color?: THREE.ColorRepresentation | undefined;
-        dashed?: boolean | undefined | undefined;
-        dashScale?: number | undefined | undefined;
-        dashSize?: number | undefined | undefined;
-        dashOffset?: number | undefined | undefined;
-        gapSize?: number | undefined | undefined;
-        opacity?: number | undefined;
-        isLineMaterial?: true | undefined;
-        linewidth?: number | undefined | undefined;
-        resolution?: (THREE.Vector2 & (number | THREE.Vector2 | [x: number, y: number] | Readonly<THREE.Vector2> | readonly [x: number, y: number])) | undefined;
-        alphaToCoverage?: boolean | undefined | undefined;
-        worldUnits?: boolean | undefined | undefined;
-        isShaderMaterial?: Readonly<boolean | undefined>;
-        setValues?: ((values?: THREE.ShaderMaterialParameters) => void) | Readonly<((values?: THREE.ShaderMaterialParameters) => void) | undefined>;
-        defines?: Record<string, unknown> | Readonly<Record<string, unknown> | undefined>;
-        isMaterial?: Readonly<boolean | undefined>;
-        version?: Readonly<number | undefined>;
-        onBeforeCompile?: ((parameters: THREE.WebGLProgramParametersWithUniforms, renderer: THREE.WebGLRenderer) => void) | Readonly<((parameters: THREE.WebGLProgramParametersWithUniforms, renderer: THREE.WebGLRenderer) => void) | undefined>;
-        customProgramCacheKey?: (() => string) | Readonly<(() => string) | undefined>;
-        needsUpdate?: Readonly<boolean | undefined>;
         blending?: 0 | 1 | 2 | 3 | 4 | 5 | undefined;
         side?: 0 | 1 | 2 | undefined;
+        opacity?: number | undefined;
         transparent?: boolean | undefined;
         alphaHash?: boolean | undefined;
         blendSrc?: 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 209 | 210 | 211 | 212 | 213 | 214 | undefined;
@@ -677,11 +645,44 @@ declare class NgtsEdges {
         polygonOffsetFactor?: number | undefined;
         polygonOffsetUnits?: number | undefined;
         dithering?: boolean | undefined;
+        alphaToCoverage?: boolean | undefined | undefined;
         premultipliedAlpha?: boolean | undefined;
         forceSinglePass?: boolean | undefined;
         allowOverride?: boolean | undefined;
         toneMapped?: boolean | undefined;
         alphaTest?: number | undefined;
+        dashed?: boolean | undefined | undefined;
+        dashScale?: number | undefined | undefined;
+        dashSize?: number | undefined | undefined;
+        dashOffset?: number | undefined | undefined;
+        gapSize?: number | undefined | undefined;
+        linewidth?: number | undefined | undefined;
+        resolution?: (THREE.Vector2 & (number | THREE.Vector2 | [x: number, y: number] | Readonly<THREE.Vector2> | readonly [x: number, y: number])) | undefined;
+        wireframe?: boolean | undefined | undefined;
+        worldUnits?: boolean | undefined | undefined;
+        material?: ((THREE.Material | THREE.Material[] | Readonly<THREE.Material> | readonly THREE.Material[]) & (three_stdlib.LineMaterial | Readonly<three_stdlib.LineMaterial>)) | undefined;
+        isLine2?: true | undefined;
+        isLineSegments2?: true | undefined;
+        computeLineDistances?: (() => three_stdlib.Line2) | Readonly<(() => three_stdlib.Line2) | undefined>;
+        isMesh?: true | undefined;
+        morphTargetInfluences?: number[] | Readonly<number[] | undefined>;
+        morphTargetDictionary?: {
+            [key: string]: number;
+        } | Readonly<{
+            [key: string]: number;
+        } | undefined>;
+        count?: Readonly<number | undefined>;
+        updateMorphTargets?: (() => void) | Readonly<(() => void) | undefined>;
+        getVertexPosition?: ((index: number, target: THREE.Vector3) => THREE.Vector3) | Readonly<((index: number, target: THREE.Vector3) => THREE.Vector3) | undefined>;
+        isLineMaterial?: true | undefined;
+        isShaderMaterial?: Readonly<boolean | undefined>;
+        setValues?: ((values?: THREE.ShaderMaterialParameters) => void) | Readonly<((values?: THREE.ShaderMaterialParameters) => void) | undefined>;
+        defines?: Record<string, unknown> | Readonly<Record<string, unknown> | undefined>;
+        isMaterial?: Readonly<boolean | undefined>;
+        version?: Readonly<number | undefined>;
+        onBeforeCompile?: ((parameters: THREE.WebGLProgramParametersWithUniforms, renderer: THREE.WebGLRenderer) => void) | Readonly<((parameters: THREE.WebGLProgramParametersWithUniforms, renderer: THREE.WebGLRenderer) => void) | undefined>;
+        customProgramCacheKey?: (() => string) | Readonly<(() => string) | undefined>;
+        needsUpdate?: Readonly<boolean | undefined>;
         uniforms?: {
             [uniform: string]: THREE.IUniform<any>;
         } | Readonly<{
@@ -690,7 +691,6 @@ declare class NgtsEdges {
         uniformsGroups?: THREE.UniformsGroup[] | Readonly<THREE.UniformsGroup[] | undefined>;
         vertexShader?: Readonly<string | undefined>;
         fragmentShader?: Readonly<string | undefined>;
-        wireframe?: boolean | undefined | undefined;
         wireframeLinewidth?: Readonly<number | undefined>;
         fog?: Readonly<boolean | undefined>;
         lights?: Readonly<boolean | undefined>;
@@ -1338,7 +1338,7 @@ declare class NgtsText {
      * Configuration options for text appearance and behavior.
      */
     options: _angular_core.InputSignalWithTransform<NgtsTextOptions, "" | Partial<NgtsTextOptions>>;
-    protected parameters: _angular_core.Signal<Omit<NgtsTextOptions, "characters" | "fontSize" | "font" | "anchorX" | "anchorY" | "sdfGlyphSize">>;
+    protected parameters: _angular_core.Signal<Omit<NgtsTextOptions, "font" | "fontSize" | "sdfGlyphSize" | "anchorX" | "anchorY" | "characters">>;
     /**
      * Emitted when the text has been synced and is ready for rendering.
      * Returns the Troika Text mesh instance.

package/types/angular-three-soba-cameras.d.ts

@@ -141,7 +141,7 @@ type NgtsCubeCameraOptions = Partial<NgtThreeElements['ngt-group']> & CubeCamera
  */
 declare class NgtsCubeCamera {
     options: _angular_core.InputSignalWithTransform<NgtsCubeCameraOptions, "" | Partial<NgtsCubeCameraOptions>>;
-    protected parameters: _angular_core.Signal<Omit<NgtsCubeCameraOptions, "resolution" | "near" | "far" | "envMap" | "fog" | "frames">>;
+    protected parameters: _angular_core.Signal<Omit<NgtsCubeCameraOptions, "near" | "far" | "envMap" | "frames" | "resolution" | "fog">>;
     private cubeCamera;
     protected camera: _angular_core.Signal<THREE.CubeCamera>;
     protected texture: _angular_core.Signal<THREE.CubeTexture<unknown>>;
@@ -217,7 +217,7 @@ interface NgtsOrthographicCameraOptions extends Partial<NgtThreeElements['ngt-or
  */
 declare class NgtsOrthographicCamera {
     options: _angular_core.InputSignalWithTransform<NgtsOrthographicCameraOptions, "" | Partial<NgtsOrthographicCameraOptions>>;
-    protected parameters: _angular_core.Signal<Omit<NgtsOrthographicCameraOptions, "resolution" | "envMap" | "frames" | "left" | "right" | "top" | "bottom" | "makeDefault">>;
+    protected parameters: _angular_core.Signal<Omit<NgtsOrthographicCameraOptions, "envMap" | "makeDefault" | "frames" | "resolution" | "left" | "right" | "top" | "bottom">>;
     protected content: _angular_core.Signal<TemplateRef<any> | undefined>;
     protected cameraContent: _angular_core.Signal<TemplateRef<any> | undefined>;
     /**
@@ -310,7 +310,7 @@ interface NgtsPerspectiveCameraOptions extends Partial<NgtThreeElements['ngt-per
  */
 declare class NgtsPerspectiveCamera {
     options: _angular_core.InputSignalWithTransform<NgtsPerspectiveCameraOptions, "" | Partial<NgtsPerspectiveCameraOptions>>;
-    protected parameters: _angular_core.Signal<Omit<NgtsPerspectiveCameraOptions, "resolution" | "envMap" | "frames" | "makeDefault">>;
+    protected parameters: _angular_core.Signal<Omit<NgtsPerspectiveCameraOptions, "envMap" | "makeDefault" | "frames" | "resolution">>;
     protected content: _angular_core.Signal<TemplateRef<any> | undefined>;
     protected cameraContent: _angular_core.Signal<TemplateRef<any> | undefined>;
     /**

package/types/angular-three-soba-gizmos.d.ts

@@ -277,7 +277,7 @@ interface NgtsGizmoViewportOptions extends Partial<NgtThreeElements['ngt-group']
 declare class NgtsGizmoViewport {
     protected readonly Math: Math;
     options: _angular_core.InputSignalWithTransform<NgtsGizmoViewportOptions, "" | Partial<NgtsGizmoViewportOptions>>;
-    protected parameters: _angular_core.Signal<Omit<NgtsGizmoViewportOptions, "font" | "axisColors" | "axisScale" | "labels" | "axisHeadScale" | "labelColor" | "hideNegativeAxes" | "hideAxisHeads" | "disabled">>;
+    protected parameters: _angular_core.Signal<Omit<NgtsGizmoViewportOptions, "axisColors" | "font" | "axisScale" | "labels" | "axisHeadScale" | "labelColor" | "hideNegativeAxes" | "hideAxisHeads" | "disabled">>;
     click: _angular_core.OutputEmitterRef<NgtThreeEvent<MouseEvent>>;
     protected axisColors: _angular_core.Signal<[string, string, string]>;
     protected axisScale: _angular_core.Signal<[number, number, number] | undefined>;
@@ -502,7 +502,7 @@ interface NgtsPivotControlsOptions {
  */
 declare class NgtsPivotControls {
     options: _angular_core.InputSignalWithTransform<NgtsPivotControlsOptions, "" | Partial<NgtsPivotControlsOptions>>;
-    protected parameters: _angular_core.Signal<Omit<NgtsPivotControlsOptions, "rotation" | "scale" | "matrix" | "visible" | "renderOrder" | "userData" | "opacity" | "anchor" | "fixed" | "axisColors" | "hoveredColor" | "enabled" | "lineWidth" | "offset" | "autoTransform" | "activeAxes" | "disableAxes" | "disableSliders" | "disableRotations" | "disableScaling" | "translationLimits" | "rotationLimits" | "scaleLimits" | "annotations" | "annotationsClass" | "depthTest">>;
+    protected parameters: _angular_core.Signal<Omit<NgtsPivotControlsOptions, "rotation" | "scale" | "matrix" | "visible" | "renderOrder" | "userData" | "enabled" | "autoTransform" | "anchor" | "disableAxes" | "disableSliders" | "disableRotations" | "disableScaling" | "activeAxes" | "offset" | "lineWidth" | "fixed" | "translationLimits" | "rotationLimits" | "scaleLimits" | "depthTest" | "axisColors" | "hoveredColor" | "annotations" | "annotationsClass" | "opacity">>;
     dragStarted: _angular_core.OutputEmitterRef<OnDragStartParameters>;
     dragEnded: _angular_core.OutputEmitterRef<void>;
     dragged: _angular_core.OutputEmitterRef<OnDragParameters>;
@@ -670,7 +670,7 @@ type NgtsTransformControlsOptions = Partial<NgtsTransformControlsObject> & Parti
 declare class NgtsTransformControls {
     object: _angular_core.InputSignal<THREE.Object3D<THREE.Object3DEventMap> | ElementRef<THREE.Object3D<THREE.Object3DEventMap>> | null | undefined>;
     options: _angular_core.InputSignal<Partial<NgtsTransformControlsOptions>>;
-    protected parameters: _angular_core.Signal<Omit<Partial<NgtsTransformControlsOptions>, "camera" | "size" | "domElement" | "enabled" | "axis" | "mode" | "translationSnap" | "rotationSnap" | "scaleSnap" | "space" | "showX" | "showY" | "showZ" | "makeDefault">>;
+    protected parameters: _angular_core.Signal<Omit<Partial<NgtsTransformControlsOptions>, "camera" | "size" | "enabled" | "axis" | "domElement" | "mode" | "translationSnap" | "rotationSnap" | "scaleSnap" | "space" | "showX" | "showY" | "showZ" | "makeDefault">>;
     protected controlsOptions: _angular_core.Signal<Pick<Partial<NgtsTransformControlsOptions>, "size" | "enabled" | "axis" | "mode" | "translationSnap" | "rotationSnap" | "scaleSnap" | "space" | "showX" | "showY" | "showZ">>;
     private camera;
     private domElement;

package/types/angular-three-soba-materials.d.ts

@@ -29,7 +29,7 @@ declare class NgtsCustomShaderMaterial {
     /**
      * The base Three.js material to extend. Can be a material instance, material class, or ElementRef to a material.
      */
-    baseMaterial: _angular_core.InputSignal<THREE.Material | typeof THREE.Material | ElementRef<THREE.Material>>;
+    baseMaterial: _angular_core.InputSignal<typeof THREE.Material | THREE.Material | ElementRef<THREE.Material>>;
     /**
      * How to attach the material to its parent object.
      * @default 'material'
@@ -41,7 +41,7 @@ declare class NgtsCustomShaderMaterial {
      */
     options: _angular_core.InputSignal<Omit<any, "baseMaterial">>;
     /** Material parameters excluding shader-specific options. */
-    parameters: _angular_core.Signal<Omit<Omit<any, "baseMaterial">, "fragmentShader" | "vertexShader" | "uniforms" | "cacheKey">>;
+    parameters: _angular_core.Signal<Omit<Omit<any, "baseMaterial">, "uniforms" | "vertexShader" | "fragmentShader" | "cacheKey">>;
     private base;
     private fragmentShader;
     private vertexShader;
@@ -195,7 +195,7 @@ declare class NgtsMeshPortalMaterial {
      * Configuration options for the portal material.
      */
     options: _angular_core.InputSignalWithTransform<NgtsMeshPortalMaterialOptions, "" | Partial<NgtsMeshPortalMaterialOptions>>;
-    protected parameters: _angular_core.Signal<Omit<NgtsMeshPortalMaterialOptions, "resolution" | "blur" | "events" | "worldUnits" | "eventPriority" | "renderPriority">>;
+    protected parameters: _angular_core.Signal<Omit<NgtsMeshPortalMaterialOptions, "resolution" | "blur" | "worldUnits" | "eventPriority" | "renderPriority" | "events">>;
     protected blur: _angular_core.Signal<number>;
     protected eventPriority: _angular_core.Signal<number>;
     protected renderPriority: _angular_core.Signal<number>;
@@ -418,7 +418,7 @@ declare class NgtsMeshRefractionMaterial {
      * Configuration options for the refraction material.
      */
     options: _angular_core.InputSignalWithTransform<NgtsMeshRefractionMaterialOptions, "" | Partial<NgtsMeshRefractionMaterialOptions>>;
-    protected parameters: _angular_core.Signal<Omit<NgtsMeshRefractionMaterialOptions, "aberrationStrength" | "fastChroma">>;
+    protected parameters: _angular_core.Signal<Omit<NgtsMeshRefractionMaterialOptions, "fastChroma" | "aberrationStrength">>;
     private fastChroma;
     protected aberrationStrength: _angular_core.Signal<number>;
     /** Reference to the underlying MeshRefractionMaterial element. */
@@ -525,7 +525,7 @@ declare class NgtsMeshTransmissionMaterial {
      * Configuration options for the transmission material.
      */
     options: _angular_core.InputSignalWithTransform<NgtsMeshTransmissionMaterialOptions, "" | Partial<NgtsMeshTransmissionMaterialOptions>>;
-    protected parameters: _angular_core.Signal<Omit<NgtsMeshTransmissionMaterialOptions, "thickness" | "anisotropy" | "transmission" | "side" | "resolution" | "background" | "buffer" | "anisotropicBlur" | "samples" | "transmissionSampler" | "backside" | "backsideThickness" | "backsideEnvMapIntensity" | "backsideResolution">>;
+    protected parameters: _angular_core.Signal<Omit<NgtsMeshTransmissionMaterialOptions, "thickness" | "anisotropy" | "transmission" | "side" | "buffer" | "anisotropicBlur" | "samples" | "transmissionSampler" | "backside" | "backsideThickness" | "backsideEnvMapIntensity" | "resolution" | "backsideResolution" | "background">>;
     private resolution;
     private backsideResolution;
     private samples;

package/types/angular-three-soba-misc.d.ts

@@ -694,7 +694,7 @@ declare class NgtsHTMLImpl {
      * HTML anchor configuration including position, occlusion, and transform settings.
      */
     options: _angular_core.InputSignalWithTransform<NgtsHTMLOptions, "" | Partial<NgtsHTMLOptions>>;
-    protected parameters: _angular_core.Signal<Omit<NgtsHTMLOptions, "castShadow" | "receiveShadow" | "transform" | "occlude">>;
+    protected parameters: _angular_core.Signal<Omit<NgtsHTMLOptions, "transform" | "castShadow" | "receiveShadow" | "occlude">>;
     /** Reference to the THREE.Group that serves as the 3D anchor point */
     groupRef: _angular_core.Signal<ElementRef<THREE.Group<THREE.Object3DEventMap>>>;
     /** Reference to the occlusion mesh (when using blending occlusion mode) */
@@ -704,7 +704,7 @@ declare class NgtsHTMLImpl {
     protected castShadow: _angular_core.Signal<boolean>;
     protected receiveShadow: _angular_core.Signal<boolean>;
     /** Current occlusion mode setting */
-    occlude: _angular_core.Signal<boolean | "raycast" | THREE.Object3D<THREE.Object3DEventMap>[] | "blending" | ElementRef<THREE.Object3D<THREE.Object3DEventMap>>[]>;
+    occlude: _angular_core.Signal<boolean | THREE.Object3D<THREE.Object3DEventMap>[] | "raycast" | "blending" | ElementRef<THREE.Object3D<THREE.Object3DEventMap>>[]>;
     /** Whether CSS 3D transform mode is enabled */
     transform: _angular_core.Signal<boolean>;
     isRaycastOcclusion: _angular_core.Signal<boolean | 0>;
@@ -980,7 +980,7 @@ declare class NgtsSampler {
      * Sampler configuration including count, weight attribute, and transform function.
      */
     options: _angular_core.InputSignalWithTransform<NgtsSamplerOptions, "" | Partial<NgtsSamplerOptions>>;
-    protected parameters: _angular_core.Signal<Omit<NgtsSamplerOptions, "count" | "transform" | "weight">>;
+    protected parameters: _angular_core.Signal<Omit<NgtsSamplerOptions, "transform" | "count" | "weight">>;
     groupRef: _angular_core.Signal<ElementRef<THREE.Group<THREE.Object3DEventMap>>>;
     private count;
     private weight;
@@ -1013,5 +1013,34 @@ declare class NgtsSampler {
  */
 declare function calculateScaleFactor(point3: THREE.Vector3, radiusPx: number, camera: THREE.Camera, size: NgtSize): number;
 
-export { NgtsBakeShadows, NgtsComputedAttribute, NgtsDecal, NgtsFBO, NgtsHTML, NgtsHTMLContent, NgtsHTMLImpl, NgtsIntersect, NgtsPreload, NgtsSampler, animations, calculateScaleFactor, depthBuffer, fbo, getVersion, injectAnimations, injectDepthBuffer, injectFBO, injectIntersect, intersect, setUpdateRange, surfaceSampler };
-export type { NgtsAnimation, NgtsAnimationApi, NgtsAnimationClip, NgtsAnimationClips, NgtsDecalOptions, NgtsFBOParams, NgtsHTMLContentOptions, NgtsHTMLOptions, NgtsSamplerOptions, TransformFn };
+/**
+ * Options for configuring soft shadows using PCSS (Percentage-Closer Soft Shadows).
+ */
+interface NgtsSoftShadowsOptions {
+    /** Size of the light source (the larger the softer the light), default: 25 */
+    size: number;
+    /** Number of samples (more samples less noise but more expensive), default: 10 */
+    samples: number;
+    /** Depth focus, use it to shift the focal point (where the shadow is the sharpest), default: 0 (the beginning) */
+    focus: number;
+}
+/**
+ * A directive that injects Percentage-Closer Soft Shadows (PCSS) into the scene.
+ *
+ * PCSS produces contact-hardening soft shadows where shadows are sharper near the
+ * contact point and softer further away, creating more realistic shadow effects.
+ *
+ * @example
+ * ```html
+ * <ngts-soft-shadows [options]="{ size: 25, samples: 10, focus: 0 }" />
+ * ```
+ */
+declare class NgtsSoftShadows {
+    options: _angular_core.InputSignalWithTransform<NgtsSoftShadowsOptions, "" | Partial<NgtsSoftShadowsOptions>>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgtsSoftShadows, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgtsSoftShadows, "ngts-soft-shadows", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { NgtsBakeShadows, NgtsComputedAttribute, NgtsDecal, NgtsFBO, NgtsHTML, NgtsHTMLContent, NgtsHTMLImpl, NgtsIntersect, NgtsPreload, NgtsSampler, NgtsSoftShadows, animations, calculateScaleFactor, depthBuffer, fbo, getVersion, injectAnimations, injectDepthBuffer, injectFBO, injectIntersect, intersect, setUpdateRange, surfaceSampler };
+export type { NgtsAnimation, NgtsAnimationApi, NgtsAnimationClip, NgtsAnimationClips, NgtsDecalOptions, NgtsFBOParams, NgtsHTMLContentOptions, NgtsHTMLOptions, NgtsSamplerOptions, NgtsSoftShadowsOptions, TransformFn };

package/types/angular-three-soba-performances.d.ts

@@ -133,7 +133,7 @@ declare class NgtsBVH {
      */
     options: _angular_core.InputSignalWithTransform<NgtsBVHOptions, "" | Partial<NgtsBVHOptions>>;
     /** @internal */
-    protected parameters: _angular_core.Signal<Omit<NgtsBVHOptions, "enabled" | "firstHitOnly" | "strategy" | "verbose" | "setBoundingBox" | "maxDepth" | "maxLeafTris" | "indirect">>;
+    protected parameters: _angular_core.Signal<Omit<NgtsBVHOptions, "indirect" | "enabled" | "firstHitOnly" | "strategy" | "verbose" | "setBoundingBox" | "maxDepth" | "maxLeafTris">>;
     /**
      * Reference to the underlying THREE.Group element.
      */
@@ -340,7 +340,7 @@ declare class NgtsInstances {
      */
     options: _angular_core.InputSignalWithTransform<NgtsInstancesOptions, "" | Partial<NgtsInstancesOptions>>;
     /** @internal */
-    protected parameters: _angular_core.Signal<Omit<NgtsInstancesOptions, "range" | "limit" | "frames">>;
+    protected parameters: _angular_core.Signal<Omit<NgtsInstancesOptions, "limit" | "frames" | "range">>;
     /**
      * Reference to the underlying THREE.InstancedMesh element.
      */
@@ -544,7 +544,7 @@ declare class NgtsPointsInstances {
     /**
      * Computed parameters passed to the underlying Points object.
      */
-    parameters: _angular_core.Signal<Omit<NgtsPointsInstancesOptions, "range" | "limit">>;
+    parameters: _angular_core.Signal<Omit<NgtsPointsInstancesOptions, "limit" | "range">>;
     /**
      * Reference to the underlying THREE.Points element.
      */
@@ -717,10 +717,9 @@ declare class NgtsSegments {
     /** @internal */
     protected materialParameters: _angular_core.Signal<{
         name?: string | undefined;
+        color?: number | undefined | undefined;
         visible?: boolean | undefined;
         userData?: Record<string, any> | undefined;
-        color?: number | undefined | undefined;
-        wireframe?: boolean | undefined | undefined;
         blending?: THREE.Blending | undefined;
         side?: THREE.Side | undefined;
         vertexColors: boolean;
@@ -762,6 +761,7 @@ declare class NgtsSegments {
         allowOverride?: boolean | undefined;
         toneMapped?: boolean | undefined;
         alphaTest?: number | undefined;
+        wireframe?: boolean | undefined | undefined;
         dashed?: boolean | undefined | undefined;
         dashScale?: number | undefined | undefined;
         dashSize?: number | undefined | undefined;

package/types/angular-three-soba-shaders.d.ts

@@ -209,9 +209,9 @@ interface MeshRefractionMaterialOptions {
  * ```
  */
 declare const MeshRefractionMaterial: (new (parameters?: (THREE.ShaderMaterialParameters & Partial<{
-    [name: string]: number | boolean | any[] | THREE.Color | THREE.CubeTexture<unknown> | THREE.Texture<unknown> | Int32Array<ArrayBufferLike> | Float32Array<ArrayBufferLike> | THREE.Matrix4 | THREE.Matrix3 | THREE.Quaternion | THREE.Vector4 | THREE.Vector3 | THREE.Vector2 | null;
+    [name: string]: number | boolean | any[] | THREE.CubeTexture<unknown> | THREE.Texture<unknown> | Int32Array<ArrayBufferLike> | Float32Array<ArrayBufferLike> | THREE.Matrix4 | THREE.Matrix3 | THREE.Quaternion | THREE.Vector4 | THREE.Vector3 | THREE.Vector2 | THREE.Color | null;
 }>) | undefined) => THREE.ShaderMaterial & {
-    [name: string]: number | boolean | any[] | THREE.Color | THREE.CubeTexture<unknown> | THREE.Texture<unknown> | Int32Array<ArrayBufferLike> | Float32Array<ArrayBufferLike> | THREE.Matrix4 | THREE.Matrix3 | THREE.Quaternion | THREE.Vector4 | THREE.Vector3 | THREE.Vector2 | null;
+    [name: string]: number | boolean | any[] | THREE.CubeTexture<unknown> | THREE.Texture<unknown> | Int32Array<ArrayBufferLike> | Float32Array<ArrayBufferLike> | THREE.Matrix4 | THREE.Matrix3 | THREE.Quaternion | THREE.Vector4 | THREE.Vector3 | THREE.Vector2 | THREE.Color | null;
 }) & {
     key: string;
 };

package/types/angular-three-soba-staging.d.ts

@@ -88,7 +88,7 @@ declare class NgtsAccumulativeShadows {
     protected readonly nullTraversal: () => null;
     protected readonly Math: Math;
     options: _angular_core.InputSignalWithTransform<NgtsAccumulativeShadowsOptions, "" | Partial<NgtsAccumulativeShadowsOptions>>;
-    parameters: _angular_core.Signal<Omit<NgtsAccumulativeShadowsOptions, "scale" | "frames" | "blend" | "limit" | "temporal" | "opacity" | "alphaTest" | "color" | "colorBlend" | "resolution" | "toneMapped">>;
+    parameters: _angular_core.Signal<Omit<NgtsAccumulativeShadowsOptions, "scale" | "temporal" | "frames" | "limit" | "blend" | "opacity" | "alphaTest" | "color" | "colorBlend" | "resolution" | "toneMapped">>;
     lightsRef: _angular_core.Signal<ElementRef<three.Group<three.Object3DEventMap>>>;
     planeRef: _angular_core.Signal<ElementRef<three.Mesh<three.PlaneGeometry, three.ShaderMaterial & {
         map: three.Texture | null;
@@ -653,7 +653,7 @@ interface NgtsCenterOptions {
 declare class NgtsCenter {
     /** Configuration options for centering behavior. */
     options: _angular_core.InputSignalWithTransform<Partial<angular_three.NgtThreeElement<typeof three.Group>> & NgtsCenterOptions, "" | Partial<Partial<angular_three.NgtThreeElement<typeof three.Group>> & NgtsCenterOptions>>;
-    protected parameters: _angular_core.Signal<Omit<Partial<angular_three.NgtThreeElement<typeof three.Group>> & NgtsCenterOptions, "object" | "disable" | "top" | "left" | "right" | "bottom" | "precise" | "cacheKey" | "front" | "back" | "disableX" | "disableY" | "disableZ">>;
+    protected parameters: _angular_core.Signal<Omit<Partial<angular_three.NgtThreeElement<typeof three.Group>> & NgtsCenterOptions, "object" | "disable" | "top" | "left" | "right" | "bottom" | "front" | "back" | "disableX" | "disableY" | "disableZ" | "precise" | "cacheKey">>;
     /** Emits when centering calculation completes with dimension and alignment info. */
     centered: _angular_core.OutputEmitterRef<NgtsCenterState>;
     /** Reference to the outer group element containing the centered content. */
@@ -797,7 +797,7 @@ declare class NgtsClouds {
     protected readonly DynamicDrawUsage: 35048;
     /** Configuration options for the clouds container. */
     options: _angular_core.InputSignalWithTransform<NgtsCloudsOptions, "" | Partial<NgtsCloudsOptions>>;
-    protected parameters: _angular_core.Signal<Omit<NgtsCloudsOptions, "frustumCulled" | "limit" | "texture" | "range" | "material">>;
+    protected parameters: _angular_core.Signal<Omit<NgtsCloudsOptions, "frustumCulled" | "limit" | "material" | "texture" | "range">>;
     private texture;
     private material;
     private range;
@@ -985,7 +985,7 @@ interface NgtsCloudOptions extends Partial<NgtThreeElements['ngt-group']> {
 declare class NgtsCloudInstance {
     /** Configuration options for this cloud formation. */
     options: _angular_core.InputSignalWithTransform<NgtsCloudOptions, "" | Partial<NgtsCloudOptions>>;
-    protected parameters: _angular_core.Signal<Omit<NgtsCloudOptions, "opacity" | "color" | "segments" | "seed" | "bounds" | "concentrate" | "distribute" | "growth" | "volume" | "smallestVolume" | "speed" | "fade">>;
+    protected parameters: _angular_core.Signal<Omit<NgtsCloudOptions, "opacity" | "color" | "segments" | "bounds" | "seed" | "concentrate" | "distribute" | "growth" | "volume" | "smallestVolume" | "speed" | "fade">>;
     private cloudInstanceRef;
     private uuid;
     private segments;
@@ -2295,7 +2295,7 @@ interface NgtsSkyOptions extends Partial<Omit<NgtThreeElements['ngt-mesh'], 'sca
 declare class NgtsSky {
     /** Configuration options for the sky appearance. */
     options: _angular_core.InputSignalWithTransform<NgtsSkyOptions, "" | Partial<NgtsSkyOptions>>;
-    protected parameters: _angular_core.Signal<Omit<NgtsSkyOptions, "distance" | "inclination" | "azimuth" | "mieCoefficient" | "mieDirectionalG" | "turbidity" | "sunPosition">>;
+    protected parameters: _angular_core.Signal<Omit<NgtsSkyOptions, "distance" | "inclination" | "azimuth" | "sunPosition" | "turbidity" | "mieCoefficient" | "mieDirectionalG">>;
     private distance;
     protected turbidity: _angular_core.Signal<number>;
     protected mieCoefficient: _angular_core.Signal<number>;
@@ -2468,7 +2468,7 @@ declare class NgtsSpotLight {
     protected readonly SpotLightHelper: typeof three.SpotLightHelper;
     /** Configuration options for the spot light. */
     options: _angular_core.InputSignalWithTransform<NgtsSpotLightOptions, "" | Partial<NgtsSpotLightOptions>>;
-    protected parameters: _angular_core.Signal<Omit<NgtsSpotLightOptions, "opacity" | "color" | "debug" | "distance" | "depthBuffer" | "angle" | "attenuation" | "anglePower" | "radiusTop" | "radiusBottom" | "volumetric">>;
+    protected parameters: _angular_core.Signal<Omit<NgtsSpotLightOptions, "opacity" | "color" | "debug" | "distance" | "depthBuffer" | "volumetric" | "angle" | "attenuation" | "anglePower" | "radiusTop" | "radiusBottom">>;
     protected volumetricOptions: _angular_core.Signal<Pick<NgtsSpotLightOptions, "opacity" | "color" | "debug" | "distance" | "depthBuffer" | "angle" | "attenuation" | "anglePower" | "radiusTop" | "radiusBottom">>;
     /** Reference to the underlying spot light element. */
     spotLightRef: _angular_core.Signal<ElementRef<three.SpotLight>>;
@@ -2613,6 +2613,9 @@ declare class NgtsStage {
     protected environment: _angular_core.Signal<"apartment" | "city" | "dawn" | "forest" | "lobby" | "night" | "park" | "studio" | "sunset" | "warehouse" | Partial<NgtsEnvironmentOptions> | null>;
     private preset;
     protected config: _angular_core.Signal<{
+        main: [x: number, y: number, z: number];
+        fill: [x: number, y: number, z: number];
+    } | {
         readonly main: readonly [1, 2, 1];
         readonly fill: readonly [-2, -0.5, -2];
     } | {
@@ -2624,9 +2627,6 @@ declare class NgtsStage {
     } | {
         readonly main: readonly [-2, 4, 4];
         readonly fill: readonly [-1, 0.5, -1.5];
-    } | {
-        main: [x: number, y: number, z: number];
-        fill: [x: number, y: number, z: number];
     }>;
     protected shadowBias: _angular_core.Signal<number>;
     protected normalBias: _angular_core.Signal<number>;