@woosh/meep-engine 2.165.5 → 2.165.7

package/src/engine/graphics/ecs/light/LightType.d.ts

@@ -1,6 +1,8 @@
-export enum LightType {
-    DIRECTION = 0,
-    SPOT = 1,
-    POINT = 2,
-    AMBIENT = 3
-}
+export type LightType = number;
+export namespace LightType {
+    let DIRECTION: number;
+    let SPOT: number;
+    let POINT: number;
+    let AMBIENT: number;
+}
+//# sourceMappingURL=LightType.d.ts.map

package/src/engine/graphics/ecs/mesh/Mesh.d.ts

@@ -1,30 +1,176 @@
-import {Object3D} from "three";
-import {AABB3} from "../../../../core/geom/3d/aabb/AABB3";
-
-export default class Mesh {
-    url: string
-    mesh: Object3D
-
-    castShadow: boolean
-    receiveShadow: boolean
-
-    readonly isLoaded: boolean
-
-    clone(): Mesh
-
-    copy(other: Mesh): void
-
-    hash(): number
-
-    equals(other: Mesh): boolean
-
-    fromJSON(json)
-
-    toJSON(): any
-
-    static fromJSON(json): Mesh
-
-    getBoundingBox(destination: AABB3): void
-
-    getOriginalBoundingBox(destination: AABB3): void
-}
+export type MeshFlags = number;
+export namespace MeshFlags {
+    let CastShadow: number;
+    let ReceiveShadow: number;
+    let Loaded: number;
+    let InView: number;
+}
+export default Mesh;
+declare class Mesh {
+    /**
+     *
+     * @param json
+     * @returns {Mesh}
+     */
+    static fromJSON(json: any): Mesh;
+    /**
+     *
+     * @param {string} url
+     * @returns {Mesh}
+     */
+    static fromURL(url: string): Mesh;
+    /**
+     *
+     * @type {string|null}
+     */
+    url: string | null;
+    /**
+     *
+     * @type {Object3D|null}
+     */
+    mesh: Object3D | null;
+    /**
+     * @transient
+     * @type {Asset|null}
+     */
+    asset: Asset | null;
+    /**
+     *
+     * @type {number}
+     */
+    opacity: number;
+    /**
+     * Initialized to size 1x1x1
+     * @type {AABB3}
+     */
+    boundingBox: AABB3;
+    /**
+     *
+     * @type {BvhClient}
+     */
+    __bvh_leaf: BvhClient;
+    /**
+     * @private
+     * @type {number}
+     */
+    private flags;
+    /**
+     *
+     * @param {Transform} transform
+     */
+    internalApplyTransform(transform: Transform): void;
+    /**
+     *
+     * @param {AABB3} destination
+     */
+    getBoundingBox(destination: AABB3): void;
+    /**
+     *
+     * @param {AABB3} destination
+     */
+    getOriginalBoundingBox(destination: AABB3): void;
+    /**
+     *
+     * @param {boolean} v
+     */
+    set castShadow(arg: boolean);
+    /**
+     *
+     * @return {boolean}
+     */
+    get castShadow(): boolean;
+    /**
+     *
+     * @param {boolean} v
+     */
+    set receiveShadow(arg: boolean);
+    /**
+     *
+     * @return {boolean}
+     */
+    get receiveShadow(): boolean;
+    /**
+     *
+     * @param {boolean} v
+     */
+    set isLoaded(arg: boolean);
+    get isLoaded(): boolean;
+    /**
+     *
+     * @param {number|MeshFlags} flag
+     * @returns {void}
+     */
+    setFlag(flag: number | MeshFlags): void;
+    /**
+     *
+     * @param {number|MeshFlags} flag
+     * @returns {void}
+     */
+    clearFlag(flag: number | MeshFlags): void;
+    /**
+     *
+     * @param {number|MeshFlags} flag
+     * @param {boolean} value
+     */
+    writeFlag(flag: number | MeshFlags, value: boolean): void;
+    /**
+     *
+     * @param {number|MeshFlags} flag
+     * @returns {boolean}
+     */
+    getFlag(flag: number | MeshFlags): boolean;
+    /**
+     *
+     * @returns {boolean}
+     */
+    hasMesh(): boolean;
+    fromJSON({ url, castShadow, receiveShadow, opacity }: {
+        url?: any;
+        castShadow?: boolean;
+        receiveShadow?: boolean;
+        opacity?: number;
+    }): void;
+    toJSON(): {
+        url: string;
+        castShadow: boolean;
+        receiveShadow: boolean;
+        opacity: number;
+    };
+    hash(): number;
+    /**
+     *
+     * @param {Mesh} other
+     * @returns {boolean}
+     */
+    equals(other: Mesh): boolean;
+    /**
+     *
+     * @param {Mesh} other
+     */
+    copy(other: Mesh): void;
+    /**
+     *
+     * @returns {Mesh}
+     */
+    clone(): Mesh;
+    /**
+     *
+     * @param {string} name
+     * @return {Object3D|undefined}
+     */
+    getDescendantObjectByName(name: string): Object3D | undefined;
+    /**
+     *
+     * @param {Vector3} result
+     * @param {HumanoidBoneType|string} boneType
+     */
+    getBonePositionByType(result: Vector3, boneType: HumanoidBoneType | string): void;
+    dispose(): void;
+}
+declare namespace Mesh {
+    let typeName: string;
+}
+import { AABB3 } from "../../../../core/geom/3d/aabb/AABB3.js";
+import { BvhClient } from "../../../../core/bvh2/bvh3/BvhClient.js";
+import { Transform } from "../../../ecs/transform/Transform.js";
+//# sourceMappingURL=Mesh.d.ts.map

package/src/engine/graphics/ecs/mesh/MeshEvents.d.ts

@@ -1,12 +1,6 @@
-export enum MeshEvents {
-    /**
-     * When asset is attached/loaded onto the Mesh component.
-     * This is the time when the 3d data becomes renderable
-     * Respective stateful check can be performed via {@link Mesh#isLoaded}
-     */
-    AssetLoaded = '@ecd-component-Mesh/asset-attached',
-    /**
-     * Required asset failed to load for whatever reason
-     */
-    AssetLoadFailed = '@ecd-component-Mesh/asset-failed',
-}
+export namespace MeshEvents {
+    let AssetLoaded: string;
+    let DataSet: string;
+    let AssetLoadFailed: string;
+}
+//# sourceMappingURL=MeshEvents.d.ts.map

package/src/engine/graphics/ecs/mesh/MeshSystem.d.ts

@@ -1,7 +1,99 @@
-import {System} from "../../../ecs/System";
-import Engine from "../../../Engine";
-import Mesh from "./Mesh";
-
-export class MeshSystem extends System<Mesh> {
-    constructor(engine: Engine)
-}
+export class MeshSystem extends System<any> {
+    /**
+     *
+     * @param {Mesh} component
+     * @param {HumanoidBoneType} boneType
+     * @param {Vector3} [result=new Vector3()]
+     * @returns {Vector3}
+     * @throws {Error} if no such bone exists
+     */
+    static getBonePosition(component: Mesh, boneType: HumanoidBoneType, result?: Vector3): Vector3;
+    /**
+     *
+     * @param {Engine} engine
+     * @constructor
+     * @extends {System}
+     */
+    constructor(engine: Engine);
+    /**
+     *
+     * @type {Engine}
+     * @private
+     */
+    private __engine;
+    dependencies: (typeof Transform | typeof Mesh)[];
+    components_used: ResourceAccessSpecification<typeof Mesh>[];
+    /**
+     *
+     * @type {AssetManager}
+     */
+    assetManager: AssetManager;
+    waitingForMesh: any[];
+    /**
+     *
+     * @type {Array.<Array.<SignalBinding>>}
+     */
+    entityData: Array<Array<SignalBinding>>;
+    graphics: any;
+    /**
+     *
+     * @type {RenderLayer|null}
+     */
+    renderLayer: RenderLayer | null;
+    /**
+     *
+     * @type {boolean}
+     * @private
+     */
+    private __use_placeholder_mesh;
+    /**
+     *
+     * @type {BVH}
+     * @private
+     */
+    private __bvh_binary;
+    /**
+     *
+     * @param {number} entity
+     * @param {EntityComponentDataset} dataset
+     * @param {Asset} asset
+     * @param {Mesh} component
+     */
+    __set_mesh_from_asset(entity: number, dataset: EntityComponentDataset, asset: Asset, component: Mesh): void;
+    startup(entityManager: any): Promise<void>;
+    /**
+     *
+     * @param {function(Mesh, number)} visitor
+     * @param {*} [thisArg]
+     */
+    traverseVisible(visitor: (arg0: Mesh, arg1: number) => any, thisArg?: any): void;
+    shutdown(entityManager: any): Promise<void>;
+    /**
+     *
+     * @param {Transform} transform
+     * @param {Mesh} model
+     * @param {number} entity
+     */
+    link(model: Mesh, transform: Transform, entity: number): void;
+    /**
+     *
+     * @param {Transform} transform
+     * @param {Mesh} model
+     * @param {string} entityId
+     */
+    unlink(model: Mesh, transform: Transform, entityId: string): void;
+    /**
+     *
+     * @param {int} entity
+     * @param {Mesh} component
+     */
+    process(entity: int, component: Mesh): void;
+    update(timeDelta: any): void;
+}
+import { System } from "../../../ecs/System.js";
+import { Transform } from "../../../ecs/transform/Transform.js";
+import Mesh from "./Mesh.js";
+import { ResourceAccessSpecification } from "../../../../core/model/ResourceAccessSpecification.js";
+import { SignalBinding } from "../../../../core/events/signal/SignalBinding.js";
+import Vector3 from "../../../../core/geom/Vector3.js";
+//# sourceMappingURL=MeshSystem.d.ts.map

package/src/engine/graphics/ecs/mesh/serialization/MeshSerializationAdapter.d.ts

@@ -1,7 +1,6 @@
 export class MeshSerializationAdapter extends BinaryClassSerializationAdapter<any> {
     constructor();
     klass: typeof Mesh;
-    version: number;
     /**
      *
      * @param {BinaryBuffer} buffer

package/src/engine/graphics/ecs/mesh/serialization/MeshSerializationAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MeshSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/mesh/serialization/MeshSerializationAdapter.js"],"names":[],"mappings":"AAGA;;IAEI,mBAAa;IACb,gBAAY;IAGZ;;;;OAIG;IACH,uCAFW,IAAI,QAUd;IAED;;;;OAIG;IACH,yCAFW,IAAI,QAUd;CAEJ;gDAvC+C,mEAAmE;iBAClG,YAAY"}
+{"version":3,"file":"MeshSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/mesh/serialization/MeshSerializationAdapter.js"],"names":[],"mappings":"AAGA;;IAEI,mBAAa;IAIb;;;;OAIG;IACH,uCAFW,IAAI,QAUd;IAED;;;;OAIG;IACH,yCAFW,IAAI,QAUd;CAEJ;gDAvC+C,mEAAmE;iBAClG,YAAY"}

package/src/engine/graphics/ecs/mesh-v2/DrawMode.d.ts

@@ -1,6 +1,8 @@
-export enum DrawMode {
-    Triangles = 0,
-    Lines = 2,
-    LineSegments = 3,
-    Points = 4
-}
+export type DrawMode = number;
+export namespace DrawMode {
+    let Triangles: number;
+    let Lines: number;
+    let LineSegments: number;
+    let Points: number;
+}
+//# sourceMappingURL=DrawMode.d.ts.map

package/src/engine/graphics/ecs/mesh-v2/ShadedGeometrySystem.d.ts

@@ -1,32 +1,147 @@
-import {BVH} from "../../../../core/bvh2/bvh3/BVH";
-import {SurfacePoint3} from "../../../../core/geom/3d/SurfacePoint3";
-import {System} from "../../../ecs/System";
-import Engine from "../../../Engine";
-import {ShadedGeometry} from "./ShadedGeometry.js";
-
-export class ShadedGeometrySystem extends System<ShadedGeometry> {
-    constructor(engine: Engine)
-
-    readonly bvh: BVH
-
-    raycastNearest(
-        contact: SurfacePoint3,
-        origin_x: number, origin_y: number, origin_z: number,
-        direction_x: number, direction_y: number, direction_z: number,
-        filter_function?: (entity: number, mesh: ShadedGeometry) => boolean,
-        filter_function_context?: any
-    ): { entity: number, mesh: ShadedGeometry } | undefined
-
-    raycast(
-        origin_x: number, origin_y: number, origin_z: number,
-        direction_x: number, direction_y: number, direction_z: number,
-        filter_function?: (entity: number, mesh: ShadedGeometry) => boolean,
-        filter_function_context?: any
-    ): { entity: number, mesh: ShadedGeometry, contact: SurfacePoint3 }[]
-
-    queryOverlapFrustum(
-        result: ArrayLike<number>,
-        result_offset: number,
-        planes: ArrayLike<number>
-    ): number
-}
+export class ShadedGeometrySystem extends System<any> {
+    /**
+     *
+     * @param {Engine} engine
+     */
+    constructor(engine: Engine);
+    dependencies: (typeof Transform | typeof ShadedGeometry)[];
+    /**
+     *s
+     * @type {Engine}
+     * @private
+     */
+    private __engine;
+    /**
+     *
+     * @type {RenderLayer|null}
+     * @private
+     */
+    private __render_layer;
+    /**
+     *
+     * @type {Map<CameraView, ShadedGeometryRendererContext>}
+     * @private
+     */
+    private __view_contexts;
+    /**
+     *
+     * @type {Map<number, function():AbstractRenderAdapter>}
+     * @private
+     */
+    private __adapter_suppliers;
+    /**
+     * Keeps count of usage for each geometry by ID
+     * @type {Map<number, number>}
+     * @private
+     */
+    private __geometry_usage_counters;
+    /**
+     *
+     * @type {BVH}
+     * @private
+     */
+    private __bvh_binary;
+    __optimization_task: Task;
+    __maintenance_task: Task;
+    /**
+     *
+     * @returns {BVH}
+     */
+    get bvh(): BVH;
+    /**
+     * NOTE: DO NOT MODIFY RESULTS
+     * @returns {Map<number,number>}
+     */
+    getGeometryUsageCounters(): Map<number, number>;
+    /**
+     *
+     * @param {number} index
+     * @param {function():AbstractRenderAdapter} supplier
+     */
+    register_render_adapter(index: number, supplier: () => AbstractRenderAdapter): void;
+    /**
+     *
+     * @param {number} index
+     * @return {boolean}
+     */
+    unregister_render_adapter(index: number): boolean;
+    /**
+     *
+     * @param {CameraView} view
+     * @private
+     */
+    private __handle_view_added;
+    /**
+     *
+     * @param {CameraView} view
+     * @private
+     */
+    private __handle_view_removed;
+    startup(entityManager: any): Promise<void>;
+    shutdown(entityManager: any): Promise<void>;
+    /**
+     *
+     * @param {ShadedGeometry} sg
+     * @param {Transform} t
+     * @param {number} entity
+     */
+    link(sg: ShadedGeometry, t: Transform, entity: number): void;
+    /**
+     *
+     * @param {ShadedGeometry} sg
+     * @param {Transform} t
+     * @param {number} entity
+     */
+    unlink(sg: ShadedGeometry, t: Transform, entity: number): void;
+    /**
+     *
+     * @param {number[]} result entity IDs
+     * @param {number} result_offset offset into result array where to write first result into
+     * @param {number[]|ArrayLike<number>} planes
+     * @returns {number} number of results
+     */
+    queryOverlapFrustum(result: number[], result_offset: number, planes: number[] | ArrayLike<number>): number;
+    /**
+     *
+     * @param {number} origin_x
+     * @param {number} origin_y
+     * @param {number} origin_z
+     * @param {number} direction_x
+     * @param {number} direction_y
+     * @param {number} direction_z
+     * @param {function(entity:number, mesh:ShadedGeometry):boolean} [filter_function]
+     * @param {*} [filter_function_context]
+     * @returns {{entity:number, mesh:ShadedGeometry, contact: SurfacePoint3}[]}
+     */
+    raycast(origin_x: number, origin_y: number, origin_z: number, direction_x: number, direction_y: number, direction_z: number, filter_function?: typeof returnTrue, filter_function_context?: any): {
+        entity: number;
+        mesh: ShadedGeometry;
+        contact: SurfacePoint3;
+    }[];
+    /**
+     *
+     * @param {SurfacePoint3} contact
+     * @param {number} origin_x
+     * @param {number} origin_y
+     * @param {number} origin_z
+     * @param {number} direction_x
+     * @param {number} direction_y
+     * @param {number} direction_z
+     * @param {function(entity:number, mesh:ShadedGeometry):boolean} [filter_function]
+     * @param {*} [filter_function_context]
+     * @returns {{entity:number, mesh:ShadedGeometry}|undefined}
+     */
+    raycastNearest(contact: SurfacePoint3, origin_x: number, origin_y: number, origin_z: number, direction_x: number, direction_y: number, direction_z: number, filter_function?: typeof returnTrue, filter_function_context?: any): {
+        entity: number;
+        mesh: ShadedGeometry;
+    } | undefined;
+    #private;
+}
+import { System } from "../../../ecs/System.js";
+import { Transform } from "../../../ecs/transform/Transform.js";
+import { ShadedGeometry } from "./ShadedGeometry.js";
+import Task from "../../../../core/process/task/Task.js";
+import { BVH } from "../../../../core/bvh2/bvh3/BVH.js";
+import { returnTrue } from "../../../../core/function/returnTrue.js";
+import { SurfacePoint3 } from "../../../../core/geom/3d/SurfacePoint3.js";
+//# sourceMappingURL=ShadedGeometrySystem.d.ts.map

package/src/engine/graphics/ecs/mesh-v2/ShadedGeometrySystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShadedGeometrySystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/mesh-v2/ShadedGeometrySystem.js"],"names":[],"mappings":"AA6DA;IACI;;;OAGG;IACH,4BAmEC;IAjEG,2DAA+C;IAE/C;;;;OAIG;IACH,iBAAsB;IAEtB;;;;OAIG;IACH,uBAA0B;IAE1B;;;;OAIG;IACH,wBAAgC;IAEhC;;;;OAIG;IACH,4BAAoC;IAEpC;;;;OAIG;IACH,kCAA0C;IAE1C;;;;OAIG;IACH,qBAA6B;IAI7B,0BAYE;IAEF,yBAIC;IAIL;;;OAGG;IACH,eAEC;IAED;;;OAGG;IACH,4BAFa,IAAI,MAAM,EAAC,MAAM,CAAC,CAI9B;IAED;;;;OAIG;IACH,+BAHW,MAAM,+CAsBhB;IAED;;;;OAIG;IACH,iCAHW,MAAM,GACL,OAAO,CAmBlB;IAED;;;;OAIG;IACH,4BASC;IAED;;;;OAIG;IACH,8BAMC;IAED,2CAqCC;IAED,4CAcC;IAED;;;;;OAKG;IACH,SAJW,cAAc,KACd,SAAS,UACT,MAAM,QAqBhB;IAED;;;;;OAKG;IACH,WAJW,cAAc,KACd,SAAS,UACT,MAAM,QAsBhB;IAED;;;;;;OAMG;IACH,4BALW,MAAM,EAAE,iBACR,MAAM,UACN,MAAM,EAAE,GAAC,UAAU,MAAM,CAAC,GACxB,MAAM,CAQlB;IAED;;;;;;;;;;;OAWG;IACH,kBAVW,MAAM,YACN,MAAM,YACN,MAAM,eACN,MAAM,eACN,MAAM,eACN,MAAM,uEAGJ;QAAC,MAAM,EAAC,MAAM,CAAC;QAAC,IAAI,EAAC,cAAc,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAC,EAAE,CA8D1E;IAGD;;;;;;;;;;;;OAYG;IACH,wBAXW,aAAa,YACb,MAAM,YACN,MAAM,YACN,MAAM,eACN,MAAM,eACN,MAAM,eACN,MAAM,uEAGJ;QAAC,MAAM,EAAC,MAAM,CAAC;QAAC,IAAI,EAAC,cAAc,CAAA;KAAC,GAAC,SAAS,CAmF1D;CACJ;uBA7fsB,wBAAwB;0BACrB,qCAAqC;+BAGhC,qBAAqB;iBARnC,uCAAuC;oBAZpC,mCAAmC;2BAQ5B,yCAAyC;8BAEtC,2CAA2C"}
+{"version":3,"file":"ShadedGeometrySystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/mesh-v2/ShadedGeometrySystem.js"],"names":[],"mappings":"AA8DA;IASI;;;OAGG;IACH,4BAmEC;IAjEG,2DAA+C;IAE/C;;;;OAIG;IACH,iBAAsB;IAEtB;;;;OAIG;IACH,uBAA0B;IAE1B;;;;OAIG;IACH,wBAAgC;IAEhC;;;;OAIG;IACH,4BAAoC;IAEpC;;;;OAIG;IACH,kCAA0C;IAE1C;;;;OAIG;IACH,qBAA6B;IAI7B,0BAYE;IAEF,yBAIC;IAIL;;;OAGG;IACH,eAEC;IAED;;;OAGG;IACH,4BAFa,IAAI,MAAM,EAAC,MAAM,CAAC,CAI9B;IAED;;;;OAIG;IACH,+BAHW,MAAM,+CAsBhB;IAED;;;;OAIG;IACH,iCAHW,MAAM,GACL,OAAO,CAmBlB;IAED;;;;OAIG;IACH,4BASC;IAED;;;;OAIG;IACH,8BAMC;IAED,2CAqCC;IAED,4CAcC;IAED;;;;;OAKG;IACH,SAJW,cAAc,KACd,SAAS,UACT,MAAM,QA2ChB;IAED;;;;;OAKG;IACH,WAJW,cAAc,KACd,SAAS,UACT,MAAM,QA4BhB;IAED;;;;;;OAMG;IACH,4BALW,MAAM,EAAE,iBACR,MAAM,UACN,MAAM,EAAE,GAAC,UAAU,MAAM,CAAC,GACxB,MAAM,CAQlB;IAED;;;;;;;;;;;OAWG;IACH,kBAVW,MAAM,YACN,MAAM,YACN,MAAM,eACN,MAAM,eACN,MAAM,eACN,MAAM,uEAGJ;QAAC,MAAM,EAAC,MAAM,CAAC;QAAC,IAAI,EAAC,cAAc,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAC,EAAE,CA8D1E;IAGD;;;;;;;;;;;;OAYG;IACH,wBAXW,aAAa,YACb,MAAM,YACN,MAAM,YACN,MAAM,eACN,MAAM,eACN,MAAM,eACN,MAAM,uEAGJ;QAAC,MAAM,EAAC,MAAM,CAAC;QAAC,IAAI,EAAC,cAAc,CAAA;KAAC,GAAC,SAAS,CAmF1D;;CACJ;uBAliBsB,wBAAwB;0BACrB,qCAAqC;+BAIhC,qBAAqB;iBATnC,uCAAuC;oBAZpC,mCAAmC;2BAQ5B,yCAAyC;8BAEtC,2CAA2C"}

package/src/engine/graphics/ecs/mesh-v2/ShadedGeometrySystem.js

@@ -17,6 +17,7 @@ import TaskState from "../../../../core/process/task/TaskState.js";
 import { iteratorTask } from "../../../../core/process/task/util/iteratorTask.js";
 import { System } from "../../../ecs/System.js";
 import { Transform } from "../../../ecs/transform/Transform.js";
+import { isForwardPlusLightingSkipped } from "../../render/forward_plus/plugin/isForwardPlusLightingSkipped.js";
 import { RuntimeDrawMethodOptimizer } from "./render/optimization/RuntimeDrawMethodOptimizer.js";
 import { ShadedGeometryRendererContext } from "./render/ShadedGeometryRendererContext.js";
 import { ShadedGeometry } from "./ShadedGeometry.js";
@@ -60,6 +61,14 @@ function* maintenance_generator(system) {
 }
 
 export class ShadedGeometrySystem extends System {
+    /**
+     * Reference-counted material handles obtained in {@link link} (one per linked
+     * entity) and released in {@link unlink}, so that the {@link MaterialManager} can
+     * reclaim materials once no mesh references them any more.
+     * @type {Map<number, Reference>}
+     */
+    #material_references = new Map();
+
     /**
      *
      * @param {Engine} engine
@@ -291,6 +300,28 @@ export class ShadedGeometrySystem extends System {
      * @param {number} entity
      */
     link(sg, t, entity) {
+        assert.notNull(sg.material, 'sg.material');
+
+        // Force the material through the manager's transform chain, so that shader
+        // injection performed by the lighting engine (Forward+ clustered lights,
+        // decals) cannot be skipped by callers that assign `sg.material` directly.
+        // Idempotent: already-managed materials come back unchanged, and transformers
+        // leave materials they do not handle (e.g. unlit ones) alone.
+        const material_manager = this.__engine.graphics.getMaterialManager();
+        const material_reference = material_manager.obtain(sg.material);
+
+        sg.material = material_reference.getValue();
+
+        // link is balanced with unlink, so no prior entry is expected here; if one
+        // exists we simply overwrite it rather than guarding a can't-happen case
+        this.#material_references.set(entity, material_reference);
+
+        assert.ok(
+            !isForwardPlusLightingSkipped(material_manager, sg.material),
+            'lit material was not transformed for Forward+ clustered lighting,'
+            + ' ensure the Forward+ plugin is registered before entities are linked'
+        );
+
         sg.__c_transform = t;
 
         sg.update_bounds();
@@ -323,6 +354,12 @@ export class ShadedGeometrySystem extends System {
         // disconnect BVH
         sg.__bvh_leaf.unlink();
 
+        // release the material handle obtained in link(), letting the manager reclaim
+        // the material once no other mesh holds a reference to it
+        const material_reference = this.#material_references.get(entity);
+        this.#material_references.delete(entity);
+        material_reference.release();
+
         const geometry_id = sg.geometry.id;
         const count_existing = this.__geometry_usage_counters.get(geometry_id);
 

package/src/engine/graphics/ecs/mesh-v2/aggregate/SGAnimationPlayback.d.ts

@@ -1,5 +1,6 @@
-export class SGAnimationPlayback {
-    clip_name: string
-    time: number
-    loop: boolean
-}
+export class SGAnimationPlayback {
+    clip_name: string;
+    time: number;
+    loop: boolean;
+}
+//# sourceMappingURL=SGAnimationPlayback.d.ts.map