@hology/core 0.0.234 → 0.0.236

package/dist/scene/materials/grass-foliage.d.ts

@@ -1,6 +1,6 @@
 import { NodeShaderMaterial } from '../../shader-nodes/index.js';
-import { Color, Texture } from 'three';
-import { RenderingView } from '../../rendering.js';
+import type { Color, Texture } from 'three';
+import type { RenderingView } from '../../rendering.js';
 export interface GrassFoliageMaterialParameters {
     map: Texture;
     color: Color;

package/dist/scene/materials/grass.d.ts

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { RenderingView } from '../../rendering.js';
+import type { RenderingView } from '../../rendering.js';
 export declare function createGrassMaterial(params: any, renderingView: RenderingView): THREE.MeshStandardMaterial;
 export declare function createGrassMaterialOld(params: any, renderingView: RenderingView): THREE.ShaderMaterial;
 //# sourceMappingURL=grass.d.ts.map

package/dist/scene/materials/utils/material-painting.d.ts

@@ -1,3 +1,4 @@
-import { Mesh, BufferAttribute } from "three";
+import type { Mesh } from "three";
+import { BufferAttribute } from "three";
 export declare function getMaterialAttribute(mesh: Mesh, index: number, recreate?: boolean): BufferAttribute;
 //# sourceMappingURL=material-painting.d.ts.map

package/dist/scene/materials/water.d.ts

@@ -1,4 +1,4 @@
 import * as THREE from 'three';
-import { RenderingView } from '../../rendering.js';
+import type { RenderingView } from '../../rendering.js';
 export declare function createWaterMaterial(params: any, renderingView: RenderingView): THREE.ShaderMaterial;
 //# sourceMappingURL=water.d.ts.map

package/dist/scene/model.d.ts

@@ -1,4 +1,4 @@
-import { EulerOrder, Side } from 'three';
+import type { EulerOrder, Side } from 'three';
 import type { SequenceData } from '../effects/sequence/sequence-data.js';
 import type { BlendingMode, VfxAssetData } from '../effects/vfx/vfx-asset.js';
 import type { ShaderGraphDocument, ShaderGraphMaterialReference } from '../shader/graph/model.js';

package/dist/scene/objects/prefab.d.ts

@@ -1,6 +1,6 @@
-import { Object3D } from "three";
-import { BaseActor } from "../../gameplay/actors/actor.js";
-import { Asset } from "../model";
+import type { Object3D } from "three";
+import type { BaseActor } from "../../gameplay/actors/actor.js";
+import type { Asset } from "../model.js";
 export declare class Prefab {
     asset: Asset;
 }

package/dist/scene/objects/shapes.d.ts

@@ -1,5 +1,7 @@
-import { BoxCollisionShape, CapsuleCollisionShape, CollisionShape, ConeCollisionShape, ConvexPolyhedronCollisionShape, CylinderCollisionShape, PlaneCollisionShape, SphereCollisionShape, TrimeshCollisionShape } from '../collision/collision-shape.js';
-import { BoxGeometry, PlaneGeometry, BufferGeometry, CylinderGeometry, SphereGeometry, TorusGeometry, ConeGeometry, CircleGeometry, CapsuleGeometry, Vector2, Color } from "three";
+import type { CollisionShape } from '../collision/collision-shape.js';
+import { BoxCollisionShape, CapsuleCollisionShape, ConeCollisionShape, ConvexPolyhedronCollisionShape, CylinderCollisionShape, PlaneCollisionShape, SphereCollisionShape, TrimeshCollisionShape } from '../collision/collision-shape.js';
+import type { BufferGeometry, Vector2, Color } from "three";
+import { BoxGeometry, PlaneGeometry, CylinderGeometry, SphereGeometry, TorusGeometry, ConeGeometry, CircleGeometry, CapsuleGeometry } from "three";
 import { TextGeometry } from 'three/examples/jsm/geometries/TextGeometry.js';
 type AVec3 = [number, number, number];
 type ShapeParameterDef<T = boolean | number | string | Vector2 | AVec3 | Color> = {

package/dist/scene/runtime-asset-service.d.ts

@@ -1,7 +1,7 @@
 import { AssetsProvider } from '../scene/assets-provider.js';
 import { Subject } from 'rxjs';
-import { Asset } from '../scene/model.js';
-import { RuntimeBackendService } from './runtime-backend-service.js';
+import type { Asset } from '../scene/model.js';
+import type { RuntimeBackendService } from './runtime-backend-service.js';
 export declare class RuntimeAssetsService extends AssetsProvider {
     private backend;
     private assets;

package/dist/scene/runtime-backend-service.d.ts

@@ -1,5 +1,5 @@
-import { SceneObject } from './materializer.js';
-import { Asset, SceneData } from './model.js';
+import type { SceneObject } from './materializer.js';
+import type { Asset, SceneData } from './model.js';
 export interface RuntimeBackendService {
     getAssets(): Promise<Asset[]>;
     getAsset(id: string): Promise<Asset>;

package/dist/scene/runtime-bundled-backend-service.d.ts

@@ -1,6 +1,6 @@
-import { SceneObject } from './materializer.js';
-import { Asset, SceneData } from './model.js';
-import { RuntimeBackendService } from './runtime-backend-service.js';
+import type { SceneObject } from './materializer.js';
+import type { Asset, SceneData } from './model.js';
+import type { RuntimeBackendService } from './runtime-backend-service.js';
 export declare class RuntimeBundledBackendService implements RuntimeBackendService {
     private assets;
     private scenes;

package/dist/scene/scatter/painted-scatter-manager.d.ts

@@ -2,7 +2,7 @@ import type { RenderingView } from '../../rendering.js';
 import type { AssetResourceLoader } from '../asset-resource-loader.js';
 import type { AssetsProvider } from '../assets-provider.js';
 import type { SceneDataProvider } from '../materializer.js';
-import { Scene } from 'three';
+import type { Scene } from 'three';
 export declare class PaintedScatterManager {
     private scene;
     private dataProvider;

package/dist/scene/scatter/surface-scatter-manager.d.ts

@@ -1,8 +1,8 @@
-import { RenderingView } from '../../rendering.js';
-import { AssetResourceLoader } from '../asset-resource-loader.js';
-import { AssetsProvider } from '../assets-provider.js';
+import type { RenderingView } from '../../rendering.js';
+import type { AssetResourceLoader } from '../asset-resource-loader.js';
+import type { AssetsProvider } from '../assets-provider.js';
 import type { SceneDataProvider } from '../materializer.js';
-import { Scene } from 'three';
+import type { Scene } from 'three';
 export declare class SurfaceScatterManager {
     private scene;
     private dataProvider;

package/dist/scene/scene-data-service.d.ts

@@ -1,4 +1,4 @@
-import { SceneDataProvider, SceneObject, ChangeCallback } from '../scene/materializer.js';
+import type { SceneDataProvider, SceneObject, ChangeCallback } from '../scene/materializer.js';
 import { BehaviorSubject } from 'rxjs';
 import { Matrix4 } from 'three';
 export declare class SceneDataService implements SceneDataProvider {

package/dist/scene/surface-query.d.ts

@@ -1,4 +1,4 @@
-import type { BaseSurfaceDefinition } from "../data/surface-definition";
-import { Intersection } from "three";
+import type { BaseSurfaceDefinition } from "../data/surface-definition.js";
+import type { Intersection } from "three";
 export declare function findSurfaceDefinition(intersection: Intersection): BaseSurfaceDefinition | null;
 //# sourceMappingURL=surface-query.d.ts.map

package/dist/scene/surface-query.js

@@ -1,4 +1,4 @@
-import{Mesh as t,Vector3 as e}from"three";import{BatchedMesh2 as r}from"./batched-mesh-2";export function findSurfaceDefinition(e){const u=e.object;if(null==u||!(u instanceof t)||null==u.material)return;const o=Array.isArray(u.material)?u.material[e.face.materialIndex]:u.material;if(null==o)return null;if(u instanceof r){const t=u.surfaceByInstance?.[e.batchId];if(null!=t)return t}let l;return l=function(t,e,r){if(null==t.userData.surfaceByLayer||!e.hasAttribute("material"))return null;const u=function(t,e){const r=t.object,u=e.getAttribute("position"),o=e.index,l=t.faceIndex,f=o?o.getX(3*l+0):3*l+0,c=o?o.getX(3*l+1):3*l+1,s=o?o.getX(3*l+2):3*l+2;n.fromBufferAttribute(u,f).applyMatrix4(r.matrixWorld),a.fromBufferAttribute(u,c).applyMatrix4(r.matrixWorld),i.fromBufferAttribute(u,s).applyMatrix4(r.matrixWorld);const m=t.point,d=m.distanceToSquared(n),p=m.distanceToSquared(a),b=m.distanceToSquared(i),y=d<p?d<b?f:s:p<b?c:s,x=e.getAttribute("material"),g=e.getAttribute("material2"),A=4;let B=0;const h=.5;if(null!=x)for(let t=0;t<A;t++){x.getComponent(y,t)>h&&(B=t+1)}if(null!=g)for(let t=0;t<A;t++){g.getComponent(y,t)>h&&(B=t+5)}return B}(r,e);return t.userData.surfaceByLayer[u]}(o,u.geometry,e),null!=l?l:o.userData.surface}const n=new e,a=new e,i=new e;/*
+import{Mesh as t,Vector3 as e}from"three";import{BatchedMesh2 as r}from"./batched-mesh-2.js";export function findSurfaceDefinition(e){const u=e.object;if(null==u||!(u instanceof t)||null==u.material)return;const o=Array.isArray(u.material)?u.material[e.face.materialIndex]:u.material;if(null==o)return null;if(u instanceof r){const t=u.surfaceByInstance?.[e.batchId];if(null!=t)return t}let l;return l=function(t,e,r){if(null==t.userData.surfaceByLayer||!e.hasAttribute("material"))return null;const u=function(t,e){const r=t.object,u=e.getAttribute("position"),o=e.index,l=t.faceIndex,f=o?o.getX(3*l+0):3*l+0,c=o?o.getX(3*l+1):3*l+1,s=o?o.getX(3*l+2):3*l+2;n.fromBufferAttribute(u,f).applyMatrix4(r.matrixWorld),a.fromBufferAttribute(u,c).applyMatrix4(r.matrixWorld),i.fromBufferAttribute(u,s).applyMatrix4(r.matrixWorld);const m=t.point,d=m.distanceToSquared(n),p=m.distanceToSquared(a),b=m.distanceToSquared(i),y=d<p?d<b?f:s:p<b?c:s,x=e.getAttribute("material"),g=e.getAttribute("material2"),A=4;let B=0;const h=.5;if(null!=x)for(let t=0;t<A;t++){x.getComponent(y,t)>h&&(B=t+1)}if(null!=g)for(let t=0;t<A;t++){g.getComponent(y,t)>h&&(B=t+5)}return B}(r,e);return t.userData.surfaceByLayer[u]}(o,u.geometry,e),null!=l?l:o.userData.surface}const n=new e,a=new e,i=new e;/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/shader/builtin/decal-unlit-shader.js

@@ -1,4 +1,4 @@
-import{__decorate as t,__metadata as e}from"tslib";import{Color as i,Texture as r,Vector2 as a,BackSide as l}from"three";import{Parameter as o}from"../parameter.js";import{DecalNodeShader as p}from"../decal-shader.js";import{float as s,rgb as d,rgba as n,textureSampler2d as h}from"three-shader-graph";import{decalAlpha as c,decalUV as m}from"../../shader-nodes/decal.js";import{particleUniforms as y}from"../../shader-nodes/particle.js";import{tileUv as u}from"./decal-standard-shader";export class DecalUnlitShader extends p{constructor(){super(...arguments),this.color=new i("#FFFFFF"),this.opacity=1,this.intensity=1,this.atlasSize=new a(1,1),this.atlasTile=1}output(){let t=u(m,this.atlasSize,this.atlasTile),e=s(this.opacity).multiply(y.opacity);null!=this.alphaMap&&(e=e.multiply(h(this.alphaMap).sample(t).r)),e=e.multiply(c);let i=n(d(this.color).multiply(y.color),e);return null!=this.colorMap&&(i=i.multiply(h(this.colorMap).sample(t))),i=n(i.rgb.multiplyScalar(this.intensity),i.a),{color:i,emissive:i.rgb}}build(){const t=super.build();return t.depthTest=!0,t.depthWrite=!1,t.userData.isDecal=!0,t.side=l,t}}t([o(),e("design:type",i)],DecalUnlitShader.prototype,"color",void 0),t([o({range:[0,1]}),e("design:type",Number)],DecalUnlitShader.prototype,"opacity",void 0),t([o({range:[0,10]}),e("design:type",Number)],DecalUnlitShader.prototype,"intensity",void 0),t([o(),e("design:type",r)],DecalUnlitShader.prototype,"colorMap",void 0),t([o(),e("design:type",r)],DecalUnlitShader.prototype,"alphaMap",void 0),t([o(),e("design:type",a)],DecalUnlitShader.prototype,"atlasSize",void 0),t([o({range:[1,64],precision:0}),e("design:type",Number)],DecalUnlitShader.prototype,"atlasTile",void 0);/*
+import{__decorate as t,__metadata as e}from"tslib";import{Color as i,Texture as r,Vector2 as a,BackSide as l}from"three";import{Parameter as o}from"../parameter.js";import{DecalNodeShader as p}from"../decal-shader.js";import{float as s,rgb as d,rgba as n,textureSampler2d as h}from"three-shader-graph";import{decalAlpha as c,decalUV as m}from"../../shader-nodes/decal.js";import{particleUniforms as y}from"../../shader-nodes/particle.js";import{tileUv as u}from"./decal-standard-shader.js";export class DecalUnlitShader extends p{constructor(){super(...arguments),this.color=new i("#FFFFFF"),this.opacity=1,this.intensity=1,this.atlasSize=new a(1,1),this.atlasTile=1}output(){let t=u(m,this.atlasSize,this.atlasTile),e=s(this.opacity).multiply(y.opacity);null!=this.alphaMap&&(e=e.multiply(h(this.alphaMap).sample(t).r)),e=e.multiply(c);let i=n(d(this.color).multiply(y.color),e);return null!=this.colorMap&&(i=i.multiply(h(this.colorMap).sample(t))),i=n(i.rgb.multiplyScalar(this.intensity),i.a),{color:i,emissive:i.rgb}}build(){const t=super.build();return t.depthTest=!0,t.depthWrite=!1,t.userData.isDecal=!0,t.side=l,t}}t([o(),e("design:type",i)],DecalUnlitShader.prototype,"color",void 0),t([o({range:[0,1]}),e("design:type",Number)],DecalUnlitShader.prototype,"opacity",void 0),t([o({range:[0,10]}),e("design:type",Number)],DecalUnlitShader.prototype,"intensity",void 0),t([o(),e("design:type",r)],DecalUnlitShader.prototype,"colorMap",void 0),t([o(),e("design:type",r)],DecalUnlitShader.prototype,"alphaMap",void 0),t([o(),e("design:type",a)],DecalUnlitShader.prototype,"atlasSize",void 0),t([o({range:[1,64],precision:0}),e("design:type",Number)],DecalUnlitShader.prototype,"atlasTile",void 0);/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/shader/builtin/index.d.ts

@@ -1,4 +1,4 @@
-import { ShaderType } from '../shader.js';
+import type { ShaderType } from '../shader.js';
 export * from './standard-shader.js';
 export * from './lambert-shader.js';
 export * from './unlit-shader.js';

package/dist/shader/decal-shader.d.ts

@@ -1,5 +1,6 @@
-import { Material } from "three";
-import { NodeShaderOutput, Shader } from "./shader.js";
+import type { Material } from "three";
+import type { NodeShaderOutput } from "./shader.js";
+import { Shader } from "./shader.js";
 export declare abstract class DecalNodeShader extends Shader {
     build(): Material;
     abstract output(): NodeShaderOutput;

package/dist/shader/graph/compiler.d.ts

@@ -1,4 +1,4 @@
-import { Material, Side } from 'three';
+import type { Material, Side } from 'three';
 import { FloatNode, NodeShaderMaterial, Vec2Node, Vec3Node } from '../../shader-nodes/index.js';
 import type { NodeShaderOutput } from '../shader.js';
 import type { ShaderGraphDocument, ShaderGraphMaterialSide, ShaderGraphNode, ShaderGraphValueType } from './model.js';

package/dist/shader/parameter.d.ts

@@ -1,12 +1,12 @@
 import 'reflect-metadata';
-import { AbstractType, Type } from '../utils/type.js';
-import { BaseActor } from '../gameplay/actors/actor.js';
-import { Color, Euler, Material, Object3D, Texture, Vector2, Vector3, Vector4, AnimationClip } from 'three';
-import { BooleanNode, FloatNode, RgbNode, Sampler2DNode, Vec2Node, Vec3Node, Vec4Node } from '../shader-nodes/index.js';
-import { VisualEffect } from '../effects/vfx/vfx-param.js';
-import { Prefab, PrefabOf } from '../scene/objects/prefab.js';
-import { DataAssetRef } from '../scene/objects/data-asset.js';
-import { Curve2 } from '../utils/curve.js';
+import type { AbstractType, Type } from '../utils/type.js';
+import type { BaseActor } from '../gameplay/actors/actor.js';
+import type { Color, Euler, Material, Object3D, Texture, Vector2, Vector3, Vector4, AnimationClip } from 'three';
+import type { BooleanNode, FloatNode, RgbNode, Sampler2DNode, Vec2Node, Vec3Node, Vec4Node } from '../shader-nodes/index.js';
+import type { VisualEffect } from '../effects/vfx/vfx-param.js';
+import type { Prefab, PrefabOf } from '../scene/objects/prefab.js';
+import type { DataAssetRef } from '../scene/objects/data-asset.js';
+import type { Curve2 } from '../utils/curve.js';
 import type { ColorLayer, MaskLayer } from './color-layer.js';
 import type { Sequence } from '../effects/sequence/sequence-data.js';
 export type KnownParameterType = Type<FloatNode | Number | Texture | Sampler2DNode | Boolean | BooleanNode | Vector2 | Vec2Node | Vector3 | Vec3Node | Vector4 | Vec4Node | Color | RgbNode | String | BaseActor | Euler | Object3D | Material | AnimationClip | VisualEffect | Sequence | Prefab | PrefabOf<BaseActor> | DataAssetRef | Curve2 | ColorLayer | MaskLayer>;

package/dist/shader/post-process-shader.d.ts

@@ -1,5 +1,6 @@
 import { ShaderMaterial } from 'three';
-import { FloatNode, NodeShaderMaterial, Vec2Node, Vec3Node, Vec4Node } from '../shader-nodes/index.js';
+import type { FloatNode, Vec2Node, Vec3Node, Vec4Node } from '../shader-nodes/index.js';
+import { NodeShaderMaterial } from '../shader-nodes/index.js';
 export type PostProcessShaderOutput = Vec4Node | Vec3Node | Vec2Node | FloatNode;
 export interface PostProcessMaterialBuilder {
     build(): ShaderMaterial;

package/dist/shader/shader.d.ts

@@ -1,8 +1,9 @@
-import { ActorComponent } from '../gameplay/actors/component.js';
-import { BaseActor } from '../gameplay/actors/actor.js';
-import { Material } from 'three';
-import { Mat4Node, BooleanNode, Vec4Node, Vec3Node, FloatNode, Vec2Node } from '../shader-nodes/index.js';
-import { Type } from '../utils/type.js';
+import type { ActorComponent } from '../gameplay/actors/component.js';
+import type { BaseActor } from '../gameplay/actors/actor.js';
+import type { Material } from 'three';
+import type { Mat4Node, Vec4Node, Vec3Node, FloatNode, Vec2Node } from '../shader-nodes/index.js';
+import { BooleanNode } from '../shader-nodes/index.js';
+import type { Type } from '../utils/type.js';
 export * from './parameter.js';
 export declare abstract class Shader {
     alphaTest: number;

package/dist/shader/trail-shader.d.ts

@@ -1,5 +1,6 @@
-import { Material } from "three";
-import { NodeShaderOutput, Shader } from "./shader.js";
+import type { Material } from "three";
+import type { NodeShaderOutput } from "./shader.js";
+import { Shader } from "./shader.js";
 export declare abstract class TrailNodeShader extends Shader {
     build(): Material;
     abstract output(): NodeShaderOutput;

package/dist/shader/trail-shader.js

@@ -1,4 +1,4 @@
-import{Shader as r}from"./shader.js";import{NodeShaderMaterial as e}from"three-shader-graph";import{Trail as o}from"../effects/vfx/trail-renderer";export class TrailNodeShader extends r{build(){const r=this.output(),{position:t}=o.getTrailShaderNodes(!1),a=new e({position:t,color:r.color});return o.applyTrailShaderParameters(a),a}}/*
+import{Shader as r}from"./shader.js";import{NodeShaderMaterial as e}from"three-shader-graph";import{Trail as o}from"../effects/vfx/trail-renderer.js";export class TrailNodeShader extends r{build(){const r=this.output(),{position:t}=o.getTrailShaderNodes(!1),a=new e({position:t,color:r.color});return o.applyTrailShaderParameters(a),a}}/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/shader/uv-nodes.d.ts

@@ -1,4 +1,4 @@
-import { Texture } from 'three';
-import { Vec2Node } from 'three-shader-graph';
+import type { Texture } from 'three';
+import type { Vec2Node } from 'three-shader-graph';
 export declare function applyUvTiling(uv: Vec2Node, texture: Texture): Vec2Node;
 //# sourceMappingURL=uv-nodes.d.ts.map

package/dist/shader-nodes/bulge.d.ts

@@ -1,4 +1,4 @@
-import { FloatNode, Vec2Node } from "three-shader-graph";
+import type { FloatNode, Vec2Node } from "three-shader-graph";
 /**
  * Create a distortion such that the center is has a smaller is expanded
  */

package/dist/shader-nodes/curve-sample.d.ts

@@ -1,5 +1,5 @@
-import { FloatNode, Sampler2DNode } from "three-shader-graph";
-import { Curve2 } from "../utils/curve";
+import type { FloatNode, Sampler2DNode } from "three-shader-graph";
+import type { Curve2 } from "../utils/curve.js";
 export declare function sampleCurve(curve: Curve2, t: FloatNode): FloatNode;
 export declare function sampleNamedEasingCurve(name: unknown, t: FloatNode): FloatNode | undefined;
 export declare function curveSampler(curve: Curve2, resolution?: number): CurveSampler;

package/dist/shader-nodes/depth.d.ts

@@ -1,6 +1,6 @@
-import { WebGLRenderer } from "three";
-import { FloatNode, Vec2Node, Vec3Node } from "three-shader-graph";
-import type { Compiler } from "three-shader-graph";
+import type { WebGLRenderer } from "three";
+import { FloatNode, Vec2Node } from "three-shader-graph";
+import type { Compiler, Vec3Node } from "three-shader-graph";
 export declare function supportsDepthTextureExtension(renderer: WebGLRenderer): boolean;
 export declare const depthUniformName = "hology_depth_map";
 export declare const resolutionUniformName = "hology_resolution";

package/dist/shader-nodes/dither.d.ts

@@ -1,4 +1,4 @@
-import { RgbNode, Vec3Node } from "three-shader-graph";
+import type { RgbNode, Vec3Node } from "three-shader-graph";
 /**
  * Remove banding of colors. Apply after calculating lighting.
  * @param color

package/dist/shader-nodes/effects.d.ts

@@ -1,4 +1,4 @@
-import { FloatNode } from "three-shader-graph";
+import type { FloatNode } from "three-shader-graph";
 export declare function fresnelEffect(power?: number | FloatNode): FloatNode;
 /**
  * Gives a factor for how shallow the depth is where 1 is the most shallow.

package/dist/shader-nodes/glsl-node.d.ts

@@ -1,4 +1,4 @@
-import { FloatNode, BooleanNode, IntNode, Vec2Node, Vec3Node, Vec4Node, Mat2Node, Mat3Node, Mat4Node, RgbNode, RgbaNode, Sampler2DNode } from "../shader-nodes/index.js";
+import type { FloatNode, BooleanNode, IntNode, Vec2Node, Vec3Node, Vec4Node, Mat2Node, Mat3Node, Mat4Node, RgbNode, RgbaNode, Sampler2DNode } from "../shader-nodes/index.js";
 type AbstractType<T> = abstract new (...args: unknown[]) => T;
 type ShaderNode = FloatNode | BooleanNode | IntNode | Vec2Node | Vec3Node | Vec4Node | Mat2Node | Mat3Node | Mat4Node | RgbNode | RgbaNode | Sampler2DNode;
 /**

package/dist/shader-nodes/gradient-sample.d.ts

@@ -1,5 +1,5 @@
 import { Color } from 'three';
-import { FloatNode, RgbaNode, Sampler2DNode } from 'three-shader-graph';
+import type { FloatNode, RgbaNode, Sampler2DNode } from 'three-shader-graph';
 export interface ColorGradientStop {
     position: number;
     color: string | number | Color | number[];

package/dist/shader-nodes/landscape.d.ts

@@ -1,4 +1,4 @@
-import { FloatNode } from 'three-shader-graph';
+import type { FloatNode } from 'three-shader-graph';
 /**
  * Get coordinates in world space which can be much better for texturing landscapes than using UV
  */

package/dist/shader-nodes/layers.d.ts

@@ -1,4 +1,4 @@
-import { RgbNode, RgbaNode, FloatNode, Vec4Node, Vec3Node, Vec2Node } from "three-shader-graph";
+import type { RgbNode, RgbaNode, FloatNode, Vec4Node, Vec3Node, Vec2Node } from "three-shader-graph";
 export declare enum LayerMixMode {
     hard = 0,
     soft = 1

package/dist/shader-nodes/material-flags.d.ts

@@ -1,5 +1,5 @@
 import { BooleanNode } from 'three-shader-graph';
-import { Compiler } from 'three-shader-graph';
+import type { Compiler } from 'three-shader-graph';
 export declare const MATERIAL_FLAG_ALPHA_TEST = 1;
 export declare const MATERIAL_FLAG_RECEIVE_DECALS = 2;
 declare class SampledSurfaceRejectsDecalsNode extends BooleanNode {

package/dist/shader-nodes/particle.d.ts

@@ -1,5 +1,5 @@
 import { FloatNode, Vec3Node } from 'three-shader-graph';
-import { Compiler } from 'three-shader-graph';
+import type { Compiler } from 'three-shader-graph';
 export declare const particleEnergyUniformName = "hology_particle_energy";
 export declare const particleTimeUniformName = "hology_particle_time";
 export declare const particleVelcoityUniformName = "hology_particle_velocity";

package/dist/shader-nodes/pom.d.ts

@@ -1,4 +1,5 @@
-import { FloatNode, Sampler2DNode, Vec2Node, Vec3Node, Vec4Node } from "three-shader-graph";
+import type { FloatNode, Sampler2DNode, Vec3Node, Vec4Node } from "three-shader-graph";
+import { Vec2Node } from "three-shader-graph";
 /**
  * Computes tangent vector using normal, position and uv.
  * Equivalent to:

package/dist/shader-nodes/pom.js

@@ -1,4 +1,4 @@
-import{abs as e,attributes as t,cross as n,dFdx as r,dFdy as a,float as i,normalize as l,select as s,transformed as p,UniformSampler2dArraySlice as f,uniforms as $,varying as o,Vec2Node as v,vec3 as u,vec4 as m}from"three-shader-graph";import{isWgslCompiler as h,isWgslFragmentCompiler as d}from"three-shader-graph";import{glslFunction as c}from"./glsl-node";export function computeTangent(e,t,i){const s=r(t),p=a(t),f=r(i),$=a(i),o=n(p,e),v=n(e,s),u=o.multiplyScalar(f.x).add(v.multiplyScalar($.x));return m(l(u),1)}export function fallbackTangent(t){const r=e(t.y),a=s(r.lt(i(.999)),u(0,1,0),u(1,0,0));return l(n(a,t))}const g=t.normal,S=o(l($.normalMatrix.multiplyVec(g))),x=o(p.mvPosition.xyz.multiplyScalar(-1));export function parallaxOcclusionMapping(e,t,n,r=8,a=24){return new y(e,t,n,r,a)}class y extends v{constructor(e,t,n,r,a){super(),this.uv=e,this.heightMap=t,this.heightScale=n,this.minLayers=r,this.maxLayers=a}compile(e){if(!h(e))return{out:e.get(this.compileGlsl())};if(!d(e))throw new Error("Parallax occlusion mapping requires fragment-stage derivatives in WGSL.");const t=`pom_${e.variable()}`,n=e.get(this.uv),r=e.get(this.heightMap),a=e.get(this.heightScale),l=e.get(S),s=e.get(x),p=e.get(i(this.minLayers)),f=e.get(i(this.maxLayers)),$=C(this.heightMap)?e.get(L(this.heightMap)):null;return{chunk:`\n        let ${t}Uv = ${n};\n        let ${t}Normal = normalize(${l});\n        let ${t}ViewPosition = ${s};\n        let ${t}ViewDirection = normalize(${t}ViewPosition);\n        let ${t}Dp1 = dpdx(-${t}ViewPosition);\n        // WGSL fragment coordinates have the opposite Y orientation from GLSL.\n        // Negate both Y derivatives so the reconstructed cotangent frame keeps\n        // the same handedness as the GLSL implementation.\n        let ${t}Dp2 = -dpdy(-${t}ViewPosition);\n        let ${t}Duv1 = dpdx(${t}Uv);\n        let ${t}Duv2 = -dpdy(${t}Uv);\n        let ${t}Dp2Perp = cross(${t}Dp2, ${t}Normal);\n        let ${t}Dp1Perp = cross(${t}Normal, ${t}Dp1);\n        let ${t}T = ${t}Dp2Perp * ${t}Duv1.x + ${t}Dp1Perp * ${t}Duv2.x;\n        let ${t}B = ${t}Dp2Perp * ${t}Duv1.y + ${t}Dp1Perp * ${t}Duv2.y;\n        let ${t}InvMax = inverseSqrt(max(dot(${t}T, ${t}T), dot(${t}B, ${t}B)));\n        let ${t}Tbn = mat3x3<f32>(\n          ${t}T * ${t}InvMax,\n          ${t}B * ${t}InvMax,\n          ${t}Normal\n        );\n        let ${t}Vv = -(transpose(${t}Tbn) * ${t}ViewDirection);\n        let ${t}SafeVvZ = select(\n          ${t}Vv.z,\n          select(-0.0001, 0.0001, ${t}Vv.z >= 0.0),\n          abs(${t}Vv.z) < 0.0001\n        );\n        let ${t}ParallaxLimit = (-length(${t}Vv.xy) / ${t}SafeVvZ) * ${a};\n        let ${t}OffsetDirection = normalize(${t}Vv.xy);\n        let ${t}MaxOffset = ${t}OffsetDirection * ${t}ParallaxLimit;\n        let ${t}NumSamples = max(\n          1.0,\n          mix(${f}, ${p}, dot(-${t}ViewDirection, ${t}Normal))\n        );\n        let ${t}StepSize = 1.0 / ${t}NumSamples;\n        var ${t}CurrentRayHeight = 1.0;\n        var ${t}CurrentOffset = vec2<f32>(0.0);\n        var ${t}LastOffset = vec2<f32>(0.0);\n        var ${t}LastSampledHeight = 1.0;\n        var ${t}CurrentSampledHeight = 1.0;\n        for (var ${t}SampleIndex: i32 = 0; ${t}SampleIndex < 24; ${t}SampleIndex = ${t}SampleIndex + 1) {\n          if (f32(${t}SampleIndex) > ${t}NumSamples) {\n            break;\n          }\n          ${t}CurrentSampledHeight = ${null==$?`textureSampleLevel(${r}Texture, ${r}Sampler, ${t}Uv + ${t}CurrentOffset, 0.0).r`:`textureSampleLevel(${r}Texture, ${r}Sampler, ${t}Uv + ${t}CurrentOffset, i32(${$}), 0.0).r`};\n          if (${t}CurrentSampledHeight > ${t}CurrentRayHeight) {\n            let ${t}Delta1 = ${t}CurrentSampledHeight - ${t}CurrentRayHeight;\n            let ${t}Delta2 = (${t}CurrentRayHeight + ${t}StepSize) - ${t}LastSampledHeight;\n            let ${t}Ratio = ${t}Delta1 / (${t}Delta1 + ${t}Delta2);\n            ${t}CurrentOffset = ${t}Ratio * ${t}LastOffset + (1.0 - ${t}Ratio) * ${t}CurrentOffset;\n            break;\n          }\n          ${t}CurrentRayHeight = ${t}CurrentRayHeight - ${t}StepSize;\n          ${t}LastOffset = ${t}CurrentOffset;\n          ${t}CurrentOffset = ${t}CurrentOffset + ${t}StepSize * ${t}MaxOffset;\n          ${t}LastSampledHeight = ${t}CurrentSampledHeight;\n        }\n        let ${t}UvWithOffset = ${t}Uv + ${t}CurrentOffset;\n      `,out:`${t}UvWithOffset`}}compileGlsl(){const e=C(this.heightMap)?L(this.heightMap):null,t=null==e?"texture2D(heightMap, uv + vCurrOffset).r":"texture(heightMap, vec3(uv + vCurrOffset, heightMapLayer)).r",n={uv:this.uv,heightScale:this.heightScale,heightMap:this.heightMap,minLayers:i(this.minLayers),maxLayers:i(this.maxLayers),vN:S,vViewPosition:x,...null==e?{}:{heightMapLayer:e}};return c(v,n,`\n        vec3 N = normalize(vN);\n        vec3 viewDir = normalize(vViewPosition);\n        vec3 dp1 = dFdx(-vViewPosition);\n        vec3 dp2 = dFdy(-vViewPosition);\n        vec2 duv1 = dFdx(uv);\n        vec2 duv2 = dFdy(uv);\n        vec3 dp2perp = cross(dp2, N);\n        vec3 dp1perp = cross(N, dp1);\n        vec3 T = dp2perp * duv1.x + dp1perp * duv2.x;\n        vec3 B = dp2perp * duv1.y + dp1perp * duv2.y;\n        float invmax = inversesqrt(max(dot(T, T), dot(B, B)));\n        mat3 tbn = mat3(T * invmax, B * invmax, N);\n        vec3 vv = -viewDir * tbn;\n        float parallaxLimit = -length(vv.xy) / vv.z;\n        parallaxLimit *= heightScale;\n        vec2 vOffsetDir = normalize(vv.xy);\n        vec2 vMaxOffset = vOffsetDir * parallaxLimit;\n        float nNumSamples = mix(float(maxLayers), float(minLayers), dot(-viewDir, N));\n        float fStepSize = 1.0 / nNumSamples;\n        float fCurrRayHeight = 1.0;\n        vec2 vCurrOffset = vec2(0.0);\n        vec2 vLastOffset = vec2(0.0);\n        float fLastSampledHeight = 1.0;\n        float fCurrSampledHeight = 1.0;\n        for (int nCurrSample = 0; nCurrSample < 24; nCurrSample++) {\n          if (float(nCurrSample) > nNumSamples) break;\n          fCurrSampledHeight = ${t};\n          if (fCurrSampledHeight > fCurrRayHeight) {\n            float delta1 = fCurrSampledHeight - fCurrRayHeight;\n            float delta2 = (fCurrRayHeight + fStepSize) - fLastSampledHeight;\n            float ratio = delta1 / (delta1 + delta2);\n            vCurrOffset = ratio * vLastOffset + (1.0 - ratio) * vCurrOffset;\n            break;\n          } else {\n            fCurrRayHeight -= fStepSize;\n            vLastOffset = vCurrOffset;\n            vCurrOffset += fStepSize * vMaxOffset;\n            fLastSampledHeight = fCurrSampledHeight;\n          }\n        }\n        return uv + vCurrOffset;\n      `)}}function C(e){return e instanceof f||"sampler2DArray"===e.constructor.typeName}function L(e){return e.index??i(0)}/*
+import{abs as e,attributes as t,cross as n,dFdx as r,dFdy as a,float as i,normalize as l,select as s,transformed as p,UniformSampler2dArraySlice as f,uniforms as $,varying as o,Vec2Node as v,vec3 as u,vec4 as m}from"three-shader-graph";import{isWgslCompiler as h,isWgslFragmentCompiler as d}from"three-shader-graph";import{glslFunction as c}from"./glsl-node.js";export function computeTangent(e,t,i){const s=r(t),p=a(t),f=r(i),$=a(i),o=n(p,e),v=n(e,s),u=o.multiplyScalar(f.x).add(v.multiplyScalar($.x));return m(l(u),1)}export function fallbackTangent(t){const r=e(t.y),a=s(r.lt(i(.999)),u(0,1,0),u(1,0,0));return l(n(a,t))}const g=t.normal,S=o(l($.normalMatrix.multiplyVec(g))),x=o(p.mvPosition.xyz.multiplyScalar(-1));export function parallaxOcclusionMapping(e,t,n,r=8,a=24){return new y(e,t,n,r,a)}class y extends v{constructor(e,t,n,r,a){super(),this.uv=e,this.heightMap=t,this.heightScale=n,this.minLayers=r,this.maxLayers=a}compile(e){if(!h(e))return{out:e.get(this.compileGlsl())};if(!d(e))throw new Error("Parallax occlusion mapping requires fragment-stage derivatives in WGSL.");const t=`pom_${e.variable()}`,n=e.get(this.uv),r=e.get(this.heightMap),a=e.get(this.heightScale),l=e.get(S),s=e.get(x),p=e.get(i(this.minLayers)),f=e.get(i(this.maxLayers)),$=C(this.heightMap)?e.get(L(this.heightMap)):null;return{chunk:`\n        let ${t}Uv = ${n};\n        let ${t}Normal = normalize(${l});\n        let ${t}ViewPosition = ${s};\n        let ${t}ViewDirection = normalize(${t}ViewPosition);\n        let ${t}Dp1 = dpdx(-${t}ViewPosition);\n        // WGSL fragment coordinates have the opposite Y orientation from GLSL.\n        // Negate both Y derivatives so the reconstructed cotangent frame keeps\n        // the same handedness as the GLSL implementation.\n        let ${t}Dp2 = -dpdy(-${t}ViewPosition);\n        let ${t}Duv1 = dpdx(${t}Uv);\n        let ${t}Duv2 = -dpdy(${t}Uv);\n        let ${t}Dp2Perp = cross(${t}Dp2, ${t}Normal);\n        let ${t}Dp1Perp = cross(${t}Normal, ${t}Dp1);\n        let ${t}T = ${t}Dp2Perp * ${t}Duv1.x + ${t}Dp1Perp * ${t}Duv2.x;\n        let ${t}B = ${t}Dp2Perp * ${t}Duv1.y + ${t}Dp1Perp * ${t}Duv2.y;\n        let ${t}InvMax = inverseSqrt(max(dot(${t}T, ${t}T), dot(${t}B, ${t}B)));\n        let ${t}Tbn = mat3x3<f32>(\n          ${t}T * ${t}InvMax,\n          ${t}B * ${t}InvMax,\n          ${t}Normal\n        );\n        let ${t}Vv = -(transpose(${t}Tbn) * ${t}ViewDirection);\n        let ${t}SafeVvZ = select(\n          ${t}Vv.z,\n          select(-0.0001, 0.0001, ${t}Vv.z >= 0.0),\n          abs(${t}Vv.z) < 0.0001\n        );\n        let ${t}ParallaxLimit = (-length(${t}Vv.xy) / ${t}SafeVvZ) * ${a};\n        let ${t}OffsetDirection = normalize(${t}Vv.xy);\n        let ${t}MaxOffset = ${t}OffsetDirection * ${t}ParallaxLimit;\n        let ${t}NumSamples = max(\n          1.0,\n          mix(${f}, ${p}, dot(-${t}ViewDirection, ${t}Normal))\n        );\n        let ${t}StepSize = 1.0 / ${t}NumSamples;\n        var ${t}CurrentRayHeight = 1.0;\n        var ${t}CurrentOffset = vec2<f32>(0.0);\n        var ${t}LastOffset = vec2<f32>(0.0);\n        var ${t}LastSampledHeight = 1.0;\n        var ${t}CurrentSampledHeight = 1.0;\n        for (var ${t}SampleIndex: i32 = 0; ${t}SampleIndex < 24; ${t}SampleIndex = ${t}SampleIndex + 1) {\n          if (f32(${t}SampleIndex) > ${t}NumSamples) {\n            break;\n          }\n          ${t}CurrentSampledHeight = ${null==$?`textureSampleLevel(${r}Texture, ${r}Sampler, ${t}Uv + ${t}CurrentOffset, 0.0).r`:`textureSampleLevel(${r}Texture, ${r}Sampler, ${t}Uv + ${t}CurrentOffset, i32(${$}), 0.0).r`};\n          if (${t}CurrentSampledHeight > ${t}CurrentRayHeight) {\n            let ${t}Delta1 = ${t}CurrentSampledHeight - ${t}CurrentRayHeight;\n            let ${t}Delta2 = (${t}CurrentRayHeight + ${t}StepSize) - ${t}LastSampledHeight;\n            let ${t}Ratio = ${t}Delta1 / (${t}Delta1 + ${t}Delta2);\n            ${t}CurrentOffset = ${t}Ratio * ${t}LastOffset + (1.0 - ${t}Ratio) * ${t}CurrentOffset;\n            break;\n          }\n          ${t}CurrentRayHeight = ${t}CurrentRayHeight - ${t}StepSize;\n          ${t}LastOffset = ${t}CurrentOffset;\n          ${t}CurrentOffset = ${t}CurrentOffset + ${t}StepSize * ${t}MaxOffset;\n          ${t}LastSampledHeight = ${t}CurrentSampledHeight;\n        }\n        let ${t}UvWithOffset = ${t}Uv + ${t}CurrentOffset;\n      `,out:`${t}UvWithOffset`}}compileGlsl(){const e=C(this.heightMap)?L(this.heightMap):null,t=null==e?"texture2D(heightMap, uv + vCurrOffset).r":"texture(heightMap, vec3(uv + vCurrOffset, heightMapLayer)).r",n={uv:this.uv,heightScale:this.heightScale,heightMap:this.heightMap,minLayers:i(this.minLayers),maxLayers:i(this.maxLayers),vN:S,vViewPosition:x,...null==e?{}:{heightMapLayer:e}};return c(v,n,`\n        vec3 N = normalize(vN);\n        vec3 viewDir = normalize(vViewPosition);\n        vec3 dp1 = dFdx(-vViewPosition);\n        vec3 dp2 = dFdy(-vViewPosition);\n        vec2 duv1 = dFdx(uv);\n        vec2 duv2 = dFdy(uv);\n        vec3 dp2perp = cross(dp2, N);\n        vec3 dp1perp = cross(N, dp1);\n        vec3 T = dp2perp * duv1.x + dp1perp * duv2.x;\n        vec3 B = dp2perp * duv1.y + dp1perp * duv2.y;\n        float invmax = inversesqrt(max(dot(T, T), dot(B, B)));\n        mat3 tbn = mat3(T * invmax, B * invmax, N);\n        vec3 vv = -viewDir * tbn;\n        float parallaxLimit = -length(vv.xy) / vv.z;\n        parallaxLimit *= heightScale;\n        vec2 vOffsetDir = normalize(vv.xy);\n        vec2 vMaxOffset = vOffsetDir * parallaxLimit;\n        float nNumSamples = mix(float(maxLayers), float(minLayers), dot(-viewDir, N));\n        float fStepSize = 1.0 / nNumSamples;\n        float fCurrRayHeight = 1.0;\n        vec2 vCurrOffset = vec2(0.0);\n        vec2 vLastOffset = vec2(0.0);\n        float fLastSampledHeight = 1.0;\n        float fCurrSampledHeight = 1.0;\n        for (int nCurrSample = 0; nCurrSample < 24; nCurrSample++) {\n          if (float(nCurrSample) > nNumSamples) break;\n          fCurrSampledHeight = ${t};\n          if (fCurrSampledHeight > fCurrRayHeight) {\n            float delta1 = fCurrSampledHeight - fCurrRayHeight;\n            float delta2 = (fCurrRayHeight + fStepSize) - fLastSampledHeight;\n            float ratio = delta1 / (delta1 + delta2);\n            vCurrOffset = ratio * vLastOffset + (1.0 - ratio) * vCurrOffset;\n            break;\n          } else {\n            fCurrRayHeight -= fStepSize;\n            vLastOffset = vCurrOffset;\n            vCurrOffset += fStepSize * vMaxOffset;\n            fLastSampledHeight = fCurrSampledHeight;\n          }\n        }\n        return uv + vCurrOffset;\n      `)}}function C(e){return e instanceof f||"sampler2DArray"===e.constructor.typeName}function L(e){return e.index??i(0)}/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/shader-nodes/scene-sample.d.ts

@@ -1,4 +1,5 @@
-import { FloatNode, RgbaNode, Vec2Node, Vec3ExpressionNode } from 'three-shader-graph';
+import type { FloatNode, RgbaNode, Vec2Node } from 'three-shader-graph';
+import { Vec3ExpressionNode } from 'three-shader-graph';
 export declare const sceneMapUniformName = "hology_scene_map";
 export declare const sceneColorSampler: import("three-shader-graph").UniformSampler2d;
 export declare function sampleSceneColor(uv: Vec2Node): RgbaNode;

package/dist/shader-nodes/shapes.d.ts

@@ -1,4 +1,4 @@
-import { FloatNode, Vec2Node } from "three-shader-graph";
+import type { FloatNode, Vec2Node } from "three-shader-graph";
 export declare function rectangleFloat(uv: Vec2Node, width: FloatNode, height: FloatNode): FloatNode;
 export declare function roundedRectangleFloat(uv: Vec2Node, width: FloatNode, height: FloatNode, radius: FloatNode): FloatNode;
 //# sourceMappingURL=shapes.d.ts.map

package/dist/shader-nodes/texture-sequence.d.ts

@@ -1,4 +1,4 @@
-import { FloatNode, Sampler2DNode, Vec2Node } from "three-shader-graph";
+import type { FloatNode, Sampler2DNode, Vec2Node } from "three-shader-graph";
 export declare function flipbookUv(uv: Vec2Node, columns: number | FloatNode, rows: number | FloatNode, time: FloatNode, fps?: number | FloatNode, mode?: 'clamp' | 'loop'): Vec2Node;
 export declare function sampleFlipbook(sampler: Sampler2DNode, uv: Vec2Node, columns: number | FloatNode, rows: number | FloatNode, time: FloatNode, fps?: number | FloatNode, mode?: 'clamp' | 'loop'): import("three-shader-graph").RgbaNode;
 //# sourceMappingURL=texture-sequence.d.ts.map

package/dist/shader-nodes/time.d.ts

@@ -1,4 +1,4 @@
-import { FloatNode, Vec2Node } from 'three-shader-graph';
+import type { FloatNode, Vec2Node } from 'three-shader-graph';
 export declare const elapsedTimeUniformName = "hology_elapsed_time";
 export declare const timeUniforms: {
     elapsed: import("three-shader-graph").UniformFloatNode;

package/dist/shader-nodes/voronoi.d.ts

@@ -1,4 +1,4 @@
-import { FloatNode, Vec2Node } from "three-shader-graph";
+import type { FloatNode, Vec2Node } from "three-shader-graph";
 export declare function voronoi(uv: Vec2Node, angleOffset: FloatNode, cellDensity: FloatNode): {
     noise: FloatNode;
     cells: FloatNode;

package/dist/shader-nodes/wgsl-node.d.ts

@@ -1,4 +1,4 @@
-import { FloatNode, BooleanNode, IntNode, Vec2Node, Vec3Node, Vec4Node, Mat2Node, Mat3Node, Mat4Node, RgbNode, RgbaNode, Sampler2DNode } from "../shader-nodes/index.js";
+import type { FloatNode, BooleanNode, IntNode, Vec2Node, Vec3Node, Vec4Node, Mat2Node, Mat3Node, Mat4Node, RgbNode, RgbaNode, Sampler2DNode } from "../shader-nodes/index.js";
 type AbstractType<T> = abstract new (...args: unknown[]) => T;
 type ShaderNode = FloatNode | BooleanNode | IntNode | Vec2Node | Vec3Node | Vec4Node | Mat2Node | Mat3Node | Mat4Node | RgbNode | RgbaNode | Sampler2DNode;
 /**

package/dist/test/character-root-motion-constraint.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=character-root-motion-constraint.test.d.ts.map

package/dist/test/character-root-motion-constraint.test.js

@@ -0,0 +1,4 @@
+import{describe as o,expect as e,it as t}from"vitest";import{Vector3 as n}from"three";import{constrainRootMotionTargetApproach as r}from"../gameplay/actors/builtin/components/character/root-motion-constraint.js";o("constrainRootMotionTargetApproach",()=>{t("stops approaching at the minimum target distance",()=>{const o=new n(0,0,2);r(o,new n(0,0,0),new n(0,0,1.5),.9),e(o.x).toBeCloseTo(0),e(o.z).toBeCloseTo(.6)}),t("preserves lateral and vertical motion while clamping approach",()=>{const o=new n(.75,.4,1);r(o,new n(0,0,0),new n(0,0,1.2),.9),e(o.x).toBeCloseTo(.75),e(o.y).toBeCloseTo(.4),e(o.z).toBeCloseTo(.3)}),t("preserves retreating motion when already inside the minimum distance",()=>{const o=new n(0,0,-.5);r(o,new n(0,0,0),new n(0,0,.5),.9),e(o.z).toBeCloseTo(-.5)})});/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */

package/dist/test/node-material-webgpu-resolver.test.js

@@ -1,4 +1,4 @@
-import{describe as e,expect as t,it as o}from"vitest";import{DataTexture as a,Material as r,MeshStandardMaterial as n,RGBAFormat as s,SpriteMaterial as i,Vector4 as l}from"three";import{batchingUniformVec4 as d,float as h,NodeShaderMaterial as p,rgb as u,rgba as m,standardMaterial as c,translateX as f,uniformFloat as v,uniformVec4 as S,uniformSampler2d as g,varyingAttributes as w,vec3 as x,vec4 as y}from"three-shader-graph";import{createNodeMaterialSignature as C,markMaterialUniformValuesNeedUpdate as B,NodeMaterialWebGpuResolver as M,setMaterialUniformValuesAutoUpdate as T,withThreeDefaultVertexAttributeValues as W}from"../rendering/node-material-webgpu-resolver.js";import{LandscapeCompositeShader as L}from"../shader/builtin/landscape-composite-shader.js";import{DecalUnlitShader as b}from"../shader/builtin/decal-unlit-shader.js";import{getSpritePosition as _}from"../shader/sprite-shader.js";import{depthNormal as G,depthWorldPosition as A,fragmentLinearEyeDepth as U,sampleSceneDepth as V,screenUV as j}from"../shader-nodes/depth.js";import{sampleSceneColor as E}from"../shader-nodes/scene-sample.js";import{applyDithering as F}from"../shader-nodes/dither.js";import{parallaxOcclusionMapping as O}from"../shader-nodes/pom.js";import{elapsedTimeUniformName as q}from"../shader-nodes/time.js";import{Trail as I}from"../effects/vfx/trail-renderer.js";import{particleUniforms as D}from"../shader-nodes/particle.js";class P extends r{set uniformValuesNeedsUpdate(e){e&&this.uniformValuesAutoVersion++}constructor(e){super(),this.disposed=!1,this.uniformValuesAutoUpdate=!0,this.uniformValuesAutoVersion=0,this.vertexShader=e.vertexShader,this.fragmentShader=e.fragmentShader,this.depthVertexShader=e.depthVertexShader??null,this.depthFragmentShader=e.depthFragmentShader??null,this.pointShadowVertexShader=e.pointShadowVertexShader??null,this.pointShadowFragmentShader=e.pointShadowFragmentShader??null,this.uniforms=e.uniforms,this.sceneTextures=e.sceneTextures??{},this.graphTextures=e.graphTextures??{},this.vertexAttributes=e.vertexAttributes??[],this.transparent=e.transparent??!1,this.alphaTest=e.alphaTest??0,this.depthTest=e.depthTest??!0,this.depthWrite=e.depthWrite??!0,this.side=e.side??this.side}dispose(){this.disposed=!0,super.dispose()}}e("NodeMaterialWebGpuResolver",()=>{o("compiles decal surface rejection without undefined WGSL expressions",()=>{const e=(new b).build(),o=new M({WGSLShaderMaterial:P}).resolve(e);t(o?.fragmentShader).not.toContain("undefined"),t(o?.fragmentShader).toContain("hology_scene_mapTexture")}),o("recompiles an opaque variant when receiveDecals changes",()=>{const e=new p({color:m(16777215)});e.userData.receiveDecals=!0;const o=new M({WGSLShaderMaterial:P},e=>[m(16777215,!1===e.userData.receiveDecals?0:2)]),a=o.resolve(e,"opaque");e.userData.receiveDecals=!1,e.needsUpdate=!0;const r=o.resolve(e,"opaque");t(r).not.toBe(a),t(a.disposed).toBe(!0),t(a.fragmentShader).not.toBe(r.fragmentShader)}),o("maps Hology elapsed time to the renderer frame clock",()=>{const e=v(q),o=new p({color:m(x(e)),transform:f(e)}),a=new M({WGSLShaderMaterial:P}).resolve(o);t(a?.vertexShader).toContain("rendererElapsedTime()"),t(a?.fragmentShader).toContain("rendererElapsedTime()"),t(a?.depthVertexShader).toContain("rendererElapsedTime()"),t(a?.pointShadowVertexShader).toContain("rendererElapsedTime()"),t(a?.uniforms).not.toHaveProperty(q)}),o("compiles the native sprite billboard position without a GLSL fallback",()=>{const e=new p({color:m(16777215),position:_(v("rotation",.25),v("screenSpaceSize",0),v("lockYAxis",1))}),o=new M({WGSLShaderMaterial:P}).resolve(e);t(o).toBeInstanceOf(P),t(o?.vertexShader).toContain("cos("),t(o?.vertexShader).toContain("sin("),t(o?.vertexShader).toContain("materialUniforms.lockYAxis"),t(o?.vertexShader).not.toContain("customFunction_")}),o("uses the per-instance rotation attribute for instanced sprites",()=>{const e=new p({color:m(16777215),position:_(v("rotation",0),void 0,void 0,!0)}),o=new M({WGSLShaderMaterial:P}).resolve(e);t(o?.vertexAttributes).toEqual(t.arrayContaining([t.objectContaining({name:"rotation",format:"float32",stepMode:"instance"})])),t(o?.vertexShader).toContain("input.rotation"),t(o?.vertexShader).not.toContain("materialUniforms.rotation")}),o("uses per-instance particle opacity in WebGPU fragment shaders",()=>{const e=new p({color:m(u(16777215),D.opacity)}),o=new M({WGSLShaderMaterial:P}).resolve(e);t(o?.vertexAttributes).toEqual(t.arrayContaining([t.objectContaining({name:"particleData",format:"float32x3",stepMode:"instance"})])),t(o?.fragmentShader).toContain(".x"),t(o?.fragmentShader).toContain("> 0.5")}),o("maps THREE.SpriteMaterial to the native sprite shader",()=>{const e=new a(new Uint8Array([255,255,255,255]),1,1,s),o=new i({map:e,color:8429760,opacity:.6,rotation:.25,sizeAttenuation:!1,alphaTest:.2,transparent:!0}),r=new M({WGSLShaderMaterial:P}),n=r.resolve(o);t(n).toBeInstanceOf(P),t(n?.vertexShader).toContain("materialUniforms.rotation"),t(n?.vertexShader).toContain("materialUniforms.screenSpaceSize"),t(n?.fragmentShader).toContain("textureSample("),t(n?.alphaTest).toBe(.2),t(n?.transparent).toBe(!0),t(n?.uniforms.rotation.value).toBe(.25),t(n?.uniforms.screenSpaceSize.value).toBe(1),o.rotation=.75;const l=r.resolve(o);t(l).toBe(n),t(l?.uniforms.rotation.value).toBe(.75)}),o("memoizes node-material signatures for repeated lookups",()=>{const e=["version","vertexShader","fragmentShader","alphaTest","alphaToCoverage","blending","colorWrite","depthFunc","depthTest","depthWrite","polygonOffset","polygonOffsetFactor","polygonOffsetUnits","premultipliedAlpha","side","stencilWrite","transparent"],o=new Map([["version",1],["vertexShader","#vertex"],["fragmentShader","#fragment"],["alphaTest",0],["alphaToCoverage",!1],["blending",1],["colorWrite",!0],["depthFunc",3],["depthTest",!0],["depthWrite",!0],["polygonOffset",!1],["polygonOffsetFactor",0],["polygonOffsetUnits",0],["premultipliedAlpha",!1],["side",0],["stencilWrite",!1],["transparent",!1]]);let a=0;const r=new Proxy({},{get:(t,r)=>"string"==typeof r&&e.includes(r)?(a+=1,o.get(r)):Reflect.get(t,r)});C(r),C(r),t(a).toBe(e.length)}),o("adapts a NodeShaderMaterial without replacing its scene material",()=>{const e=v("intensity",.75),o=new p({color:c({color:u(5210052).multiplyScalar(e),roughness:.42,metalness:.18}),transparent:!0,alphaTest:.25}),a=new M({WGSLShaderMaterial:P}),r=a.resolve(o);t(r).toBeInstanceOf(P),t(r).not.toBe(o),t(r?.transparent).toBe(!0),t(r?.alphaTest).toBe(.25),t(r?.fragmentShader).toContain("rendererPointLightForLight"),t(o.isShaderMaterial).toBe(!0),e.value=.25,t(a.resolve(o)).toBe(r),t(r?.uniforms.intensity?.value).toBe(.25)}),o("syncs direct NodeShaderMaterial uniform mutations to the resolved material",()=>{const e=S("trailTint",new l(0,0,0,0)),o=v("hology_particle_energy",1),a=new p({color:e.multiplyScalar(o)}),r=new M({WGSLShaderMaterial:P});a.uniforms.trailTint.value=new l(1,.25,.5,.75),a.uniforms.hology_particle_energy.value=.4;const n=r.resolve(a);t(n?.uniforms.trailTint.value).toEqual(new l(1,.25,.5,.75)),t(n?.uniforms.hology_particle_energy.value).toBe(.4),a.uniforms.trailTint.value.set(.2,.4,.6,.8),a.uniforms.hology_particle_energy.value=.1,t(r.resolve(a)).toBe(n),t(n?.uniforms.trailTint.value).toEqual(new l(.2,.4,.6,.8)),t(n?.uniforms.hology_particle_energy.value).toBe(.1)}),o("only syncs explicitly invalidated uniforms when auto update is disabled",()=>{const e=v("intensity",.75),o=new p({color:m(x(e))});o.uniformValuesAutoUpdate=!1;const a=new M({WGSLShaderMaterial:P}),r=a.resolve(o),n=r.uniformValuesAutoVersion;e.value=.25,t(a.resolve(o)).toBe(r),t(r?.uniforms.intensity.value).toBe(.75),t(r?.uniformValuesAutoVersion).toBe(n),o.uniformValuesNeedsUpdate=!0,t(a.resolve(o)).toBe(r),t(r?.uniforms.intensity.value).toBe(.25),t(r?.uniformValuesAutoVersion).toBe(n+1)}),o("supports explicit invalidation for mapped Three.js materials",()=>{const e=new n({roughness:.8});T(e,!1);const o=new M({WGSLShaderMaterial:P}),a=o.resolve(e);e.roughness=.2,t(o.resolve(e)).toBe(a),t(a?.uniforms.roughness.value).toBe(.8),B(e),t(o.resolve(e)).toBe(a),t(a?.uniforms.roughness.value).toBe(.2)}),o("binds uniforms referenced only by an MRT material output",()=>{const e=v("roughness",.7),o=new p({color:m(5601177),alphaTest:.1});o.outputRoughness=e;const a=new M({WGSLShaderMaterial:P},e=>[e.outputColor,y(x(0,0,1),e.outputRoughness)]).resolve(o);t(a?.fragmentShader).toContain("materialUniforms.roughness"),t(a?.fragmentShader).not.toContain("graphColor"),t(a?.fragmentShader).toMatch(/if \(.+ < 0\.1\) \{ discard; \}/),t(a?.uniforms.roughness?.value).toBe(.7)}),o("compiles a landscape composite built from node material semantic outputs",()=>{const e=new M({WGSLShaderMaterial:P}),o=new p({color:c({color:u(5147450),roughness:.82,metalness:0})}),a=new p({color:c({color:u(7432286),roughness:.6,metalness:.05})}),r=new L;r.layers=[o,a];const n=e.resolve(r.build());t(n).toBeInstanceOf(P),t(n?.fragmentShader).toContain("rendererDirectionalLightForLight"),t(n?.vertexShader).toContain("@location(6) material: vec4<f32>"),t(n?.vertexShader).toContain("@location(8) hole: f32")}),o("allocates the trail's authored vertex attributes",()=>{const e=new M({WGSLShaderMaterial:P}).resolve(I.createBaseMaterial());t(e).toBeInstanceOf(P),t(e?.vertexAttributes).toEqual(t.arrayContaining([t.objectContaining({name:"nodeID",shaderLocation:6,format:"float32"}),t.objectContaining({name:"nodeCenter",shaderLocation:7,format:"float32x3"})]))}),o("uses Three's default value when a geometry has no uv1 attribute",()=>{const e=W([{name:"uv1",shaderLocation:6,format:"float32x2"},{name:"custom",shaderLocation:7,format:"float32"}]);t(e).toEqual(t.arrayContaining([t.objectContaining({name:"uv1",defaultValue:[0,0]}),t.objectContaining({name:"custom"})])),t(e[1]).not.toHaveProperty("defaultValue")}),o("compiles the foliage transform and named texture-uniform pattern",()=>{const e=new M({WGSLShaderMaterial:P}),o=new a(new Uint8Array([255,255,255,255]),1,1,s),r=new p({color:g("map").sample(w.uv),transform:f(v("windOffset",.25)),uniforms:{map:{value:o}},alphaTest:.5}),n=e.resolve(r);t(n).toBeInstanceOf(P),t(n?.vertexShader).toContain("rendererClipPosition(_ng_localPosition"),t(n?.depthVertexShader).toContain("materialUniforms.windOffset"),t(n?.depthFragmentShader).toContain("textureSample("),t(n?.depthFragmentShader).toContain("< 0.5) { discard;"),t(n?.pointShadowFragmentShader).toContain("distanceToLight")}),o("rebuilds cached materials when scene-local texture bindings change",()=>{const e=new M({WGSLShaderMaterial:P}),o=new a(new Uint8Array([255,255,255,255]),1,1,s),r=new a(new Uint8Array([32,64,128,255]),1,1,s),n=new p({color:g("map").sample(w.uv),uniforms:{map:{value:o}},alphaTest:.5}),i=e.resolve(n);n.uniforms.map.value=r;const l=e.resolve(n);t(l).not.toBe(i),t(i.disposed).toBe(!0),n.dispose();const d=e.resolve(n);t(d).not.toBe(l),t(l.disposed).toBe(!0)}),o("uses the renderer batch id without Three’s batchingIdTexture",()=>{const e=new M({WGSLShaderMaterial:P}),o=new a(new Uint8Array([255,96,24,255]),1,1,s),r=new p({color:m(d("vp0")),uniforms:{vp0:{value:o}}}),n=e.resolve(r);t(n).toBeInstanceOf(P),t(n?.vertexShader).toContain("rendererBatchingId(input.instanceIndex)")}),o("compiles depth nodes that use fragment-coordinate expressions",()=>{const e=new M({WGSLShaderMaterial:P}),o=new p({color:m(x(j.x,j.y,U))}),a=e.resolve(o);t(a).toBeInstanceOf(P),t(a?.fragmentShader).toContain("input.position.xy"),t(a?.fragmentShader).toContain("input.position.z"),t(a?.fragmentShader).toContain("rendererCamera.viewportAndTime.xy"),t(a?.fragmentShader).not.toContain("gl_FragCoord")}),o("maps scene color and depth nodes to renderer-owned textures",()=>{const e=new M({WGSLShaderMaterial:P}),o=new p({color:E(j).multiplyScalar(V(j))}),a=e.resolve(o);t(a.sceneTextures).toEqual({hology_scene_map:"sceneColor",hology_depth_map:"sceneDepth"}),t(a.graphTextures).toEqual({}),t(a.fragmentShader).toContain("hology_scene_mapTexture"),t(a.fragmentShader).toContain("hology_depth_mapTexture"),t(a.fragmentShader).toContain("vec4<f32>(textureSample(hology_depth_mapTexture")}),o("caches distinct material variants for opaque and late draw stages",()=>{const e=new M({WGSLShaderMaterial:P},(e,t)=>"opaque"===t?[m(x(1)),m(x(0))]:void 0),o=new p({color:m(x(1))}),a=e.resolve(o,"opaque"),r=e.resolve(o,"late");t(a).not.toBe(r),t(e.resolve(o,"opaque")).toBe(a),t(e.resolve(o,"late")).toBe(r),t(a?.fragmentShader).toContain("@location(1)"),t(r?.fragmentShader).not.toContain("@location(1)")}),o("reconstructs WebGPU depth positions with inverted NDC Y",()=>{const e=new M({WGSLShaderMaterial:P}),o=new p({color:m(A.add(G.multiplyScalar(0)))}),a=e.resolve(o);t(a.fragmentShader).toContain("vec2<f32>(2.0, -2.0)"),t(a.fragmentShader).toMatch(/-\(float_op_\d+\)/)}),o("emits dither and parallax nodes without GLSL custom functions",()=>{const e=new M({WGSLShaderMaterial:P}),o=new a(new Uint8Array([128,128,128,255]),1,1,s),r=O(w.uv,g("heightMap",o),h(.03)),n=new p({color:y(r.x,r.y,F(x(.2,.4,.8)).z,1)}),i=e.resolve(n);t(i).toBeInstanceOf(P),t(i?.fragmentShader).toContain("textureSampleLevel(heightMapTexture, heightMapSampler"),t(i?.fragmentShader).toMatch(/= -dpdy\(-pom_\d+ViewPosition\)/),t(i?.fragmentShader).toMatch(/= -dpdy\(pom_\d+Uv\)/),t(i?.fragmentShader).not.toContain("customFunction_"),t(i?.fragmentShader).not.toContain("gl_FragCoord")}),o("inherits, updates, and clears the WebGPU world environment",()=>{const e=new a(new Uint8Array([255,255,255,255]),1,1,s),o=new p({color:c({color:u(8421504),roughness:.5,metalness:.1})}),r=new M({WGSLShaderMaterial:P});r.setWorldEnvironment({texture:e,intensity:.75});const n=r.resolve(o);t(n.fragmentShader).toContain("envMapTexture"),t(n.uniforms.envMapIntensity?.value).toBe(.75),t(o.envMap).toBeUndefined(),r.setWorldEnvironment({texture:e,intensity:.25});const i=r.resolve(o);t(i).toBe(n),t(i.uniforms.envMapIntensity?.value).toBe(.25),r.setWorldEnvironment(null);const l=r.resolve(o);t(l).not.toBe(n),t(n.disposed).toBe(!0),t(l.fragmentShader).not.toContain("envMapTexture")}),o("keeps an authored material environment ahead of the world environment",()=>{const e=new a(new Uint8Array([255,255,255,255]),1,1,s),o=new a(new Uint8Array([64,96,128,255]),1,1,s),r=new p({color:c({color:u(8421504),roughness:.5,metalness:.1}),envMap:o}),n=new M({WGSLShaderMaterial:P});n.setWorldEnvironment({texture:e,intensity:.2}),n.resolve(r),t(r.uniforms.envMap.value).toBe(o),t(r.envMap).toBe(o)})});/*
+import{describe as e,expect as t,it as o}from"vitest";import{DataTexture as a,Material as r,MeshStandardMaterial as n,RGBAFormat as s,SpriteMaterial as i,Vector4 as l}from"three";import{batchingUniformVec4 as d,float as h,NodeShaderMaterial as p,rgb as u,rgba as m,standardMaterial as c,translateX as f,uniformFloat as v,uniformVec4 as S,uniformSampler2d as g,varyingAttributes as w,vec3 as x,vec4 as y}from"three-shader-graph";import{createNodeMaterialSignature as C,markMaterialUniformValuesNeedUpdate as B,NodeMaterialWebGpuResolver as M,setMaterialUniformValuesAutoUpdate as T,withThreeDefaultVertexAttributeValues as W}from"../rendering/node-material-webgpu-resolver.js";import{LandscapeCompositeShader as L}from"../shader/builtin/landscape-composite-shader.js";import{DecalUnlitShader as b}from"../shader/builtin/decal-unlit-shader.js";import{getSpritePosition as _}from"../shader/sprite-shader.js";import{depthNormal as G,depthWorldPosition as U,fragmentLinearEyeDepth as A,sampleSceneDepth as V,screenUV as j}from"../shader-nodes/depth.js";import{sampleSceneColor as E}from"../shader-nodes/scene-sample.js";import{applyDithering as F}from"../shader-nodes/dither.js";import{parallaxOcclusionMapping as O}from"../shader-nodes/pom.js";import{elapsedTimeUniformName as q}from"../shader-nodes/time.js";import{Trail as I}from"../effects/vfx/trail-renderer.js";import{particleUniforms as D}from"../shader-nodes/particle.js";class P extends r{set uniformValuesNeedsUpdate(e){e&&this.uniformValuesAutoVersion++}constructor(e){super(),this.disposed=!1,this.uniformValuesAutoUpdate=!0,this.uniformValuesAutoVersion=0,this.vertexShader=e.vertexShader,this.fragmentShader=e.fragmentShader,this.depthVertexShader=e.depthVertexShader??null,this.depthFragmentShader=e.depthFragmentShader??null,this.pointShadowVertexShader=e.pointShadowVertexShader??null,this.pointShadowFragmentShader=e.pointShadowFragmentShader??null,this.uniforms=e.uniforms,this.sceneTextures=e.sceneTextures??{},this.graphTextures=e.graphTextures??{},this.vertexAttributes=e.vertexAttributes??[],this.transparent=e.transparent??!1,this.alphaTest=e.alphaTest??0,this.depthTest=e.depthTest??!0,this.depthWrite=e.depthWrite??!0,this.side=e.side??this.side}dispose(){this.disposed=!0,super.dispose()}}e("NodeMaterialWebGpuResolver",()=>{o("compiles decal surface rejection without undefined WGSL expressions",()=>{const e=(new b).build(),o=new M({WGSLShaderMaterial:P}).resolve(e);t(o?.fragmentShader).not.toContain("undefined"),t(o?.fragmentShader).toContain("hology_scene_mapTexture")}),o("recompiles an opaque variant when receiveDecals changes",()=>{const e=new p({color:m(16777215)});e.userData.receiveDecals=!0;const o=new M({WGSLShaderMaterial:P},e=>[m(16777215,!1===e.userData.receiveDecals?0:2)]),a=o.resolve(e,"opaque");e.userData.receiveDecals=!1,e.needsUpdate=!0;const r=o.resolve(e,"opaque");t(r).not.toBe(a),t(a.disposed).toBe(!0),t(a.fragmentShader).not.toBe(r.fragmentShader)}),o("maps Hology elapsed time to the renderer frame clock",()=>{const e=v(q),o=new p({color:m(x(e)),transform:f(e)}),a=new M({WGSLShaderMaterial:P}).resolve(o);t(a?.vertexShader).toContain("rendererElapsedTime()"),t(a?.fragmentShader).toContain("rendererElapsedTime()"),t(a?.depthVertexShader).toContain("rendererElapsedTime()"),t(a?.pointShadowVertexShader).toContain("rendererElapsedTime()"),t(a?.uniforms).not.toHaveProperty(q)}),o("compiles the native sprite billboard position without a GLSL fallback",()=>{const e=new p({color:m(16777215),position:_(v("rotation",.25),v("screenSpaceSize",0),v("lockYAxis",1))}),o=new M({WGSLShaderMaterial:P}).resolve(e);t(o).toBeInstanceOf(P),t(o?.vertexShader).toContain("cos("),t(o?.vertexShader).toContain("sin("),t(o?.vertexShader).toContain("materialUniforms.lockYAxis"),t(o?.vertexShader).not.toContain("customFunction_")}),o("uses the per-instance rotation attribute for instanced sprites",()=>{const e=new p({color:m(16777215),position:_(v("rotation",0),void 0,void 0,!0)}),o=new M({WGSLShaderMaterial:P}).resolve(e);t(o?.vertexAttributes).toEqual(t.arrayContaining([t.objectContaining({name:"rotation",format:"float32",stepMode:"instance"})])),t(o?.vertexShader).toContain("input.rotation"),t(o?.vertexShader).not.toContain("materialUniforms.rotation")}),o("uses per-instance particle opacity in WebGPU fragment shaders",()=>{const e=new p({color:m(u(16777215),D.opacity)}),o=new M({WGSLShaderMaterial:P}).resolve(e);t(o?.vertexAttributes).toEqual(t.arrayContaining([t.objectContaining({name:"particleData",format:"float32x3",stepMode:"instance"})])),t(o?.fragmentShader).toContain(".x"),t(o?.fragmentShader).toContain("> 0.5")}),o("maps THREE.SpriteMaterial to the native sprite shader",()=>{const e=new a(new Uint8Array([255,255,255,255]),1,1,s),o=new i({map:e,color:8429760,opacity:.6,rotation:.25,sizeAttenuation:!1,alphaTest:.2,transparent:!0}),r=new M({WGSLShaderMaterial:P}),n=r.resolve(o);t(n).toBeInstanceOf(P),t(n?.vertexShader).toContain("materialUniforms.rotation"),t(n?.vertexShader).toContain("materialUniforms.screenSpaceSize"),t(n?.fragmentShader).toContain("textureSample("),t(n?.alphaTest).toBe(.2),t(n?.transparent).toBe(!0),t(n?.uniforms.rotation.value).toBe(.25),t(n?.uniforms.screenSpaceSize.value).toBe(1),o.rotation=.75;const l=r.resolve(o);t(l).toBe(n),t(l?.uniforms.rotation.value).toBe(.75)}),o("memoizes node-material signatures for repeated lookups",()=>{const e=["version","vertexShader","fragmentShader","alphaTest","alphaToCoverage","blending","colorWrite","depthFunc","depthTest","depthWrite","polygonOffset","polygonOffsetFactor","polygonOffsetUnits","premultipliedAlpha","side","stencilWrite","transparent"],o=new Map([["version",1],["vertexShader","#vertex"],["fragmentShader","#fragment"],["alphaTest",0],["alphaToCoverage",!1],["blending",1],["colorWrite",!0],["depthFunc",3],["depthTest",!0],["depthWrite",!0],["polygonOffset",!1],["polygonOffsetFactor",0],["polygonOffsetUnits",0],["premultipliedAlpha",!1],["side",0],["stencilWrite",!1],["transparent",!1]]);let a=0;const r=new Proxy({},{get:(t,r)=>"string"==typeof r&&e.includes(r)?(a+=1,o.get(r)):Reflect.get(t,r)});C(r),C(r),t(a).toBe(e.length)}),o("adapts a NodeShaderMaterial without replacing its scene material",()=>{const e=v("intensity",.75),o=new p({color:c({color:u(5210052).multiplyScalar(e),roughness:.42,metalness:.18}),transparent:!0,alphaTest:.25}),a=new M({WGSLShaderMaterial:P}),r=a.resolve(o);t(r).toBeInstanceOf(P),t(r).not.toBe(o),t(r?.transparent).toBe(!0),t(r?.alphaTest).toBe(.25),t(r?.fragmentShader).toContain("rendererPointLightForLight"),t(o.isShaderMaterial).toBe(!0),e.value=.25,t(a.resolve(o)).toBe(r),t(r?.uniforms.intensity?.value).toBe(.25)}),o("syncs direct NodeShaderMaterial uniform mutations to the resolved material",()=>{const e=S("trailTint",new l(0,0,0,0)),o=v("hology_particle_energy",1),a=new p({color:e.multiplyScalar(o)}),r=new M({WGSLShaderMaterial:P});a.uniforms.trailTint.value=new l(1,.25,.5,.75),a.uniforms.hology_particle_energy.value=.4;const n=r.resolve(a);t(n?.uniforms.trailTint.value).toEqual(new l(1,.25,.5,.75)),t(n?.uniforms.hology_particle_energy.value).toBe(.4),a.uniforms.trailTint.value.set(.2,.4,.6,.8),a.uniforms.hology_particle_energy.value=.1,t(r.resolve(a)).toBe(n),t(n?.uniforms.trailTint.value).toEqual(new l(.2,.4,.6,.8)),t(n?.uniforms.hology_particle_energy.value).toBe(.1)}),o("only syncs explicitly invalidated uniforms when auto update is disabled",()=>{const e=v("intensity",.75),o=new p({color:m(x(e))});o.uniformValuesAutoUpdate=!1;const a=new M({WGSLShaderMaterial:P}),r=a.resolve(o),n=r.uniformValuesAutoVersion;e.value=.25,t(a.resolve(o)).toBe(r),t(r?.uniforms.intensity.value).toBe(.75),t(r?.uniformValuesAutoVersion).toBe(n),o.uniformValuesNeedsUpdate=!0,t(a.resolve(o)).toBe(r),t(r?.uniforms.intensity.value).toBe(.25),t(r?.uniformValuesAutoVersion).toBe(n+1)}),o("supports explicit invalidation for mapped Three.js materials",()=>{const e=new n({roughness:.8});T(e,!1);const o=new M({WGSLShaderMaterial:P}),a=o.resolve(e);e.roughness=.2,t(o.resolve(e)).toBe(a),t(a?.uniforms.roughness.value).toBe(.8),B(e),t(o.resolve(e)).toBe(a),t(a?.uniforms.roughness.value).toBe(.2)}),o("binds uniforms referenced only by an MRT material output",()=>{const e=v("roughness",.7),o=new p({color:m(5601177),alphaTest:.1});o.outputRoughness=e;const a=new M({WGSLShaderMaterial:P},e=>[e.outputColor,y(x(0,0,1),e.outputRoughness)]).resolve(o);t(a?.fragmentShader).toContain("materialUniforms.roughness"),t(a?.fragmentShader).not.toContain("graphColor"),t(a?.fragmentShader).toMatch(/if \(.+ < 0\.1\) \{ discard; \}/),t(a?.uniforms.roughness?.value).toBe(.7)}),o("compiles a landscape composite built from node material semantic outputs",()=>{const e=new M({WGSLShaderMaterial:P}),o=new p({color:c({color:u(5147450),roughness:.82,metalness:0})}),a=new p({color:c({color:u(7432286),roughness:.6,metalness:.05})}),r=new L;r.layers=[o,a];const n=e.resolve(r.build());t(n).toBeInstanceOf(P),t(n?.fragmentShader).toContain("rendererDirectionalLightForLight"),t(n?.vertexShader).toContain("@location(6) material: vec4<f32>"),t(n?.vertexShader).toContain("@location(8) hole: f32")}),o("allocates the trail's authored vertex attributes",()=>{const e=new M({WGSLShaderMaterial:P}).resolve(I.createBaseMaterial());t(e).toBeInstanceOf(P),t(e?.vertexAttributes).toEqual(t.arrayContaining([t.objectContaining({name:"nodeID",shaderLocation:6,format:"float32"}),t.objectContaining({name:"nodeCenter",shaderLocation:7,format:"float32x3"})]))}),o("uses Three's default value when a geometry has no uv1 attribute",()=>{const e=W([{name:"uv1",shaderLocation:6,format:"float32x2"},{name:"custom",shaderLocation:7,format:"float32"}]);t(e).toEqual(t.arrayContaining([t.objectContaining({name:"uv1",defaultValue:[0,0]}),t.objectContaining({name:"custom"})])),t(e[1]).not.toHaveProperty("defaultValue")}),o("compiles the foliage transform and named texture-uniform pattern",()=>{const e=new M({WGSLShaderMaterial:P}),o=new a(new Uint8Array([255,255,255,255]),1,1,s),r=new p({color:g("map").sample(w.uv),transform:f(v("windOffset",.25)),uniforms:{map:{value:o}},alphaTest:.5}),n=e.resolve(r);t(n).toBeInstanceOf(P),t(n?.vertexShader).toContain("rendererClipPosition(_ng_localPosition"),t(n?.depthVertexShader).toContain("materialUniforms.windOffset"),t(n?.depthFragmentShader).toContain("textureSample("),t(n?.depthFragmentShader).toContain("< 0.5) { discard;"),t(n?.pointShadowFragmentShader).toContain("distanceToLight")}),o("rebuilds cached materials when scene-local texture bindings change",()=>{const e=new M({WGSLShaderMaterial:P}),o=new a(new Uint8Array([255,255,255,255]),1,1,s),r=new a(new Uint8Array([32,64,128,255]),1,1,s),n=new p({color:g("map").sample(w.uv),uniforms:{map:{value:o}},alphaTest:.5}),i=e.resolve(n);n.uniforms.map.value=r;const l=e.resolve(n);t(l).not.toBe(i),t(i.disposed).toBe(!0),n.dispose();const d=e.resolve(n);t(d).not.toBe(l),t(l.disposed).toBe(!0)}),o("uses the renderer batch id without Three’s batchingIdTexture",()=>{const e=new M({WGSLShaderMaterial:P}),o=new a(new Uint8Array([255,96,24,255]),1,1,s),r=new p({color:m(d("vp0")),uniforms:{vp0:{value:o}}}),n=e.resolve(r);t(n).toBeInstanceOf(P),t(n?.vertexShader).toContain("rendererBatchingId(input.instanceIndex)")}),o("compiles depth nodes that use fragment-coordinate expressions",()=>{const e=new M({WGSLShaderMaterial:P}),o=new p({color:m(x(j.x,j.y,A))}),a=e.resolve(o);t(a).toBeInstanceOf(P),t(a?.fragmentShader).toContain("input.position.xy"),t(a?.fragmentShader).toContain("input.position.z"),t(a?.fragmentShader).toContain("rendererViewportSize()"),t(a?.fragmentShader).not.toContain("gl_FragCoord")}),o("maps scene color and depth nodes to renderer-owned textures",()=>{const e=new M({WGSLShaderMaterial:P}),o=new p({color:E(j).multiplyScalar(V(j))}),a=e.resolve(o);t(a.sceneTextures).toEqual({hology_scene_map:"sceneColor",hology_depth_map:"sceneDepth"}),t(a.graphTextures).toEqual({}),t(a.fragmentShader).toContain("hology_scene_mapTexture"),t(a.fragmentShader).toContain("hology_depth_mapTexture"),t(a.fragmentShader).toContain("vec4<f32>(textureSample(hology_depth_mapTexture")}),o("caches distinct material variants for opaque and late draw stages",()=>{const e=new M({WGSLShaderMaterial:P},(e,t)=>"opaque"===t?[m(x(1)),m(x(0))]:void 0),o=new p({color:m(x(1))}),a=e.resolve(o,"opaque"),r=e.resolve(o,"late");t(a).not.toBe(r),t(e.resolve(o,"opaque")).toBe(a),t(e.resolve(o,"late")).toBe(r),t(a?.fragmentShader).toContain("@location(1)"),t(r?.fragmentShader).not.toContain("@location(1)")}),o("reconstructs WebGPU depth positions with inverted NDC Y",()=>{const e=new M({WGSLShaderMaterial:P}),o=new p({color:m(U.add(G.multiplyScalar(0)))}),a=e.resolve(o);t(a.fragmentShader).toContain("vec2<f32>(2.0, -2.0)"),t(a.fragmentShader).toMatch(/-\(float_op_\d+\)/)}),o("emits dither and parallax nodes without GLSL custom functions",()=>{const e=new M({WGSLShaderMaterial:P}),o=new a(new Uint8Array([128,128,128,255]),1,1,s),r=O(w.uv,g("heightMap",o),h(.03)),n=new p({color:y(r.x,r.y,F(x(.2,.4,.8)).z,1)}),i=e.resolve(n);t(i).toBeInstanceOf(P),t(i?.fragmentShader).toContain("textureSampleLevel(heightMapTexture, heightMapSampler"),t(i?.fragmentShader).toMatch(/= -dpdy\(-pom_\d+ViewPosition\)/),t(i?.fragmentShader).toMatch(/= -dpdy\(pom_\d+Uv\)/),t(i?.fragmentShader).not.toContain("customFunction_"),t(i?.fragmentShader).not.toContain("gl_FragCoord")}),o("inherits, updates, and clears the WebGPU world environment",()=>{const e=new a(new Uint8Array([255,255,255,255]),1,1,s),o=new p({color:c({color:u(8421504),roughness:.5,metalness:.1})}),r=new M({WGSLShaderMaterial:P});r.setWorldEnvironment({texture:e,intensity:.75});const n=r.resolve(o);t(n.fragmentShader).toContain("envMapTexture"),t(n.uniforms.envMapIntensity?.value).toBe(.75),t(o.envMap).toBeUndefined(),r.setWorldEnvironment({texture:e,intensity:.25});const i=r.resolve(o);t(i).toBe(n),t(i.uniforms.envMapIntensity?.value).toBe(.25),r.setWorldEnvironment(null);const l=r.resolve(o);t(l).not.toBe(n),t(n.disposed).toBe(!0),t(l.fragmentShader).not.toContain("envMapTexture")}),o("keeps an authored material environment ahead of the world environment",()=>{const e=new a(new Uint8Array([255,255,255,255]),1,1,s),o=new a(new Uint8Array([64,96,128,255]),1,1,s),r=new p({color:c({color:u(8421504),roughness:.5,metalness:.1}),envMap:o}),n=new M({WGSLShaderMaterial:P});n.setWorldEnvironment({texture:e,intensity:.2}),n.resolve(r),t(r.uniforms.envMap.value).toBe(o),t(r.envMap).toBe(o)})});/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/utils/materials.d.ts

@@ -1,3 +1,3 @@
-import * as THREE from 'three';
+import type * as THREE from 'three';
 export declare function iterateMaterials(material: THREE.Material | THREE.Material[]): Generator<THREE.Material, void, unknown>;
 //# sourceMappingURL=materials.d.ts.map

package/dist/utils/mesh.d.ts

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { Object3D } from 'three';
+import type { Object3D } from 'three';
 export declare class NoRaycastMesh extends THREE.Mesh {
     raycast(...args: any[]): void;
 }

package/dist/utils/obb-utils.d.ts

@@ -1,4 +1,5 @@
-import { BufferGeometry, Euler, Vector3 } from "three";
+import type { BufferGeometry } from "three";
+import { Euler, Vector3 } from "three";
 export interface OBBData {
     center: Vector3;
     size: Vector3;

package/dist/utils/three/cleanup.d.ts

@@ -1,4 +1,4 @@
-import { Material, Object3D } from "three";
+import type { Material, Object3D } from "three";
 export declare function disposeScene(scene: Object3D): void;
 export declare function disposeMaterial(material: Material): void;
 //# sourceMappingURL=cleanup.d.ts.map

package/dist/utils/three/depth-pass.d.ts

@@ -1,4 +1,4 @@
-import { Camera, MeshDepthMaterial, Scene, WebGLRenderTarget, WebGLRenderer } from "three";
+import type { Camera, MeshDepthMaterial, Scene, WebGLRenderTarget, WebGLRenderer } from "three";
 import { Pass } from "three-stdlib";
 declare class DepthPass extends Pass {
     private scene;

package/dist/utils/three/traverse.d.ts

@@ -1,4 +1,5 @@
-import { Mesh, Object3D, Vector3 } from 'three';
+import type { Object3D } from 'three';
+import { Mesh, Vector3 } from 'three';
 type ObjectPredicate<T> = (obj: T) => boolean;
 export declare function filterScene(scene: Object3D, predicate: ObjectPredicate<Object3D>): Object3D<import("three").Object3DEventMap, Event>[];
 export declare function findFirstVisibleObject(scene: Object3D, predicate: ObjectPredicate<Object3D>): Object3D;

package/dist/worker/index.js

@@ -1,4 +1,4 @@
-import{setupNavMeshWorker as r}from"../gameplay/ai/dynamic-tiled-navmesh.worker";let e;export function registerWorker(r){e=r}export function hasWorkerBuilder(){return null!=e}export function createWorker(){return e()}export function initWorker(){r()}/*
+import{setupNavMeshWorker as r}from"../gameplay/ai/dynamic-tiled-navmesh.worker.js";let e;export function registerWorker(r){e=r}export function hasWorkerBuilder(){return null!=e}export function createWorker(){return e()}export function initWorker(){r()}/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */