@skenora/runtime 0.1.2

package/dist/systems/material-binding-resolver.d.ts

@@ -0,0 +1,16 @@
+import type { Material } from "@babylonjs/core/Materials/material";
+import type { Scene } from "@babylonjs/core/scene";
+import type { MaterialBindingRecord } from "@skenora/contracts";
+/**
+ * Resolves document material ids and bindings against the current Babylon
+ * scene without owning the resolved materials.
+ */
+export declare class MaterialBindingResolver {
+    #private;
+    constructor(scene: Scene);
+    get(materialId: string): Material | null;
+    resolve(binding: Readonly<MaterialBindingRecord>): Material | null;
+    setBindings(bindings: Readonly<Record<string, MaterialBindingRecord>>): void;
+    clear(): void;
+}
+//# sourceMappingURL=material-binding-resolver.d.ts.map

package/dist/systems/material-binding-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-binding-resolver.d.ts","sourceRoot":"","sources":["../../src/systems/material-binding-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;;GAGG;AACH,qBAAa,uBAAuB;;gBAItB,KAAK,EAAE,KAAK;IAIxB,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAOxC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,QAAQ,GAAG,IAAI;IAkBlE,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,GAAG,IAAI;IAW5E,KAAK,IAAI,IAAI;CAGd"}

package/dist/systems/material-binding-resolver.js

@@ -0,0 +1,54 @@
+/**
+ * Resolves document material ids and bindings against the current Babylon
+ * scene without owning the resolved materials.
+ */
+export class MaterialBindingResolver {
+    #scene;
+    #bindings = new Map();
+    constructor(scene) {
+        this.#scene = scene;
+    }
+    get(materialId) {
+        const binding = this.#bindings.get(materialId)?.[0];
+        return binding
+            ? this.resolve(binding)
+            : this.#scene.getMaterialById(materialId);
+    }
+    resolve(binding) {
+        const mesh = this.#scene.meshes.find((candidate) => belongsToEntity(candidate, binding.entityId) &&
+            candidate.material !== null &&
+            (!binding.targetName ||
+                candidate.material.id === binding.targetName ||
+                candidate.material.name === binding.targetName));
+        if (mesh?.material)
+            return mesh.material;
+        return (this.#scene.getMaterialById(binding.materialId) ??
+            (binding.targetName
+                ? this.#scene.getMaterialByName(binding.targetName)
+                : null));
+    }
+    setBindings(bindings) {
+        this.#bindings.clear();
+        for (const binding of Object.values(bindings)) {
+            const materialBindings = this.#bindings.get(binding.materialId);
+            this.#bindings.set(binding.materialId, [
+                ...(materialBindings ?? []),
+                binding,
+            ]);
+        }
+    }
+    clear() {
+        this.#bindings.clear();
+    }
+}
+function belongsToEntity(node, entityId) {
+    let current = node;
+    while (current && typeof current === "object") {
+        const candidate = current;
+        if (candidate.metadata?.skenora?.entityId === entityId)
+            return true;
+        current = candidate.parent;
+    }
+    return false;
+}
+//# sourceMappingURL=material-binding-resolver.js.map

package/dist/systems/material-binding-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-binding-resolver.js","sourceRoot":"","sources":["../../src/systems/material-binding-resolver.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAO,uBAAuB;IACzB,MAAM,CAAQ;IACd,SAAS,GAAG,IAAI,GAAG,EAA4C,CAAC;IAEzE,YAAY,KAAY;QACtB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,GAAG,CAAC,UAAkB;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACpD,OAAO,OAAO;YACZ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YACvB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,CAAC,OAAwC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAClC,CAAC,SAAS,EAAE,EAAE,CACZ,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC;YAC5C,SAAS,CAAC,QAAQ,KAAK,IAAI;YAC3B,CAAC,CAAC,OAAO,CAAC,UAAU;gBAClB,SAAS,CAAC,QAAQ,CAAC,EAAE,KAAK,OAAO,CAAC,UAAU;gBAC5C,SAAS,CAAC,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,UAAU,CAAC,CACpD,CAAC;QACF,IAAI,IAAI,EAAE,QAAQ;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;QACzC,OAAO,CACL,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC;YAC/C,CAAC,OAAO,CAAC,UAAU;gBACjB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,OAAO,CAAC,UAAU,CAAC;gBACnD,CAAC,CAAC,IAAI,CAAC,CACV,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,QAAyD;QACnE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9C,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAChE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE;gBACrC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC;gBAC3B,OAAO;aACR,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF;AAED,SAAS,eAAe,CACtB,IAA4C,EAC5C,QAAgB;IAEhB,IAAI,OAAO,GAAY,IAAI,CAAC;IAC5B,OAAO,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,SAAS,GAAG,OAGjB,CAAC;QACF,IAAI,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACpE,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/systems/material-controller.d.ts

@@ -0,0 +1,29 @@
+/** Applies document-owned material overrides to imported materials. */
+import { PBRMaterial } from "@babylonjs/core/Materials/PBR/pbrMaterial";
+import type { Material } from "@babylonjs/core/Materials/material";
+import type { AbstractMesh } from "@babylonjs/core/Meshes/abstractMesh";
+import type { Scene } from "@babylonjs/core/scene";
+import type { MaterialBindingRecord, MaterialOverride, SceneDocumentData, MaterialExecutionPolicy, MaterialPreparationEvent, MaterialEffectRuntimeProperty, GpuProgramPreparationReport } from "@skenora/contracts";
+import type { ResourceResolver } from "@skenora/resources";
+import type { GpuProgramCache } from "./gpu-program-cache.js";
+export type MaterialResolver = (binding: Readonly<MaterialBindingRecord>) => Material | null;
+export interface MaterialControllerOptions {
+    policy?: MaterialExecutionPolicy;
+    onPreparation?: (event: MaterialPreparationEvent) => void;
+    onGpuProgramPreparation?: (event: GpuProgramPreparationReport) => void;
+    gpuProgramCache?: GpuProgramCache;
+}
+/** Applies document-owned PBR overrides without owning imported materials. */
+export declare class MaterialController {
+    #private;
+    readonly scene: Scene;
+    readonly resources: ResourceResolver;
+    constructor(scene: Scene, resources: ResourceResolver, resolve: MaterialResolver, options?: MaterialControllerOptions);
+    apply(document: Readonly<SceneDocumentData>, isCurrent?: () => boolean): Promise<void>;
+    getOwnedMaterials(materialId: string): readonly PBRMaterial[] | null;
+    setEffectProperty(materialId: string, property: MaterialEffectRuntimeProperty, value: unknown): void;
+    readOriginalMaterial(mesh: AbstractMesh): Material | null;
+    capture(material: PBRMaterial, identity: Pick<MaterialOverride, "id">): MaterialOverride;
+    dispose(): void;
+}
+//# sourceMappingURL=material-controller.d.ts.map

package/dist/systems/material-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-controller.d.ts","sourceRoot":"","sources":["../../src/systems/material-controller.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAGxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAEV,qBAAqB,EACrB,gBAAgB,EAEhB,iBAAiB,EAEjB,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,EAC7B,2BAA2B,EAC5B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAEV,gBAAgB,EAEjB,MAAM,oBAAoB,CAAC;AAW5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,QAAQ,CAAC,qBAAqB,CAAC,KACrC,QAAQ,GAAG,IAAI,CAAC;AAErB,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,CAAC;IAC1D,uBAAuB,CAAC,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,IAAI,CAAC;IACvE,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAQD,8EAA8E;AAC9E,qBAAa,kBAAkB;;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;gBAcnC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,yBAA8B;IAQnC,KAAK,CACT,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACrC,SAAS,GAAE,MAAM,OAA+B,GAC/C,OAAO,CAAC,IAAI,CAAC;IA0ChB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,GAAG,IAAI;IAIpE,iBAAiB,CACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,6BAA6B,EACvC,KAAK,EAAE,OAAO,GACb,IAAI;IAKP,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,GAAG,IAAI;IAIzD,OAAO,CACL,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,GACrC,gBAAgB;IAoGnB,OAAO,IAAI,IAAI;CAuEhB"}

package/dist/systems/material-controller.js

@@ -0,0 +1,233 @@
+/** Applies document-owned material overrides to imported materials. */
+import { PBRMaterial } from "@babylonjs/core/Materials/PBR/pbrMaterial";
+import { Texture } from "@babylonjs/core/Materials/Textures/texture";
+import { MATERIAL_TEXTURE_SLOT_NAMES } from "@skenora/contracts";
+import { applyPbrOverride, assignTextureSlot, createTexture, readManagedReference, readTextureSlot, toColorValue, } from "./pbr-material.js";
+/** Applies document-owned PBR overrides without owning imported materials. */
+export class MaterialController {
+    scene;
+    resources;
+    #resolve;
+    #options;
+    #bindings = new Map();
+    #originals = new Map();
+    #owned = null;
+    #resourceScope = null;
+    #revision = 0;
+    #disposed = false;
+    constructor(scene, resources, resolve, options = {}) {
+        this.scene = scene;
+        this.resources = resources;
+        this.#resolve = resolve;
+        this.#options = options;
+    }
+    async apply(document, isCurrent = () => !this.#disposed) {
+        this.#assertActive();
+        const revision = ++this.#revision;
+        const current = () => isCurrent() && revision === this.#revision;
+        if (!this.#owned &&
+            Object.values(document.materials).some((material) => material.creation)) {
+            const { OwnedMaterialController } = await import("./owned-material-controller.js");
+            if (!current())
+                return;
+            this.#owned ??= new OwnedMaterialController(this.scene, this.resources, this.#options.policy, this.#options.onPreparation, this.#options.gpuProgramCache, this.#options.onGpuProgramPreparation);
+        }
+        await this.#owned?.apply(document, current);
+        if (!current())
+            return;
+        this.#releaseTextures();
+        this.#restoreOverrides();
+        for (const binding of Object.values(document.materialBindings)) {
+            if (!current())
+                return;
+            const override = document.materials[binding.materialId];
+            if (!override || override.creation)
+                continue;
+            const material = this.#resolve(binding);
+            if (!(material instanceof PBRMaterial))
+                continue;
+            if (!this.#originals.has(material)) {
+                this.#originals.set(material, {
+                    definition: this.capture(material, { id: override.id }),
+                    transparencyMode: material.transparencyMode,
+                });
+            }
+            applyPbrOverride(material, override);
+            await this.#applyTextures(document, material, override, current);
+        }
+    }
+    getOwnedMaterials(materialId) {
+        return this.#owned?.get(materialId) ?? null;
+    }
+    setEffectProperty(materialId, property, value) {
+        if (!this.#owned)
+            throw new Error("Owned material effects are not active");
+        this.#owned.setEffectProperty(materialId, property, value);
+    }
+    readOriginalMaterial(mesh) {
+        return this.#owned ? this.#owned.readOriginal(mesh) : mesh.material;
+    }
+    capture(material, identity) {
+        const textures = Object.fromEntries(MATERIAL_TEXTURE_SLOT_NAMES.flatMap((slot) => {
+            const texture = readTextureSlot(material, slot);
+            const reference = texture instanceof Texture ? readManagedReference(texture) : null;
+            return reference ? [[slot, reference]] : [];
+        }));
+        const effects = this.#owned?.captureEffects(material);
+        return {
+            ...identity,
+            ...(effects ? { effects } : {}),
+            workflow: material.metallic === null && material.roughness === null
+                ? "specular-glossiness"
+                : "metallic-roughness",
+            baseColor: toColorValue(material.albedoColor),
+            reflectivityColor: toColorValue(material.reflectivityColor),
+            ambientColor: toColorValue(material.ambientColor),
+            metallic: material.metallic,
+            roughness: material.roughness,
+            microSurface: material.microSurface,
+            metallicF0Factor: material.metallicF0Factor,
+            alpha: material.alpha,
+            emissiveColor: toColorValue(material.emissiveColor),
+            emissiveIntensity: material.emissiveIntensity,
+            indexOfRefraction: material.indexOfRefraction,
+            ...(material.transparencyMode === null
+                ? {}
+                : { transparencyMode: material.transparencyMode }),
+            alphaCutOff: material.alphaCutOff,
+            useAlphaFromBaseColorTexture: material.useAlphaFromAlbedoTexture,
+            useLightmapAsShadowmap: material.useLightmapAsShadowmap,
+            useAmbientInGrayScale: material.useAmbientInGrayScale,
+            useMicroSurfaceFromReflectivityMapAlpha: material.useMicroSurfaceFromReflectivityMapAlpha,
+            useAutoMicroSurfaceFromReflectivityMap: material.useAutoMicroSurfaceFromReflectivityMap,
+            unlit: material.unlit,
+            doubleSided: !material.backFaceCulling,
+            clearCoat: {
+                enabled: material.clearCoat.isEnabled,
+                intensity: material.clearCoat.intensity,
+                roughness: material.clearCoat.roughness,
+                indexOfRefraction: material.clearCoat.indexOfRefraction,
+                remapF0OnInterfaceChange: material.clearCoat.remapF0OnInterfaceChange,
+                tintEnabled: material.clearCoat.isTintEnabled,
+                tintColor: toColorValue(material.clearCoat.tintColor),
+                tintThickness: material.clearCoat.tintThickness,
+                tintColorAtDistance: material.clearCoat.tintColorAtDistance,
+            },
+            sheen: {
+                enabled: material.sheen.isEnabled,
+                intensity: material.sheen.intensity,
+                roughness: material.sheen.roughness ?? 0,
+                color: toColorValue(material.sheen.color),
+                linkWithBaseColor: material.sheen.linkSheenWithAlbedo,
+                useRoughnessFromMainTexture: material.sheen.useRoughnessFromMainTexture,
+            },
+            anisotropy: {
+                enabled: material.anisotropy.isEnabled,
+                intensity: material.anisotropy.intensity,
+                direction: {
+                    x: material.anisotropy.direction.x,
+                    y: material.anisotropy.direction.y,
+                },
+            },
+            subSurface: {
+                enabled: material.subSurface.isRefractionEnabled ||
+                    material.subSurface.isTranslucencyEnabled,
+                refractionEnabled: material.subSurface.isRefractionEnabled,
+                translucencyEnabled: material.subSurface.isTranslucencyEnabled,
+                indexOfRefraction: material.subSurface.indexOfRefraction,
+                volumeIndexOfRefraction: material.subSurface.volumeIndexOfRefraction,
+                minimumThickness: material.subSurface.minimumThickness,
+                maximumThickness: material.subSurface.maximumThickness,
+                tintColor: toColorValue(material.subSurface.tintColor),
+                tintColorAtDistance: material.subSurface.tintColorAtDistance,
+                refractionIntensity: material.subSurface.refractionIntensity,
+                translucencyIntensity: material.subSurface.translucencyIntensity,
+                diffusionDistance: toColorValue(material.subSurface.diffusionDistance),
+                linkRefractionWithTransparency: material.subSurface.linkRefractionWithTransparency,
+                useAlbedoToTintRefraction: material.subSurface.useAlbedoToTintRefraction,
+                useAlbedoToTintTranslucency: material.subSurface.useAlbedoToTintTranslucency,
+            },
+            ...(Object.keys(textures).length > 0
+                ? {
+                    textures: textures,
+                }
+                : {}),
+        };
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.#revision += 1;
+        this.#releaseTextures();
+        this.#restoreOverrides();
+        this.#owned?.dispose();
+        this.#owned = null;
+    }
+    async #applyTextures(document, material, override, isCurrent) {
+        const entries = Object.entries(override.textures ?? {});
+        for (const [slot, reference] of entries) {
+            const asset = document.assets[reference.assetId];
+            if (!asset)
+                continue;
+            this.#resourceScope ??= this.resources.createScope();
+            const resource = await acquireCurrent(this.#resourceScope, asset, isCurrent);
+            if (!resource)
+                return;
+            const texture = createTexture(this.scene, resource.objectUrl, reference, `${material.name}:${slot}`);
+            const previous = readTextureSlot(material, slot);
+            assignTextureSlot(material, slot, texture);
+            const bindings = this.#bindings.get(material) ?? [];
+            bindings.push({ slot, texture, previous });
+            this.#bindings.set(material, bindings);
+        }
+    }
+    #releaseTextures() {
+        for (const [material, bindings] of this.#bindings) {
+            for (const binding of [...bindings].reverse()) {
+                if (readTextureSlot(material, binding.slot) === binding.texture) {
+                    assignTextureSlot(material, binding.slot, binding.previous);
+                }
+                binding.texture.dispose();
+            }
+        }
+        this.#bindings.clear();
+        this.#resourceScope?.dispose();
+        this.#resourceScope = null;
+    }
+    #restoreOverrides() {
+        for (const [material, original] of this.#originals) {
+            applyPbrOverride(material, original.definition);
+            material.transparencyMode = original.transparencyMode;
+        }
+        this.#originals.clear();
+    }
+    #assertActive() {
+        if (this.#disposed) {
+            throw new Error("MaterialController has been disposed");
+        }
+    }
+}
+async function acquireCurrent(scope, asset, isCurrent) {
+    try {
+        const resource = await scope.acquire(asset);
+        if (isCurrent())
+            return resource;
+        scope.dispose();
+        return null;
+    }
+    catch (error) {
+        if (!isCurrent() && isAbortError(error)) {
+            scope.dispose();
+            return null;
+        }
+        throw error;
+    }
+}
+function isAbortError(error) {
+    return (!!error &&
+        typeof error === "object" &&
+        "name" in error &&
+        error.name === "AbortError");
+}
+//# sourceMappingURL=material-controller.js.map

package/dist/systems/material-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-controller.js","sourceRoot":"","sources":["../../src/systems/material-controller.ts"],"names":[],"mappings":"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"}

package/dist/systems/material-preparation.d.ts

@@ -0,0 +1,9 @@
+import type { PBRMaterial } from "@babylonjs/core/Materials/PBR/pbrMaterial";
+import type { AbstractMesh } from "@babylonjs/core/Meshes/abstractMesh";
+/**
+ * Prepares the surface variant without touching active submesh draw wrappers.
+ * Unlike forceCompilationAsync, this owns and cancels its polling timer.
+ * Readiness is not a visual-quality assertion or a check of every shadow pass.
+ */
+export declare function prepareMaterialSurface(material: PBRMaterial, mesh: AbstractMesh, slot: number, signal: AbortSignal): Promise<void>;
+//# sourceMappingURL=material-preparation.d.ts.map

package/dist/systems/material-preparation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-preparation.d.ts","sourceRoot":"","sources":["../../src/systems/material-preparation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAGxE;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAuDf"}

package/dist/systems/material-preparation.js

@@ -0,0 +1,51 @@
+import { SubMesh } from "@babylonjs/core/Meshes/subMesh";
+/**
+ * Prepares the surface variant without touching active submesh draw wrappers.
+ * Unlike forceCompilationAsync, this owns and cancels its polling timer.
+ * Readiness is not a visual-quality assertion or a check of every shadow pass.
+ */
+export async function prepareMaterialSurface(material, mesh, slot, signal) {
+    const probe = new SubMesh(slot, 0, mesh.getTotalVertices(), 0, mesh.getTotalIndices(), mesh, undefined, false, false);
+    let timer;
+    let abort = () => undefined;
+    const hotSwap = material.allowShaderHotSwapping;
+    material.allowShaderHotSwapping = false;
+    try {
+        await new Promise((resolve, reject) => {
+            abort = () => reject(new DOMException("Material preparation cancelled", "AbortError"));
+            signal.addEventListener("abort", abort, { once: true });
+            const check = () => {
+                if (signal.aborted || mesh.isDisposed()) {
+                    abort();
+                    return;
+                }
+                try {
+                    if (material.isReadyForSubMesh(mesh, probe, mesh.hasThinInstances)) {
+                        resolve();
+                        return;
+                    }
+                    if (probe.effect?.getCompilationError() &&
+                        probe.effect.allFallbacksProcessed()) {
+                        reject(new Error("Material program preparation failed"));
+                        return;
+                    }
+                    timer = setTimeout(check, 16);
+                }
+                catch {
+                    reject(new Error("Material program preparation failed"));
+                }
+            };
+            check();
+        });
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+        signal.removeEventListener("abort", abort);
+        material.allowShaderHotSwapping = hotSwap;
+        // The probe was not inserted in mesh.subMeshes. SubMesh.dispose() would
+        // splice index -1 in Babylon 9, removing a real submesh; release only its cache.
+        probe.resetDrawCache();
+    }
+}
+//# sourceMappingURL=material-preparation.js.map

package/dist/systems/material-preparation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-preparation.js","sourceRoot":"","sources":["../../src/systems/material-preparation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAqB,EACrB,IAAkB,EAClB,IAAY,EACZ,MAAmB;IAEnB,MAAM,KAAK,GAAG,IAAI,OAAO,CACvB,IAAI,EACJ,CAAC,EACD,IAAI,CAAC,gBAAgB,EAAE,EACvB,CAAC,EACD,IAAI,CAAC,eAAe,EAAE,EACtB,IAAI,EACJ,SAAS,EACT,KAAK,EACL,KAAK,CACN,CAAC;IACF,IAAI,KAAgD,CAAC;IACrD,IAAI,KAAK,GAAe,GAAG,EAAE,CAAC,SAAS,CAAC;IACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,sBAAsB,CAAC;IAChD,QAAQ,CAAC,sBAAsB,GAAG,KAAK,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,KAAK,GAAG,GAAG,EAAE,CACX,MAAM,CACJ,IAAI,YAAY,CAAC,gCAAgC,EAAE,YAAY,CAAC,CACjE,CAAC;YACJ,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,MAAM,KAAK,GAAG,GAAG,EAAE;gBACjB,IAAI,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;oBACxC,KAAK,EAAE,CAAC;oBACR,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC;oBACH,IAAI,QAAQ,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;wBACnE,OAAO,EAAE,CAAC;wBACV,OAAO;oBACT,CAAC;oBACD,IACE,KAAK,CAAC,MAAM,EAAE,mBAAmB,EAAE;wBACnC,KAAK,CAAC,MAAM,CAAC,qBAAqB,EAAE,EACpC,CAAC;wBACD,MAAM,CAAC,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC,CAAC;wBACzD,OAAO;oBACT,CAAC;oBACD,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAChC,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,CAAC,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC,CAAC;gBAC3D,CAAC;YACH,CAAC,CAAC;YACF,KAAK,EAAE,CAAC;QACV,CAAC,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,KAAK,KAAK,SAAS;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC3C,QAAQ,CAAC,sBAAsB,GAAG,OAAO,CAAC;QAC1C,wEAAwE;QACxE,iFAAiF;QACjF,KAAK,CAAC,cAAc,EAAE,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/systems/material-slots.d.ts

@@ -0,0 +1,18 @@
+import type { Material } from "@babylonjs/core/Materials/material";
+import type { AbstractMesh } from "@babylonjs/core/Meshes/abstractMesh";
+import type { Scene } from "@babylonjs/core/scene";
+import type { MaterialBindingRecord, MaterialDiagnostic, MaterialSlotDescriptor } from "@skenora/contracts";
+export declare class MaterialProjectionError extends Error {
+    readonly diagnostic: Readonly<MaterialDiagnostic>;
+    constructor(diagnostic: MaterialDiagnostic);
+}
+export interface MaterialSlot {
+    readonly mesh: AbstractMesh;
+    readonly slot: number;
+    readonly original: Material | null;
+    readonly material: Material | null;
+    readonly descriptor: MaterialSlotDescriptor;
+}
+export declare function listMaterialSlots(scene: Scene, entityId: string, readOriginal?: (mesh: AbstractMesh) => Material | null): readonly MaterialSlot[];
+export declare function resolveMaterialSlot(scene: Scene, binding: Readonly<MaterialBindingRecord>, readOriginal?: (mesh: AbstractMesh) => Material | null): MaterialSlot;
+//# sourceMappingURL=material-slots.d.ts.map

package/dist/systems/material-slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-slots.d.ts","sourceRoot":"","sources":["../../src/systems/material-slots.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;gBACtC,UAAU,EAAE,kBAAkB;CAK3C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;CAC7C;AAcD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,MAAM,EAChB,YAAY,GAAE,CAAC,IAAI,EAAE,YAAY,KAAK,QAAQ,GAAG,IAClC,GACd,SAAS,YAAY,EAAE,CA4BzB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,QAAQ,CAAC,qBAAqB,CAAC,EACxC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,QAAQ,GAAG,IAAI,GACrD,YAAY,CAwCd"}

package/dist/systems/material-slots.js

@@ -0,0 +1,78 @@
+import { MultiMaterial } from "@babylonjs/core/Materials/multiMaterial";
+export class MaterialProjectionError extends Error {
+    diagnostic;
+    constructor(diagnostic) {
+        super(diagnostic.message);
+        this.name = "MaterialProjectionError";
+        this.diagnostic = Object.freeze({ ...diagnostic });
+    }
+}
+/** Stops at the closest declared entity so parents cannot claim child entities. */
+function entityOf(mesh) {
+    let node = mesh;
+    while (node) {
+        const id = node.metadata
+            ?.skenora?.entityId;
+        if (typeof id === "string")
+            return id;
+        node = node.parent;
+    }
+    return null;
+}
+export function listMaterialSlots(scene, entityId, readOriginal = (mesh) => mesh.material) {
+    return scene.meshes.flatMap((mesh) => {
+        if (mesh.isDisposed() ||
+            mesh.getTotalVertices() === 0 ||
+            entityOf(mesh) !== entityId)
+            return [];
+        const original = readOriginal(mesh);
+        const sourceNodeId = mesh.metadata?.skenora?.sourceNodeId;
+        const nodeId = typeof sourceNodeId === "string" ? sourceNodeId : mesh.id;
+        const materials = original instanceof MultiMaterial ? original.subMaterials : [original];
+        return materials.map((material, slot) => ({
+            mesh,
+            slot,
+            original,
+            material,
+            descriptor: {
+                entityId,
+                nodeId,
+                slot,
+                materialName: material?.name ?? null,
+            },
+        }));
+    });
+}
+export function resolveMaterialSlot(scene, binding, readOriginal) {
+    const matches = listMaterialSlots(scene, binding.entityId, readOriginal).filter(({ descriptor }) => (binding.target?.nodeId === undefined ||
+        descriptor.nodeId === binding.target.nodeId) &&
+        (binding.target?.slot === undefined ||
+            descriptor.slot === binding.target.slot));
+    if (matches.length !== 1) {
+        throw new MaterialProjectionError({
+            stage: "binding",
+            code: matches.length
+                ? "ambiguous-material-slot"
+                : "missing-material-slot",
+            materialId: binding.materialId,
+            bindingId: binding.id,
+            message: matches.length
+                ? "More than one material slot matches; specify the source node ID and slot."
+                : "No material slot matches this entity and selector; inspect the current asset slots.",
+        });
+    }
+    if (matches[0].mesh.getClassName() === "LinesMesh" ||
+        matches[0].mesh.isAnInstance) {
+        throw new MaterialProjectionError({
+            stage: "binding",
+            code: "unsupported-material-target",
+            materialId: binding.materialId,
+            bindingId: binding.id,
+            message: matches[0].mesh.isAnInstance
+                ? "This instance borrows its source mesh material. Select a directly owned mesh slot or supply a non-instanced asset."
+                : "Line geometry does not accept authored PBR surfaces. Select a filled surface or use a tube.",
+        });
+    }
+    return matches[0];
+}
+//# sourceMappingURL=material-slots.js.map

package/dist/systems/material-slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-slots.js","sourceRoot":"","sources":["../../src/systems/material-slots.ts"],"names":[],"mappings":"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"}

package/dist/systems/owned-material-controller.d.ts

@@ -0,0 +1,20 @@
+import { PBRMaterial } from "@babylonjs/core/Materials/PBR/pbrMaterial";
+import type { Material } from "@babylonjs/core/Materials/material";
+import type { AbstractMesh } from "@babylonjs/core/Meshes/abstractMesh";
+import type { Scene } from "@babylonjs/core/scene";
+import { type MaterialExecutionPolicy, type MaterialPreparationEvent, type SceneDocumentData, type MaterialSurfaceEffects, type MaterialEffectRuntimeProperty, type GpuProgramPreparationReport } from "@skenora/contracts";
+import type { ResourceResolver } from "@skenora/resources";
+import { GpuProgramCache } from "./gpu-program-cache.js";
+/** Owns only explicitly authored instances; imported resources are borrowed. */
+export declare class OwnedMaterialController {
+    #private;
+    constructor(scene: Scene, resources: ResourceResolver, policy?: MaterialExecutionPolicy, onPreparation?: (event: MaterialPreparationEvent) => void, programCache?: GpuProgramCache, onGpuProgramPreparation?: (event: GpuProgramPreparationReport) => void);
+    /** Null means legacy/unknown; an empty array means an unbound owned definition. */
+    get(materialId: string): readonly PBRMaterial[] | null;
+    captureEffects(material: PBRMaterial): MaterialSurfaceEffects | undefined;
+    setEffectProperty(materialId: string, property: MaterialEffectRuntimeProperty, value: unknown): void;
+    readOriginal: (mesh: AbstractMesh) => Material | null;
+    apply(document: Readonly<SceneDocumentData>, isCurrent: () => boolean): Promise<void>;
+    dispose(): void;
+}
+//# sourceMappingURL=owned-material-controller.d.ts.map

package/dist/systems/owned-material-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owned-material-controller.d.ts","sourceRoot":"","sources":["../../src/systems/owned-material-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAExE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAEnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAKL,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAI7B,KAAK,iBAAiB,EAEtB,KAAK,sBAAsB,EAE3B,KAAK,6BAA6B,EAIlC,KAAK,2BAA2B,EAEjC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,oBAAoB,CAAC;AAe1E,OAAO,EAAE,eAAe,EAA2B,MAAM,qBAAqB,CAAC;AAkC/E,gFAAgF;AAChF,qBAAa,uBAAuB;;gBAiBhC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,gBAAgB,EAC3B,MAAM,CAAC,EAAE,uBAAuB,EAChC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,EACzD,YAAY,CAAC,EAAE,eAAe,EAC9B,uBAAuB,CAAC,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,IAAI;IA6BxE,mFAAmF;IACnF,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,GAAG,IAAI;IAKtD,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,sBAAsB,GAAG,SAAS;IAIzE,iBAAiB,CACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,6BAA6B,EACvC,KAAK,EAAE,OAAO,GACb,IAAI;IA0CP,YAAY,GAAI,MAAM,YAAY,KAAG,QAAQ,GAAG,IAAI,CAKlD;IAEI,KAAK,CACT,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACrC,SAAS,EAAE,MAAM,OAAO,GACvB,OAAO,CAAC,IAAI,CAAC;IA6YhB,OAAO,IAAI,IAAI;CAoFhB"}