angular-three 4.0.0-next.96 → 4.0.0-next.98

package/index.d.ts

@@ -1,13 +1,14 @@
 export * from './lib/directives/args';
 export * from './lib/directives/parent';
 export * from './lib/directives/selection';
+export * from './lib/events';
 export * from './lib/html';
 export * from './lib/instance';
 export * from './lib/loader';
+export * from './lib/loader-resource';
 export * from './lib/loop';
 export * from './lib/pipes/hexify';
 export * from './lib/portal';
-export * from './lib/events';
 export * from './lib/renderer/catalogue';
 export * from './lib/renderer/constants';
 export * from './lib/renderer/renderer';

package/lib/loader-resource.d.ts

@@ -0,0 +1,14 @@
+import { type Injector, type ResourceRef } from '@angular/core';
+import type { NgtBranchingReturn, NgtGLTFLike, NgtLoaderExtensions, NgtLoaderProto, NgtLoaderResults, NgtLoaderReturnType } from './loader';
+import { type NgtObjectMap } from './utils/make';
+export declare function loaderResource<TData, TUrl extends string | string[] | Record<string, string>, TLoaderConstructor extends NgtLoaderProto<TData>, TReturn = NgtLoaderReturnType<TData, TLoaderConstructor>>(loaderConstructorFactory: (url: TUrl) => TLoaderConstructor, input: () => TUrl, { extensions, onLoad, onProgress, injector, }?: {
+    extensions?: NgtLoaderExtensions<TLoaderConstructor>;
+    onLoad?: (data: NoInfer<NgtLoaderResults<TUrl, NgtBranchingReturn<TReturn, NgtGLTFLike, NgtGLTFLike & NgtObjectMap>>>) => void;
+    onProgress?: (event: ProgressEvent) => void;
+    injector?: Injector;
+}): ResourceRef<NgtLoaderResults<TUrl, NgtBranchingReturn<TReturn, NgtGLTFLike, NgtGLTFLike & NgtObjectMap>> | undefined>;
+export declare namespace loaderResource {
+    var preload: <TData, TUrl extends string | string[] | Record<string, string>, TLoaderConstructor extends NgtLoaderProto<TData>>(loaderConstructor: TLoaderConstructor, inputs: TUrl, extensions?: NgtLoaderExtensions<TLoaderConstructor>) => void;
+    var destroy: () => void;
+    var clear: (urls: string | string[]) => void;
+}

package/lib/loader.d.ts

@@ -1,10 +1,10 @@
 import { Injector, Signal } from '@angular/core';
-import { Loader, Object3D } from 'three';
+import * as THREE from 'three';
 import { NgtObjectMap } from './utils/make';
 export type NgtGLTFLike = {
-    scene: Object3D;
+    scene: THREE.Object3D;
 };
-export interface NgtLoader<T> extends Loader {
+export interface NgtLoader<T> extends THREE.Loader {
     load(url: string, onLoad?: (result: T) => void, onProgress?: (event: ProgressEvent) => void, onError?: (event: unknown) => void): unknown;
     loadAsync(url: string, onProgress?: (event: ProgressEvent) => void): Promise<T>;
 }
@@ -18,6 +18,10 @@ export type NgtBranchingReturn<T, Parent, Coerced> = NgtConditionalType<T, Paren
 export type NgtLoaderResults<TInput extends string | string[] | Record<string, string>, TReturn> = TInput extends string[] ? TReturn[] : TInput extends object ? {
     [key in keyof TInput]: TReturn;
 } : TReturn;
+/**
+ * @deprecated Use loaderResource instead. Will be removed in v5.0.0
+ * @since v4.0.0~
+ */
 declare function _injectLoader<TData, TUrl extends string | string[] | Record<string, string>, TLoaderConstructor extends NgtLoaderProto<TData>, TReturn = NgtLoaderReturnType<TData, TLoaderConstructor>>(loaderConstructorFactory: (inputs: string[]) => TLoaderConstructor, inputs: () => TUrl, { extensions, onProgress, onLoad, injector, }?: {
     extensions?: NgtLoaderExtensions<TLoaderConstructor>;
     onProgress?: (event: ProgressEvent) => void;
@@ -30,5 +34,9 @@ declare namespace _injectLoader {
     var clear: (urls: string | string[]) => void;
 }
 export type NgtInjectedLoader = typeof _injectLoader;
+/**
+ * @deprecated Use loaderResource instead. Will be removed in v5.0.0
+ * @since v4.0.0~
+ */
 export declare const injectLoader: NgtInjectedLoader;
 export {};

package/lib/renderer/renderer.d.ts

@@ -34,7 +34,7 @@ export declare class NgtRenderer2 implements Renderer2 {
         [key: string]: any;
     };
     destroy(): void;
-    createElement(name: string, namespace?: string | null): NgtRendererNode<"portal"> | NgtRendererNode<"three"> | NgtRendererNode<"platform">;
+    createElement(name: string, namespace?: string | null): NgtRendererNode<"three"> | NgtRendererNode<"platform"> | NgtRendererNode<"portal">;
     createComment(value: string): NgtRendererNode<"comment">;
     createText(value: string): NgtRendererNode<"text">;
     destroyNode: (node: NgtRendererNode) => void;

package/lib/roots.d.ts

@@ -1,9 +1,9 @@
 import { Injector } from '@angular/core';
 import type { NgtCanvasElement, NgtCanvasOptions, NgtDisposable } from './types';
-export declare function injectCanvasRootInitializer(injector?: Injector): (canvas: NgtCanvasElement) => {
+export declare function canvasRootInitializer(injector?: Injector): (canvas: NgtCanvasElement) => {
     isConfigured: boolean;
     destroy: (timeout?: number) => void;
     configure: (inputs: NgtCanvasOptions) => void;
 };
-export type NgtCanvasConfigurator = ReturnType<ReturnType<typeof injectCanvasRootInitializer>>;
+export type NgtCanvasConfigurator = ReturnType<ReturnType<typeof canvasRootInitializer>>;
 export declare function dispose<T extends NgtDisposable>(obj: T): void;

package/lib/utils/before-render.d.ts

@@ -18,7 +18,12 @@ import type { NgtBeforeRenderRecord } from '../types';
  * )
  * ```
  */
-export declare function injectBeforeRender(cb: NgtBeforeRenderRecord['callback'], { priority, injector }?: {
+export declare function beforeRender(cb: NgtBeforeRenderRecord['callback'], { priority, injector }?: {
     priority?: number | (() => number);
     injector?: Injector;
 }): () => void;
+/**
+ * @deprecated Use `beforeRender` instead. Will be removed in v5.0.0
+ * @since v4.0.0
+ */
+export declare const injectBeforeRender: typeof beforeRender;

package/lib/utils/object-events.d.ts

@@ -22,6 +22,11 @@ export declare class NgtObjectEvents {
     static ɵfac: i0.ɵɵFactoryDeclaration<NgtObjectEvents, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<NgtObjectEvents, "[ngtObjectEvents]", never, { "ngtObjectEvents": { "alias": "ngtObjectEvents"; "required": false; "isSignal": true; }; }, { "click": "click"; "dblclick": "dblclick"; "contextmenu": "contextmenu"; "pointerup": "pointerup"; "pointerdown": "pointerdown"; "pointerover": "pointerover"; "pointerout": "pointerout"; "pointerenter": "pointerenter"; "pointerleave": "pointerleave"; "pointermove": "pointermove"; "pointermissed": "pointermissed"; "pointercancel": "pointercancel"; "wheel": "wheel"; "ngtObjectEvents": "ngtObjectEventsChange"; }, never, never, true, never>;
 }
-export declare function injectObjectEvents(target: () => ElementRef<THREE.Object3D> | THREE.Object3D | null | undefined, events: NgtEventHandlers, { injector }?: {
+/**
+ * @deprecated use objectEvents instead. Will be removed in v5.0.0
+ * @since v4.0.0
+ */
+export declare const injectObjectEvents: typeof objectEvents;
+export declare function objectEvents(target: () => ElementRef<THREE.Object3D> | THREE.Object3D | null | undefined, events: NgtEventHandlers, { injector }?: {
     injector?: Injector;
 }): (() => void)[];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "angular-three",
-	"version": "4.0.0-next.96",
+	"version": "4.0.0-next.98",
 	"publishConfig": {
 		"access": "public"
 	},

package/testing/lib/utils/web-gl-rendering-context.d.ts

@@ -9,7 +9,7 @@ export declare class WebGL2RenderingContext {
     private GL_VERSION;
     private SCISSOR_BOX;
     private VIEWPORT;
-    getParameter(paramId: number): string[] | number[] | undefined;
+    getParameter(paramId: number): number[] | string[] | undefined;
     getExtension(ext: string): any;
     getProgramInfoLog: () => string;
     getShaderInfoLog: () => string;