@onerjs/serializers 8.41.6 → 8.41.8

package/3MF/3mfSerializer.configuration.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Class used to store configuration of the 3MF Serializer
+ */
+export declare class ThreeMfSerializerGlobalConfiguration {
+    /**
+     * Url to use to load the fflate library (for zip compression)
+     */
+    static FFLATEUrl: string;
+}

package/3MF/3mfSerializer.configuration.js

@@ -0,0 +1,11 @@
+/**
+ * Class used to store configuration of the 3MF Serializer
+ */
+export class ThreeMfSerializerGlobalConfiguration {
+}
+/**
+ * Url to use to load the fflate library (for zip compression)
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+ThreeMfSerializerGlobalConfiguration.FFLATEUrl = "https://unpkg.com/fflate@0.8.2";
+//# sourceMappingURL=3mfSerializer.configuration.js.map

package/3MF/3mfSerializer.configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"3mfSerializer.configuration.js","sourceRoot":"","sources":["../../../../dev/serializers/src/3MF/3mfSerializer.configuration.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,oCAAoC;;AAC7C;;GAEG;AACH,gEAAgE;AAClD,8CAAS,GAAG,gCAAgC,CAAC","sourcesContent":["/**\r\n * Class used to store configuration of the 3MF Serializer\r\n */\r\nexport class ThreeMfSerializerGlobalConfiguration {\r\n    /**\r\n     * Url to use to load the fflate library (for zip compression)\r\n     */\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    public static FFLATEUrl = \"https://unpkg.com/fflate@0.8.2\";\r\n}\r\n"]}

package/3MF/3mfSerializer.d.ts

@@ -0,0 +1,132 @@
+import { Mesh } from "@onerjs/core/Meshes/mesh.js";
+import { InstancedMesh } from "@onerjs/core/Meshes/instancedMesh.js";
+import { type ThreeMfModelBuilder } from "./core/model/3mf.builder.js";
+import { type I3mfModel } from "./core/model/3mf.interfaces.js";
+import { AbstractThreeMfSerializer, type IThreeMfSerializerOptions } from "./core/model/3mf.serializer.js";
+/**
+ * Options controlling how meshes are exported into the 3MF model.
+ *
+ * Notes:
+ * - These flags are kept generic here and are expected to be interpreted by the concrete serializer/model builder.
+ * - Defaults are set in AbstractThreeMfSerializer.DEFAULT_3MF_EXPORTER_OPTIONS.
+ */
+export interface IBjsThreeMfSerializerOptions extends IThreeMfSerializerOptions {
+    /**
+     * If true, export mesh instances (multiple references to the same geometry) when supported.
+     * If false, geometry may be duplicated depending on the concrete implementation.
+     */
+    exportInstances?: boolean;
+}
+/**
+ * Babylon.js to 3MF serializer.
+ *
+ * This serializer converts Babylon meshes into a 3MF model, then relies on the base class
+ * (AbstractThreeMfSerializer) to package the OPC parts into a zip stream.
+ *
+ * Design notes:
+ * - First pass: export "source" meshes (non-instances) and build an index to map Babylon mesh/submesh to 3MF object id.
+ * - Second pass (optional): export instances as additional build items referencing the original object ids.
+ * - Submesh export is handled by extracting per-submesh vertex/index buffers so materials/colors can be preserved
+ *   by downstream steps that attach per-object properties.
+ */
+export declare class BjsThreeMfSerializer extends AbstractThreeMfSerializer<Mesh | InstancedMesh, IBjsThreeMfSerializerOptions> {
+    /**
+     *
+     */
+    static DefaultOptions: IBjsThreeMfSerializerOptions;
+    /**
+     * Babylon's vertex buffer semantic for positions.
+     * Babylon uses string-based "kind" keys for vertex buffers.
+     */
+    private static _PositionKind;
+    /**
+     * Cached promise so we only attempt to load fflate once.
+     * This prevents multiple concurrent LoadScriptAsync calls.
+     */
+    private _fflateReadyPromise?;
+    /**
+     * @param opts serializer options (merged with defaults in base class).
+     */
+    constructor(opts?: Partial<IBjsThreeMfSerializerOptions>);
+    /**
+     * Build a 3MF model from Babylon meshes.
+     *
+     * Important: this method should not allocate huge intermediate data unless needed.
+     * Submesh extraction does allocate new position/index arrays for each exported submesh.
+     * @param builder
+     * @param meshes
+     * @returns
+     */
+    toModel(builder: ThreeMfModelBuilder, ...meshes: Array<Mesh | InstancedMesh>): I3mfModel;
+    /**
+     * Ensure the zip library (fflate) is available in the current runtime.
+     *
+     * Host assumptions:
+     * - This implementation relies on fflate being exposed on globalThis.fflate.
+     * - If it is not present, it loads a script from ThreeMfSerializerGlobalConfiguration.FFLATEUrl using Babylon Tools.LoadScriptAsync.
+     * @returns
+     */
+    ensureZipLibReadyAsync(): Promise<any>;
+    /**
+     * Extract a single SubMesh into a standalone vertex/index buffer pair.
+     *
+     * Why:
+     * - 3MF mesh objects typically reference a contiguous vertex array and triangle indices.
+     * - Babylon SubMesh references a slice of the global index buffer, but shares the vertex buffer.
+     * - To serialize each submesh independently, we build a compacted vertex buffer containing only the used vertices
+     *   and remap indices accordingly.
+     *
+     * Complexity:
+     * - O(indexCount) time, O(uniqueVerticesInSubmesh) additional memory.
+     * @param mesh
+     * @param sm
+     * @returns
+     */
+    private _extractSubMesh;
+    /**
+     * Group items by a computed key.
+     * Used to group instances by sourceMesh so the resulting XML is easier to read and debug.
+     * @param items
+     * @param key
+     * @returns
+     */
+    private _groupBy;
+    /**
+     * Basis conversion from Babylon coordinate system to the expected 3MF coordinate system.
+     *
+     * Here we rotate +90 degrees around X:
+     * - This is commonly used to convert between Y-up and Z-up conventions.
+     * - Verify this matches your pipeline (Babylon is typically left-handed Y-up).
+     */
+    private static readonly _R_BJS_TO_3MF;
+    /**
+     * Converts a Babylon.js 4x4 matrix into a 3MF 3x4 transform matrix and writes the result into ref.
+     *
+     * Babylon.js conventions:
+     * - Babylon exposes matrices with logical row/column indexing (M(row, column)).
+     * - It stores the 16 coefficients in a contiguous array in row-major order:
+     *   [ M00, M01, M02, M03,
+     *     M10, M11, M12, M13,
+     *     M20, M21, M22, M23,
+     *     M30, M31, M32, M33 ]
+     *
+     * 3MF expectation:
+     * - 3MF uses an affine transform represented as a 3x4 matrix (12 values).
+     * - The values are taken from the first 3 columns of the 4x4 matrix, across the 4 rows:
+     *   m00 m01 m02  m10 m11 m12  m20 m21 m22  m30 m31 m32
+     *
+     * Steps:
+     * 1) Compose Babylon transform with the basis change:
+     *    tmp = tBjs * _R_BJS_TO_3MF
+     * 2) Extract the 12 coefficients in 3MF order from tmp.m.
+     *
+     * Interop note:
+     * - Do not transpose here. We only reorder values to match the 3MF 3x4 serialization order.
+     * - Transposition is only relevant when interfacing with code that assumes column-major storage.
+     *
+     * @param tBjs Babylon.js 4x4 matrix.
+     * @param ref Output 3MF 3x4 matrix container (ref.values assigned).
+     * @returns ref, for chaining.
+     */
+    private _handleBjsTo3mfMatrixTransformToRef;
+}

package/3MF/3mfSerializer.js

@@ -0,0 +1,328 @@
+import { Mesh } from "@onerjs/core/Meshes/mesh.js";
+import { InstancedMesh } from "@onerjs/core/Meshes/instancedMesh.js";
+import { Matrix } from "@onerjs/core/Maths/math.js";
+import { Tools } from "@onerjs/core/Misc/tools.js";
+// 3MF
+import { ThreeMfMeshBuilder } from "./core/model/3mf.builder.js";
+import { Matrix3d } from "./core/model/3mf.js";
+import { ST_Unit } from "./core/model/3mf.interfaces.js";
+import { AbstractThreeMfSerializer } from "./core/model/3mf.serializer.js";
+import { ThreeMfSerializerGlobalConfiguration } from "./3mfSerializer.configuration.js";
+/**
+ *
+ */
+class IncrementalIdFactory {
+    /**
+     *
+     * @param from
+     * @param to
+     * @param step
+     */
+    constructor(from = 0, to = Number.MIN_SAFE_INTEGER, step = 1) {
+        this._from = from;
+        this._to = to;
+        this._step = step;
+        this._i = from;
+    }
+    /**
+     *
+     * @returns
+     */
+    next() {
+        if (this._i < this._to) {
+            throw new Error("ST_ResourceID out of bound");
+        }
+        const v = this._i;
+        this._i += this._step;
+        return v;
+    }
+    /**
+     *
+     * @returns
+     */
+    reset() {
+        this._i = this._from;
+        return this;
+    }
+}
+/**
+ * Babylon.js to 3MF serializer.
+ *
+ * This serializer converts Babylon meshes into a 3MF model, then relies on the base class
+ * (AbstractThreeMfSerializer) to package the OPC parts into a zip stream.
+ *
+ * Design notes:
+ * - First pass: export "source" meshes (non-instances) and build an index to map Babylon mesh/submesh to 3MF object id.
+ * - Second pass (optional): export instances as additional build items referencing the original object ids.
+ * - Submesh export is handled by extracting per-submesh vertex/index buffers so materials/colors can be preserved
+ *   by downstream steps that attach per-object properties.
+ */
+export class BjsThreeMfSerializer extends AbstractThreeMfSerializer {
+    /**
+     * @param opts serializer options (merged with defaults in base class).
+     */
+    constructor(opts = {}) {
+        super({ ...BjsThreeMfSerializer.DefaultOptions, ...opts });
+    }
+    /**
+     * Build a 3MF model from Babylon meshes.
+     *
+     * Important: this method should not allocate huge intermediate data unless needed.
+     * Submesh extraction does allocate new position/index arrays for each exported submesh.
+     * @param builder
+     * @param meshes
+     * @returns
+     */
+    toModel(builder, ...meshes) {
+        // avoid parasits..
+        meshes = meshes.filter((m) => m instanceof Mesh || m instanceof InstancedMesh);
+        const idFactory = new IncrementalIdFactory();
+        const modelBuilder = builder;
+        /**
+         * Index mapping Babylon elements to the created 3MF object.
+         *
+         * Why:
+         * - Instances need to reference the base object id.
+         * - When exporting submeshes, instances should reference per-submesh objects rather than the whole mesh.
+         *
+         * Key type:
+         * - When exportSubmeshes is true: we store entries for each SubMesh.
+         * - Otherwise: we store entries for each Mesh.
+         */
+        const index = new Map();
+        /**
+         * If exportInstances is enabled, we collect instanced meshes during the first pass and process them later.
+         * If exportInstances is disabled, instances are ignored (they will not appear in the output).
+         */
+        const instances = this.options.exportInstances ? [] : null;
+        // First pass: export base meshes (non-instances).
+        // This creates the "resource objects" referenced by build items.
+        for (let j = 0; j < meshes.length; j++) {
+            const babylonMesh = meshes[j];
+            if (babylonMesh instanceof InstancedMesh) {
+                // Defer instance handling to the second pass.
+                instances?.push(babylonMesh);
+                continue;
+            }
+            const objectName = babylonMesh.name || `mesh${j}`;
+            // Convert Babylon world matrix to 3MF build transform (3x4).
+            // This transform will be attached to the build item referencing the created object.
+            const worldTransform = babylonMesh.getWorldMatrix();
+            const buildTransform = this._handleBjsTo3mfMatrixTransformToRef(worldTransform, Matrix3d.Zero());
+            // Submeshes can carry material/color boundaries in Babylon.
+            // When exportSubmeshes is enabled, we export each submesh as its own 3MF object so
+            // consumers can attach per-object properties (e.g. colors) later.
+            const subMeshes = babylonMesh.subMeshes;
+            if (subMeshes === undefined) {
+                // very unlikely...
+                continue;
+            }
+            // Babylon.js automatically creates one SubMesh covering the whole mesh if you don’t define any.
+            const isStandalone = subMeshes.length == 1;
+            for (let k = 0; k < subMeshes.length; k++) {
+                const subMesh = subMeshes[k];
+                const data = this._extractSubMesh(babylonMesh, subMesh);
+                if (data) {
+                    const submeshName = isStandalone ? `${objectName}` : `${objectName}_${k}`;
+                    const object = new ThreeMfMeshBuilder(idFactory.next()).withData(data).withName(submeshName).build();
+                    // Add object to resources.
+                    modelBuilder.withMesh(object);
+                    // Add a build item referencing the object at the mesh world transform.
+                    modelBuilder.withBuild(object.id, buildTransform);
+                    // Cache mapping for instances (instances will reference this object id).
+                    index.set(subMesh, object);
+                }
+            }
+        }
+        // Second pass: export instances as additional build items.
+        //
+        // In 3MF terms:
+        // - We do not duplicate geometry for each instance.
+        // - We emit multiple build items referencing the same object id, each with its own transform.
+        if (instances && instances.length) {
+            // Group instances by their source mesh to keep related builds close in the XML.
+            const grouped = this._groupBy(instances, (i) => i.sourceMesh);
+            for (const [_babylonMesh, _instances] of Array.from(grouped.entries())) {
+                if (!_instances || !_instances.length) {
+                    continue;
+                }
+                for (let j = 0; j < _instances.length; j++) {
+                    const mesh = _instances[j];
+                    const worldTransform = mesh.getWorldMatrix();
+                    // If we exported submeshes, the base "resource objects" are per-submesh.
+                    // For an instance we emit a build item per submesh object.
+                    const subMeshes = _babylonMesh.subMeshes;
+                    for (let k = 0; k < subMeshes.length; k++) {
+                        const subMesh = subMeshes[k];
+                        // Look up the 3MF object created for this submesh in the first pass.
+                        const objectRef = index.get(subMesh);
+                        if (objectRef) {
+                            modelBuilder.withBuild(objectRef.id, this._handleBjsTo3mfMatrixTransformToRef(worldTransform, Matrix3d.Zero()));
+                            continue;
+                        }
+                    }
+                }
+            }
+        }
+        return modelBuilder.build();
+    }
+    /**
+     * Ensure the zip library (fflate) is available in the current runtime.
+     *
+     * Host assumptions:
+     * - This implementation relies on fflate being exposed on globalThis.fflate.
+     * - If it is not present, it loads a script from ThreeMfSerializerGlobalConfiguration.FFLATEUrl using Babylon Tools.LoadScriptAsync.
+     * @returns
+     */
+    async ensureZipLibReadyAsync() {
+        if (this._fflateReadyPromise) {
+            return await this._fflateReadyPromise;
+        }
+        this._fflateReadyPromise = (async () => {
+            // globalThis is the global object in all modern JS runtimes (browser, workers, Node, etc.).
+            const g = globalThis;
+            // If fflate is not already present, load it dynamically.
+            // This assumes the loaded script sets globalThis.fflate.
+            if (!g.fflate) {
+                await Tools.LoadScriptAsync(ThreeMfSerializerGlobalConfiguration.FFLATEUrl);
+            }
+            return g.fflate;
+        })();
+        return await this._fflateReadyPromise;
+    }
+    /**
+     * Extract a single SubMesh into a standalone vertex/index buffer pair.
+     *
+     * Why:
+     * - 3MF mesh objects typically reference a contiguous vertex array and triangle indices.
+     * - Babylon SubMesh references a slice of the global index buffer, but shares the vertex buffer.
+     * - To serialize each submesh independently, we build a compacted vertex buffer containing only the used vertices
+     *   and remap indices accordingly.
+     *
+     * Complexity:
+     * - O(indexCount) time, O(uniqueVerticesInSubmesh) additional memory.
+     * @param mesh
+     * @param sm
+     * @returns
+     */
+    _extractSubMesh(mesh, sm) {
+        const allInd = mesh.getIndices();
+        if (!allInd) {
+            return undefined;
+        }
+        const allPos = mesh.getVerticesData(BjsThreeMfSerializer._PositionKind);
+        if (!allPos) {
+            return undefined;
+        }
+        // Fast path: the submesh covers the full index buffer, so reuse the original arrays.
+        // Note: This returns Babylon-owned arrays; if callers mutate, they will affect source mesh data.
+        // Kept as-is to avoid extra allocations.
+        if (sm.indexStart == 0 && sm.indexCount == allInd.length) {
+            return {
+                positions: allPos,
+                indices: allInd,
+            };
+        }
+        const indStart = sm.indexStart;
+        // Map old vertex index -> new compacted vertex index.
+        const map = new Map();
+        // Compacted positions (x,y,z repeated). We assemble into number[] then convert to Float32Array at the end.
+        const newPositions = [];
+        // Indices for the compacted vertex buffer.
+        // Uint32Array is used to support large meshes; ensure downstream 3MF writer supports 32-bit indices if needed.
+        const newIndices = new Uint32Array(sm.indexCount);
+        for (let i = 0; i < sm.indexCount; i++) {
+            const oldVi = allInd[indStart + i];
+            let newVi = map.get(oldVi);
+            if (newVi === undefined) {
+                newVi = map.size;
+                map.set(oldVi, newVi);
+                // Copy the corresponding position (assumes positions are 3-floats per vertex).
+                // If the source mesh uses a different stride or includes morph targets, this ignores them.
+                const p = oldVi * 3;
+                newPositions.push(allPos[p], allPos[p + 1], allPos[p + 2]);
+            }
+            newIndices[i] = newVi;
+        }
+        return {
+            positions: new Float32Array(newPositions),
+            indices: newIndices,
+        };
+    }
+    /**
+     * Group items by a computed key.
+     * Used to group instances by sourceMesh so the resulting XML is easier to read and debug.
+     * @param items
+     * @param key
+     * @returns
+     */
+    _groupBy(items, key) {
+        const m = new Map();
+        for (const it of items) {
+            const k = key(it);
+            const arr = m.get(k);
+            if (arr) {
+                arr.push(it);
+            }
+            else {
+                m.set(k, [it]);
+            }
+        }
+        return m;
+    }
+    /**
+     * Converts a Babylon.js 4x4 matrix into a 3MF 3x4 transform matrix and writes the result into ref.
+     *
+     * Babylon.js conventions:
+     * - Babylon exposes matrices with logical row/column indexing (M(row, column)).
+     * - It stores the 16 coefficients in a contiguous array in row-major order:
+     *   [ M00, M01, M02, M03,
+     *     M10, M11, M12, M13,
+     *     M20, M21, M22, M23,
+     *     M30, M31, M32, M33 ]
+     *
+     * 3MF expectation:
+     * - 3MF uses an affine transform represented as a 3x4 matrix (12 values).
+     * - The values are taken from the first 3 columns of the 4x4 matrix, across the 4 rows:
+     *   m00 m01 m02  m10 m11 m12  m20 m21 m22  m30 m31 m32
+     *
+     * Steps:
+     * 1) Compose Babylon transform with the basis change:
+     *    tmp = tBjs * _R_BJS_TO_3MF
+     * 2) Extract the 12 coefficients in 3MF order from tmp.m.
+     *
+     * Interop note:
+     * - Do not transpose here. We only reorder values to match the 3MF 3x4 serialization order.
+     * - Transposition is only relevant when interfacing with code that assumes column-major storage.
+     *
+     * @param tBjs Babylon.js 4x4 matrix.
+     * @param ref Output 3MF 3x4 matrix container (ref.values assigned).
+     * @returns ref, for chaining.
+     */
+    _handleBjsTo3mfMatrixTransformToRef(tBjs, ref) {
+        const tmp = tBjs.multiplyToRef(BjsThreeMfSerializer._R_BJS_TO_3MF, Matrix.Zero());
+        const a = tmp.m;
+        // a is Babylon row-major storage. Extract rows 0..3, cols 0..2 in 3MF order.
+        // 3MF order: m00 m01 m02 m10 m11 m12 m20 m21 m22 m30 m31 m32
+        ref.values = [a[0], a[1], a[2], a[4], a[5], a[6], a[8], a[9], a[10], a[12], a[13], a[14]];
+        return ref;
+    }
+}
+/**
+ *
+ */
+BjsThreeMfSerializer.DefaultOptions = { unit: ST_Unit.meter, exportInstances: false };
+/**
+ * Babylon's vertex buffer semantic for positions.
+ * Babylon uses string-based "kind" keys for vertex buffers.
+ */
+BjsThreeMfSerializer._PositionKind = "position";
+/**
+ * Basis conversion from Babylon coordinate system to the expected 3MF coordinate system.
+ *
+ * Here we rotate +90 degrees around X:
+ * - This is commonly used to convert between Y-up and Z-up conventions.
+ * - Verify this matches your pipeline (Babylon is typically left-handed Y-up).
+ */
+BjsThreeMfSerializer._R_BJS_TO_3MF = Matrix.RotationX(Math.PI / 2).multiply(Matrix.Scaling(1, -1, 1));
+//# sourceMappingURL=3mfSerializer.js.map

package/3MF/3mfSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"3mfSerializer.js","sourceRoot":"","sources":["../../../../dev/serializers/src/3MF/3mfSerializer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,oCAAyB;AACxC,OAAO,EAAE,aAAa,EAAE,6CAAkC;AAC1D,OAAO,EAAE,MAAM,EAAE,mCAAwB;AACzC,OAAO,EAAE,KAAK,EAAE,mCAAwB;AAExC,MAAM;AACN,OAAO,EAAE,kBAAkB,EAA4B,MAAM,0BAA0B,CAAC;AACxF,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAmC,MAAM,6BAA6B,CAAC;AAEvF,OAAO,EAAE,yBAAyB,EAAkC,MAAM,6BAA6B,CAAC;AACxG,OAAO,EAAE,oCAAoC,EAAE,MAAM,+BAA+B,CAAC;AAErF;;GAEG;AACH,MAAM,oBAAoB;IAUtB;;;;;OAKG;IACH,YAAmB,OAAe,CAAC,EAAE,KAAa,MAAM,CAAC,gBAAgB,EAAE,OAAe,CAAC;QACvF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACI,IAAI;QACP,IAAI,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;QAClB,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC;QACtB,OAAO,CAAC,CAAC;IACb,CAAC;IAED;;;OAGG;IACI,KAAK;QACR,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QACrB,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAiBD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,oBAAqB,SAAQ,yBAA6E;IAkBnH;;OAEG;IACH,YAAmB,OAA8C,EAAE;QAC/D,KAAK,CAAC,EAAE,GAAG,oBAAoB,CAAC,cAAc,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;;OAQG;IACa,OAAO,CAAC,OAA4B,EAAE,GAAG,MAAmC;QACxF,mBAAmB;QACnB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,aAAa,CAAC,CAAC;QAE/E,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAE7C,MAAM,YAAY,GAAG,OAAO,CAAC;QAE7B;;;;;;;;;;WAUG;QACH,MAAM,KAAK,GAAG,IAAI,GAAG,EAA8B,CAAC;QAEpD;;;WAGG;QACH,MAAM,SAAS,GAAgC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAExF,kDAAkD;QAClD,iEAAiE;QACjE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YAC9B,IAAI,WAAW,YAAY,aAAa,EAAE,CAAC;gBACvC,8CAA8C;gBAC9C,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;gBAC7B,SAAS;YACb,CAAC;YAED,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE,CAAC;YAElD,6DAA6D;YAC7D,oFAAoF;YACpF,MAAM,cAAc,GAAG,WAAW,CAAC,cAAc,EAAE,CAAC;YACpD,MAAM,cAAc,GAAG,IAAI,CAAC,mCAAmC,CAAC,cAAc,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YAEjG,4DAA4D;YAC5D,mFAAmF;YACnF,kEAAkE;YAClE,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC;YACxC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC1B,mBAAmB;gBACnB,SAAS;YACb,CAAC;YAED,gGAAgG;YAChG,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC;YAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxC,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;gBAE7B,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;gBAExD,IAAI,IAAI,EAAE,CAAC;oBACP,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,CAAC,EAAE,CAAC;oBAE1E,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,CAAC;oBAErG,2BAA2B;oBAC3B,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;oBAE9B,uEAAuE;oBACvE,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;oBAElD,yEAAyE;oBACzE,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC/B,CAAC;YACL,CAAC;QACL,CAAC;QAED,2DAA2D;QAC3D,EAAE;QACF,gBAAgB;QAChB,oDAAoD;QACpD,8FAA8F;QAC9F,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;YAChC,gFAAgF;YAChF,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;YAE9D,KAAK,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;gBACrE,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;oBACpC,SAAS;gBACb,CAAC;gBAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACzC,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;oBAC3B,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;oBAE7C,yEAAyE;oBACzE,2DAA2D;oBAC3D,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC;oBAEzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;wBACxC,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;wBAE7B,qEAAqE;wBACrE,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;wBAErC,IAAI,SAAS,EAAE,CAAC;4BACZ,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,mCAAmC,CAAC,cAAc,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;4BAChH,SAAS;wBACb,CAAC;oBACL,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;QAED,OAAO,YAAY,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;IAED;;;;;;;OAOG;IACa,KAAK,CAAC,sBAAsB;QACxC,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC3B,OAAO,MAAM,IAAI,CAAC,mBAAmB,CAAC;QAC1C,CAAC;QAED,IAAI,CAAC,mBAAmB,GAAG,CAAC,KAAK,IAAI,EAAE;YACnC,4FAA4F;YAC5F,MAAM,CAAC,GAAG,UAAiB,CAAC;YAE5B,yDAAyD;YACzD,yDAAyD;YACzD,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,KAAK,CAAC,eAAe,CAAC,oCAAoC,CAAC,SAAS,CAAC,CAAC;YAChF,CAAC;YAED,OAAO,CAAC,CAAC,MAAM,CAAC;QACpB,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,MAAM,IAAI,CAAC,mBAAmB,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACK,eAAe,CAAC,IAAU,EAAE,EAAW;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,qFAAqF;QACrF,iGAAiG;QACjG,yCAAyC;QACzC,IAAI,EAAE,CAAC,UAAU,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACvD,OAAO;gBACH,SAAS,EAAE,MAAM;gBACjB,OAAO,EAAE,MAAM;aAClB,CAAC;QACN,CAAC;QAED,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC;QAE/B,sDAAsD;QACtD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;QAEtC,2GAA2G;QAC3G,MAAM,YAAY,GAAa,EAAE,CAAC;QAElC,2CAA2C;QAC3C,+GAA+G;QAC/G,MAAM,UAAU,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;QAElD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;YAEnC,IAAI,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACtB,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC;gBACjB,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAEtB,+EAA+E;gBAC/E,2FAA2F;gBAC3F,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;gBACpB,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC/D,CAAC;YAED,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QAC1B,CAAC;QAED,OAAO;YACH,SAAS,EAAE,IAAI,YAAY,CAAC,YAAY,CAAC;YACzC,OAAO,EAAE,UAAU;SACtB,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACK,QAAQ,CAAO,KAAmB,EAAE,GAAgB;QACxD,MAAM,CAAC,GAAG,IAAI,GAAG,EAAU,CAAC;QAC5B,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;YAClB,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACrB,IAAI,GAAG,EAAE,CAAC;gBACN,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACJ,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACnB,CAAC;QACL,CAAC;QACD,OAAO,CAAC,CAAC;IACb,CAAC;IAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACK,mCAAmC,CAAC,IAAY,EAAE,GAAa;QACnE,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAClF,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QAEhB,6EAA6E;QAC7E,6DAA6D;QAC7D,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1F,OAAO,GAAG,CAAC;IACf,CAAC;;AA7TD;;GAEG;AACI,mCAAc,GAAiC,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;AAEtG;;;GAGG;AACY,kCAAa,GAAG,UAAU,CAAC;AAsQ1C;;;;;;GAMG;AACqB,kCAAa,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC","sourcesContent":["// Babylonjs\r\nimport type { SubMesh } from \"core/Meshes\";\r\nimport { Mesh } from \"core/Meshes/mesh\";\r\nimport { InstancedMesh } from \"core/Meshes/instancedMesh\";\r\nimport { Matrix } from \"core/Maths/math\";\r\nimport { Tools } from \"core/Misc/tools\";\r\n\r\n// 3MF\r\nimport { ThreeMfMeshBuilder, type ThreeMfModelBuilder } from \"./core/model/3mf.builder\";\r\nimport { Matrix3d } from \"./core/model/3mf\";\r\n\r\nimport { ST_Unit, type I3mfModel, type I3mfObject } from \"./core/model/3mf.interfaces\";\r\nimport type { I3mfVertexData } from \"./core/model/3mf.types\";\r\nimport { AbstractThreeMfSerializer, type IThreeMfSerializerOptions } from \"./core/model/3mf.serializer\";\r\nimport { ThreeMfSerializerGlobalConfiguration } from \"./3mfSerializer.configuration\";\r\n\r\n/**\r\n *\r\n */\r\nclass IncrementalIdFactory {\r\n    /** */\r\n    _from: number;\r\n    /** */\r\n    _to: number;\r\n    /** */\r\n    _step: number;\r\n    /** */\r\n    _i: number;\r\n\r\n    /**\r\n     *\r\n     * @param from\r\n     * @param to\r\n     * @param step\r\n     */\r\n    public constructor(from: number = 0, to: number = Number.MIN_SAFE_INTEGER, step: number = 1) {\r\n        this._from = from;\r\n        this._to = to;\r\n        this._step = step;\r\n        this._i = from;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @returns\r\n     */\r\n    public next(): number {\r\n        if (this._i < this._to) {\r\n            throw new Error(\"ST_ResourceID out of bound\");\r\n        }\r\n        const v = this._i;\r\n        this._i += this._step;\r\n        return v;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @returns\r\n     */\r\n    public reset(): IncrementalIdFactory {\r\n        this._i = this._from;\r\n        return this;\r\n    }\r\n}\r\n\r\n/**\r\n * Options controlling how meshes are exported into the 3MF model.\r\n *\r\n * Notes:\r\n * - These flags are kept generic here and are expected to be interpreted by the concrete serializer/model builder.\r\n * - Defaults are set in AbstractThreeMfSerializer.DEFAULT_3MF_EXPORTER_OPTIONS.\r\n */\r\nexport interface IBjsThreeMfSerializerOptions extends IThreeMfSerializerOptions {\r\n    /**\r\n     * If true, export mesh instances (multiple references to the same geometry) when supported.\r\n     * If false, geometry may be duplicated depending on the concrete implementation.\r\n     */\r\n    exportInstances?: boolean;\r\n}\r\n\r\n/**\r\n * Babylon.js to 3MF serializer.\r\n *\r\n * This serializer converts Babylon meshes into a 3MF model, then relies on the base class\r\n * (AbstractThreeMfSerializer) to package the OPC parts into a zip stream.\r\n *\r\n * Design notes:\r\n * - First pass: export \"source\" meshes (non-instances) and build an index to map Babylon mesh/submesh to 3MF object id.\r\n * - Second pass (optional): export instances as additional build items referencing the original object ids.\r\n * - Submesh export is handled by extracting per-submesh vertex/index buffers so materials/colors can be preserved\r\n *   by downstream steps that attach per-object properties.\r\n */\r\nexport class BjsThreeMfSerializer extends AbstractThreeMfSerializer<Mesh | InstancedMesh, IBjsThreeMfSerializerOptions> {\r\n    /**\r\n     *\r\n     */\r\n    static DefaultOptions: IBjsThreeMfSerializerOptions = { unit: ST_Unit.meter, exportInstances: false };\r\n\r\n    /**\r\n     * Babylon's vertex buffer semantic for positions.\r\n     * Babylon uses string-based \"kind\" keys for vertex buffers.\r\n     */\r\n    private static _PositionKind = \"position\";\r\n\r\n    /**\r\n     * Cached promise so we only attempt to load fflate once.\r\n     * This prevents multiple concurrent LoadScriptAsync calls.\r\n     */\r\n    private _fflateReadyPromise?: Promise<any>;\r\n\r\n    /**\r\n     * @param opts serializer options (merged with defaults in base class).\r\n     */\r\n    public constructor(opts: Partial<IBjsThreeMfSerializerOptions> = {}) {\r\n        super({ ...BjsThreeMfSerializer.DefaultOptions, ...opts });\r\n    }\r\n\r\n    /**\r\n     * Build a 3MF model from Babylon meshes.\r\n     *\r\n     * Important: this method should not allocate huge intermediate data unless needed.\r\n     * Submesh extraction does allocate new position/index arrays for each exported submesh.\r\n     * @param builder\r\n     * @param meshes\r\n     * @returns\r\n     */\r\n    public override toModel(builder: ThreeMfModelBuilder, ...meshes: Array<Mesh | InstancedMesh>): I3mfModel {\r\n        // avoid parasits..\r\n        meshes = meshes.filter((m) => m instanceof Mesh || m instanceof InstancedMesh);\r\n\r\n        const idFactory = new IncrementalIdFactory();\r\n\r\n        const modelBuilder = builder;\r\n\r\n        /**\r\n         * Index mapping Babylon elements to the created 3MF object.\r\n         *\r\n         * Why:\r\n         * - Instances need to reference the base object id.\r\n         * - When exporting submeshes, instances should reference per-submesh objects rather than the whole mesh.\r\n         *\r\n         * Key type:\r\n         * - When exportSubmeshes is true: we store entries for each SubMesh.\r\n         * - Otherwise: we store entries for each Mesh.\r\n         */\r\n        const index = new Map<Mesh | SubMesh, I3mfObject>();\r\n\r\n        /**\r\n         * If exportInstances is enabled, we collect instanced meshes during the first pass and process them later.\r\n         * If exportInstances is disabled, instances are ignored (they will not appear in the output).\r\n         */\r\n        const instances: Array<InstancedMesh> | null = this.options.exportInstances ? [] : null;\r\n\r\n        // First pass: export base meshes (non-instances).\r\n        // This creates the \"resource objects\" referenced by build items.\r\n        for (let j = 0; j < meshes.length; j++) {\r\n            const babylonMesh = meshes[j];\r\n            if (babylonMesh instanceof InstancedMesh) {\r\n                // Defer instance handling to the second pass.\r\n                instances?.push(babylonMesh);\r\n                continue;\r\n            }\r\n\r\n            const objectName = babylonMesh.name || `mesh${j}`;\r\n\r\n            // Convert Babylon world matrix to 3MF build transform (3x4).\r\n            // This transform will be attached to the build item referencing the created object.\r\n            const worldTransform = babylonMesh.getWorldMatrix();\r\n            const buildTransform = this._handleBjsTo3mfMatrixTransformToRef(worldTransform, Matrix3d.Zero());\r\n\r\n            // Submeshes can carry material/color boundaries in Babylon.\r\n            // When exportSubmeshes is enabled, we export each submesh as its own 3MF object so\r\n            // consumers can attach per-object properties (e.g. colors) later.\r\n            const subMeshes = babylonMesh.subMeshes;\r\n            if (subMeshes === undefined) {\r\n                // very unlikely...\r\n                continue;\r\n            }\r\n\r\n            // Babylon.js automatically creates one SubMesh covering the whole mesh if you don’t define any.\r\n            const isStandalone = subMeshes.length == 1;\r\n            for (let k = 0; k < subMeshes.length; k++) {\r\n                const subMesh = subMeshes[k];\r\n\r\n                const data = this._extractSubMesh(babylonMesh, subMesh);\r\n\r\n                if (data) {\r\n                    const submeshName = isStandalone ? `${objectName}` : `${objectName}_${k}`;\r\n\r\n                    const object = new ThreeMfMeshBuilder(idFactory.next()).withData(data).withName(submeshName).build();\r\n\r\n                    // Add object to resources.\r\n                    modelBuilder.withMesh(object);\r\n\r\n                    // Add a build item referencing the object at the mesh world transform.\r\n                    modelBuilder.withBuild(object.id, buildTransform);\r\n\r\n                    // Cache mapping for instances (instances will reference this object id).\r\n                    index.set(subMesh, object);\r\n                }\r\n            }\r\n        }\r\n\r\n        // Second pass: export instances as additional build items.\r\n        //\r\n        // In 3MF terms:\r\n        // - We do not duplicate geometry for each instance.\r\n        // - We emit multiple build items referencing the same object id, each with its own transform.\r\n        if (instances && instances.length) {\r\n            // Group instances by their source mesh to keep related builds close in the XML.\r\n            const grouped = this._groupBy(instances, (i) => i.sourceMesh);\r\n\r\n            for (const [_babylonMesh, _instances] of Array.from(grouped.entries())) {\r\n                if (!_instances || !_instances.length) {\r\n                    continue;\r\n                }\r\n\r\n                for (let j = 0; j < _instances.length; j++) {\r\n                    const mesh = _instances[j];\r\n                    const worldTransform = mesh.getWorldMatrix();\r\n\r\n                    // If we exported submeshes, the base \"resource objects\" are per-submesh.\r\n                    // For an instance we emit a build item per submesh object.\r\n                    const subMeshes = _babylonMesh.subMeshes;\r\n\r\n                    for (let k = 0; k < subMeshes.length; k++) {\r\n                        const subMesh = subMeshes[k];\r\n\r\n                        // Look up the 3MF object created for this submesh in the first pass.\r\n                        const objectRef = index.get(subMesh);\r\n\r\n                        if (objectRef) {\r\n                            modelBuilder.withBuild(objectRef.id, this._handleBjsTo3mfMatrixTransformToRef(worldTransform, Matrix3d.Zero()));\r\n                            continue;\r\n                        }\r\n                    }\r\n                }\r\n            }\r\n        }\r\n\r\n        return modelBuilder.build();\r\n    }\r\n\r\n    /**\r\n     * Ensure the zip library (fflate) is available in the current runtime.\r\n     *\r\n     * Host assumptions:\r\n     * - This implementation relies on fflate being exposed on globalThis.fflate.\r\n     * - If it is not present, it loads a script from ThreeMfSerializerGlobalConfiguration.FFLATEUrl using Babylon Tools.LoadScriptAsync.\r\n     * @returns\r\n     */\r\n    public override async ensureZipLibReadyAsync(): Promise<any> {\r\n        if (this._fflateReadyPromise) {\r\n            return await this._fflateReadyPromise;\r\n        }\r\n\r\n        this._fflateReadyPromise = (async () => {\r\n            // globalThis is the global object in all modern JS runtimes (browser, workers, Node, etc.).\r\n            const g = globalThis as any;\r\n\r\n            // If fflate is not already present, load it dynamically.\r\n            // This assumes the loaded script sets globalThis.fflate.\r\n            if (!g.fflate) {\r\n                await Tools.LoadScriptAsync(ThreeMfSerializerGlobalConfiguration.FFLATEUrl);\r\n            }\r\n\r\n            return g.fflate;\r\n        })();\r\n\r\n        return await this._fflateReadyPromise;\r\n    }\r\n\r\n    /**\r\n     * Extract a single SubMesh into a standalone vertex/index buffer pair.\r\n     *\r\n     * Why:\r\n     * - 3MF mesh objects typically reference a contiguous vertex array and triangle indices.\r\n     * - Babylon SubMesh references a slice of the global index buffer, but shares the vertex buffer.\r\n     * - To serialize each submesh independently, we build a compacted vertex buffer containing only the used vertices\r\n     *   and remap indices accordingly.\r\n     *\r\n     * Complexity:\r\n     * - O(indexCount) time, O(uniqueVerticesInSubmesh) additional memory.\r\n     * @param mesh\r\n     * @param sm\r\n     * @returns\r\n     */\r\n    private _extractSubMesh(mesh: Mesh, sm: SubMesh): I3mfVertexData | undefined {\r\n        const allInd = mesh.getIndices();\r\n        if (!allInd) {\r\n            return undefined;\r\n        }\r\n\r\n        const allPos = mesh.getVerticesData(BjsThreeMfSerializer._PositionKind);\r\n        if (!allPos) {\r\n            return undefined;\r\n        }\r\n\r\n        // Fast path: the submesh covers the full index buffer, so reuse the original arrays.\r\n        // Note: This returns Babylon-owned arrays; if callers mutate, they will affect source mesh data.\r\n        // Kept as-is to avoid extra allocations.\r\n        if (sm.indexStart == 0 && sm.indexCount == allInd.length) {\r\n            return {\r\n                positions: allPos,\r\n                indices: allInd,\r\n            };\r\n        }\r\n\r\n        const indStart = sm.indexStart;\r\n\r\n        // Map old vertex index -> new compacted vertex index.\r\n        const map = new Map<number, number>();\r\n\r\n        // Compacted positions (x,y,z repeated). We assemble into number[] then convert to Float32Array at the end.\r\n        const newPositions: number[] = [];\r\n\r\n        // Indices for the compacted vertex buffer.\r\n        // Uint32Array is used to support large meshes; ensure downstream 3MF writer supports 32-bit indices if needed.\r\n        const newIndices = new Uint32Array(sm.indexCount);\r\n\r\n        for (let i = 0; i < sm.indexCount; i++) {\r\n            const oldVi = allInd[indStart + i];\r\n\r\n            let newVi = map.get(oldVi);\r\n            if (newVi === undefined) {\r\n                newVi = map.size;\r\n                map.set(oldVi, newVi);\r\n\r\n                // Copy the corresponding position (assumes positions are 3-floats per vertex).\r\n                // If the source mesh uses a different stride or includes morph targets, this ignores them.\r\n                const p = oldVi * 3;\r\n                newPositions.push(allPos[p], allPos[p + 1], allPos[p + 2]);\r\n            }\r\n\r\n            newIndices[i] = newVi;\r\n        }\r\n\r\n        return {\r\n            positions: new Float32Array(newPositions),\r\n            indices: newIndices,\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Group items by a computed key.\r\n     * Used to group instances by sourceMesh so the resulting XML is easier to read and debug.\r\n     * @param items\r\n     * @param key\r\n     * @returns\r\n     */\r\n    private _groupBy<T, K>(items: readonly T[], key: (v: T) => K): Map<K, T[]> {\r\n        const m = new Map<K, T[]>();\r\n        for (const it of items) {\r\n            const k = key(it);\r\n            const arr = m.get(k);\r\n            if (arr) {\r\n                arr.push(it);\r\n            } else {\r\n                m.set(k, [it]);\r\n            }\r\n        }\r\n        return m;\r\n    }\r\n\r\n    /**\r\n     * Basis conversion from Babylon coordinate system to the expected 3MF coordinate system.\r\n     *\r\n     * Here we rotate +90 degrees around X:\r\n     * - This is commonly used to convert between Y-up and Z-up conventions.\r\n     * - Verify this matches your pipeline (Babylon is typically left-handed Y-up).\r\n     */\r\n    private static readonly _R_BJS_TO_3MF = Matrix.RotationX(Math.PI / 2).multiply(Matrix.Scaling(1, -1, 1));\r\n\r\n    /**\r\n     * Converts a Babylon.js 4x4 matrix into a 3MF 3x4 transform matrix and writes the result into ref.\r\n     *\r\n     * Babylon.js conventions:\r\n     * - Babylon exposes matrices with logical row/column indexing (M(row, column)).\r\n     * - It stores the 16 coefficients in a contiguous array in row-major order:\r\n     *   [ M00, M01, M02, M03,\r\n     *     M10, M11, M12, M13,\r\n     *     M20, M21, M22, M23,\r\n     *     M30, M31, M32, M33 ]\r\n     *\r\n     * 3MF expectation:\r\n     * - 3MF uses an affine transform represented as a 3x4 matrix (12 values).\r\n     * - The values are taken from the first 3 columns of the 4x4 matrix, across the 4 rows:\r\n     *   m00 m01 m02  m10 m11 m12  m20 m21 m22  m30 m31 m32\r\n     *\r\n     * Steps:\r\n     * 1) Compose Babylon transform with the basis change:\r\n     *    tmp = tBjs * _R_BJS_TO_3MF\r\n     * 2) Extract the 12 coefficients in 3MF order from tmp.m.\r\n     *\r\n     * Interop note:\r\n     * - Do not transpose here. We only reorder values to match the 3MF 3x4 serialization order.\r\n     * - Transposition is only relevant when interfacing with code that assumes column-major storage.\r\n     *\r\n     * @param tBjs Babylon.js 4x4 matrix.\r\n     * @param ref Output 3MF 3x4 matrix container (ref.values assigned).\r\n     * @returns ref, for chaining.\r\n     */\r\n    private _handleBjsTo3mfMatrixTransformToRef(tBjs: Matrix, ref: Matrix3d): Matrix3d {\r\n        const tmp = tBjs.multiplyToRef(BjsThreeMfSerializer._R_BJS_TO_3MF, Matrix.Zero());\r\n        const a = tmp.m;\r\n\r\n        // a is Babylon row-major storage. Extract rows 0..3, cols 0..2 in 3MF order.\r\n        // 3MF order: m00 m01 m02 m10 m11 m12 m20 m21 m22 m30 m31 m32\r\n        ref.values = [a[0], a[1], a[2], a[4], a[5], a[6], a[8], a[9], a[10], a[12], a[13], a[14]];\r\n        return ref;\r\n    }\r\n}\r\n"]}

package/3MF/core/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./xml/index.js";
+export * from "./model/index.js";

package/3MF/core/index.js

@@ -0,0 +1,4 @@
+/* eslint-disable @typescript-eslint/no-restricted-imports */
+export * from "./xml/index.js";
+export * from "./model/index.js";
+//# sourceMappingURL=index.js.map

package/3MF/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../dev/serializers/src/3MF/core/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC","sourcesContent":["/* eslint-disable @typescript-eslint/no-restricted-imports */\r\nexport * from \"./xml/index\";\r\nexport * from \"./model/index\";\r\n"]}