@babylonjs/serializers 9.18.1 → 9.18.2

package/3MF/core/model/3mf.builder.d.ts

@@ -2,227 +2,268 @@ import { type Matrix3d, ThreeMfModel, ThreeMfObject } from "./3mf.js";
 import { type I3mfBaseMaterials, type I3mfModel, type I3mfObject, type I3mfTriangle, type I3mfVertex, type ST_ResourceID, type ST_ResourceIndex, type ST_Unit, ST_ObjectType } from "./3mf.interfaces.js";
 import { type I3mfDocument, type I3mfContentType, type I3mfRelationship } from "./3mf.opc.interfaces.js";
 import { type I3mfRGBAColor, type I3mfVertexData } from "./3mf.types.js";
+/**
+ * Handler invoked for every vertex generated by a {@link ThreeMfMeshBuilder}, allowing it to be transformed before export.
+ */
 export type VertexHandler = (vertex: I3mfVertex) => I3mfVertex;
+/**
+ * Handler invoked for every triangle generated by a {@link ThreeMfMeshBuilder}, allowing it to be transformed before export.
+ */
 export type TriangleHandler = (triangle: I3mfTriangle) => I3mfTriangle;
-/** */
+/**
+ * Fluent builder for a 3MF object resource.
+ * An object is the base resource of a 3MF model and is either a mesh or a set of components.
+ */
 export declare class ThreeMfObjectBuilder {
     /**
-     *
+     * The 3MF object resource currently being built.
      */
     protected _object: ThreeMfObject;
     /**
-     *
-     * @param id
-     * @param type
+     * Creates a new object builder.
+     * @param id The unique resource id of the object within the model.
+     * @param type The 3MF object type (model, support, solidsupport, surface or other).
      */
     constructor(id: ST_ResourceID, type: ST_ObjectType);
     /**
-     *
-     * @param name
-     * @returns
+     * Sets the human readable name of the object.
+     * @param name The name to assign to the object.
+     * @returns This builder, to allow chaining.
      */
     withName(name: string): ThreeMfObjectBuilder;
     /**
-     *
-     * @param thumbnail
-     * @returns
+     * Sets the thumbnail of the object.
+     * @param thumbnail The package relative path of the thumbnail part.
+     * @returns This builder, to allow chaining.
      */
     withThumbnail(thumbnail: string): ThreeMfObjectBuilder;
     /**
-     *
-     * @param id
-     * @param index
-     * @returns
+     * Assigns the property resource used by the object.
+     * @param id The resource id of the property group (for example a base materials group).
+     * @param index The zero based index of the property within the group. Defaults to 0.
+     * @returns This builder, to allow chaining.
      */
     withProperty(id: ST_ResourceIndex, index?: number): ThreeMfObjectBuilder;
     /**
-     *
-     * @returns
+     * Returns the object that has been built.
+     * @returns The built 3MF object resource.
      */
     build(): I3mfObject;
     /**
-     *
-     * @param id
-     * @param type
+     * Discards the current object and starts building a new one.
+     * @param id The unique resource id of the new object.
+     * @param type The 3MF object type of the new object.
      */
     reset(id: ST_ResourceID, type: ST_ObjectType): void;
 }
 /**
- *
+ * Fluent builder for a 3MF object made of components.
+ * A components object references other objects instead of defining its own geometry.
  */
 export declare class ThreeMfComponentsBuilder extends ThreeMfObjectBuilder {
     /**
-     *
-     * @param id
-     * @param type
+     * Creates a new components object builder.
+     * @param id The unique resource id of the object within the model.
+     * @param type The 3MF object type. Defaults to `ST_ObjectType.model`.
      */
     constructor(id: ST_ResourceID, type?: ST_ObjectType);
     /**
-     *
-     * @param id
-     * @param t
-     * @returns
+     * Adds a component referencing another object resource.
+     * @param id The resource id of the referenced object.
+     * @param t The optional transform applied to the referenced object.
+     * @returns This builder, to allow chaining.
      */
     withComponent(id: ST_ResourceID, t?: Matrix3d): ThreeMfComponentsBuilder;
 }
 /**
- *
+ * Fluent builder for a 3MF object holding a mesh.
+ * Vertices and triangles are generated from Babylon vertex data and can be post processed through handlers.
  */
 export declare class ThreeMfMeshBuilder extends ThreeMfObjectBuilder {
     /**
-     *
+     * Optional handler invoked for every vertex before it is added to the mesh.
      */
     _vh?: VertexHandler;
     /**
-     *
+     * Optional handler invoked for every triangle before it is added to the mesh.
      */
     _th?: TriangleHandler;
     /**
-     *
-     * @param id
+     * Creates a new mesh object builder.
+     * @param id The unique resource id of the object within the model.
      */
     constructor(id: ST_ResourceID);
     /**
-     *
-     * @param vertex
-     * @param triangle
-     * @returns
+     * Registers the handlers used to post process the generated geometry.
+     * @param vertex The handler invoked for every generated vertex.
+     * @param triangle The optional handler invoked for every generated triangle.
+     * @returns This builder, to allow chaining.
      */
     withPostProcessHandlers(vertex: VertexHandler, triangle?: TriangleHandler): ThreeMfMeshBuilder;
     /**
-     *
-     * @param data
-     * @returns
+     * Builds the mesh content of the object from the provided vertex data.
+     * @param data The positions and indices used to generate the mesh.
+     * @returns This builder, to allow chaining.
      */
     withData(data: I3mfVertexData): ThreeMfMeshBuilder;
     /**
-     *
-     * @param id
-     * @param i
-     * @returns
+     * Assigns the material used by the mesh.
+     * @param id The resource id of the base materials group.
+     * @param i The zero based index of the material within the group.
+     * @returns This builder, to allow chaining.
      */
     withMaterial(id: ST_ResourceID, i: number): ThreeMfMeshBuilder;
     /**
-     *
-     * @param data
-     * @returns
+     * Converts vertex data into a 3MF mesh.
+     * @param data The positions and indices used to generate the mesh.
+     * @returns The generated 3MF mesh.
      */
     private _buildMesh;
+    /**
+     * Converts a flat position array into a 3MF vertex list, applying the vertex handler when one is registered.
+     * @param p The flat array of x, y and z positions.
+     * @returns The generated 3MF vertex list.
+     */
     private _buildVertices;
+    /**
+     * Converts a flat index array into a 3MF triangle list, applying the triangle handler when one is registered.
+     * @param indice The flat array of vertex indices, three per triangle.
+     * @returns The generated 3MF triangle list.
+     */
     private _buildTriangle;
 }
 /**
- *
+ * Fluent builder for a 3MF base materials resource.
+ * Colors are stored as sRGB hexadecimal strings as required by the 3MF specification.
  */
 export declare class ThreeMfMaterialBuilder {
     private _m;
+    /**
+     * Creates a new base materials builder.
+     * @param id The unique resource id of the base materials group within the model.
+     */
     constructor(id: ST_ResourceID);
     /**
-     *
-     * @param name
-     * @param color
-     * @returns
+     * Adds a named color to the group, or updates it when the name already exists.
+     * @param name The name of the material. The lookup is case insensitive.
+     * @param color The linear RGBA color, converted to an sRGB hexadecimal string.
+     * @returns This builder, to allow chaining.
      */
     withColor(name: string, color: I3mfRGBAColor): ThreeMfMaterialBuilder;
     /**
-     *
-     * @returns
+     * Returns the base materials group that has been built.
+     * @returns The built base materials resource.
      */
     build(): I3mfBaseMaterials;
+    /**
+     * Converts a linear color into the sRGB hexadecimal string used by 3MF.
+     * @param c The linear color to convert. The alpha channel is optional.
+     * @returns The color as `#RRGGBB`, or `#RRGGBBAA` when an alpha channel is provided.
+     */
     private _rgbaToHex;
 }
 /**
- *
+ * Fluent builder for a 3MF model, the root part of a 3MF document.
+ * It aggregates the resources (materials, meshes and components) and the build items that reference them.
  */
 export declare class ThreeMfModelBuilder {
     /**
-     *
+     * The lower cased set of the metadata names defined by the 3MF specification.
      */
     static KnownMetaSet: Set<string>;
     /**
-     *
+     * The 3MF model currently being built.
      */
     _model: ThreeMfModel;
     /**
-     *
+     * The object resources added to the model, indexed by resource id.
      */
     _objects: Map<string, I3mfObject>;
     /**
-     *
-     * @param name
-     * @param value
-     * @param preserve
-     * @param type
-     * @returns
+     * Adds a metadata entry to the model.
+     * @param name The metadata name. Names outside of the 3MF specification must be namespace qualified.
+     * @param value The metadata value.
+     * @param preserve Whether consumers must preserve this entry when editing the document.
+     * @param type The XML schema type of the value. Defaults to `xs:string`.
+     * @returns This builder, to allow chaining.
      */
     withMetaData(name: string, value: string, preserve?: boolean, type?: string): ThreeMfModelBuilder;
     /**
-     *
-     * @param material
-     * @returns
+     * Adds a base materials group to the model resources.
+     * @param material The base materials resource, or a builder that produces one.
+     * @returns This builder, to allow chaining.
      */
     withMaterial(material: I3mfBaseMaterials | ThreeMfMaterialBuilder): ThreeMfModelBuilder;
     /**
-     *
-     * @param object
-     * @returns
+     * Adds a mesh object to the model resources.
+     * @param object The object resource, or a builder that produces one.
+     * @returns This builder, to allow chaining.
      */
     withMesh(object: I3mfObject | ThreeMfMeshBuilder): ThreeMfModelBuilder;
     /**
-     *
-     * @param components
-     * @returns
+     * Adds a components object to the model resources.
+     * @param components The object resource, or a builder that produces one.
+     * @returns This builder, to allow chaining.
      */
     withComponents(components: I3mfObject | ThreeMfComponentsBuilder): ThreeMfModelBuilder;
     /**
-     *
-     * @param objectid
-     * @param transform
-     * @param partnumber
-     * @returns
+     * Adds a build item, which places an object resource in the build plate.
+     * @param objectid The resource id of the object to place.
+     * @param transform The optional transform applied to the object.
+     * @param partnumber The optional part number identifying the produced part.
+     * @returns This builder, to allow chaining.
      */
     withBuild(objectid: ST_ResourceID, transform?: Matrix3d, partnumber?: string): ThreeMfModelBuilder;
     /**
-     *
-     * @param unit
-     * @returns
+     * Sets the unit in which the model coordinates are expressed.
+     * @param unit The 3MF unit (micron, millimeter, centimeter, inch, foot or meter).
+     * @returns This builder, to allow chaining.
      */
     withUnit(unit: ST_Unit): ThreeMfModelBuilder;
     /**
-     *
-     * @returns
+     * Discards the current model and starts building a new one.
+     * @returns This builder, to allow chaining.
      */
     reset(): ThreeMfModelBuilder;
     /**
-     *
-     * @returns
+     * Validates and returns the model that has been built.
+     * @returns The built 3MF model.
+     * @throws When the model has no object resource or no build item.
      */
     build(): ThreeMfModel;
 }
 /**
- *
+ * Fluent builder for a 3MF document, the OPC package that wraps the model.
+ * It gathers the content types, the relationships and the model part.
  */
 export declare class ThreeMfDocumentBuilder {
     private _cts?;
     private _rs?;
     private _m?;
     /**
-     *
-     * @param type
-     * @returns
+     * Declares an OPC content type. Duplicate declarations are ignored.
+     * @param type The extension to content type mapping to declare.
+     * @returns This builder, to allow chaining.
      */
     withContentType(type: I3mfContentType): ThreeMfDocumentBuilder;
     /**
-     *
-     * @param rel
-     * @returns
+     * Adds an OPC relationship and ensures the relationships content type is declared.
+     * Relationships with an already registered id are ignored.
+     * @param rel The relationship to add.
+     * @returns This builder, to allow chaining.
      */
     withRelationship(rel: I3mfRelationship): ThreeMfDocumentBuilder;
     /**
-     *
-     * @param m
-     * @returns
+     * Sets the model part of the document and ensures the model content type is declared.
+     * @param m The model resource, or a builder that produces one.
+     * @returns This builder, to allow chaining.
      */
     withModel(m: I3mfModel | ThreeMfModelBuilder): ThreeMfDocumentBuilder;
+    /**
+     * Validates and returns the document that has been built.
+     * A default relationship pointing at the model part is generated when none was provided.
+     * @returns The built 3MF document.
+     * @throws When no model has been set.
+     */
     build(): I3mfDocument;
 }

package/3MF/core/model/3mf.builder.js

@@ -3,39 +3,42 @@ import { ThreeMfBase, ThreeMfBaseMaterials, ThreeMfBuild, ThreeMfComponent, Thre
 import { ST_ObjectType, } from "./3mf.interfaces.js";
 import { ThreeMfContentType, ThreeMfContentTypes, ThreeMfDocument, ThreeMfRelationship, ThreeMfRelationships } from "./3mf.opc.js";
 import { Known3mfRelationshipTypes, KnownI3mfContentType, ModelFileName, Object3dDirName, } from "./3mf.opc.interfaces.js";
-/** */
+/**
+ * Fluent builder for a 3MF object resource.
+ * An object is the base resource of a 3MF model and is either a mesh or a set of components.
+ */
 export class ThreeMfObjectBuilder {
     /**
-     *
-     * @param id
-     * @param type
+     * Creates a new object builder.
+     * @param id The unique resource id of the object within the model.
+     * @param type The 3MF object type (model, support, solidsupport, surface or other).
      */
     constructor(id, type) {
         this._object = new ThreeMfObject(id, type);
     }
     /**
-     *
-     * @param name
-     * @returns
+     * Sets the human readable name of the object.
+     * @param name The name to assign to the object.
+     * @returns This builder, to allow chaining.
      */
     withName(name) {
         this._object.name = name;
         return this;
     }
     /**
-     *
-     * @param thumbnail
-     * @returns
+     * Sets the thumbnail of the object.
+     * @param thumbnail The package relative path of the thumbnail part.
+     * @returns This builder, to allow chaining.
      */
     withThumbnail(thumbnail) {
         this._object.thumbnail = thumbnail;
         return this;
     }
     /**
-     *
-     * @param id
-     * @param index
-     * @returns
+     * Assigns the property resource used by the object.
+     * @param id The resource id of the property group (for example a base materials group).
+     * @param index The zero based index of the property within the group. Defaults to 0.
+     * @returns This builder, to allow chaining.
      */
     withProperty(id, index = 0) {
         this._object.pid = id;
@@ -43,39 +46,40 @@ export class ThreeMfObjectBuilder {
         return this;
     }
     /**
-     *
-     * @returns
+     * Returns the object that has been built.
+     * @returns The built 3MF object resource.
      */
     build() {
         return this._object;
     }
     /**
-     *
-     * @param id
-     * @param type
+     * Discards the current object and starts building a new one.
+     * @param id The unique resource id of the new object.
+     * @param type The 3MF object type of the new object.
      */
     reset(id, type) {
         this._object = new ThreeMfObject(id, type);
     }
 }
 /**
- *
+ * Fluent builder for a 3MF object made of components.
+ * A components object references other objects instead of defining its own geometry.
  */
 export class ThreeMfComponentsBuilder extends ThreeMfObjectBuilder {
     /**
-     *
-     * @param id
-     * @param type
+     * Creates a new components object builder.
+     * @param id The unique resource id of the object within the model.
+     * @param type The 3MF object type. Defaults to `ST_ObjectType.model`.
      */
     constructor(id, type = ST_ObjectType.model) {
         super(id, type);
         this._object.content = new ThreeMfComponents();
     }
     /**
-     *
-     * @param id
-     * @param t
-     * @returns
+     * Adds a component referencing another object resource.
+     * @param id The resource id of the referenced object.
+     * @param t The optional transform applied to the referenced object.
+     * @returns This builder, to allow chaining.
      */
     withComponent(id, t) {
         this._object.content.component.push(new ThreeMfComponent(id, t));
@@ -83,21 +87,22 @@ export class ThreeMfComponentsBuilder extends ThreeMfObjectBuilder {
     }
 }
 /**
- *
+ * Fluent builder for a 3MF object holding a mesh.
+ * Vertices and triangles are generated from Babylon vertex data and can be post processed through handlers.
  */
 export class ThreeMfMeshBuilder extends ThreeMfObjectBuilder {
     /**
-     *
-     * @param id
+     * Creates a new mesh object builder.
+     * @param id The unique resource id of the object within the model.
      */
     constructor(id) {
         super(id, ST_ObjectType.model);
     }
     /**
-     *
-     * @param vertex
-     * @param triangle
-     * @returns
+     * Registers the handlers used to post process the generated geometry.
+     * @param vertex The handler invoked for every generated vertex.
+     * @param triangle The optional handler invoked for every generated triangle.
+     * @returns This builder, to allow chaining.
      */
     withPostProcessHandlers(vertex, triangle) {
         this._vh = vertex;
@@ -105,19 +110,19 @@ export class ThreeMfMeshBuilder extends ThreeMfObjectBuilder {
         return this;
     }
     /**
-     *
-     * @param data
-     * @returns
+     * Builds the mesh content of the object from the provided vertex data.
+     * @param data The positions and indices used to generate the mesh.
+     * @returns This builder, to allow chaining.
      */
     withData(data) {
         this._object.content = this._buildMesh(data);
         return this;
     }
     /**
-     *
-     * @param id
-     * @param i
-     * @returns
+     * Assigns the material used by the mesh.
+     * @param id The resource id of the base materials group.
+     * @param i The zero based index of the material within the group.
+     * @returns This builder, to allow chaining.
      */
     withMaterial(id, i) {
         this._object.pid = id;
@@ -125,15 +130,20 @@ export class ThreeMfMeshBuilder extends ThreeMfObjectBuilder {
         return this;
     }
     /**
-     *
-     * @param data
-     * @returns
+     * Converts vertex data into a 3MF mesh.
+     * @param data The positions and indices used to generate the mesh.
+     * @returns The generated 3MF mesh.
      */
     _buildMesh(data) {
         const vertices = this._buildVertices(data.positions);
         const triangles = this._buildTriangle(data.indices);
         return new ThreeMfMesh(vertices, triangles);
     }
+    /**
+     * Converts a flat position array into a 3MF vertex list, applying the vertex handler when one is registered.
+     * @param p The flat array of x, y and z positions.
+     * @returns The generated 3MF vertex list.
+     */
     _buildVertices(p) {
         const container = new ThreeMfVertices();
         if (p) {
@@ -151,6 +161,11 @@ export class ThreeMfMeshBuilder extends ThreeMfObjectBuilder {
         }
         return container;
     }
+    /**
+     * Converts a flat index array into a 3MF triangle list, applying the triangle handler when one is registered.
+     * @param indice The flat array of vertex indices, three per triangle.
+     * @returns The generated 3MF triangle list.
+     */
     _buildTriangle(indice) {
         const container = new ThreeMfTriangles();
         if (indice) {
@@ -170,17 +185,22 @@ export class ThreeMfMeshBuilder extends ThreeMfObjectBuilder {
     }
 }
 /**
- *
+ * Fluent builder for a 3MF base materials resource.
+ * Colors are stored as sRGB hexadecimal strings as required by the 3MF specification.
  */
 export class ThreeMfMaterialBuilder {
+    /**
+     * Creates a new base materials builder.
+     * @param id The unique resource id of the base materials group within the model.
+     */
     constructor(id) {
         this._m = new ThreeMfBaseMaterials(id);
     }
     /**
-     *
-     * @param name
-     * @param color
-     * @returns
+     * Adds a named color to the group, or updates it when the name already exists.
+     * @param name The name of the material. The lookup is case insensitive.
+     * @param color The linear RGBA color, converted to an sRGB hexadecimal string.
+     * @returns This builder, to allow chaining.
      */
     withColor(name, color) {
         this._m.base = this._m.base ?? [];
@@ -194,12 +214,17 @@ export class ThreeMfMaterialBuilder {
         return this;
     }
     /**
-     *
-     * @returns
+     * Returns the base materials group that has been built.
+     * @returns The built base materials resource.
      */
     build() {
         return this._m;
     }
+    /**
+     * Converts a linear color into the sRGB hexadecimal string used by 3MF.
+     * @param c The linear color to convert. The alpha channel is optional.
+     * @returns The color as `#RRGGBB`, or `#RRGGBBAA` when an alpha channel is provided.
+     */
     _rgbaToHex(c) {
         const toSRGB = (c) => Math.round(Math.min(255, Math.max(0, Math.pow(c, 1 / 2.2) * 255)));
         const r = toSRGB(c.r).toString(16).padStart(2, "0").toUpperCase();
@@ -216,26 +241,27 @@ export class ThreeMfMaterialBuilder {
     }
 }
 /**
- *
+ * Fluent builder for a 3MF model, the root part of a 3MF document.
+ * It aggregates the resources (materials, meshes and components) and the build items that reference them.
  */
 export class ThreeMfModelBuilder {
     constructor() {
         /**
-         *
+         * The 3MF model currently being built.
          */
         this._model = new ThreeMfModel();
         /**
-         *
+         * The object resources added to the model, indexed by resource id.
          */
         this._objects = new Map();
     }
     /**
-     *
-     * @param name
-     * @param value
-     * @param preserve
-     * @param type
-     * @returns
+     * Adds a metadata entry to the model.
+     * @param name The metadata name. Names outside of the 3MF specification must be namespace qualified.
+     * @param value The metadata value.
+     * @param preserve Whether consumers must preserve this entry when editing the document.
+     * @param type The XML schema type of the value. Defaults to `xs:string`.
+     * @returns This builder, to allow chaining.
      */
     withMetaData(name, value, preserve, type) {
         if (!this._model.metadata) {
@@ -248,9 +274,9 @@ export class ThreeMfModelBuilder {
         return this;
     }
     /**
-     *
-     * @param material
-     * @returns
+     * Adds a base materials group to the model resources.
+     * @param material The base materials resource, or a builder that produces one.
+     * @returns This builder, to allow chaining.
      */
     withMaterial(material) {
         if (material instanceof ThreeMfMaterialBuilder) {
@@ -264,9 +290,9 @@ export class ThreeMfModelBuilder {
         return this;
     }
     /**
-     *
-     * @param object
-     * @returns
+     * Adds a mesh object to the model resources.
+     * @param object The object resource, or a builder that produces one.
+     * @returns This builder, to allow chaining.
      */
     withMesh(object) {
         if (object instanceof ThreeMfMeshBuilder) {
@@ -277,9 +303,9 @@ export class ThreeMfModelBuilder {
         return this;
     }
     /**
-     *
-     * @param components
-     * @returns
+     * Adds a components object to the model resources.
+     * @param components The object resource, or a builder that produces one.
+     * @returns This builder, to allow chaining.
      */
     withComponents(components) {
         if (components instanceof ThreeMfComponentsBuilder) {
@@ -290,11 +316,11 @@ export class ThreeMfModelBuilder {
         return this;
     }
     /**
-     *
-     * @param objectid
-     * @param transform
-     * @param partnumber
-     * @returns
+     * Adds a build item, which places an object resource in the build plate.
+     * @param objectid The resource id of the object to place.
+     * @param transform The optional transform applied to the object.
+     * @param partnumber The optional part number identifying the produced part.
+     * @returns This builder, to allow chaining.
      */
     withBuild(objectid, transform, partnumber) {
         this._model.build = this._model.build ?? new ThreeMfBuild();
@@ -302,17 +328,17 @@ export class ThreeMfModelBuilder {
         return this;
     }
     /**
-     *
-     * @param unit
-     * @returns
+     * Sets the unit in which the model coordinates are expressed.
+     * @param unit The 3MF unit (micron, millimeter, centimeter, inch, foot or meter).
+     * @returns This builder, to allow chaining.
      */
     withUnit(unit) {
         this._model.unit = unit;
         return this;
     }
     /**
-     *
-     * @returns
+     * Discards the current model and starts building a new one.
+     * @returns This builder, to allow chaining.
      */
     reset() {
         this._model = new ThreeMfModel();
@@ -320,8 +346,9 @@ export class ThreeMfModelBuilder {
         return this;
     }
     /**
-     *
-     * @returns
+     * Validates and returns the model that has been built.
+     * @returns The built 3MF model.
+     * @throws When the model has no object resource or no build item.
      */
     build() {
         // quick surface check..
@@ -335,17 +362,18 @@ export class ThreeMfModelBuilder {
     }
 }
 /**
- *
+ * The lower cased set of the metadata names defined by the 3MF specification.
  */
 ThreeMfModelBuilder.KnownMetaSet = new Set(ThreeMfModel.KnownMeta.map((m) => m.toLowerCase()));
 /**
- *
+ * Fluent builder for a 3MF document, the OPC package that wraps the model.
+ * It gathers the content types, the relationships and the model part.
  */
 export class ThreeMfDocumentBuilder {
     /**
-     *
-     * @param type
-     * @returns
+     * Declares an OPC content type. Duplicate declarations are ignored.
+     * @param type The extension to content type mapping to declare.
+     * @returns This builder, to allow chaining.
      */
     withContentType(type) {
         if (!this._cts) {
@@ -358,9 +386,10 @@ export class ThreeMfDocumentBuilder {
         return this;
     }
     /**
-     *
-     * @param rel
-     * @returns
+     * Adds an OPC relationship and ensures the relationships content type is declared.
+     * Relationships with an already registered id are ignored.
+     * @param rel The relationship to add.
+     * @returns This builder, to allow chaining.
      */
     withRelationship(rel) {
         if (!this._rs) {
@@ -375,9 +404,9 @@ export class ThreeMfDocumentBuilder {
         return this;
     }
     /**
-     *
-     * @param m
-     * @returns
+     * Sets the model part of the document and ensures the model content type is declared.
+     * @param m The model resource, or a builder that produces one.
+     * @returns This builder, to allow chaining.
      */
     withModel(m) {
         if (m instanceof ThreeMfModelBuilder) {
@@ -388,6 +417,12 @@ export class ThreeMfDocumentBuilder {
         this.withContentType(new ThreeMfContentType("model", KnownI3mfContentType.Model));
         return this;
     }
+    /**
+     * Validates and returns the document that has been built.
+     * A default relationship pointing at the model part is generated when none was provided.
+     * @returns The built 3MF document.
+     * @throws When no model has been set.
+     */
     build() {
         if (!this._m) {
             throw new Error("Invalid state: you Must provide at least a model.");

package/3MF/core/model/3mf.builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"3mf.builder.js","sourceRoot":"","sources":["../../../../../../dev/serializers/src/3MF/core/model/3mf.builder.ts"],"names":[],"mappings":"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","sourcesContent":["// 3MF\r\nimport {\r\n    type Matrix3d,\r\n    ThreeMfBase,\r\n    ThreeMfBaseMaterials,\r\n    ThreeMfBuild,\r\n    ThreeMfComponent,\r\n    ThreeMfComponents,\r\n    ThreeMfItem,\r\n    ThreeMfMesh,\r\n    ThreeMfMeta,\r\n    ThreeMfModel,\r\n    ThreeMfObject,\r\n    ThreeMfResources,\r\n    ThreeMfTriangle,\r\n    ThreeMfTriangles,\r\n    ThreeMfVertex,\r\n    ThreeMfVertices,\r\n} from \"./3mf\";\r\nimport {\r\n    type I3mfBaseMaterials,\r\n    type I3mfComponents,\r\n    type I3mfMesh,\r\n    type I3mfMetadata,\r\n    type I3mfModel,\r\n    type I3mfObject,\r\n    type I3mfTriangle,\r\n    type I3mfTriangles,\r\n    type I3mfVertex,\r\n    type I3mfVertices,\r\n    type ST_ResourceID,\r\n    type ST_ResourceIndex,\r\n    type ST_Unit,\r\n    ST_ObjectType,\r\n} from \"./3mf.interfaces\";\r\nimport { ThreeMfContentType, ThreeMfContentTypes, ThreeMfDocument, ThreeMfRelationship, ThreeMfRelationships } from \"./3mf.opc\";\r\nimport {\r\n    type I3mfDocument,\r\n    Known3mfRelationshipTypes,\r\n    KnownI3mfContentType,\r\n    ModelFileName,\r\n    Object3dDirName,\r\n    type I3mfContentType,\r\n    type I3mfContentTypes,\r\n    type I3mfRelationship,\r\n    type I3mfRelationships,\r\n} from \"./3mf.opc.interfaces\";\r\nimport { type I3mfRGBAColor, type I3mfVertexData, type ThreeMfFloatArray, type ThreeMfIndicesArray } from \"./3mf.types\";\r\n\r\nexport type VertexHandler = (vertex: I3mfVertex) => I3mfVertex;\r\nexport type TriangleHandler = (triangle: I3mfTriangle) => I3mfTriangle;\r\n\r\n/** */\r\nexport class ThreeMfObjectBuilder {\r\n    /**\r\n     *\r\n     */\r\n    protected _object: ThreeMfObject;\r\n\r\n    /**\r\n     *\r\n     * @param id\r\n     * @param type\r\n     */\r\n    public constructor(id: ST_ResourceID, type: ST_ObjectType) {\r\n        this._object = new ThreeMfObject(id, type);\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @param name\r\n     * @returns\r\n     */\r\n    public withName(name: string): ThreeMfObjectBuilder {\r\n        this._object.name = name;\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @param thumbnail\r\n     * @returns\r\n     */\r\n    public withThumbnail(thumbnail: string): ThreeMfObjectBuilder {\r\n        this._object.thumbnail = thumbnail;\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @param id\r\n     * @param index\r\n     * @returns\r\n     */\r\n    public withProperty(id: ST_ResourceIndex, index: number = 0): ThreeMfObjectBuilder {\r\n        this._object.pid = id;\r\n        this._object.id = index;\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @returns\r\n     */\r\n    public build(): I3mfObject {\r\n        return this._object;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @param id\r\n     * @param type\r\n     */\r\n    public reset(id: ST_ResourceID, type: ST_ObjectType) {\r\n        this._object = new ThreeMfObject(id, type);\r\n    }\r\n}\r\n\r\n/**\r\n *\r\n */\r\nexport class ThreeMfComponentsBuilder extends ThreeMfObjectBuilder {\r\n    /**\r\n     *\r\n     * @param id\r\n     * @param type\r\n     */\r\n    public constructor(id: ST_ResourceID, type: ST_ObjectType = ST_ObjectType.model) {\r\n        super(id, type);\r\n        this._object.content = new ThreeMfComponents();\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @param id\r\n     * @param t\r\n     * @returns\r\n     */\r\n    public withComponent(id: ST_ResourceID, t?: Matrix3d): ThreeMfComponentsBuilder {\r\n        (this._object.content as I3mfComponents).component.push(new ThreeMfComponent(id, t));\r\n        return this;\r\n    }\r\n}\r\n\r\n/**\r\n *\r\n */\r\nexport class ThreeMfMeshBuilder extends ThreeMfObjectBuilder {\r\n    /**\r\n     *\r\n     */\r\n    _vh?: VertexHandler;\r\n    /**\r\n     *\r\n     */\r\n    _th?: TriangleHandler;\r\n\r\n    /**\r\n     *\r\n     * @param id\r\n     */\r\n    public constructor(id: ST_ResourceID) {\r\n        super(id, ST_ObjectType.model);\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @param vertex\r\n     * @param triangle\r\n     * @returns\r\n     */\r\n    public withPostProcessHandlers(vertex: VertexHandler, triangle?: TriangleHandler): ThreeMfMeshBuilder {\r\n        this._vh = vertex;\r\n        this._th = triangle;\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @param data\r\n     * @returns\r\n     */\r\n    withData(data: I3mfVertexData): ThreeMfMeshBuilder {\r\n        this._object.content = this._buildMesh(data);\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @param id\r\n     * @param i\r\n     * @returns\r\n     */\r\n    withMaterial(id: ST_ResourceID, i: number): ThreeMfMeshBuilder {\r\n        this._object.pid = id;\r\n        this._object.pindex = i;\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @param data\r\n     * @returns\r\n     */\r\n    private _buildMesh(data: I3mfVertexData): I3mfMesh {\r\n        const vertices = this._buildVertices(data.positions);\r\n        const triangles = this._buildTriangle(data.indices);\r\n        return new ThreeMfMesh(vertices, triangles);\r\n    }\r\n\r\n    private _buildVertices(p: ThreeMfFloatArray | null): I3mfVertices {\r\n        const container = new ThreeMfVertices();\r\n        if (p) {\r\n            for (let i = 0; i < p.length; ) {\r\n                const x = p[i++];\r\n                const y = p[i++];\r\n                const z = p[i++];\r\n                let v = new ThreeMfVertex(x, y, z);\r\n                // might be optimized....\r\n                if (this._vh) {\r\n                    v = this._vh(v);\r\n                }\r\n                container.vertex.push(v);\r\n            }\r\n        }\r\n        return container;\r\n    }\r\n\r\n    private _buildTriangle(indice: ThreeMfIndicesArray | null): I3mfTriangles {\r\n        const container = new ThreeMfTriangles();\r\n        if (indice) {\r\n            for (let i = 0; i < indice.length; ) {\r\n                const a = indice[i++];\r\n                const b = indice[i++];\r\n                const c = indice[i++];\r\n                let t = new ThreeMfTriangle(a, b, c);\r\n                // might be optimized....\r\n                if (this._th) {\r\n                    t = this._th(t);\r\n                }\r\n                container.triangle.push(t);\r\n            }\r\n        }\r\n        return container;\r\n    }\r\n}\r\n\r\n/**\r\n *\r\n */\r\nexport class ThreeMfMaterialBuilder {\r\n    private _m: I3mfBaseMaterials;\r\n\r\n    public constructor(id: ST_ResourceID) {\r\n        this._m = new ThreeMfBaseMaterials(id);\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @param name\r\n     * @param color\r\n     * @returns\r\n     */\r\n    public withColor(name: string, color: I3mfRGBAColor): ThreeMfMaterialBuilder {\r\n        this._m.base = this._m.base ?? [];\r\n        let m = this._m.base.find((m) => m.name.toLowerCase() === name.toLowerCase());\r\n        if (m) {\r\n            m.displaycolor = this._rgbaToHex(color);\r\n            return this;\r\n        }\r\n        m = new ThreeMfBase(name, this._rgbaToHex(color));\r\n        this._m.base.push(m);\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @returns\r\n     */\r\n    public build(): I3mfBaseMaterials {\r\n        return this._m;\r\n    }\r\n\r\n    private _rgbaToHex(c: I3mfRGBAColor | { r: number; g: number; b: number; a?: number }): string {\r\n        const toSRGB = (c: number) => Math.round(Math.min(255, Math.max(0, Math.pow(c, 1 / 2.2) * 255)));\r\n\r\n        const r = toSRGB(c.r).toString(16).padStart(2, \"0\").toUpperCase();\r\n        const g = toSRGB(c.g).toString(16).padStart(2, \"0\").toUpperCase();\r\n        const b = toSRGB(c.b).toString(16).padStart(2, \"0\").toUpperCase();\r\n\r\n        if (typeof (c as any).a === \"number\") {\r\n            const a = Math.round(Math.min(255, Math.max(0, c.a! * 255)))\r\n                .toString(16)\r\n                .padStart(2, \"0\")\r\n                .toUpperCase();\r\n            return `#${r}${g}${b}${a}`;\r\n        }\r\n\r\n        return `#${r}${g}${b}`;\r\n    }\r\n}\r\n\r\n/**\r\n *\r\n */\r\nexport class ThreeMfModelBuilder {\r\n    /**\r\n     *\r\n     */\r\n    static KnownMetaSet = new Set(ThreeMfModel.KnownMeta.map((m) => m.toLowerCase()));\r\n\r\n    /**\r\n     *\r\n     */\r\n    _model: ThreeMfModel = new ThreeMfModel();\r\n    /**\r\n     *\r\n     */\r\n    _objects = new Map<string, I3mfObject>();\r\n\r\n    /**\r\n     *\r\n     * @param name\r\n     * @param value\r\n     * @param preserve\r\n     * @param type\r\n     * @returns\r\n     */\r\n    public withMetaData(name: string, value: string, preserve?: boolean, type?: string): ThreeMfModelBuilder {\r\n        if (!this._model.metadata) {\r\n            // lazzy\r\n            this._model.metadata = new Array<I3mfMetadata>();\r\n        }\r\n        //const isKnownMeta = (s: string): boolean => TMFBuilder.knownMetaSet.has(s.toLowerCase());\r\n        //const qn:IQName = xmlNameToParts(name);\r\n        this._model.metadata.push(new ThreeMfMeta(name, value, preserve, type));\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @param material\r\n     * @returns\r\n     */\r\n    public withMaterial(material: I3mfBaseMaterials | ThreeMfMaterialBuilder): ThreeMfModelBuilder {\r\n        if (material instanceof ThreeMfMaterialBuilder) {\r\n            material = material.build();\r\n        }\r\n        if (material) {\r\n            this._model.resources = this._model.resources ?? new ThreeMfResources();\r\n            this._model.resources.basematerials = this._model.resources.basematerials ?? [];\r\n            this._model.resources.basematerials.push(material);\r\n        }\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @param object\r\n     * @returns\r\n     */\r\n    public withMesh(object: I3mfObject | ThreeMfMeshBuilder): ThreeMfModelBuilder {\r\n        if (object instanceof ThreeMfMeshBuilder) {\r\n            object = object.build();\r\n        }\r\n        this._model.resources = this._model.resources ?? new ThreeMfResources();\r\n        this._model.resources.object.push(object);\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @param components\r\n     * @returns\r\n     */\r\n    public withComponents(components: I3mfObject | ThreeMfComponentsBuilder): ThreeMfModelBuilder {\r\n        if (components instanceof ThreeMfComponentsBuilder) {\r\n            components = components.build();\r\n        }\r\n        this._model.resources = this._model.resources ?? new ThreeMfResources();\r\n        this._model.resources.object.push(components);\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @param objectid\r\n     * @param transform\r\n     * @param partnumber\r\n     * @returns\r\n     */\r\n    public withBuild(objectid: ST_ResourceID, transform?: Matrix3d, partnumber?: string): ThreeMfModelBuilder {\r\n        this._model.build = this._model.build ?? new ThreeMfBuild();\r\n        this._model.build.item?.push(new ThreeMfItem(objectid, transform, partnumber));\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @param unit\r\n     * @returns\r\n     */\r\n    public withUnit(unit: ST_Unit): ThreeMfModelBuilder {\r\n        this._model.unit = unit;\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @returns\r\n     */\r\n    public reset(): ThreeMfModelBuilder {\r\n        this._model = new ThreeMfModel();\r\n        this._objects = new Map<string, I3mfObject>();\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @returns\r\n     */\r\n    public build(): ThreeMfModel {\r\n        // quick surface check..\r\n        if (!this._model.resources?.object?.length) {\r\n            throw new Error(\"Invalid state: resources MUST be defined \");\r\n        }\r\n        if (!this._model.build?.item?.length) {\r\n            throw new Error(\"Invalid state: Build MUST be defined \");\r\n        }\r\n        return this._model;\r\n    }\r\n}\r\n\r\n/**\r\n *\r\n */\r\nexport class ThreeMfDocumentBuilder {\r\n    private _cts?: I3mfContentTypes;\r\n    private _rs?: I3mfRelationships;\r\n    private _m?: I3mfModel;\r\n\r\n    /**\r\n     *\r\n     * @param type\r\n     * @returns\r\n     */\r\n    public withContentType(type: I3mfContentType): ThreeMfDocumentBuilder {\r\n        if (!this._cts) {\r\n            this._cts = new ThreeMfContentTypes();\r\n        }\r\n        const arr = this._cts.items;\r\n        if (!arr.some((x) => x.ext === type.ext && x.ct === type.ct)) {\r\n            arr.push(type);\r\n        }\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @param rel\r\n     * @returns\r\n     */\r\n    public withRelationship(rel: I3mfRelationship): ThreeMfDocumentBuilder {\r\n        if (!this._rs) {\r\n            this._rs = new ThreeMfRelationships();\r\n        }\r\n        const arr = this._rs.items;\r\n        if (!arr.some((x) => x.id === rel.id)) {\r\n            arr.push(rel);\r\n        }\r\n        // here we ensure that the content type is declared.\r\n        this.withContentType(new ThreeMfContentType(\"rels\", KnownI3mfContentType.Relationships));\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @param m\r\n     * @returns\r\n     */\r\n    public withModel(m: I3mfModel | ThreeMfModelBuilder): ThreeMfDocumentBuilder {\r\n        if (m instanceof ThreeMfModelBuilder) {\r\n            m = m.build();\r\n        }\r\n        this._m = m;\r\n        // here we ensure that the content type is declared.\r\n        this.withContentType(new ThreeMfContentType(\"model\", KnownI3mfContentType.Model));\r\n        return this;\r\n    }\r\n\r\n    public build(): I3mfDocument {\r\n        if (!this._m) {\r\n            throw new Error(\"Invalid state: you Must provide at least a model.\");\r\n        }\r\n\r\n        // we automate the build of the relationship if not provided..\r\n        const path = `${Object3dDirName}${ModelFileName}`;\r\n        if (!this._rs) {\r\n            const absolutePath = `/${path}`;\r\n            this.withRelationship(new ThreeMfRelationship(`rel${0}`, Known3mfRelationshipTypes.ThreeDimModel, absolutePath));\r\n        }\r\n\r\n        return new ThreeMfDocument(this._cts!, this._rs!, this._m);\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"3mf.builder.js","sourceRoot":"","sources":["../../../../../../dev/serializers/src/3MF/core/model/3mf.builder.ts"],"names":[],"mappings":"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","sourcesContent":["// 3MF\r\nimport {\r\n    type Matrix3d,\r\n    ThreeMfBase,\r\n    ThreeMfBaseMaterials,\r\n    ThreeMfBuild,\r\n    ThreeMfComponent,\r\n    ThreeMfComponents,\r\n    ThreeMfItem,\r\n    ThreeMfMesh,\r\n    ThreeMfMeta,\r\n    ThreeMfModel,\r\n    ThreeMfObject,\r\n    ThreeMfResources,\r\n    ThreeMfTriangle,\r\n    ThreeMfTriangles,\r\n    ThreeMfVertex,\r\n    ThreeMfVertices,\r\n} from \"./3mf\";\r\nimport {\r\n    type I3mfBaseMaterials,\r\n    type I3mfComponents,\r\n    type I3mfMesh,\r\n    type I3mfMetadata,\r\n    type I3mfModel,\r\n    type I3mfObject,\r\n    type I3mfTriangle,\r\n    type I3mfTriangles,\r\n    type I3mfVertex,\r\n    type I3mfVertices,\r\n    type ST_ResourceID,\r\n    type ST_ResourceIndex,\r\n    type ST_Unit,\r\n    ST_ObjectType,\r\n} from \"./3mf.interfaces\";\r\nimport { ThreeMfContentType, ThreeMfContentTypes, ThreeMfDocument, ThreeMfRelationship, ThreeMfRelationships } from \"./3mf.opc\";\r\nimport {\r\n    type I3mfDocument,\r\n    Known3mfRelationshipTypes,\r\n    KnownI3mfContentType,\r\n    ModelFileName,\r\n    Object3dDirName,\r\n    type I3mfContentType,\r\n    type I3mfContentTypes,\r\n    type I3mfRelationship,\r\n    type I3mfRelationships,\r\n} from \"./3mf.opc.interfaces\";\r\nimport { type I3mfRGBAColor, type I3mfVertexData, type ThreeMfFloatArray, type ThreeMfIndicesArray } from \"./3mf.types\";\r\n\r\n/**\r\n * Handler invoked for every vertex generated by a {@link ThreeMfMeshBuilder}, allowing it to be transformed before export.\r\n */\r\nexport type VertexHandler = (vertex: I3mfVertex) => I3mfVertex;\r\n/**\r\n * Handler invoked for every triangle generated by a {@link ThreeMfMeshBuilder}, allowing it to be transformed before export.\r\n */\r\nexport type TriangleHandler = (triangle: I3mfTriangle) => I3mfTriangle;\r\n\r\n/**\r\n * Fluent builder for a 3MF object resource.\r\n * An object is the base resource of a 3MF model and is either a mesh or a set of components.\r\n */\r\nexport class ThreeMfObjectBuilder {\r\n    /**\r\n     * The 3MF object resource currently being built.\r\n     */\r\n    protected _object: ThreeMfObject;\r\n\r\n    /**\r\n     * Creates a new object builder.\r\n     * @param id The unique resource id of the object within the model.\r\n     * @param type The 3MF object type (model, support, solidsupport, surface or other).\r\n     */\r\n    public constructor(id: ST_ResourceID, type: ST_ObjectType) {\r\n        this._object = new ThreeMfObject(id, type);\r\n    }\r\n\r\n    /**\r\n     * Sets the human readable name of the object.\r\n     * @param name The name to assign to the object.\r\n     * @returns This builder, to allow chaining.\r\n     */\r\n    public withName(name: string): ThreeMfObjectBuilder {\r\n        this._object.name = name;\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Sets the thumbnail of the object.\r\n     * @param thumbnail The package relative path of the thumbnail part.\r\n     * @returns This builder, to allow chaining.\r\n     */\r\n    public withThumbnail(thumbnail: string): ThreeMfObjectBuilder {\r\n        this._object.thumbnail = thumbnail;\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Assigns the property resource used by the object.\r\n     * @param id The resource id of the property group (for example a base materials group).\r\n     * @param index The zero based index of the property within the group. Defaults to 0.\r\n     * @returns This builder, to allow chaining.\r\n     */\r\n    public withProperty(id: ST_ResourceIndex, index: number = 0): ThreeMfObjectBuilder {\r\n        this._object.pid = id;\r\n        this._object.id = index;\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Returns the object that has been built.\r\n     * @returns The built 3MF object resource.\r\n     */\r\n    public build(): I3mfObject {\r\n        return this._object;\r\n    }\r\n\r\n    /**\r\n     * Discards the current object and starts building a new one.\r\n     * @param id The unique resource id of the new object.\r\n     * @param type The 3MF object type of the new object.\r\n     */\r\n    public reset(id: ST_ResourceID, type: ST_ObjectType) {\r\n        this._object = new ThreeMfObject(id, type);\r\n    }\r\n}\r\n\r\n/**\r\n * Fluent builder for a 3MF object made of components.\r\n * A components object references other objects instead of defining its own geometry.\r\n */\r\nexport class ThreeMfComponentsBuilder extends ThreeMfObjectBuilder {\r\n    /**\r\n     * Creates a new components object builder.\r\n     * @param id The unique resource id of the object within the model.\r\n     * @param type The 3MF object type. Defaults to `ST_ObjectType.model`.\r\n     */\r\n    public constructor(id: ST_ResourceID, type: ST_ObjectType = ST_ObjectType.model) {\r\n        super(id, type);\r\n        this._object.content = new ThreeMfComponents();\r\n    }\r\n\r\n    /**\r\n     * Adds a component referencing another object resource.\r\n     * @param id The resource id of the referenced object.\r\n     * @param t The optional transform applied to the referenced object.\r\n     * @returns This builder, to allow chaining.\r\n     */\r\n    public withComponent(id: ST_ResourceID, t?: Matrix3d): ThreeMfComponentsBuilder {\r\n        (this._object.content as I3mfComponents).component.push(new ThreeMfComponent(id, t));\r\n        return this;\r\n    }\r\n}\r\n\r\n/**\r\n * Fluent builder for a 3MF object holding a mesh.\r\n * Vertices and triangles are generated from Babylon vertex data and can be post processed through handlers.\r\n */\r\nexport class ThreeMfMeshBuilder extends ThreeMfObjectBuilder {\r\n    /**\r\n     * Optional handler invoked for every vertex before it is added to the mesh.\r\n     */\r\n    _vh?: VertexHandler;\r\n    /**\r\n     * Optional handler invoked for every triangle before it is added to the mesh.\r\n     */\r\n    _th?: TriangleHandler;\r\n\r\n    /**\r\n     * Creates a new mesh object builder.\r\n     * @param id The unique resource id of the object within the model.\r\n     */\r\n    public constructor(id: ST_ResourceID) {\r\n        super(id, ST_ObjectType.model);\r\n    }\r\n\r\n    /**\r\n     * Registers the handlers used to post process the generated geometry.\r\n     * @param vertex The handler invoked for every generated vertex.\r\n     * @param triangle The optional handler invoked for every generated triangle.\r\n     * @returns This builder, to allow chaining.\r\n     */\r\n    public withPostProcessHandlers(vertex: VertexHandler, triangle?: TriangleHandler): ThreeMfMeshBuilder {\r\n        this._vh = vertex;\r\n        this._th = triangle;\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Builds the mesh content of the object from the provided vertex data.\r\n     * @param data The positions and indices used to generate the mesh.\r\n     * @returns This builder, to allow chaining.\r\n     */\r\n    withData(data: I3mfVertexData): ThreeMfMeshBuilder {\r\n        this._object.content = this._buildMesh(data);\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Assigns the material used by the mesh.\r\n     * @param id The resource id of the base materials group.\r\n     * @param i The zero based index of the material within the group.\r\n     * @returns This builder, to allow chaining.\r\n     */\r\n    withMaterial(id: ST_ResourceID, i: number): ThreeMfMeshBuilder {\r\n        this._object.pid = id;\r\n        this._object.pindex = i;\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Converts vertex data into a 3MF mesh.\r\n     * @param data The positions and indices used to generate the mesh.\r\n     * @returns The generated 3MF mesh.\r\n     */\r\n    private _buildMesh(data: I3mfVertexData): I3mfMesh {\r\n        const vertices = this._buildVertices(data.positions);\r\n        const triangles = this._buildTriangle(data.indices);\r\n        return new ThreeMfMesh(vertices, triangles);\r\n    }\r\n\r\n    /**\r\n     * Converts a flat position array into a 3MF vertex list, applying the vertex handler when one is registered.\r\n     * @param p The flat array of x, y and z positions.\r\n     * @returns The generated 3MF vertex list.\r\n     */\r\n    private _buildVertices(p: ThreeMfFloatArray | null): I3mfVertices {\r\n        const container = new ThreeMfVertices();\r\n        if (p) {\r\n            for (let i = 0; i < p.length;) {\r\n                const x = p[i++];\r\n                const y = p[i++];\r\n                const z = p[i++];\r\n                let v = new ThreeMfVertex(x, y, z);\r\n                // might be optimized....\r\n                if (this._vh) {\r\n                    v = this._vh(v);\r\n                }\r\n                container.vertex.push(v);\r\n            }\r\n        }\r\n        return container;\r\n    }\r\n\r\n    /**\r\n     * Converts a flat index array into a 3MF triangle list, applying the triangle handler when one is registered.\r\n     * @param indice The flat array of vertex indices, three per triangle.\r\n     * @returns The generated 3MF triangle list.\r\n     */\r\n    private _buildTriangle(indice: ThreeMfIndicesArray | null): I3mfTriangles {\r\n        const container = new ThreeMfTriangles();\r\n        if (indice) {\r\n            for (let i = 0; i < indice.length;) {\r\n                const a = indice[i++];\r\n                const b = indice[i++];\r\n                const c = indice[i++];\r\n                let t = new ThreeMfTriangle(a, b, c);\r\n                // might be optimized....\r\n                if (this._th) {\r\n                    t = this._th(t);\r\n                }\r\n                container.triangle.push(t);\r\n            }\r\n        }\r\n        return container;\r\n    }\r\n}\r\n\r\n/**\r\n * Fluent builder for a 3MF base materials resource.\r\n * Colors are stored as sRGB hexadecimal strings as required by the 3MF specification.\r\n */\r\nexport class ThreeMfMaterialBuilder {\r\n    private _m: I3mfBaseMaterials;\r\n\r\n    /**\r\n     * Creates a new base materials builder.\r\n     * @param id The unique resource id of the base materials group within the model.\r\n     */\r\n    public constructor(id: ST_ResourceID) {\r\n        this._m = new ThreeMfBaseMaterials(id);\r\n    }\r\n\r\n    /**\r\n     * Adds a named color to the group, or updates it when the name already exists.\r\n     * @param name The name of the material. The lookup is case insensitive.\r\n     * @param color The linear RGBA color, converted to an sRGB hexadecimal string.\r\n     * @returns This builder, to allow chaining.\r\n     */\r\n    public withColor(name: string, color: I3mfRGBAColor): ThreeMfMaterialBuilder {\r\n        this._m.base = this._m.base ?? [];\r\n        let m = this._m.base.find((m) => m.name.toLowerCase() === name.toLowerCase());\r\n        if (m) {\r\n            m.displaycolor = this._rgbaToHex(color);\r\n            return this;\r\n        }\r\n        m = new ThreeMfBase(name, this._rgbaToHex(color));\r\n        this._m.base.push(m);\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Returns the base materials group that has been built.\r\n     * @returns The built base materials resource.\r\n     */\r\n    public build(): I3mfBaseMaterials {\r\n        return this._m;\r\n    }\r\n\r\n    /**\r\n     * Converts a linear color into the sRGB hexadecimal string used by 3MF.\r\n     * @param c The linear color to convert. The alpha channel is optional.\r\n     * @returns The color as `#RRGGBB`, or `#RRGGBBAA` when an alpha channel is provided.\r\n     */\r\n    private _rgbaToHex(c: I3mfRGBAColor | { r: number; g: number; b: number; a?: number }): string {\r\n        const toSRGB = (c: number) => Math.round(Math.min(255, Math.max(0, Math.pow(c, 1 / 2.2) * 255)));\r\n\r\n        const r = toSRGB(c.r).toString(16).padStart(2, \"0\").toUpperCase();\r\n        const g = toSRGB(c.g).toString(16).padStart(2, \"0\").toUpperCase();\r\n        const b = toSRGB(c.b).toString(16).padStart(2, \"0\").toUpperCase();\r\n\r\n        if (typeof (c as any).a === \"number\") {\r\n            const a = Math.round(Math.min(255, Math.max(0, c.a! * 255)))\r\n                .toString(16)\r\n                .padStart(2, \"0\")\r\n                .toUpperCase();\r\n            return `#${r}${g}${b}${a}`;\r\n        }\r\n\r\n        return `#${r}${g}${b}`;\r\n    }\r\n}\r\n\r\n/**\r\n * Fluent builder for a 3MF model, the root part of a 3MF document.\r\n * It aggregates the resources (materials, meshes and components) and the build items that reference them.\r\n */\r\nexport class ThreeMfModelBuilder {\r\n    /**\r\n     * The lower cased set of the metadata names defined by the 3MF specification.\r\n     */\r\n    static KnownMetaSet = new Set(ThreeMfModel.KnownMeta.map((m) => m.toLowerCase()));\r\n\r\n    /**\r\n     * The 3MF model currently being built.\r\n     */\r\n    _model: ThreeMfModel = new ThreeMfModel();\r\n    /**\r\n     * The object resources added to the model, indexed by resource id.\r\n     */\r\n    _objects = new Map<string, I3mfObject>();\r\n\r\n    /**\r\n     * Adds a metadata entry to the model.\r\n     * @param name The metadata name. Names outside of the 3MF specification must be namespace qualified.\r\n     * @param value The metadata value.\r\n     * @param preserve Whether consumers must preserve this entry when editing the document.\r\n     * @param type The XML schema type of the value. Defaults to `xs:string`.\r\n     * @returns This builder, to allow chaining.\r\n     */\r\n    public withMetaData(name: string, value: string, preserve?: boolean, type?: string): ThreeMfModelBuilder {\r\n        if (!this._model.metadata) {\r\n            // lazzy\r\n            this._model.metadata = new Array<I3mfMetadata>();\r\n        }\r\n        //const isKnownMeta = (s: string): boolean => TMFBuilder.knownMetaSet.has(s.toLowerCase());\r\n        //const qn:IQName = xmlNameToParts(name);\r\n        this._model.metadata.push(new ThreeMfMeta(name, value, preserve, type));\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Adds a base materials group to the model resources.\r\n     * @param material The base materials resource, or a builder that produces one.\r\n     * @returns This builder, to allow chaining.\r\n     */\r\n    public withMaterial(material: I3mfBaseMaterials | ThreeMfMaterialBuilder): ThreeMfModelBuilder {\r\n        if (material instanceof ThreeMfMaterialBuilder) {\r\n            material = material.build();\r\n        }\r\n        if (material) {\r\n            this._model.resources = this._model.resources ?? new ThreeMfResources();\r\n            this._model.resources.basematerials = this._model.resources.basematerials ?? [];\r\n            this._model.resources.basematerials.push(material);\r\n        }\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Adds a mesh object to the model resources.\r\n     * @param object The object resource, or a builder that produces one.\r\n     * @returns This builder, to allow chaining.\r\n     */\r\n    public withMesh(object: I3mfObject | ThreeMfMeshBuilder): ThreeMfModelBuilder {\r\n        if (object instanceof ThreeMfMeshBuilder) {\r\n            object = object.build();\r\n        }\r\n        this._model.resources = this._model.resources ?? new ThreeMfResources();\r\n        this._model.resources.object.push(object);\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Adds a components object to the model resources.\r\n     * @param components The object resource, or a builder that produces one.\r\n     * @returns This builder, to allow chaining.\r\n     */\r\n    public withComponents(components: I3mfObject | ThreeMfComponentsBuilder): ThreeMfModelBuilder {\r\n        if (components instanceof ThreeMfComponentsBuilder) {\r\n            components = components.build();\r\n        }\r\n        this._model.resources = this._model.resources ?? new ThreeMfResources();\r\n        this._model.resources.object.push(components);\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Adds a build item, which places an object resource in the build plate.\r\n     * @param objectid The resource id of the object to place.\r\n     * @param transform The optional transform applied to the object.\r\n     * @param partnumber The optional part number identifying the produced part.\r\n     * @returns This builder, to allow chaining.\r\n     */\r\n    public withBuild(objectid: ST_ResourceID, transform?: Matrix3d, partnumber?: string): ThreeMfModelBuilder {\r\n        this._model.build = this._model.build ?? new ThreeMfBuild();\r\n        this._model.build.item?.push(new ThreeMfItem(objectid, transform, partnumber));\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Sets the unit in which the model coordinates are expressed.\r\n     * @param unit The 3MF unit (micron, millimeter, centimeter, inch, foot or meter).\r\n     * @returns This builder, to allow chaining.\r\n     */\r\n    public withUnit(unit: ST_Unit): ThreeMfModelBuilder {\r\n        this._model.unit = unit;\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Discards the current model and starts building a new one.\r\n     * @returns This builder, to allow chaining.\r\n     */\r\n    public reset(): ThreeMfModelBuilder {\r\n        this._model = new ThreeMfModel();\r\n        this._objects = new Map<string, I3mfObject>();\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Validates and returns the model that has been built.\r\n     * @returns The built 3MF model.\r\n     * @throws When the model has no object resource or no build item.\r\n     */\r\n    public build(): ThreeMfModel {\r\n        // quick surface check..\r\n        if (!this._model.resources?.object?.length) {\r\n            throw new Error(\"Invalid state: resources MUST be defined \");\r\n        }\r\n        if (!this._model.build?.item?.length) {\r\n            throw new Error(\"Invalid state: Build MUST be defined \");\r\n        }\r\n        return this._model;\r\n    }\r\n}\r\n\r\n/**\r\n * Fluent builder for a 3MF document, the OPC package that wraps the model.\r\n * It gathers the content types, the relationships and the model part.\r\n */\r\nexport class ThreeMfDocumentBuilder {\r\n    private _cts?: I3mfContentTypes;\r\n    private _rs?: I3mfRelationships;\r\n    private _m?: I3mfModel;\r\n\r\n    /**\r\n     * Declares an OPC content type. Duplicate declarations are ignored.\r\n     * @param type The extension to content type mapping to declare.\r\n     * @returns This builder, to allow chaining.\r\n     */\r\n    public withContentType(type: I3mfContentType): ThreeMfDocumentBuilder {\r\n        if (!this._cts) {\r\n            this._cts = new ThreeMfContentTypes();\r\n        }\r\n        const arr = this._cts.items;\r\n        if (!arr.some((x) => x.ext === type.ext && x.ct === type.ct)) {\r\n            arr.push(type);\r\n        }\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Adds an OPC relationship and ensures the relationships content type is declared.\r\n     * Relationships with an already registered id are ignored.\r\n     * @param rel The relationship to add.\r\n     * @returns This builder, to allow chaining.\r\n     */\r\n    public withRelationship(rel: I3mfRelationship): ThreeMfDocumentBuilder {\r\n        if (!this._rs) {\r\n            this._rs = new ThreeMfRelationships();\r\n        }\r\n        const arr = this._rs.items;\r\n        if (!arr.some((x) => x.id === rel.id)) {\r\n            arr.push(rel);\r\n        }\r\n        // here we ensure that the content type is declared.\r\n        this.withContentType(new ThreeMfContentType(\"rels\", KnownI3mfContentType.Relationships));\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Sets the model part of the document and ensures the model content type is declared.\r\n     * @param m The model resource, or a builder that produces one.\r\n     * @returns This builder, to allow chaining.\r\n     */\r\n    public withModel(m: I3mfModel | ThreeMfModelBuilder): ThreeMfDocumentBuilder {\r\n        if (m instanceof ThreeMfModelBuilder) {\r\n            m = m.build();\r\n        }\r\n        this._m = m;\r\n        // here we ensure that the content type is declared.\r\n        this.withContentType(new ThreeMfContentType(\"model\", KnownI3mfContentType.Model));\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Validates and returns the document that has been built.\r\n     * A default relationship pointing at the model part is generated when none was provided.\r\n     * @returns The built 3MF document.\r\n     * @throws When no model has been set.\r\n     */\r\n    public build(): I3mfDocument {\r\n        if (!this._m) {\r\n            throw new Error(\"Invalid state: you Must provide at least a model.\");\r\n        }\r\n\r\n        // we automate the build of the relationship if not provided..\r\n        const path = `${Object3dDirName}${ModelFileName}`;\r\n        if (!this._rs) {\r\n            const absolutePath = `/${path}`;\r\n            this.withRelationship(new ThreeMfRelationship(`rel${0}`, Known3mfRelationshipTypes.ThreeDimModel, absolutePath));\r\n        }\r\n\r\n        return new ThreeMfDocument(this._cts!, this._rs!, this._m);\r\n    }\r\n}\r\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@babylonjs/serializers",
-    "version": "9.18.1",
+    "version": "9.18.2",
     "main": "index.js",
     "module": "index.js",
     "types": "index.d.ts",
@@ -18,10 +18,10 @@
         "postcompile": "build-tools -c add-js-to-es6"
     },
     "devDependencies": {
-        "@babylonjs/core": "9.18.1",
+        "@babylonjs/core": "9.18.2",
         "@dev/build-tools": "^1.0.0",
         "@dev/serializers": "^1.0.0",
-        "babylonjs-gltf2interface": "9.18.1"
+        "babylonjs-gltf2interface": "9.18.2"
     },
     "peerDependencies": {
         "@babylonjs/core": "^9.0.0",