@babylonjs/serializers 9.12.1 → 9.14.0

package/glTF/2.0/Extensions/KHR_lights_punctual.js

@@ -1,145 +1,8 @@
-import { Vector3, Quaternion, TmpVectors } from "@babylonjs/core/Maths/math.vector.js";
-import { Light } from "@babylonjs/core/Lights/light.js";
-import { ShadowLight } from "@babylonjs/core/Lights/shadowLight.js";
-import { GLTFExporter } from "../glTFExporter.js";
-import { Logger } from "@babylonjs/core/Misc/logger.js";
-import { ConvertToRightHandedPosition, OmitDefaultValues, CollapseChildIntoParent, IsChildCollapsible } from "../glTFUtilities.js";
-const NAME = "KHR_lights_punctual";
-const DEFAULTS = {
-    name: "",
-    color: [1, 1, 1],
-    intensity: 1,
-    range: Number.MAX_VALUE,
-};
-const SPOTDEFAULTS = {
-    innerConeAngle: 0,
-    outerConeAngle: Math.PI / 4.0,
-};
-const LIGHTDIRECTION = Vector3.Backward();
 /**
- * [Specification](https://github.com/KhronosGroup/glTF/blob/master/extensions/2.0/Khronos/KHR_lights_punctual/README.md)
+ * Re-exports the pure implementation and applies the runtime registration side effect.
+ * Import "./KHR_lights_punctual.pure" for tree-shakeable, side-effect-free usage.
  */
-// eslint-disable-next-line @typescript-eslint/naming-convention
-export class KHR_lights_punctual {
-    /**
-     * @internal
-     */
-    constructor(exporter) {
-        /** The name of this extension. */
-        this.name = NAME;
-        /** Defines whether this extension is enabled. */
-        this.enabled = true;
-        /** Defines whether this extension is required */
-        this.required = false;
-        this._exporter = exporter;
-    }
-    /** @internal */
-    dispose() {
-        this._lights = null;
-    }
-    /** @internal */
-    get wasUsed() {
-        return !!this._lights;
-    }
-    /** @internal */
-    onExporting() {
-        this._exporter._glTF.extensions[NAME] = this._lights;
-    }
-    /**
-     * Define this method to modify the default behavior when exporting a node
-     * @param context The context when exporting the node
-     * @param node glTF node
-     * @param babylonNode BabylonJS node
-     * @param nodeMap Node mapping of babylon node to glTF node index
-     * @param convertToRightHanded Flag to convert the values to right-handed
-     * @returns nullable INode promise
-     */
-    async postExportNodeAsync(context, node, babylonNode, nodeMap, convertToRightHanded) {
-        return await new Promise((resolve) => {
-            if (!(babylonNode instanceof Light)) {
-                resolve(node);
-                return;
-            }
-            const lightType = babylonNode.getTypeID() == Light.LIGHTTYPEID_POINTLIGHT
-                ? "point" /* KHRLightsPunctual_LightType.POINT */
-                : babylonNode.getTypeID() == Light.LIGHTTYPEID_DIRECTIONALLIGHT
-                    ? "directional" /* KHRLightsPunctual_LightType.DIRECTIONAL */
-                    : babylonNode.getTypeID() == Light.LIGHTTYPEID_SPOTLIGHT
-                        ? "spot" /* KHRLightsPunctual_LightType.SPOT */
-                        : null;
-            if (!lightType || !(babylonNode instanceof ShadowLight)) {
-                Logger.Warn(`${context}: Light ${babylonNode.name} is not supported in ${NAME}`);
-                resolve(node);
-                return;
-            }
-            if (babylonNode.falloffType !== Light.FALLOFF_GLTF) {
-                Logger.Warn(`${context}: Light falloff for ${babylonNode.name} does not match the ${NAME} specification!`);
-            }
-            // Set the node's translation and rotation here, since lights are not handled in exportNodeAsync
-            if (!babylonNode.position.equalsToFloats(0, 0, 0)) {
-                const translation = TmpVectors.Vector3[0].copyFrom(babylonNode.position);
-                if (convertToRightHanded) {
-                    ConvertToRightHandedPosition(translation);
-                }
-                node.translation = translation.asArray();
-            }
-            // Represent the Babylon light's direction as a quaternion
-            // relative to glTF lights' forward direction, (0, 0, -1).
-            if (lightType !== "point" /* KHRLightsPunctual_LightType.POINT */) {
-                const direction = babylonNode.direction.normalizeToRef(TmpVectors.Vector3[0]);
-                if (convertToRightHanded) {
-                    ConvertToRightHandedPosition(direction);
-                }
-                const lightRotationQuaternion = Quaternion.FromUnitVectorsToRef(LIGHTDIRECTION, direction, TmpVectors.Quaternion[0]);
-                if (!Quaternion.IsIdentity(lightRotationQuaternion)) {
-                    node.rotation = lightRotationQuaternion.asArray();
-                }
-            }
-            const light = {
-                type: lightType,
-                name: babylonNode.name,
-                color: babylonNode.diffuse.asArray(),
-                intensity: babylonNode.intensity,
-                range: babylonNode.range,
-            };
-            OmitDefaultValues(light, DEFAULTS);
-            // Separately handle the required 'spot' field for spot lights
-            if (lightType === "spot" /* KHRLightsPunctual_LightType.SPOT */) {
-                const babylonSpotLight = babylonNode;
-                light.spot = {
-                    innerConeAngle: babylonSpotLight.innerAngle / 2.0,
-                    outerConeAngle: babylonSpotLight.angle / 2.0,
-                };
-                OmitDefaultValues(light.spot, SPOTDEFAULTS);
-            }
-            this._lights || (this._lights = {
-                lights: [],
-            });
-            this._lights.lights.push(light);
-            const lightReference = {
-                light: this._lights.lights.length - 1,
-            };
-            // Assign the light to its parent node, if possible, to condense the glTF
-            // Why and when: the glTF loader generates a new parent TransformNode for each light node, which we should undo on export
-            const parentBabylonNode = babylonNode.parent;
-            if (parentBabylonNode && IsChildCollapsible(babylonNode, parentBabylonNode)) {
-                const parentNodeIndex = nodeMap.get(parentBabylonNode);
-                if (parentNodeIndex) {
-                    // Combine the light's transformation with the parent's
-                    const parentNode = this._exporter._nodes[parentNodeIndex];
-                    CollapseChildIntoParent(node, parentNode);
-                    parentNode.extensions || (parentNode.extensions = {});
-                    parentNode.extensions[NAME] = lightReference;
-                    // Do not export the original node
-                    resolve(null);
-                    return;
-                }
-            }
-            node.extensions || (node.extensions = {});
-            node.extensions[NAME] = lightReference;
-            resolve(node);
-        });
-    }
-}
-GLTFExporter.RegisterExtension(NAME, (exporter) => new KHR_lights_punctual(exporter));
+export * from "./KHR_lights_punctual.pure.js";
+import { RegisterKHR_lights_punctual } from "./KHR_lights_punctual.pure.js";
+RegisterKHR_lights_punctual();
 //# sourceMappingURL=KHR_lights_punctual.js.map

package/glTF/2.0/Extensions/KHR_lights_punctual.js.map

@@ -1 +1 @@
-{"version":3,"file":"KHR_lights_punctual.js","sourceRoot":"","sources":["../../../../../../dev/serializers/src/glTF/2.0/Extensions/KHR_lights_punctual.ts"],"names":[],"mappings":"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","sourcesContent":["import { type SpotLight } from \"core/Lights/spotLight\";\r\nimport { type Nullable } from \"core/types\";\r\nimport { Vector3, Quaternion, TmpVectors } from \"core/Maths/math.vector\";\r\nimport { Light } from \"core/Lights/light\";\r\nimport { type Node } from \"core/node\";\r\nimport { ShadowLight } from \"core/Lights/shadowLight\";\r\nimport { type INode, type IKHRLightsPunctual_LightReference, type IKHRLightsPunctual_Light, type IKHRLightsPunctual, KHRLightsPunctual_LightType } from \"babylonjs-gltf2interface\";\r\nimport { type IGLTFExporterExtensionV2 } from \"../glTFExporterExtension\";\r\nimport { GLTFExporter } from \"../glTFExporter\";\r\nimport { Logger } from \"core/Misc/logger\";\r\nimport { ConvertToRightHandedPosition, OmitDefaultValues, CollapseChildIntoParent, IsChildCollapsible } from \"../glTFUtilities\";\r\n\r\nconst NAME = \"KHR_lights_punctual\";\r\nconst DEFAULTS: Omit<IKHRLightsPunctual_Light, \"type\"> = {\r\n    name: \"\",\r\n    color: [1, 1, 1],\r\n    intensity: 1,\r\n    range: Number.MAX_VALUE,\r\n};\r\nconst SPOTDEFAULTS: NonNullable<IKHRLightsPunctual_Light[\"spot\"]> = {\r\n    innerConeAngle: 0,\r\n    outerConeAngle: Math.PI / 4.0,\r\n};\r\nconst LIGHTDIRECTION = Vector3.Backward();\r\n\r\n/**\r\n * [Specification](https://github.com/KhronosGroup/glTF/blob/master/extensions/2.0/Khronos/KHR_lights_punctual/README.md)\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport class KHR_lights_punctual implements IGLTFExporterExtensionV2 {\r\n    /** The name of this extension. */\r\n    public readonly name = NAME;\r\n\r\n    /** Defines whether this extension is enabled. */\r\n    public enabled = true;\r\n\r\n    /** Defines whether this extension is required */\r\n    public required = false;\r\n\r\n    /** Reference to the glTF exporter */\r\n    private _exporter: GLTFExporter;\r\n\r\n    private _lights: IKHRLightsPunctual;\r\n\r\n    /**\r\n     * @internal\r\n     */\r\n    constructor(exporter: GLTFExporter) {\r\n        this._exporter = exporter;\r\n    }\r\n\r\n    /** @internal */\r\n    public dispose() {\r\n        (this._lights as any) = null;\r\n    }\r\n\r\n    /** @internal */\r\n    public get wasUsed() {\r\n        return !!this._lights;\r\n    }\r\n\r\n    /** @internal */\r\n    public onExporting(): void {\r\n        this._exporter._glTF.extensions![NAME] = this._lights;\r\n    }\r\n    /**\r\n     * Define this method to modify the default behavior when exporting a node\r\n     * @param context The context when exporting the node\r\n     * @param node glTF node\r\n     * @param babylonNode BabylonJS node\r\n     * @param nodeMap Node mapping of babylon node to glTF node index\r\n     * @param convertToRightHanded Flag to convert the values to right-handed\r\n     * @returns nullable INode promise\r\n     */\r\n    public async postExportNodeAsync(context: string, node: INode, babylonNode: Node, nodeMap: Map<Node, number>, convertToRightHanded: boolean): Promise<Nullable<INode>> {\r\n        return await new Promise((resolve) => {\r\n            if (!(babylonNode instanceof Light)) {\r\n                resolve(node);\r\n                return;\r\n            }\r\n\r\n            const lightType =\r\n                babylonNode.getTypeID() == Light.LIGHTTYPEID_POINTLIGHT\r\n                    ? KHRLightsPunctual_LightType.POINT\r\n                    : babylonNode.getTypeID() == Light.LIGHTTYPEID_DIRECTIONALLIGHT\r\n                      ? KHRLightsPunctual_LightType.DIRECTIONAL\r\n                      : babylonNode.getTypeID() == Light.LIGHTTYPEID_SPOTLIGHT\r\n                        ? KHRLightsPunctual_LightType.SPOT\r\n                        : null;\r\n            if (!lightType || !(babylonNode instanceof ShadowLight)) {\r\n                Logger.Warn(`${context}: Light ${babylonNode.name} is not supported in ${NAME}`);\r\n                resolve(node);\r\n                return;\r\n            }\r\n\r\n            if (babylonNode.falloffType !== Light.FALLOFF_GLTF) {\r\n                Logger.Warn(`${context}: Light falloff for ${babylonNode.name} does not match the ${NAME} specification!`);\r\n            }\r\n\r\n            // Set the node's translation and rotation here, since lights are not handled in exportNodeAsync\r\n            if (!babylonNode.position.equalsToFloats(0, 0, 0)) {\r\n                const translation = TmpVectors.Vector3[0].copyFrom(babylonNode.position);\r\n                if (convertToRightHanded) {\r\n                    ConvertToRightHandedPosition(translation);\r\n                }\r\n                node.translation = translation.asArray();\r\n            }\r\n\r\n            // Represent the Babylon light's direction as a quaternion\r\n            // relative to glTF lights' forward direction, (0, 0, -1).\r\n            if (lightType !== KHRLightsPunctual_LightType.POINT) {\r\n                const direction = babylonNode.direction.normalizeToRef(TmpVectors.Vector3[0]);\r\n                if (convertToRightHanded) {\r\n                    ConvertToRightHandedPosition(direction);\r\n                }\r\n\r\n                const lightRotationQuaternion = Quaternion.FromUnitVectorsToRef(LIGHTDIRECTION, direction, TmpVectors.Quaternion[0]);\r\n                if (!Quaternion.IsIdentity(lightRotationQuaternion)) {\r\n                    node.rotation = lightRotationQuaternion.asArray();\r\n                }\r\n            }\r\n\r\n            const light: IKHRLightsPunctual_Light = {\r\n                type: lightType,\r\n                name: babylonNode.name,\r\n                color: babylonNode.diffuse.asArray(),\r\n                intensity: babylonNode.intensity,\r\n                range: babylonNode.range,\r\n            };\r\n            OmitDefaultValues(light, DEFAULTS);\r\n\r\n            // Separately handle the required 'spot' field for spot lights\r\n            if (lightType === KHRLightsPunctual_LightType.SPOT) {\r\n                const babylonSpotLight = babylonNode as SpotLight;\r\n                light.spot = {\r\n                    innerConeAngle: babylonSpotLight.innerAngle / 2.0,\r\n                    outerConeAngle: babylonSpotLight.angle / 2.0,\r\n                };\r\n                OmitDefaultValues(light.spot, SPOTDEFAULTS);\r\n            }\r\n\r\n            this._lights ||= {\r\n                lights: [],\r\n            };\r\n            this._lights.lights.push(light);\r\n\r\n            const lightReference: IKHRLightsPunctual_LightReference = {\r\n                light: this._lights.lights.length - 1,\r\n            };\r\n\r\n            // Assign the light to its parent node, if possible, to condense the glTF\r\n            // Why and when: the glTF loader generates a new parent TransformNode for each light node, which we should undo on export\r\n            const parentBabylonNode = babylonNode.parent;\r\n\r\n            if (parentBabylonNode && IsChildCollapsible(babylonNode, parentBabylonNode)) {\r\n                const parentNodeIndex = nodeMap.get(parentBabylonNode);\r\n                if (parentNodeIndex) {\r\n                    // Combine the light's transformation with the parent's\r\n                    const parentNode = this._exporter._nodes[parentNodeIndex];\r\n                    CollapseChildIntoParent(node, parentNode);\r\n                    parentNode.extensions ||= {};\r\n                    parentNode.extensions[NAME] = lightReference;\r\n\r\n                    // Do not export the original node\r\n                    resolve(null);\r\n                    return;\r\n                }\r\n            }\r\n\r\n            node.extensions ||= {};\r\n            node.extensions[NAME] = lightReference;\r\n            resolve(node);\r\n        });\r\n    }\r\n}\r\n\r\nGLTFExporter.RegisterExtension(NAME, (exporter) => new KHR_lights_punctual(exporter));\r\n"]}
+{"version":3,"file":"KHR_lights_punctual.js","sourceRoot":"","sources":["../../../../../../dev/serializers/src/glTF/2.0/Extensions/KHR_lights_punctual.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,4BAA4B,CAAC;AAE3C,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,2BAA2B,EAAE,CAAC","sourcesContent":["/**\r\n * Re-exports the pure implementation and applies the runtime registration side effect.\r\n * Import \"./KHR_lights_punctual.pure\" for tree-shakeable, side-effect-free usage.\r\n */\r\nexport * from \"./KHR_lights_punctual.pure\";\r\n\r\nimport { RegisterKHR_lights_punctual } from \"./KHR_lights_punctual.pure\";\r\nRegisterKHR_lights_punctual();\r\n"]}

package/glTF/2.0/Extensions/KHR_lights_punctual.pure.d.ts

@@ -0,0 +1,44 @@
+import { type Nullable } from "@babylonjs/core/types.js";
+import { type Node } from "@babylonjs/core/node.js";
+import { type INode } from "babylonjs-gltf2interface";
+import { type IGLTFExporterExtensionV2 } from "../glTFExporterExtension.js";
+import { GLTFExporter } from "../glTFExporter.js";
+/**
+ * [Specification](https://github.com/KhronosGroup/glTF/blob/master/extensions/2.0/Khronos/KHR_lights_punctual/README.md)
+ */
+export declare class KHR_lights_punctual implements IGLTFExporterExtensionV2 {
+    /** The name of this extension. */
+    readonly name = "KHR_lights_punctual";
+    /** Defines whether this extension is enabled. */
+    enabled: boolean;
+    /** Defines whether this extension is required */
+    required: boolean;
+    /** Reference to the glTF exporter */
+    private _exporter;
+    private _lights;
+    /**
+     * @internal
+     */
+    constructor(exporter: GLTFExporter);
+    /** @internal */
+    dispose(): void;
+    /** @internal */
+    get wasUsed(): boolean;
+    /** @internal */
+    onExporting(): void;
+    /**
+     * Define this method to modify the default behavior when exporting a node
+     * @param context The context when exporting the node
+     * @param node glTF node
+     * @param babylonNode BabylonJS node
+     * @param nodeMap Node mapping of babylon node to glTF node index
+     * @param convertToRightHanded Flag to convert the values to right-handed
+     * @returns nullable INode promise
+     */
+    postExportNodeAsync(context: string, node: INode, babylonNode: Node, nodeMap: Map<Node, number>, convertToRightHanded: boolean): Promise<Nullable<INode>>;
+}
+/**
+ * Registers the KHR_lights_punctual glTF serializer extension with the {@link GLTFExporter}.
+ * Safe to call multiple times; only the first call has an effect.
+ */
+export declare function RegisterKHR_lights_punctual(): void;

package/glTF/2.0/Extensions/KHR_lights_punctual.pure.js

@@ -0,0 +1,157 @@
+import { Vector3, Quaternion, TmpVectors } from "@babylonjs/core/Maths/math.vector.pure.js";
+import { Light } from "@babylonjs/core/Lights/light.js";
+import { ShadowLight } from "@babylonjs/core/Lights/shadowLight.js";
+import { GLTFExporter } from "../glTFExporter.js";
+import { Logger } from "@babylonjs/core/Misc/logger.js";
+import { ConvertToRightHandedPosition, OmitDefaultValues, CollapseChildIntoParent, IsChildCollapsible } from "../glTFUtilities.js";
+const NAME = "KHR_lights_punctual";
+const DEFAULTS = {
+    name: "",
+    color: [1, 1, 1],
+    intensity: 1,
+    range: Number.MAX_VALUE,
+};
+const SPOTDEFAULTS = {
+    innerConeAngle: 0,
+    outerConeAngle: Math.PI / 4.0,
+};
+const LIGHTDIRECTION = /*#__PURE__*/ Vector3.Backward();
+/**
+ * [Specification](https://github.com/KhronosGroup/glTF/blob/master/extensions/2.0/Khronos/KHR_lights_punctual/README.md)
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+export class KHR_lights_punctual {
+    /**
+     * @internal
+     */
+    constructor(exporter) {
+        /** The name of this extension. */
+        this.name = NAME;
+        /** Defines whether this extension is enabled. */
+        this.enabled = true;
+        /** Defines whether this extension is required */
+        this.required = false;
+        this._exporter = exporter;
+    }
+    /** @internal */
+    dispose() {
+        this._lights = null;
+    }
+    /** @internal */
+    get wasUsed() {
+        return !!this._lights;
+    }
+    /** @internal */
+    onExporting() {
+        this._exporter._glTF.extensions[NAME] = this._lights;
+    }
+    /**
+     * Define this method to modify the default behavior when exporting a node
+     * @param context The context when exporting the node
+     * @param node glTF node
+     * @param babylonNode BabylonJS node
+     * @param nodeMap Node mapping of babylon node to glTF node index
+     * @param convertToRightHanded Flag to convert the values to right-handed
+     * @returns nullable INode promise
+     */
+    async postExportNodeAsync(context, node, babylonNode, nodeMap, convertToRightHanded) {
+        return await new Promise((resolve) => {
+            if (!(babylonNode instanceof Light)) {
+                resolve(node);
+                return;
+            }
+            const lightType = babylonNode.getTypeID() == Light.LIGHTTYPEID_POINTLIGHT
+                ? "point" /* KHRLightsPunctual_LightType.POINT */
+                : babylonNode.getTypeID() == Light.LIGHTTYPEID_DIRECTIONALLIGHT
+                    ? "directional" /* KHRLightsPunctual_LightType.DIRECTIONAL */
+                    : babylonNode.getTypeID() == Light.LIGHTTYPEID_SPOTLIGHT
+                        ? "spot" /* KHRLightsPunctual_LightType.SPOT */
+                        : null;
+            if (!lightType || !(babylonNode instanceof ShadowLight)) {
+                Logger.Warn(`${context}: Light ${babylonNode.name} is not supported in ${NAME}`);
+                resolve(node);
+                return;
+            }
+            if (babylonNode.falloffType !== Light.FALLOFF_GLTF) {
+                Logger.Warn(`${context}: Light falloff for ${babylonNode.name} does not match the ${NAME} specification!`);
+            }
+            // Set the node's translation and rotation here, since lights are not handled in exportNodeAsync
+            if (!babylonNode.position.equalsToFloats(0, 0, 0)) {
+                const translation = TmpVectors.Vector3[0].copyFrom(babylonNode.position);
+                if (convertToRightHanded) {
+                    ConvertToRightHandedPosition(translation);
+                }
+                node.translation = translation.asArray();
+            }
+            // Represent the Babylon light's direction as a quaternion
+            // relative to glTF lights' forward direction, (0, 0, -1).
+            if (lightType !== "point" /* KHRLightsPunctual_LightType.POINT */) {
+                const direction = babylonNode.direction.normalizeToRef(TmpVectors.Vector3[0]);
+                if (convertToRightHanded) {
+                    ConvertToRightHandedPosition(direction);
+                }
+                const lightRotationQuaternion = Quaternion.FromUnitVectorsToRef(LIGHTDIRECTION, direction, TmpVectors.Quaternion[0]);
+                if (!Quaternion.IsIdentity(lightRotationQuaternion)) {
+                    node.rotation = lightRotationQuaternion.asArray();
+                }
+            }
+            const light = {
+                type: lightType,
+                name: babylonNode.name,
+                color: babylonNode.diffuse.asArray(),
+                intensity: babylonNode.intensity,
+                range: babylonNode.range,
+            };
+            OmitDefaultValues(light, DEFAULTS);
+            // Separately handle the required 'spot' field for spot lights
+            if (lightType === "spot" /* KHRLightsPunctual_LightType.SPOT */) {
+                const babylonSpotLight = babylonNode;
+                light.spot = {
+                    innerConeAngle: babylonSpotLight.innerAngle / 2.0,
+                    outerConeAngle: babylonSpotLight.angle / 2.0,
+                };
+                OmitDefaultValues(light.spot, SPOTDEFAULTS);
+            }
+            this._lights || (this._lights = {
+                lights: [],
+            });
+            this._lights.lights.push(light);
+            const lightReference = {
+                light: this._lights.lights.length - 1,
+            };
+            // Assign the light to its parent node, if possible, to condense the glTF
+            // Why and when: the glTF loader generates a new parent TransformNode for each light node, which we should undo on export
+            const parentBabylonNode = babylonNode.parent;
+            if (parentBabylonNode && IsChildCollapsible(babylonNode, parentBabylonNode)) {
+                const parentNodeIndex = nodeMap.get(parentBabylonNode);
+                if (parentNodeIndex) {
+                    // Combine the light's transformation with the parent's
+                    const parentNode = this._exporter._nodes[parentNodeIndex];
+                    CollapseChildIntoParent(node, parentNode);
+                    parentNode.extensions || (parentNode.extensions = {});
+                    parentNode.extensions[NAME] = lightReference;
+                    // Do not export the original node
+                    resolve(null);
+                    return;
+                }
+            }
+            node.extensions || (node.extensions = {});
+            node.extensions[NAME] = lightReference;
+            resolve(node);
+        });
+    }
+}
+let _Registered = false;
+/**
+ * Registers the KHR_lights_punctual glTF serializer extension with the {@link GLTFExporter}.
+ * Safe to call multiple times; only the first call has an effect.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+export function RegisterKHR_lights_punctual() {
+    if (_Registered) {
+        return;
+    }
+    _Registered = true;
+    GLTFExporter.RegisterExtension(NAME, (exporter) => new KHR_lights_punctual(exporter));
+}
+//# sourceMappingURL=KHR_lights_punctual.pure.js.map

package/glTF/2.0/Extensions/KHR_lights_punctual.pure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KHR_lights_punctual.pure.js","sourceRoot":"","sources":["../../../../../../dev/serializers/src/glTF/2.0/Extensions/KHR_lights_punctual.pure.ts"],"names":[],"mappings":"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","sourcesContent":["import { type SpotLight } from \"core/Lights/spotLight\";\r\nimport { type Nullable } from \"core/types\";\r\nimport { Vector3, Quaternion, TmpVectors } from \"core/Maths/math.vector.pure\";\r\nimport { Light } from \"core/Lights/light\";\r\nimport { type Node } from \"core/node\";\r\nimport { ShadowLight } from \"core/Lights/shadowLight\";\r\nimport { type INode, type IKHRLightsPunctual_LightReference, type IKHRLightsPunctual_Light, type IKHRLightsPunctual, KHRLightsPunctual_LightType } from \"babylonjs-gltf2interface\";\r\nimport { type IGLTFExporterExtensionV2 } from \"../glTFExporterExtension\";\r\nimport { GLTFExporter } from \"../glTFExporter\";\r\nimport { Logger } from \"core/Misc/logger\";\r\nimport { ConvertToRightHandedPosition, OmitDefaultValues, CollapseChildIntoParent, IsChildCollapsible } from \"../glTFUtilities\";\r\n\r\nconst NAME = \"KHR_lights_punctual\";\r\nconst DEFAULTS: Omit<IKHRLightsPunctual_Light, \"type\"> = {\r\n    name: \"\",\r\n    color: [1, 1, 1],\r\n    intensity: 1,\r\n    range: Number.MAX_VALUE,\r\n};\r\nconst SPOTDEFAULTS: NonNullable<IKHRLightsPunctual_Light[\"spot\"]> = {\r\n    innerConeAngle: 0,\r\n    outerConeAngle: Math.PI / 4.0,\r\n};\r\nconst LIGHTDIRECTION = /*#__PURE__*/ Vector3.Backward();\r\n\r\n/**\r\n * [Specification](https://github.com/KhronosGroup/glTF/blob/master/extensions/2.0/Khronos/KHR_lights_punctual/README.md)\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport class KHR_lights_punctual implements IGLTFExporterExtensionV2 {\r\n    /** The name of this extension. */\r\n    public readonly name = NAME;\r\n\r\n    /** Defines whether this extension is enabled. */\r\n    public enabled = true;\r\n\r\n    /** Defines whether this extension is required */\r\n    public required = false;\r\n\r\n    /** Reference to the glTF exporter */\r\n    private _exporter: GLTFExporter;\r\n\r\n    private _lights: IKHRLightsPunctual;\r\n\r\n    /**\r\n     * @internal\r\n     */\r\n    constructor(exporter: GLTFExporter) {\r\n        this._exporter = exporter;\r\n    }\r\n\r\n    /** @internal */\r\n    public dispose() {\r\n        (this._lights as any) = null;\r\n    }\r\n\r\n    /** @internal */\r\n    public get wasUsed() {\r\n        return !!this._lights;\r\n    }\r\n\r\n    /** @internal */\r\n    public onExporting(): void {\r\n        this._exporter._glTF.extensions![NAME] = this._lights;\r\n    }\r\n    /**\r\n     * Define this method to modify the default behavior when exporting a node\r\n     * @param context The context when exporting the node\r\n     * @param node glTF node\r\n     * @param babylonNode BabylonJS node\r\n     * @param nodeMap Node mapping of babylon node to glTF node index\r\n     * @param convertToRightHanded Flag to convert the values to right-handed\r\n     * @returns nullable INode promise\r\n     */\r\n    public async postExportNodeAsync(context: string, node: INode, babylonNode: Node, nodeMap: Map<Node, number>, convertToRightHanded: boolean): Promise<Nullable<INode>> {\r\n        return await new Promise((resolve) => {\r\n            if (!(babylonNode instanceof Light)) {\r\n                resolve(node);\r\n                return;\r\n            }\r\n\r\n            const lightType =\r\n                babylonNode.getTypeID() == Light.LIGHTTYPEID_POINTLIGHT\r\n                    ? KHRLightsPunctual_LightType.POINT\r\n                    : babylonNode.getTypeID() == Light.LIGHTTYPEID_DIRECTIONALLIGHT\r\n                      ? KHRLightsPunctual_LightType.DIRECTIONAL\r\n                      : babylonNode.getTypeID() == Light.LIGHTTYPEID_SPOTLIGHT\r\n                        ? KHRLightsPunctual_LightType.SPOT\r\n                        : null;\r\n            if (!lightType || !(babylonNode instanceof ShadowLight)) {\r\n                Logger.Warn(`${context}: Light ${babylonNode.name} is not supported in ${NAME}`);\r\n                resolve(node);\r\n                return;\r\n            }\r\n\r\n            if (babylonNode.falloffType !== Light.FALLOFF_GLTF) {\r\n                Logger.Warn(`${context}: Light falloff for ${babylonNode.name} does not match the ${NAME} specification!`);\r\n            }\r\n\r\n            // Set the node's translation and rotation here, since lights are not handled in exportNodeAsync\r\n            if (!babylonNode.position.equalsToFloats(0, 0, 0)) {\r\n                const translation = TmpVectors.Vector3[0].copyFrom(babylonNode.position);\r\n                if (convertToRightHanded) {\r\n                    ConvertToRightHandedPosition(translation);\r\n                }\r\n                node.translation = translation.asArray();\r\n            }\r\n\r\n            // Represent the Babylon light's direction as a quaternion\r\n            // relative to glTF lights' forward direction, (0, 0, -1).\r\n            if (lightType !== KHRLightsPunctual_LightType.POINT) {\r\n                const direction = babylonNode.direction.normalizeToRef(TmpVectors.Vector3[0]);\r\n                if (convertToRightHanded) {\r\n                    ConvertToRightHandedPosition(direction);\r\n                }\r\n\r\n                const lightRotationQuaternion = Quaternion.FromUnitVectorsToRef(LIGHTDIRECTION, direction, TmpVectors.Quaternion[0]);\r\n                if (!Quaternion.IsIdentity(lightRotationQuaternion)) {\r\n                    node.rotation = lightRotationQuaternion.asArray();\r\n                }\r\n            }\r\n\r\n            const light: IKHRLightsPunctual_Light = {\r\n                type: lightType,\r\n                name: babylonNode.name,\r\n                color: babylonNode.diffuse.asArray(),\r\n                intensity: babylonNode.intensity,\r\n                range: babylonNode.range,\r\n            };\r\n            OmitDefaultValues(light, DEFAULTS);\r\n\r\n            // Separately handle the required 'spot' field for spot lights\r\n            if (lightType === KHRLightsPunctual_LightType.SPOT) {\r\n                const babylonSpotLight = babylonNode as SpotLight;\r\n                light.spot = {\r\n                    innerConeAngle: babylonSpotLight.innerAngle / 2.0,\r\n                    outerConeAngle: babylonSpotLight.angle / 2.0,\r\n                };\r\n                OmitDefaultValues(light.spot, SPOTDEFAULTS);\r\n            }\r\n\r\n            this._lights ||= {\r\n                lights: [],\r\n            };\r\n            this._lights.lights.push(light);\r\n\r\n            const lightReference: IKHRLightsPunctual_LightReference = {\r\n                light: this._lights.lights.length - 1,\r\n            };\r\n\r\n            // Assign the light to its parent node, if possible, to condense the glTF\r\n            // Why and when: the glTF loader generates a new parent TransformNode for each light node, which we should undo on export\r\n            const parentBabylonNode = babylonNode.parent;\r\n\r\n            if (parentBabylonNode && IsChildCollapsible(babylonNode, parentBabylonNode)) {\r\n                const parentNodeIndex = nodeMap.get(parentBabylonNode);\r\n                if (parentNodeIndex) {\r\n                    // Combine the light's transformation with the parent's\r\n                    const parentNode = this._exporter._nodes[parentNodeIndex];\r\n                    CollapseChildIntoParent(node, parentNode);\r\n                    parentNode.extensions ||= {};\r\n                    parentNode.extensions[NAME] = lightReference;\r\n\r\n                    // Do not export the original node\r\n                    resolve(null);\r\n                    return;\r\n                }\r\n            }\r\n\r\n            node.extensions ||= {};\r\n            node.extensions[NAME] = lightReference;\r\n            resolve(node);\r\n        });\r\n    }\r\n}\r\n\r\nlet _Registered = false;\r\n/**\r\n * Registers the KHR_lights_punctual glTF serializer extension with the {@link GLTFExporter}.\r\n * Safe to call multiple times; only the first call has an effect.\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport function RegisterKHR_lights_punctual(): void {\r\n    if (_Registered) {\r\n        return;\r\n    }\r\n    _Registered = true;\r\n\r\n    GLTFExporter.RegisterExtension(NAME, (exporter) => new KHR_lights_punctual(exporter));\r\n}\r\n"]}

package/glTF/2.0/Extensions/KHR_materials_anisotropy.d.ts

@@ -1,32 +1,5 @@
-import { type IMaterial } from "babylonjs-gltf2interface";
-import { type IGLTFExporterExtensionV2 } from "../glTFExporterExtension.js";
-import { GLTFExporter } from "../glTFExporter.js";
-import { type Material } from "@babylonjs/core/Materials/material.js";
-import { type BaseTexture } from "@babylonjs/core/Materials/Textures/baseTexture.js";
 /**
- * @internal
+ * Re-exports the pure implementation and applies the runtime registration side effect.
+ * Import "./KHR_materials_anisotropy.pure" for tree-shakeable, side-effect-free usage.
  */
-export declare class KHR_materials_anisotropy implements IGLTFExporterExtensionV2 {
-    /** Name of this extension */
-    readonly name = "KHR_materials_anisotropy";
-    /** Defines whether this extension is enabled */
-    enabled: boolean;
-    /** Defines whether this extension is required */
-    required: boolean;
-    private _exporter;
-    private _wasUsed;
-    private _anisoTexturesMap;
-    constructor(exporter: GLTFExporter);
-    dispose(): void;
-    /** @internal */
-    get wasUsed(): boolean;
-    /**
-     * After exporting a material, deal with the additional textures
-     * @param context GLTF context of the material
-     * @param node exported GLTF node
-     * @param babylonMaterial corresponding babylon material
-     * @returns array of additional textures to export
-     */
-    postExportMaterialAdditionalTexturesAsync?(context: string, node: IMaterial, babylonMaterial: Material): Promise<BaseTexture[]>;
-    postExportMaterialAsync?(context: string, node: IMaterial, babylonMaterial: Material): Promise<IMaterial>;
-}
+export * from "./KHR_materials_anisotropy.pure.js";

package/glTF/2.0/Extensions/KHR_materials_anisotropy.js

@@ -1,180 +1,8 @@
-import { GLTFExporter } from "../glTFExporter.js";
-import { PBRBaseMaterial } from "@babylonjs/core/Materials/PBR/pbrBaseMaterial.js";
-import { OpenPBRMaterial } from "@babylonjs/core/Materials/PBR/openpbrMaterial.js";
-import { MergeTexturesAsync, CreateRGBAConfiguration, CreateTextureInput, CreateConstantInput } from "@babylonjs/core/Materials/Textures/textureMerger.js";
-const NAME = "KHR_materials_anisotropy";
-// Convert OpenPBR anisotropy values to glTF-compatible values
-function OpenpbrAnisotropyStrengthToGltf(baseRoughness, anisotropy) {
-    const baseAlpha = baseRoughness * baseRoughness;
-    const roughnessT = baseAlpha * Math.sqrt(2.0 / (1.0 + (1 - anisotropy) * (1 - anisotropy)));
-    const roughnessB = (1 - anisotropy) * roughnessT;
-    const newBaseRoughness = Math.sqrt(roughnessB);
-    const newAnisotropyStrength = Math.min(Math.sqrt((roughnessT - baseAlpha) / Math.max(1.0 - baseAlpha, 0.0001)), 1.0);
-    return { newBaseRoughness, newAnisotropyStrength };
-}
 /**
- * Generate a unique ID for the merged anisotropy textures based on the internal texture data.
- * This is used for caching merged textures.
- * @param babylonMaterial Source OpenPBR material
- * @returns A unique ID string for the merged anisotropy textures
- * @internal
+ * Re-exports the pure implementation and applies the runtime registration side effect.
+ * Import "./KHR_materials_anisotropy.pure" for tree-shakeable, side-effect-free usage.
  */
-function GetAnisoTextureId(babylonMaterial) {
-    const anisoStrengthTexture = babylonMaterial.specularRoughnessAnisotropyTexture;
-    const tangentTexture = babylonMaterial.geometryTangentTexture;
-    const strengthId = anisoStrengthTexture && anisoStrengthTexture.getInternalTexture() ? anisoStrengthTexture.getInternalTexture().uniqueId : "NoStrength";
-    const tangentId = tangentTexture && tangentTexture.getInternalTexture() ? tangentTexture.getInternalTexture().uniqueId : "NoTangent";
-    return `${strengthId}_${tangentId}`;
-}
-// In your postExportMaterialAsync method:
-async function CreateMergedAnisotropyTexture(babylonMaterial) {
-    const scene = babylonMaterial.getScene();
-    const anisoStrengthTexture = babylonMaterial.specularRoughnessAnisotropyTexture;
-    const tangentTexture = babylonMaterial.geometryTangentTexture;
-    // If we don't have any textures, we don't need to generate anything.
-    if (!(anisoStrengthTexture || tangentTexture)) {
-        return null;
-    }
-    return await MergeTexturesAsync("AnisotropyTexture", CreateRGBAConfiguration(tangentTexture ? CreateTextureInput(tangentTexture, 0) : CreateConstantInput(1.0), // tangent x from red channel
-    tangentTexture ? CreateTextureInput(tangentTexture, 1) : CreateConstantInput(0.0), // tangent y from green channel
-    anisoStrengthTexture ? CreateTextureInput(anisoStrengthTexture, 0) : CreateConstantInput(1.0) // Anisotropy from red channel
-    ), scene);
-}
-/**
- * @internal
- */
-// eslint-disable-next-line @typescript-eslint/naming-convention
-export class KHR_materials_anisotropy {
-    constructor(exporter) {
-        /** Name of this extension */
-        this.name = NAME;
-        /** Defines whether this extension is enabled */
-        this.enabled = true;
-        /** Defines whether this extension is required */
-        this.required = false;
-        this._wasUsed = false;
-        this._anisoTexturesMap = {};
-        this._exporter = exporter;
-    }
-    dispose() { }
-    /** @internal */
-    get wasUsed() {
-        return this._wasUsed;
-    }
-    /**
-     * After exporting a material, deal with the additional textures
-     * @param context GLTF context of the material
-     * @param node exported GLTF node
-     * @param babylonMaterial corresponding babylon material
-     * @returns array of additional textures to export
-     */
-    async postExportMaterialAdditionalTexturesAsync(context, node, babylonMaterial) {
-        const additionalTextures = [];
-        if (babylonMaterial instanceof PBRBaseMaterial) {
-            if (babylonMaterial.anisotropy.isEnabled && !babylonMaterial.anisotropy.legacy) {
-                if (babylonMaterial.anisotropy.texture) {
-                    additionalTextures.push(babylonMaterial.anisotropy.texture);
-                }
-                return additionalTextures;
-            }
-        }
-        else if (babylonMaterial instanceof OpenPBRMaterial) {
-            if (babylonMaterial.specularRoughnessAnisotropy > 0) {
-                const texId = GetAnisoTextureId(babylonMaterial);
-                if (this._anisoTexturesMap[texId]) {
-                    additionalTextures.push(this._anisoTexturesMap[texId]);
-                }
-                else {
-                    const anisoTexture = await CreateMergedAnisotropyTexture(babylonMaterial);
-                    if (anisoTexture) {
-                        additionalTextures.push(anisoTexture);
-                        this._anisoTexturesMap[texId] = anisoTexture;
-                    }
-                }
-                return additionalTextures;
-            }
-        }
-        return [];
-    }
-    // eslint-disable-next-line no-restricted-syntax
-    postExportMaterialAsync(context, node, babylonMaterial) {
-        return new Promise((resolve) => {
-            var _a;
-            if (babylonMaterial instanceof PBRBaseMaterial) {
-                if (!babylonMaterial.anisotropy.isEnabled || babylonMaterial.anisotropy.legacy) {
-                    resolve(node);
-                    return;
-                }
-                this._wasUsed = true;
-                node.extensions = node.extensions || {};
-                const anisotropyTextureInfo = this._exporter._materialExporter.getTextureInfo(babylonMaterial.anisotropy.texture);
-                const anisotropyInfo = {
-                    anisotropyStrength: babylonMaterial.anisotropy.intensity,
-                    anisotropyRotation: babylonMaterial.anisotropy.angle,
-                    anisotropyTexture: anisotropyTextureInfo ?? undefined,
-                };
-                if (anisotropyInfo.anisotropyTexture !== null) {
-                    this._exporter._materialNeedsUVsSet.add(babylonMaterial);
-                }
-                node.extensions[NAME] = anisotropyInfo;
-            }
-            else if (babylonMaterial instanceof OpenPBRMaterial) {
-                if (babylonMaterial.specularRoughnessAnisotropy > 0) {
-                    this._wasUsed = true;
-                    node.extensions = node.extensions || {};
-                    // Check if we can convert from OpenPBR anisotropy to glTF anisotropy
-                    // Conversion involves both specular roughness and anisotropic roughness changes so,
-                    // if there are textures for either, we can't reliably convert due to there potentially
-                    // being different mappings between the textures.
-                    let roughnessTexture = babylonMaterial.specularRoughnessTexture;
-                    if (babylonMaterial._useRoughnessFromMetallicTextureGreen) {
-                        roughnessTexture = babylonMaterial.baseMetalnessTexture;
-                    }
-                    const mergedAnisoTexture = this._anisoTexturesMap[babylonMaterial.id];
-                    // If no textures are being used, we'll always output glTF-style anisotropy.
-                    // If using OpenPBR anisotropy, convert the constants. Otherwise, just export what we have.
-                    if (!roughnessTexture && !mergedAnisoTexture) {
-                        // Convert constants
-                        let newBaseRoughness = babylonMaterial.specularRoughness;
-                        let newAnisotropyStrength = babylonMaterial.specularRoughnessAnisotropy;
-                        if (!babylonMaterial._useGltfStyleAnisotropy) {
-                            const newParams = OpenpbrAnisotropyStrengthToGltf(babylonMaterial.specularRoughness, babylonMaterial.specularRoughnessAnisotropy);
-                            newBaseRoughness = newParams.newBaseRoughness;
-                            newAnisotropyStrength = newParams.newAnisotropyStrength;
-                        }
-                        if (node.pbrMetallicRoughness) {
-                            node.pbrMetallicRoughness.roughnessFactor = newBaseRoughness;
-                        }
-                        const anisotropyInfo = {
-                            anisotropyStrength: newAnisotropyStrength,
-                            anisotropyRotation: babylonMaterial.geometryTangentAngle + Math.PI * 0.5,
-                            anisotropyTexture: undefined,
-                        };
-                        node.extensions[NAME] = anisotropyInfo;
-                        return resolve(node);
-                    }
-                    const mergedAnisoTextureInfo = mergedAnisoTexture ? this._exporter._materialExporter.getTextureInfo(mergedAnisoTexture) : null;
-                    const anisotropyInfo = {
-                        anisotropyStrength: babylonMaterial.specularRoughnessAnisotropy,
-                        anisotropyRotation: babylonMaterial.geometryTangentAngle,
-                        anisotropyTexture: mergedAnisoTextureInfo ? mergedAnisoTextureInfo : undefined,
-                        extensions: {},
-                    };
-                    if (!babylonMaterial._useGltfStyleAnisotropy) {
-                        // Enable OpenPBR extension on this material.
-                        node.extensions["KHR_materials_openpbr"] = {};
-                        (_a = this._exporter._glTF).extensionsUsed || (_a.extensionsUsed = []);
-                        if (this._exporter._glTF.extensionsUsed.indexOf("KHR_materials_openpbr") === -1) {
-                            this._exporter._glTF.extensionsUsed.push("KHR_materials_openpbr");
-                        }
-                    }
-                    this._exporter._materialNeedsUVsSet.add(babylonMaterial);
-                    node.extensions[NAME] = anisotropyInfo;
-                }
-            }
-            resolve(node);
-        });
-    }
-}
-GLTFExporter.RegisterExtension(NAME, (exporter) => new KHR_materials_anisotropy(exporter));
+export * from "./KHR_materials_anisotropy.pure.js";
+import { RegisterKHR_materials_anisotropy } from "./KHR_materials_anisotropy.pure.js";
+RegisterKHR_materials_anisotropy();
 //# sourceMappingURL=KHR_materials_anisotropy.js.map