angular-three-soba 4.0.0-next.97 → 4.0.0-next.98

package/staging/lib/environment/environment-resource.d.ts

@@ -0,0 +1,35 @@
+import { Injector } from '@angular/core';
+import * as THREE from 'three';
+export declare const ENVIRONMENT_PRESETS: {
+    apartment: string;
+    city: string;
+    dawn: string;
+    forest: string;
+    lobby: string;
+    night: string;
+    park: string;
+    studio: string;
+    sunset: string;
+    warehouse: string;
+};
+export type NgtsEnvironmentPresets = keyof typeof ENVIRONMENT_PRESETS;
+export interface NgtsEnvironmentResourceOptions {
+    files: string | string[];
+    path: string;
+    preset?: NgtsEnvironmentPresets;
+    extensions?: (loader: THREE.Loader) => void;
+    colorSpace?: THREE.ColorSpace;
+}
+export declare function environmentResource(options?: () => Partial<NgtsEnvironmentResourceOptions>, { injector }?: {
+    injector?: Injector;
+}): {
+    texture: import("@angular/core").Signal<THREE.Texture | THREE.CubeTexture | null>;
+    resource: import("@angular/core").ResourceRef<unknown>;
+};
+export declare namespace environmentResource {
+    var preload: (options?: Partial<NgtsEnvironmentResourceOptions>) => void;
+    var clear: (clearOptions: {
+        files?: string | string[];
+        preset?: NgtsEnvironmentPresets;
+    }) => void;
+}

package/staging/lib/environment/environment.d.ts

@@ -1,9 +1,9 @@
 import { ElementRef, TemplateRef } from '@angular/core';
 import { NgtEuler } from 'angular-three';
 import * as THREE from 'three';
-import { NgtsEnvironmentPresets, NgtsInjectEnvironmentOptions } from './inject-environment';
+import { type NgtsEnvironmentPresets, type NgtsEnvironmentResourceOptions } from './environment-resource';
 import * as i0 from "@angular/core";
-export interface NgtsEnvironmentOptions extends Partial<NgtsInjectEnvironmentOptions> {
+export interface NgtsEnvironmentOptions extends Partial<NgtsEnvironmentResourceOptions> {
     frames?: number;
     near?: number;
     far?: number;
@@ -82,7 +82,7 @@ export declare class NgtsEnvironmentPortal {
 export declare class NgtsEnvironmentGround {
     options: import("@angular/core").InputSignal<NgtsEnvironmentOptions>;
     envSet: import("@angular/core").OutputEmitterRef<void>;
-    private defaultTexture;
+    private defaultEnvironment;
     protected height: import("@angular/core").Signal<any>;
     protected radius: import("@angular/core").Signal<any>;
     protected scale: import("@angular/core").Signal<any>;

package/staging/lib/environment/inject-environment.d.ts

@@ -1,30 +1,14 @@
 import { Injector } from '@angular/core';
-import * as THREE from 'three';
-export declare const ENVIRONMENT_PRESETS: {
-    apartment: string;
-    city: string;
-    dawn: string;
-    forest: string;
-    lobby: string;
-    night: string;
-    park: string;
-    studio: string;
-    sunset: string;
-    warehouse: string;
-};
-export type NgtsEnvironmentPresets = keyof typeof ENVIRONMENT_PRESETS;
-export interface NgtsInjectEnvironmentOptions {
-    files: string | string[];
-    path: string;
-    preset?: NgtsEnvironmentPresets;
-    extensions?: (loader: THREE.Loader) => void;
-    colorSpace?: THREE.ColorSpace;
-}
-export declare function injectEnvironment(options?: () => Partial<NgtsInjectEnvironmentOptions>, { injector }?: {
+import { type NgtsEnvironmentPresets, type NgtsEnvironmentResourceOptions } from './environment-resource';
+/**
+ * @deprecated use environmentResource instead. Will be removed in v5.0.0
+ * @since v4.0.0
+ */
+export declare function injectEnvironment(options?: () => Partial<NgtsEnvironmentResourceOptions>, { injector }?: {
     injector?: Injector;
-}): import("@angular/core").Signal<THREE.Texture | THREE.CubeTexture | null>;
+}): import("@angular/core").Signal<import("three").Texture | import("three").CubeTexture | null>;
 export declare namespace injectEnvironment {
-    var preload: (options?: () => Partial<NgtsInjectEnvironmentOptions>) => void;
+    var preload: (options?: () => Partial<NgtsEnvironmentResourceOptions>) => void;
     var clear: (clearOptions: {
         files?: string | string[];
         preset?: NgtsEnvironmentPresets;

package/staging/lib/lightformer.d.ts

@@ -14,7 +14,7 @@ export interface NgtsLightformerOptions {
 export declare class NgtsLightformer {
     protected readonly side: 2;
     options: import("@angular/core").InputSignalWithTransform<Partial<Omit<import("angular-three").NgtThreeElement<typeof THREE.Mesh>, "scale">> & NgtsLightformerOptions, "" | Partial<Partial<Omit<import("angular-three").NgtThreeElement<typeof THREE.Mesh>, "scale">> & NgtsLightformerOptions>>;
-    protected parameters: import("@angular/core").Signal<Omit<Partial<Omit<import("angular-three").NgtThreeElement<typeof THREE.Mesh>, "scale">> & NgtsLightformerOptions, "scale" | "map" | "color" | "toneMapped" | "intensity" | "target" | "form">>;
+    protected parameters: import("@angular/core").Signal<Omit<Partial<Omit<import("angular-three").NgtThreeElement<typeof THREE.Mesh>, "scale">> & NgtsLightformerOptions, "scale" | "map" | "intensity" | "color" | "toneMapped" | "target" | "form">>;
     private intensity;
     private color;
     private target;

package/staging/lib/matcap-texture.d.ts

@@ -1,6 +1,10 @@
-import { Injector, Signal } from '@angular/core';
+import { Injector, ResourceRef, Signal } from '@angular/core';
 import * as THREE from 'three';
 import * as i0 from "@angular/core";
+/**
+ * @deprecated Use matcapTexture instead. Will be removed in v5.0.0
+ * @since v4.0.0
+ */
 export declare function injectMatcapTexture(id?: () => number | string, { format, onLoad, injector, }?: {
     format?: () => number;
     onLoad?: (texture: THREE.Texture[]) => void;
@@ -10,13 +14,22 @@ export declare function injectMatcapTexture(id?: () => number | string, { format
     texture: Signal<THREE.Texture | null>;
     numTot: Signal<number>;
 };
+export declare function matcapTextureResource(id?: () => number | string, { format, onLoad, injector, }?: {
+    format?: () => number;
+    onLoad?: (texture: THREE.Texture) => void;
+    injector?: Injector;
+}): {
+    url: Signal<string>;
+    resource: ResourceRef<THREE.Texture | undefined>;
+    numTot: Signal<number>;
+};
 export interface NgtsMatcapTextureOptions {
     id?: number | string;
     format?: number;
 }
 export declare class NgtsMatcapTexture {
     matcapTexture: import("@angular/core").InputSignal<NgtsMatcapTextureOptions | undefined>;
-    matcapTextureLoaded: import("@angular/core").OutputEmitterRef<THREE.Texture[]>;
+    matcapTextureLoaded: import("@angular/core").InputSignal<((texture: THREE.Texture) => void) | undefined>;
     private template;
     private vcr;
     private id;
@@ -24,8 +37,8 @@ export declare class NgtsMatcapTexture {
     private ref?;
     constructor();
     static ngTemplateContextGuard(_: NgtsMatcapTexture, ctx: unknown): ctx is {
-        $implicit: Signal<THREE.Texture | null>;
+        $implicit: ResourceRef<THREE.Texture | undefined>;
     };
     static ɵfac: i0.ɵɵFactoryDeclaration<NgtsMatcapTexture, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<NgtsMatcapTexture, "ng-template[matcapTexture]", never, { "matcapTexture": { "alias": "matcapTexture"; "required": false; "isSignal": true; }; }, { "matcapTextureLoaded": "matcapTextureLoaded"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgtsMatcapTexture, "ng-template[matcapTexture]", never, { "matcapTexture": { "alias": "matcapTexture"; "required": false; "isSignal": true; }; "matcapTextureLoaded": { "alias": "matcapTextureLoaded"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }

package/staging/lib/normal-texture.d.ts

@@ -1,4 +1,4 @@
-import { Injector, Signal } from '@angular/core';
+import { Injector, ResourceRef } from '@angular/core';
 import * as THREE from 'three';
 import * as i0 from "@angular/core";
 interface NgtsNormalTextureSettings {
@@ -6,21 +6,34 @@ interface NgtsNormalTextureSettings {
     anisotropy?: number;
     offset?: number[];
 }
+/**
+ * @deprecated Use normalTexture instead. Will be removed in v5.0.0
+ * @since v4.0.0
+ */
 export declare function injectNormalTexture(id: (() => string | number) | undefined, { settings, onLoad, injector, }: {
     settings?: () => NgtsNormalTextureSettings;
     onLoad?: (texture: THREE.Texture[]) => void;
     injector?: Injector;
 }): {
-    url: Signal<string>;
-    texture: Signal<THREE.Texture | null>;
-    numTot: Signal<number>;
+    url: import("@angular/core").Signal<string>;
+    texture: import("@angular/core").Signal<THREE.Texture | null>;
+    numTot: import("@angular/core").Signal<number>;
+};
+export declare function normalTextureResource(id: (() => string | number) | undefined, { settings, onLoad, injector, }: {
+    settings?: () => NgtsNormalTextureSettings;
+    onLoad?: (texture: THREE.Texture) => void;
+    injector?: Injector;
+}): {
+    url: import("@angular/core").Signal<string>;
+    resource: ResourceRef<THREE.Texture | undefined>;
+    numTot: import("@angular/core").Signal<number>;
 };
 export interface NgtsNormalTextureOptions extends NgtsNormalTextureSettings {
     id?: number | string;
 }
 export declare class NgtsNormalTexture {
     normalTexture: import("@angular/core").InputSignal<NgtsNormalTextureOptions | undefined>;
-    normalTextureLoaded: import("@angular/core").OutputEmitterRef<THREE.Texture[]>;
+    normalTextureLoaded: import("@angular/core").InputSignal<((texture: THREE.Texture) => void) | undefined>;
     private template;
     private vcr;
     private id;
@@ -28,9 +41,9 @@ export declare class NgtsNormalTexture {
     private ref?;
     constructor();
     static ngTemplateContextGuard(_: NgtsNormalTexture, ctx: unknown): ctx is {
-        $implicit: Signal<THREE.Texture | null>;
+        $implicit: ResourceRef<THREE.Texture | undefined>;
     };
     static ɵfac: i0.ɵɵFactoryDeclaration<NgtsNormalTexture, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<NgtsNormalTexture, "ng-template[normalTexture]", never, { "normalTexture": { "alias": "normalTexture"; "required": false; "isSignal": true; }; }, { "normalTextureLoaded": "normalTextureLoaded"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgtsNormalTexture, "ng-template[normalTexture]", never, { "normalTexture": { "alias": "normalTexture"; "required": false; "isSignal": true; }; "normalTextureLoaded": { "alias": "normalTextureLoaded"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 export {};

package/staging/lib/render-texture.d.ts

@@ -44,7 +44,7 @@ export declare class NgtsRenderTextureContent {
 export declare class NgtsRenderTextureImpl {
     attach: import("@angular/core").InputSignal<NgtAttachable>;
     options: import("@angular/core").InputSignalWithTransform<NgtsRenderTextureOptions, "" | Partial<NgtsRenderTextureOptions>>;
-    protected parameters: import("@angular/core").Signal<Omit<NgtsRenderTextureOptions, "frames" | "width" | "height" | "depthBuffer" | "stencilBuffer" | "samples" | "generateMipmaps" | "renderPriority" | "eventPriority" | "compute">>;
+    protected parameters: import("@angular/core").Signal<Omit<NgtsRenderTextureOptions, "width" | "height" | "frames" | "depthBuffer" | "stencilBuffer" | "generateMipmaps" | "samples" | "renderPriority" | "eventPriority" | "compute">>;
     content: import("@angular/core").Signal<TemplateRef<any>>;
     private store;
     private width;

package/staging/lib/spot-light.d.ts

@@ -3,7 +3,7 @@ import { NgtThreeElements } from 'angular-three';
 import * as THREE from 'three';
 import * as i0 from "@angular/core";
 export interface NgtsSpotLightOptions extends Partial<NgtThreeElements['ngt-spot-light']> {
-    depthBuffer?: THREE.DepthTexture;
+    depthBuffer: THREE.DepthTexture | null;
     attenuation?: number;
     anglePower?: number;
     radiusTop?: number;
@@ -44,7 +44,7 @@ export declare class NgtsVolumetricMesh {
     protected color: import("@angular/core").Signal<THREE.ColorRepresentation | undefined>;
     protected attenuation: import("@angular/core").Signal<number | undefined>;
     protected anglePower: import("@angular/core").Signal<number | undefined>;
-    protected depthBuffer: import("@angular/core").Signal<THREE.DepthTexture | undefined>;
+    protected depthBuffer: import("@angular/core").Signal<THREE.DepthTexture | null>;
     protected geometry: import("@angular/core").Signal<THREE.CylinderGeometry>;
     constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<NgtsVolumetricMesh, never>;
@@ -104,8 +104,8 @@ export declare class NgtsSpotLightShadow {
 export declare class NgtsSpotLight {
     protected readonly SpotLightHelper: typeof THREE.SpotLightHelper;
     options: import("@angular/core").InputSignalWithTransform<NgtsSpotLightOptions, "" | Partial<NgtsSpotLightOptions>>;
-    protected parameters: import("@angular/core").Signal<Omit<NgtsSpotLightOptions, "opacity" | "color" | "debug" | "distance" | "volumetric" | "angle" | "depthBuffer" | "attenuation" | "anglePower" | "radiusTop" | "radiusBottom">>;
-    protected volumetricOptions: import("@angular/core").Signal<Pick<NgtsSpotLightOptions, "opacity" | "color" | "debug" | "distance" | "angle" | "depthBuffer" | "attenuation" | "anglePower" | "radiusTop" | "radiusBottom">>;
+    protected parameters: import("@angular/core").Signal<Omit<NgtsSpotLightOptions, "opacity" | "color" | "volumetric" | "distance" | "angle" | "depthBuffer" | "attenuation" | "anglePower" | "radiusTop" | "radiusBottom" | "debug">>;
+    protected volumetricOptions: import("@angular/core").Signal<Pick<NgtsSpotLightOptions, "opacity" | "color" | "distance" | "angle" | "depthBuffer" | "attenuation" | "anglePower" | "radiusTop" | "radiusBottom" | "debug">>;
     spotLightRef: import("@angular/core").Signal<ElementRef<THREE.SpotLight>>;
     debug: import("@angular/core").Signal<boolean | undefined>;
     protected angle: import("@angular/core").Signal<Readonly<number | undefined>>;

package/staging/lib/stage.d.ts

@@ -4,7 +4,7 @@ import { NgtsAccumulativeShadowsOptions } from './accumulative-shadows';
 import { NgtsCenterOptions, NgtsCenterState } from './center';
 import { NgtsContactShadowsOptions } from './contact-shadows';
 import { NgtsEnvironmentOptions } from './environment/environment';
-import { NgtsEnvironmentPresets } from './environment/inject-environment';
+import { type NgtsEnvironmentPresets } from './environment/environment-resource';
 import { NgtsRandomizedLightsOptions } from './randomized-lights';
 import * as i0 from "@angular/core";
 type NgtsStageShadowsOptions = Partial<NgtsAccumulativeShadowsOptions> & Partial<NgtsRandomizedLightsOptions> & Partial<NgtsContactShadowsOptions> & {