angular-three 4.2.2 → 4.2.4-next.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "angular-three",
-	"version": "4.2.2",
+	"version": "4.2.4-next.0",
 	"publishConfig": {
 		"access": "public"
 	},

package/types/angular-three-dom.d.ts

@@ -42,9 +42,8 @@ declare function createPointerEvents(store: SignalState<NgtState>): NgtEventMana
  * ```
  */
 declare class NgtCanvasContent {
-    private canvas;
     constructor();
-    static ngTemplateContextGuard(_: NgtCanvasContent, ctx: unknown): ctx is {
+    static ngTemplateContextGuard(_: NgtCanvasContent, _ctx: unknown): _ctx is {
         $implicit: HTMLCanvasElement;
         host: HTMLElement;
     };

package/types/angular-three.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { Injector, Signal, WritableSignal, ElementRef, Provider, ProviderToken, Type, AbstractType, InjectionToken, ResourceRef, RendererFactory2, RendererType2, Renderer2, ChangeDetectorRef, InjectOptions, OutputEmitterRef, ValueEqualityFn } from '@angular/core';
+import { Injector, Signal, WritableSignal, ElementRef, Provider, ProviderToken, Type, AbstractType, InjectionToken, ResourceRef, RendererFactory2, RendererType2, Renderer2, RendererStyleFlags2, ChangeDetectorRef, InjectOptions, OutputEmitterRef, ValueEqualityFn } from '@angular/core';
 import * as THREE from 'three';
 import { Object3D } from 'three';
 import { Observable } from 'rxjs';
@@ -22,6 +22,7 @@ import * as angular_three from 'angular-three';
 declare abstract class NgtCommonDirective<TValue> {
     private vcr;
     private template;
+    private renderer;
     protected injector: Injector;
     protected injected: boolean;
     protected injectedValue: TValue | null;
@@ -553,7 +554,7 @@ interface NgtInstanceState<TObject extends NgtAnyRecord = NgtAnyRecord> {
     object: TObject & {
         __ngt__?: NgtInstanceState<TObject>;
     };
-    add: (instance: NgtInstanceNode, type: 'objects' | 'nonObjects') => void;
+    add: (instance: NgtInstanceNode, type: 'objects' | 'nonObjects', before?: NgtInstanceNode | null) => void;
     remove: (instance: NgtInstanceNode, type: 'objects' | 'nonObjects') => void;
     setParent: (parent: NgtInstanceNode | null) => void;
     updateGeometryStamp: () => void;
@@ -680,7 +681,7 @@ interface NgtState {
     previousRoot: SignalState<NgtState> | null;
     /** Internals */
     internal: NgtInternalState;
-    /** maxSkipCount from renderer options */
+    /** @deprecated Retained for compatibility; ancestor notifications are microtask-batched. */
     maxNotificationSkipCount?: number;
 }
 interface NgtCanvasOptions {
@@ -736,7 +737,6 @@ declare class NgtParent extends NgtCommonDirective<THREE.Object3D | null | undef
     protected shouldSkipRender: _angular_core.Signal<boolean>;
     constructor();
     validate(): boolean;
-    protected beforeCreateView(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgtParent, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgtParent, "ng-template[parent]", never, { "parent": { "alias": "parent"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -831,24 +831,12 @@ declare function createEvents(store: SignalState<NgtState>): {
  */
 /** Flag indicating a node is managed by the Angular Three renderer */
 declare const NGT_RENDERER_NODE_FLAG = "__ngt_renderer__";
-/** Flag for canvas content template comments */
-declare const NGT_CANVAS_CONTENT_FLAG = "__ngt_renderer_canvas_content__";
-/** Flag for portal content template comments */
-declare const NGT_PORTAL_CONTENT_FLAG = "__ngt_renderer_portal_content__";
-/** Flag for args directive comments */
-declare const NGT_ARGS_FLAG = "__ngt_renderer_args__";
-/** Flag for parent directive comments */
-declare const NGT_PARENT_FLAG = "__ngt_renderer_parent__";
-/** Internal flag for adding comment nodes */
-declare const NGT_INTERNAL_ADD_COMMENT_FLAG = "__ngt_renderer_add_comment__";
-/** Internal flag for setting parent on comment nodes */
-declare const NGT_INTERNAL_SET_PARENT_COMMENT_FLAG = "__ngt_renderer_set_parent_comment__";
+/** Internal hook for scoping structural directive context to embedded view creation */
+declare const NGT_RENDERER_CONTEXT_FLAG = "__ngt_renderer_context__";
 /** Flag for getting node attributes */
 declare const NGT_GET_NODE_ATTRIBUTE_FLAG = "__ngt_get_node_attribute__";
 /** Flag for DOM parent element reference */
 declare const NGT_DOM_PARENT_FLAG = "__ngt_dom_parent__";
-/** Flag indicating the delegate renderer's destroyNode has been patched */
-declare const NGT_DELEGATE_RENDERER_DESTROY_NODE_PATCHED_FLAG = "__ngt_delegate_renderer_destroy_node_patched__";
 /** Flag for HTML directive classes */
 declare const NGT_HTML_FLAG = "__ngt_html__";
 /** Native Three.js EventDispatcher events */
@@ -897,12 +885,14 @@ declare function provideHTMLDomElement<TDeps extends Array<ProviderToken<any>>,
  */
 declare abstract class NgtHTML {
     static [NGT_HTML_FLAG]: boolean;
-    protected domElement: HTMLElement | "gl" | null;
+    protected domElement: "gl" | HTMLElement | null;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgtHTML, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgtHTML, never, never, {}, {}, never, never, true, never>;
 }
 
+/** RFC 4122 v4 UUID — safe in non-secure contexts (e.g. http:// on LAN). */
+declare function uuidv4Fallback(): string;
 /**
  * @deprecated Use `getInstanceState` instead. Will be removed in 5.0.0
  * @param obj - The object to get local state from
@@ -968,6 +958,8 @@ declare function invalidateInstance<TInstance extends NgtAnyRecord>(instance: Ng
  * ```
  */
 declare function prepare<TInstance extends NgtAnyRecord = NgtAnyRecord>(object: TInstance, type: string, instanceState?: Partial<NgtInstanceState>): NgtInstanceNode<TInstance>;
+/** @internal */
+declare function flushAncestorNotifications(): void;
 
 /**
  * Generates a unique identifier.
@@ -1009,7 +1001,7 @@ declare function makeRendererInstance<TCanvas extends NgtCanvasElement>(glOption
  * @param size - The viewport size for calculating aspect ratio
  * @returns Either an OrthographicCamera or PerspectiveCamera
  */
-declare function makeCameraInstance(isOrthographic: boolean, size: NgtSize): THREE.PerspectiveCamera | THREE.OrthographicCamera;
+declare function makeCameraInstance(isOrthographic: boolean, size: NgtSize): THREE.OrthographicCamera | THREE.PerspectiveCamera;
 /**
  * Type representing a parsed object graph from a loaded 3D model.
  *
@@ -1071,6 +1063,11 @@ type NgtLoaderReturnType<T, L extends NgtLoaderProto<T>> = T extends unknown ? A
 type NgtLoaderExtensions<T extends {
     prototype: NgtLoaderProto<any>;
 }> = (loader: T['prototype']) => void;
+/**
+ * Semantic components that identify a configured loader. Tuple entries use
+ * value identity for primitives and reference identity for objects/functions.
+ */
+type NgtLoaderCacheKey = readonly unknown[];
 /**
  * Conditional type utility.
  */
@@ -1092,14 +1089,20 @@ type NgtLoaderResults<TInput extends string | string[] | Record<string, string>,
  * @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, }?: {
+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, cacheKey, onProgress, onLoad, injector, }?: {
     extensions?: NgtLoaderExtensions<TLoaderConstructor>;
+    /**
+     * Semantic loader configuration. Supply this when an extension's captured
+     * configuration can change, or when equivalent extension closures should
+     * share preloaded results. Configured requests without a key are isolated.
+     */
+    cacheKey?: () => NgtLoaderCacheKey;
     onProgress?: (event: ProgressEvent) => void;
     onLoad?: (data: NoInfer<TReturn>) => void;
     injector?: Injector;
 }): Signal<NgtLoaderResults<TUrl, NgtBranchingReturn<TReturn, NgtGLTFLike, NgtGLTFLike & NgtObjectMap>> | null>;
 declare namespace _injectLoader {
-    var preload: <TData, TUrl extends string | string[] | Record<string, string>, TLoaderConstructor extends NgtLoaderProto<TData>>(loaderConstructorFactory: (inputs: string[]) => TLoaderConstructor, inputs: () => TUrl, extensions?: NgtLoaderExtensions<TLoaderConstructor>, onLoad?: (data: NoInfer<TData>) => void) => void;
+    var preload: <TData, TUrl extends string | string[] | Record<string, string>, TLoaderConstructor extends NgtLoaderProto<TData>>(loaderConstructorFactory: (inputs: string[]) => TLoaderConstructor, inputs: () => TUrl, extensions?: NgtLoaderExtensions<TLoaderConstructor>, onLoad?: (data: NoInfer<TData>) => void, cacheKey?: () => NgtLoaderCacheKey) => void;
     var destroy: () => void;
     var clear: (urls: string | string[]) => void;
 }
@@ -1147,14 +1150,21 @@ declare const injectLoader: NgtInjectedLoader;
  * }
  * ```
  */
-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, }?: {
+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, cacheKey, onLoad, onProgress, injector, }?: {
     extensions?: NgtLoaderExtensions<TLoaderConstructor>;
+    /**
+     * Semantic loader configuration. Components are compared by primitive value
+     * or object/function identity. Required when captured extension configuration
+     * changes, and useful for sharing equivalent preload/load closures. Configured
+     * requests without a key are isolated.
+     */
+    cacheKey?: () => NgtLoaderCacheKey;
     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>;
 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 preload: <TData, TUrl extends string | string[] | Record<string, string>, TLoaderConstructor extends NgtLoaderProto<TData>>(loaderConstructor: TLoaderConstructor, inputs: TUrl, extensions?: NgtLoaderExtensions<TLoaderConstructor>, cacheKey?: NgtLoaderCacheKey) => void;
     var destroy: () => void;
     var clear: (urls: string | string[]) => void;
 }
@@ -1309,7 +1319,7 @@ declare class NgtPortalAutoRender {
  * ```
  */
 declare class NgtPortalContent {
-    static ngTemplateContextGuard(_: NgtPortalContent, ctx: unknown): ctx is {
+    static ngTemplateContextGuard(_: NgtPortalContent, _ctx: unknown): _ctx is {
         injector: Injector;
     };
     constructor();
@@ -1362,12 +1372,15 @@ declare class NgtPortalImpl {
     private previousStore;
     private portalStore;
     private injector;
+    private document;
     private size;
     private events;
     private restState;
     private portalContentRendered;
     portalRendered: _angular_core.Signal<boolean>;
     private portalViewRef?;
+    /** @internal Subscribe to invalidations originating in this portal layer. */
+    onInvalidate(listener: () => void): () => void;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgtPortalImpl, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgtPortalImpl, "ngt-portal", never, { "container": { "alias": "container"; "required": true; "isSignal": true; }; "state": { "alias": "state"; "required": false; "isSignal": true; }; }, {}, ["contentRef", "anchorRef"], never, true, never>;
@@ -1427,50 +1440,73 @@ declare const NGT_CATALOGUE: InjectionToken<Record<string, NgtConstructorReprese
  */
 declare function injectCatalogue(): Record<string, NgtConstructorRepresentation>;
 
+type NgtRendererAnchor = {
+    kind: 'canvas' | 'portal';
+    store: SignalState<NgtState>;
+    domParent?: NgtRendererNode<'portal'>;
+} | {
+    kind: 'args' | 'parent';
+    injector: Injector;
+};
 type ThreeRendererState = [
     type: 'three',
     destroyed: boolean,
     rawValue: any | undefined,
     portalContainer: never | undefined,
-    injector: never | undefined,
-    parent: NgtRendererNode<'platform' | 'portal' | 'three'> | undefined,
-    children: Array<NgtRendererNode<'platform' | 'portal' | 'comment'>>
+    parent: NgtRendererNode | undefined,
+    children: NgtRendererNode[],
+    parentOverride: NgtRendererNode<'three'> | undefined,
+    anchor: NgtRendererAnchor | undefined,
+    owner: NgtRendererNode | undefined,
+    ownedNodes: Set<NgtRendererNode> | undefined
 ];
 type PortalRendererState = [
     type: 'portal',
     destroyed: boolean,
     rawValue: never | undefined,
     portalContainer: NgtRendererNode<'three'> | undefined,
-    injector: Injector | undefined,
-    parent: any | undefined,
-    children: any[]
+    parent: NgtRendererNode | undefined,
+    children: NgtRendererNode[],
+    parentOverride: never | undefined,
+    anchor: NgtRendererAnchor | undefined,
+    owner: NgtRendererNode | undefined,
+    ownedNodes: Set<NgtRendererNode> | undefined
 ];
 type PlatformRendererState = [
     type: 'platform',
     destroyed: boolean,
     rawValue: never | undefined,
     portalContainer: never | undefined,
-    injector: never | undefined,
-    parent: NgtRendererNode<'three' | 'portal'> | undefined,
-    children: Array<NgtRendererNode<'three' | 'portal' | 'comment'>>
+    parent: NgtRendererNode | undefined,
+    children: NgtRendererNode[],
+    parentOverride: never | undefined,
+    anchor: NgtRendererAnchor | undefined,
+    owner: NgtRendererNode | undefined,
+    ownedNodes: Set<NgtRendererNode> | undefined
 ];
 type CommentRendererState = [
     type: 'comment',
     destroyed: boolean,
     rawValue: never | undefined,
     portalContainer: never | undefined,
-    injector: Injector | undefined,
     parent: NgtRendererNode | undefined,
-    children: NgtRendererNode[]
+    children: NgtRendererNode[],
+    parentOverride: never | undefined,
+    anchor: NgtRendererAnchor | undefined,
+    owner: NgtRendererNode | undefined,
+    ownedNodes: Set<NgtRendererNode> | undefined
 ];
 type TextRendererState = [
     type: 'text',
     destroyed: boolean,
     rawValue: never | undefined,
     portalContainer: never | undefined,
-    injector: never | undefined,
     parent: NgtRendererNode | undefined,
-    children: NgtRendererNode[]
+    children: NgtRendererNode[],
+    parentOverride: never | undefined,
+    anchor: NgtRendererAnchor | undefined,
+    owner: NgtRendererNode | undefined,
+    ownedNodes: Set<NgtRendererNode> | undefined
 ];
 type NgtRendererStateMap = {
     three: ThreeRendererState;
@@ -1479,10 +1515,12 @@ type NgtRendererStateMap = {
     comment: CommentRendererState;
     text: TextRendererState;
 };
-interface NgtRendererNode<TType extends keyof NgtRendererStateMap = keyof NgtRendererStateMap> extends NgtAnyRecord {
+type NgtRendererNodeType = keyof NgtRendererStateMap;
+interface NgtRendererNode<TType extends NgtRendererNodeType = NgtRendererNodeType> extends NgtAnyRecord {
     [NGT_RENDERER_NODE_FLAG]: NgtRendererStateMap[TType];
     [NGT_DOM_PARENT_FLAG]?: HTMLElement;
 }
+declare function setRendererAnchor(node: unknown, anchor: NgtRendererAnchor): boolean;
 
 /**
  * Configuration options for the Angular Three renderer factory.
@@ -1494,13 +1532,8 @@ interface NgtRendererFactory2Options {
      */
     verbose?: boolean;
     /**
-     * When a change happens to an object's direct children, Angular Three will notify the object's ancestors
-     * of this change so the ancestors are aware of the updated matrices of the object. In order to reduce the
-     * number of notifications, Angular Three caches and skips notifications when possible.
-     *
-     * However, this can cause missed notifications in some cases. Control the number of skips with this option.
-     *
-     * @default 5
+     * @deprecated Ancestor notifications are now deterministically coalesced once per microtask.
+     * This option is retained for source compatibility and no longer changes runtime behavior.
      */
     maxNotificationSkipCount?: number;
 }
@@ -1532,12 +1565,15 @@ declare class NgtRendererFactory2 implements RendererFactory2 {
     private catalogue;
     private document;
     private options;
-    private rendererMap;
+    private rendererByDelegate;
     /**
      * NOTE: We use `useFactory` to instantiate `NgtRendererFactory2`
      */
     constructor(delegateRendererFactory: RendererFactory2);
     createRenderer(hostElement: any, type: RendererType2 | null): Renderer2;
+    begin(): void;
+    end(): void;
+    whenRenderingDone(): Promise<any>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgtRendererFactory2, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<NgtRendererFactory2>;
 }
@@ -1558,37 +1594,52 @@ declare class NgtRenderer2 implements Renderer2 {
     private catalogue;
     private document;
     private options;
-    count: number;
-    private argsInjectors;
-    private parentInjectors;
-    constructor(delegateRenderer: Renderer2, catalogue: Record<string, NgtConstructorRepresentation>, document: Document, options: NgtRendererFactory2Options, count?: number);
-    get data(): {
+    private directiveInjectors;
+    private parameterKeys;
+    private attachedListeners;
+    private updatedListeners;
+    readonly data: {
         [key: string]: any;
     };
+    constructor(delegateRenderer: Renderer2, catalogue: Record<string, NgtConstructorRepresentation>, document: Document, options: NgtRendererFactory2Options);
     destroy(): void;
-    createElement(name: string, namespace?: string | null): NgtRendererNode<"three"> | NgtRendererNode<"portal"> | NgtRendererNode<"platform">;
-    createComment(value: string): NgtRendererNode<"comment">;
-    createText(value: string): NgtRendererNode<"text">;
-    destroyNode: (node: NgtRendererNode) => void;
+    createElement(name: string, namespace?: string | null): any;
+    createComment(value: string): any;
+    createText(value: string): any;
+    destroyNode(node: NgtRendererNode): void;
     appendChild(parent: NgtRendererNode, newChild: NgtRendererNode, refChild?: NgtRendererNode, isMove?: boolean): void;
     insertBefore(parent: NgtRendererNode, newChild: NgtRendererNode, refChild: NgtRendererNode, isMove?: boolean): void;
-    removeChild(parent: NgtRendererNode, oldChild: NgtRendererNode, isHostElement?: boolean): void;
+    removeChild(parent: NgtRendererNode, oldChild: NgtRendererNode, isHostElement?: boolean, requireSynchronousElementRemoval?: boolean): void;
     parentNode(node: NgtRendererNode): any;
     removeAttribute(el: NgtRendererNode, name: string, namespace?: string | null): void;
     setAttribute(el: NgtRendererNode, name: string, value: string, namespace?: string | null): void;
     setProperty(el: NgtRendererNode, name: string, value: any): void;
-    listen(target: 'window' | 'document' | 'body' | NgtRendererNode, eventName: string, callback: (event: any) => boolean | void): () => void;
+    listen(target: 'window' | 'document' | 'body' | NgtRendererNode, eventName: string, callback: (event: any) => boolean | void, options?: Parameters<Renderer2['listen']>[3]): () => void;
     private appendThreeRendererNodes;
     private setNodeRelationship;
+    private findNearestThreeParent;
+    private findTargetThreeParent;
+    private portalStore;
+    private findNearestPortalStore;
+    private findFirstThreeDescendant;
+    private findThreeInsertionReference;
+    private findThreeReferenceAfterLogicalNode;
+    private attachThreeDescendants;
+    private detachThreeDescendants;
+    private destroyOwnedNodes;
+    private listenToInstanceEvent;
+    private registerWithOptions;
     private getNgtDirective;
+    [NGT_RENDERER_CONTEXT_FLAG]: <T>(injector: Injector, callback: () => T) => T;
     private normalizeAttach;
-    addClass: (el: any, name: string) => void;
-    removeClass: (el: any, name: string) => void;
-    setStyle: (el: any, style: string, value: any, flags?: _angular_core.RendererStyleFlags2) => void;
-    removeStyle: (el: any, style: string, flags?: _angular_core.RendererStyleFlags2) => void;
-    selectRootElement: (selectorOrNode: string | any, preserveContent?: boolean) => any;
-    nextSibling: (node: any) => any;
-    setValue: (node: any, value: string) => void;
+    private updateAttachment;
+    addClass(el: NgtRendererNode, name: string): void;
+    removeClass(el: NgtRendererNode, name: string): void;
+    setStyle(el: NgtRendererNode, style: string, value: any, flags?: RendererStyleFlags2): void;
+    removeStyle(el: NgtRendererNode, style: string, flags?: RendererStyleFlags2): void;
+    selectRootElement(selectorOrNode: string | any, preserveContent?: boolean): any;
+    nextSibling(node: NgtRendererNode): any;
+    setValue(node: NgtRendererNode, value: string): void;
 }
 
 /**
@@ -1609,7 +1660,7 @@ declare class NgtRenderer2 implements Renderer2 {
  * ```
  */
 declare function canvasRootInitializer(injector?: Injector): (canvas: NgtCanvasElement) => {
-    isConfigured: boolean;
+    readonly isConfigured: boolean;
     destroy: (timeout?: number) => void;
     configure: (inputs: NgtCanvasOptions) => void;
 };
@@ -1989,7 +2040,7 @@ declare const is: {
      * Generic Three.js type check using the is* pattern.
      * @example is.three<THREE.Mesh>(obj, 'isMesh')
      */
-    three: <TThreeEntity extends object, TKey extends keyof TThreeEntity = keyof TThreeEntity>(a: unknown, isKey: TKey extends `is${infer K}` ? TKey : never) => a is TThreeEntity;
+    three: <TThreeEntity extends object, TKey extends keyof TThreeEntity = keyof TThreeEntity>(a: unknown, isKey: TKey extends `is${string}` ? TKey : never) => a is TThreeEntity;
     /** Checks if value is a valid Three.js ColorRepresentation */
     colorRepresentation: (a: unknown) => a is THREE.ColorRepresentation;
     /** Checks if object has colorSpace or outputColorSpace property */
@@ -2263,5 +2314,5 @@ declare function checkUpdate(value: unknown): void;
  */
 declare function updateCamera(camera: NgtCamera, size: NgtSize): void;
 
-export { NGT_APPLY_PROPS, NGT_ARGS_FLAG, NGT_CANVAS_CONTENT_FLAG, NGT_CATALOGUE, NGT_DELEGATE_RENDERER_DESTROY_NODE_PATCHED_FLAG, NGT_DOM_PARENT_FLAG, NGT_GET_NODE_ATTRIBUTE_FLAG, NGT_HTML_FLAG, NGT_INTERNAL_ADD_COMMENT_FLAG, NGT_INTERNAL_SET_PARENT_COMMENT_FLAG, NGT_LOOP, NGT_PARENT_FLAG, NGT_PORTAL_CONTENT_FLAG, NGT_RENDERER_NODE_FLAG, NGT_RENDERER_OPTIONS, NGT_STORE, NgtArgs, NgtElementEvents, NgtHTML, NgtHexify, NgtObjectEvents, NgtParent, NgtPortal, NgtPortalAutoRender, NgtPortalContent, NgtPortalImpl, NgtRenderer2, NgtRendererFactory2, NgtRoutedScene, NgtSelect, NgtSelection, NgtSelectionApi, THREE_NATIVE_EVENTS, addAfterEffect, addEffect, addTail, applyProps, attach, beforeRender, canvasRootInitializer, checkNeedsUpdate, checkUpdate, createAttachFunction, createEvents, detach, dispose, elementEvents, extend, flushGlobalEffects, getEmitter, getInstanceState, getLocalState, hasListener, injectBeforeRender, injectCatalogue, injectLoader, injectLoop, injectObjectEvents, injectStore, invalidateInstance, is, loaderResource, makeCameraInstance, makeDpr, makeId, makeObjectGraph, makeRendererInstance, merge, objectEvents, omit, pick, prepare, provideHTMLDomElement, remove, removeInteractivity, resolveInstanceKey, resolveRef, roots, signalState, storeFactory, toDeepSignal, updateCamera, vector2, vector3, vector4 };
-export type { DeepSignal, NgtAfterAttach, NgtAllObject3DEventsMap, NgtAnyRecord, NgtArguments, NgtAttachFunction, NgtAttachable, NgtBeforeRenderEvent, NgtBeforeRenderRecord, NgtBranchingReturn, NgtCamera, NgtCameraLike, NgtCameraParameters, NgtCanvasConfigurator, NgtCanvasElement, NgtCanvasOptions, NgtColor, NgtComputeFunction, NgtConditionalType, NgtConstructorRepresentation, NgtDisposable, NgtDomEvent, NgtDpr, NgtElementProperties, NgtEquConfig, NgtEuler, NgtEventHandlers, NgtEventManager, NgtEventPrefix, NgtEvents, NgtFilterFunction, NgtFrameloop, NgtGLDefaultOptions, NgtGLOptions, NgtGLTFLike, NgtGlobalEffectType, NgtGlobalRenderCallback, NgtInjectedLoader, NgtInstanceHierarchyState, NgtInstanceNode, NgtInstanceState, NgtInternalState, NgtIntersection, NgtIntersectionEvent, NgtIsProperties, NgtLayers, NgtLoader, NgtLoaderExtensions, NgtLoaderProto, NgtLoaderResults, NgtLoaderReturnType, NgtMathProperties, NgtMathRepresentation, NgtMathType, NgtMathTypes, NgtMatrix3, NgtMatrix4, NgtMutable, NgtNodeElement, NgtNodeEventListener, NgtNodeEventMap, NgtNonFunctionKeys, NgtNonMutableProperties, NgtNonPartialProperties, NgtNullableRaycast, NgtNullish, NgtObject3DEventsMap, NgtObjectMap, NgtOverwrite, NgtPerformance, NgtPointerCaptureTarget, NgtPortalState, NgtProperties, NgtQuaternion, NgtRaycastableRepresentation, NgtRenderState, NgtRendererFactory2Options, NgtRendererLike, NgtShadows, NgtSize, NgtState, NgtThreeElement, NgtThreeElements, NgtThreeEvent, NgtVector2, NgtVector3, NgtVector4, NgtVectorRepresentation, NgtViewport, NgtXRManager, PartialStateUpdater, SignalState, StateSource, ThreeAddedEvent, ThreeChangeEvent, ThreeChildAddedEvent, ThreeChildRemovedEvent, ThreeDisposeEvent, ThreeRemovedEvent, WritableStateSource };
+export { NGT_APPLY_PROPS, NGT_CATALOGUE, NGT_DOM_PARENT_FLAG, NGT_GET_NODE_ATTRIBUTE_FLAG, NGT_HTML_FLAG, NGT_LOOP, NGT_RENDERER_CONTEXT_FLAG, NGT_RENDERER_NODE_FLAG, NGT_RENDERER_OPTIONS, NGT_STORE, NgtArgs, NgtElementEvents, NgtHTML, NgtHexify, NgtObjectEvents, NgtParent, NgtPortal, NgtPortalAutoRender, NgtPortalContent, NgtPortalImpl, NgtRenderer2, NgtRendererFactory2, NgtRoutedScene, NgtSelect, NgtSelection, NgtSelectionApi, THREE_NATIVE_EVENTS, addAfterEffect, addEffect, addTail, applyProps, attach, beforeRender, canvasRootInitializer, checkNeedsUpdate, checkUpdate, createAttachFunction, createEvents, detach, dispose, elementEvents, extend, flushAncestorNotifications, flushGlobalEffects, getEmitter, getInstanceState, getLocalState, hasListener, injectBeforeRender, injectCatalogue, injectLoader, injectLoop, injectObjectEvents, injectStore, invalidateInstance, is, loaderResource, makeCameraInstance, makeDpr, makeId, makeObjectGraph, makeRendererInstance, merge, objectEvents, omit, pick, prepare, provideHTMLDomElement, remove, removeInteractivity, resolveInstanceKey, resolveRef, roots, setRendererAnchor, signalState, storeFactory, toDeepSignal, updateCamera, uuidv4Fallback, vector2, vector3, vector4 };
+export type { DeepSignal, NgtAfterAttach, NgtAllObject3DEventsMap, NgtAnyRecord, NgtArguments, NgtAttachFunction, NgtAttachable, NgtBeforeRenderEvent, NgtBeforeRenderRecord, NgtBranchingReturn, NgtCamera, NgtCameraLike, NgtCameraParameters, NgtCanvasConfigurator, NgtCanvasElement, NgtCanvasOptions, NgtColor, NgtComputeFunction, NgtConditionalType, NgtConstructorRepresentation, NgtDisposable, NgtDomEvent, NgtDpr, NgtElementProperties, NgtEquConfig, NgtEuler, NgtEventHandlers, NgtEventManager, NgtEventPrefix, NgtEvents, NgtFilterFunction, NgtFrameloop, NgtGLDefaultOptions, NgtGLOptions, NgtGLTFLike, NgtGlobalEffectType, NgtGlobalRenderCallback, NgtInjectedLoader, NgtInstanceHierarchyState, NgtInstanceNode, NgtInstanceState, NgtInternalState, NgtIntersection, NgtIntersectionEvent, NgtIsProperties, NgtLayers, NgtLoader, NgtLoaderCacheKey, NgtLoaderExtensions, NgtLoaderProto, NgtLoaderResults, NgtLoaderReturnType, NgtMathProperties, NgtMathRepresentation, NgtMathType, NgtMathTypes, NgtMatrix3, NgtMatrix4, NgtMutable, NgtNodeElement, NgtNodeEventListener, NgtNodeEventMap, NgtNonFunctionKeys, NgtNonMutableProperties, NgtNonPartialProperties, NgtNullableRaycast, NgtNullish, NgtObject3DEventsMap, NgtObjectMap, NgtOverwrite, NgtPerformance, NgtPointerCaptureTarget, NgtPortalState, NgtProperties, NgtQuaternion, NgtRaycastableRepresentation, NgtRenderState, NgtRendererAnchor, NgtRendererFactory2Options, NgtRendererLike, NgtShadows, NgtSize, NgtState, NgtThreeElement, NgtThreeElements, NgtThreeEvent, NgtVector2, NgtVector3, NgtVector4, NgtVectorRepresentation, NgtViewport, NgtXRManager, PartialStateUpdater, SignalState, StateSource, ThreeAddedEvent, ThreeChangeEvent, ThreeChildAddedEvent, ThreeChildRemovedEvent, ThreeDisposeEvent, ThreeRemovedEvent, WritableStateSource };