@babylonjs/serializers 7.37.1 → 7.37.2

package/glTF/2.0/glTFSerializer.js

@@ -1,58 +1,39 @@
-import { _Exporter } from "./glTFExporter.js";
+import { GLTFExporter } from "./glTFExporter.js";
 /**
  * Class for generating glTF data from a Babylon scene.
  */
 export class GLTF2Export {
     /**
-     * Exports the geometry of the scene to .gltf file format asynchronously
-     * @param scene Babylon scene with scene hierarchy information
-     * @param filePrefix File prefix to use when generating the glTF file
+     * Exports the scene to .gltf file format
+     * @param scene Babylon scene
+     * @param fileName Name to use for the .gltf file
      * @param options Exporter options
-     * @returns Returns an object with a .gltf file and associates texture names
-     * as keys and their data and paths as values
+     * @returns Returns the exported data
      */
-    static GLTFAsync(scene, filePrefix, options) {
-        return scene.whenReadyAsync().then(() => {
-            const glTFPrefix = filePrefix.replace(/\.[^/.]+$/, "");
-            const gltfGenerator = new _Exporter(scene, options);
-            return gltfGenerator._generateGLTFAsync(glTFPrefix);
-        });
-    }
-    static _PreExportAsync(scene, options) {
-        return Promise.resolve().then(() => {
-            if (options && options.exportWithoutWaitingForScene) {
-                return Promise.resolve();
-            }
-            else {
-                return scene.whenReadyAsync();
-            }
-        });
-    }
-    static _PostExportAsync(scene, glTFData, options) {
-        return Promise.resolve().then(() => {
-            if (options && options.exportWithoutWaitingForScene) {
-                return glTFData;
-            }
-            else {
-                return glTFData;
-            }
-        });
+    static async GLTFAsync(scene, fileName, options) {
+        if (!options || !options.exportWithoutWaitingForScene) {
+            await scene.whenReadyAsync();
+        }
+        const exporter = new GLTFExporter(scene, options);
+        const data = await exporter.generateGLTFAsync(fileName.replace(/\.[^/.]+$/, ""));
+        exporter.dispose();
+        return data;
     }
     /**
-     * Exports the geometry of the scene to .glb file format asychronously
-     * @param scene Babylon scene with scene hierarchy information
-     * @param filePrefix File prefix to use when generating glb file
+     * Exports the scene to .glb file format
+     * @param scene Babylon scene
+     * @param fileName Name to use for the .glb file
      * @param options Exporter options
-     * @returns Returns an object with a .glb filename as key and data as value
+     * @returns Returns the exported data
      */
-    static GLBAsync(scene, filePrefix, options) {
-        return this._PreExportAsync(scene, options).then(() => {
-            const glTFPrefix = filePrefix.replace(/\.[^/.]+$/, "");
-            const gltfGenerator = new _Exporter(scene, options);
-            return gltfGenerator._generateGLBAsync(glTFPrefix).then((glTFData) => {
-                return this._PostExportAsync(scene, glTFData, options);
-            });
-        });
+    static async GLBAsync(scene, fileName, options) {
+        if (!options || !options.exportWithoutWaitingForScene) {
+            await scene.whenReadyAsync();
+        }
+        const exporter = new GLTFExporter(scene, options);
+        const data = await exporter.generateGLBAsync(fileName.replace(/\.[^/.]+$/, ""));
+        exporter.dispose();
+        return data;
     }
 }
 //# sourceMappingURL=glTFSerializer.js.map

package/glTF/2.0/glTFSerializer.js.map

@@ -1 +1 @@
-{"version":3,"file":"glTFSerializer.js","sourceRoot":"","sources":["../../../../../dev/serializers/src/glTF/2.0/glTFSerializer.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAsD3C;;GAEG;AACH,MAAM,OAAO,WAAW;IACpB;;;;;;;OAOG;IACI,MAAM,CAAC,SAAS,CAAC,KAAY,EAAE,UAAkB,EAAE,OAAwB;QAC9E,OAAO,KAAK,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;YACpC,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACvD,MAAM,aAAa,GAAG,IAAI,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACpD,OAAO,aAAa,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACP,CAAC;IAEO,MAAM,CAAC,eAAe,CAAC,KAAY,EAAE,OAAwB;QACjE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;YAC/B,IAAI,OAAO,IAAI,OAAO,CAAC,4BAA4B,EAAE,CAAC;gBAClD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACJ,OAAO,KAAK,CAAC,cAAc,EAAE,CAAC;YAClC,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;IAEO,MAAM,CAAC,gBAAgB,CAAC,KAAY,EAAE,QAAkB,EAAE,OAAwB;QACtF,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;YAC/B,IAAI,OAAO,IAAI,OAAO,CAAC,4BAA4B,EAAE,CAAC;gBAClD,OAAO,QAAQ,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACJ,OAAO,QAAQ,CAAC;YACpB,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,QAAQ,CAAC,KAAY,EAAE,UAAkB,EAAE,OAAwB;QAC7E,OAAO,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YAClD,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACvD,MAAM,aAAa,GAAG,IAAI,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACpD,OAAO,aAAa,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACjE,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC3D,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;CACJ","sourcesContent":["import type { Node } from \"core/node\";\r\nimport type { Scene } from \"core/scene\";\r\nimport type { Animation } from \"core/Animations/animation\";\r\nimport type { GLTFData } from \"./glTFData\";\r\nimport { _Exporter } from \"./glTFExporter\";\r\n\r\n/**\r\n * Holds a collection of exporter options and parameters\r\n */\r\nexport interface IExportOptions {\r\n    /**\r\n     * Function which indicates whether a babylon node should be exported or not\r\n     * @param node source Babylon node. It is used to check whether it should be exported to glTF or not\r\n     * @returns boolean, which indicates whether the node should be exported (true) or not (false)\r\n     */\r\n    shouldExportNode?(node: Node): boolean;\r\n\r\n    /**\r\n     * Function which indicates whether an animation on the scene should be exported or not\r\n     * @param animation source animation\r\n     * @returns boolean, which indicates whether the animation should be exported (true) or not (false)\r\n     */\r\n    shouldExportAnimation?(animation: Animation): boolean;\r\n\r\n    /**\r\n     * Function used to extract the part of node's metadata that will be exported into glTF node extras\r\n     * @param metadata source metadata to read from\r\n     * @returns the data to store to glTF node extras\r\n     */\r\n    metadataSelector?(metadata: any): any;\r\n\r\n    /**\r\n     * The sample rate to bake animation curves. Defaults to 1 / 60.\r\n     */\r\n    animationSampleRate?: number;\r\n\r\n    /**\r\n     * Begin serialization without waiting for the scene to be ready. Defaults to false.\r\n     */\r\n    exportWithoutWaitingForScene?: boolean;\r\n\r\n    /**\r\n     * Indicates if unused vertex uv attributes should be included in export. Defaults to false.\r\n     */\r\n    exportUnusedUVs?: boolean;\r\n\r\n    /**\r\n     * Remove no-op root nodes when possible. Defaults to true.\r\n     */\r\n    removeNoopRootNodes?: boolean;\r\n\r\n    /**\r\n     * Indicates if coordinate system swapping root nodes should be included in export. Defaults to false.\r\n     * @deprecated Please use removeNoopRootNodes instead\r\n     */\r\n    includeCoordinateSystemConversionNodes?: boolean;\r\n}\r\n\r\n/**\r\n * Class for generating glTF data from a Babylon scene.\r\n */\r\nexport class GLTF2Export {\r\n    /**\r\n     * Exports the geometry of the scene to .gltf file format asynchronously\r\n     * @param scene Babylon scene with scene hierarchy information\r\n     * @param filePrefix File prefix to use when generating the glTF file\r\n     * @param options Exporter options\r\n     * @returns Returns an object with a .gltf file and associates texture names\r\n     * as keys and their data and paths as values\r\n     */\r\n    public static GLTFAsync(scene: Scene, filePrefix: string, options?: IExportOptions): Promise<GLTFData> {\r\n        return scene.whenReadyAsync().then(() => {\r\n            const glTFPrefix = filePrefix.replace(/\\.[^/.]+$/, \"\");\r\n            const gltfGenerator = new _Exporter(scene, options);\r\n            return gltfGenerator._generateGLTFAsync(glTFPrefix);\r\n        });\r\n    }\r\n\r\n    private static _PreExportAsync(scene: Scene, options?: IExportOptions): Promise<void> {\r\n        return Promise.resolve().then(() => {\r\n            if (options && options.exportWithoutWaitingForScene) {\r\n                return Promise.resolve();\r\n            } else {\r\n                return scene.whenReadyAsync();\r\n            }\r\n        });\r\n    }\r\n\r\n    private static _PostExportAsync(scene: Scene, glTFData: GLTFData, options?: IExportOptions): Promise<GLTFData> {\r\n        return Promise.resolve().then(() => {\r\n            if (options && options.exportWithoutWaitingForScene) {\r\n                return glTFData;\r\n            } else {\r\n                return glTFData;\r\n            }\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Exports the geometry of the scene to .glb file format asychronously\r\n     * @param scene Babylon scene with scene hierarchy information\r\n     * @param filePrefix File prefix to use when generating glb file\r\n     * @param options Exporter options\r\n     * @returns Returns an object with a .glb filename as key and data as value\r\n     */\r\n    public static GLBAsync(scene: Scene, filePrefix: string, options?: IExportOptions): Promise<GLTFData> {\r\n        return this._PreExportAsync(scene, options).then(() => {\r\n            const glTFPrefix = filePrefix.replace(/\\.[^/.]+$/, \"\");\r\n            const gltfGenerator = new _Exporter(scene, options);\r\n            return gltfGenerator._generateGLBAsync(glTFPrefix).then((glTFData) => {\r\n                return this._PostExportAsync(scene, glTFData, options);\r\n            });\r\n        });\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"glTFSerializer.js","sourceRoot":"","sources":["../../../../../dev/serializers/src/glTF/2.0/glTFSerializer.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAsD9C;;GAEG;AACH,MAAM,OAAO,WAAW;IACpB;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,KAAY,EAAE,QAAgB,EAAE,OAAwB;QAClF,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,CAAC;YACpD,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;QACjF,QAAQ,CAAC,OAAO,EAAE,CAAC;QAEnB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAY,EAAE,QAAgB,EAAE,OAAwB;QACjF,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,CAAC;YACpD,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;QAChF,QAAQ,CAAC,OAAO,EAAE,CAAC;QAEnB,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ","sourcesContent":["import type { Node } from \"core/node\";\r\nimport type { Scene } from \"core/scene\";\r\nimport type { Animation } from \"core/Animations/animation\";\r\nimport type { GLTFData } from \"./glTFData\";\r\nimport { GLTFExporter } from \"./glTFExporter\";\r\n\r\n/**\r\n * Holds a collection of exporter options and parameters\r\n */\r\nexport interface IExportOptions {\r\n    /**\r\n     * Function which indicates whether a babylon node should be exported or not\r\n     * @param node source Babylon node. It is used to check whether it should be exported to glTF or not\r\n     * @returns boolean, which indicates whether the node should be exported (true) or not (false)\r\n     */\r\n    shouldExportNode?(node: Node): boolean;\r\n\r\n    /**\r\n     * Function which indicates whether an animation on the scene should be exported or not\r\n     * @param animation source animation\r\n     * @returns boolean, which indicates whether the animation should be exported (true) or not (false)\r\n     */\r\n    shouldExportAnimation?(animation: Animation): boolean;\r\n\r\n    /**\r\n     * Function used to extract the part of node's metadata that will be exported into glTF node extras\r\n     * @param metadata source metadata to read from\r\n     * @returns the data to store to glTF node extras\r\n     */\r\n    metadataSelector?(metadata: any): any;\r\n\r\n    /**\r\n     * The sample rate to bake animation curves. Defaults to 1 / 60.\r\n     */\r\n    animationSampleRate?: number;\r\n\r\n    /**\r\n     * Begin serialization without waiting for the scene to be ready. Defaults to false.\r\n     */\r\n    exportWithoutWaitingForScene?: boolean;\r\n\r\n    /**\r\n     * Indicates if unused vertex uv attributes should be included in export. Defaults to false.\r\n     */\r\n    exportUnusedUVs?: boolean;\r\n\r\n    /**\r\n     * Remove no-op root nodes when possible. Defaults to true.\r\n     */\r\n    removeNoopRootNodes?: boolean;\r\n\r\n    /**\r\n     * Indicates if coordinate system swapping root nodes should be included in export. Defaults to false.\r\n     * @deprecated Please use removeNoopRootNodes instead\r\n     */\r\n    includeCoordinateSystemConversionNodes?: boolean;\r\n}\r\n\r\n/**\r\n * Class for generating glTF data from a Babylon scene.\r\n */\r\nexport class GLTF2Export {\r\n    /**\r\n     * Exports the scene to .gltf file format\r\n     * @param scene Babylon scene\r\n     * @param fileName Name to use for the .gltf file\r\n     * @param options Exporter options\r\n     * @returns Returns the exported data\r\n     */\r\n    public static async GLTFAsync(scene: Scene, fileName: string, options?: IExportOptions): Promise<GLTFData> {\r\n        if (!options || !options.exportWithoutWaitingForScene) {\r\n            await scene.whenReadyAsync();\r\n        }\r\n\r\n        const exporter = new GLTFExporter(scene, options);\r\n        const data = await exporter.generateGLTFAsync(fileName.replace(/\\.[^/.]+$/, \"\"));\r\n        exporter.dispose();\r\n\r\n        return data;\r\n    }\r\n\r\n    /**\r\n     * Exports the scene to .glb file format\r\n     * @param scene Babylon scene\r\n     * @param fileName Name to use for the .glb file\r\n     * @param options Exporter options\r\n     * @returns Returns the exported data\r\n     */\r\n    public static async GLBAsync(scene: Scene, fileName: string, options?: IExportOptions): Promise<GLTFData> {\r\n        if (!options || !options.exportWithoutWaitingForScene) {\r\n            await scene.whenReadyAsync();\r\n        }\r\n\r\n        const exporter = new GLTFExporter(scene, options);\r\n        const data = await exporter.generateGLBAsync(fileName.replace(/\\.[^/.]+$/, \"\"));\r\n        exporter.dispose();\r\n\r\n        return data;\r\n    }\r\n}\r\n"]}

package/glTF/2.0/glTFUtilities.d.ts

@@ -1,46 +1,78 @@
-import type { IBufferView, AccessorComponentType, IAccessor } from "babylonjs-gltf2interface";
-import { AccessorType } from "babylonjs-gltf2interface";
-import type { FloatArray, Nullable } from "@babylonjs/core/types.js";
+import type { IBufferView, AccessorComponentType, IAccessor, INode } from "babylonjs-gltf2interface";
+import { AccessorType, MeshPrimitiveMode } from "babylonjs-gltf2interface";
+import type { FloatArray, DataArray, IndicesArray, Nullable } from "@babylonjs/core/types.js";
 import type { Vector4 } from "@babylonjs/core/Maths/math.vector.js";
-import { Vector3 } from "@babylonjs/core/Maths/math.vector.js";
+import { Quaternion, Vector3 } from "@babylonjs/core/Maths/math.vector.js";
+import { VertexBuffer } from "@babylonjs/core/Buffers/buffer.js";
+import type { Node } from "@babylonjs/core/node.js";
 /**
- * @internal
+ * Creates a buffer view based on the supplied arguments
+ * @param bufferIndex index value of the specified buffer
+ * @param byteOffset byte offset value
+ * @param byteLength byte length of the bufferView
+ * @param byteStride byte distance between conequential elements
+ * @returns bufferView for glTF
  */
-export declare class _GLTFUtilities {
-    /**
-     * Creates a buffer view based on the supplied arguments
-     * @param bufferIndex index value of the specified buffer
-     * @param byteOffset byte offset value
-     * @param byteLength byte length of the bufferView
-     * @param byteStride byte distance between conequential elements
-     * @param name name of the buffer view
-     * @returns bufferView for glTF
-     */
-    static _CreateBufferView(bufferIndex: number, byteOffset: number, byteLength: number, byteStride?: number, name?: string): IBufferView;
-    /**
-     * Creates an accessor based on the supplied arguments
-     * @param bufferviewIndex The index of the bufferview referenced by this accessor
-     * @param name The name of the accessor
-     * @param type The type of the accessor
-     * @param componentType The datatype of components in the attribute
-     * @param count The number of attributes referenced by this accessor
-     * @param byteOffset The offset relative to the start of the bufferView in bytes
-     * @param min Minimum value of each component in this attribute
-     * @param max Maximum value of each component in this attribute
-     * @returns accessor for glTF
-     */
-    static _CreateAccessor(bufferviewIndex: number, name: string, type: AccessorType, componentType: AccessorComponentType, count: number, byteOffset: Nullable<number>, min: Nullable<number[]>, max: Nullable<number[]>): IAccessor;
-    /**
-     * Calculates the minimum and maximum values of an array of position floats
-     * @param positions Positions array of a mesh
-     * @param vertexStart Starting vertex offset to calculate min and max values
-     * @param vertexCount Number of vertices to check for min and max values
-     * @returns min number array and max number array
-     */
-    static _CalculateMinMaxPositions(positions: FloatArray, vertexStart: number, vertexCount: number): {
-        min: number[];
-        max: number[];
-    };
-    static _NormalizeTangentFromRef(tangent: Vector4 | Vector3): void;
-    static _GetDataAccessorElementCount(accessorType: AccessorType): 1 | 3 | 2 | 4 | 9 | 16;
-}
+export declare function CreateBufferView(bufferIndex: number, byteOffset: number, byteLength: number, byteStride?: number): IBufferView;
+/**
+ * Creates an accessor based on the supplied arguments
+ * @param bufferViewIndex The index of the bufferview referenced by this accessor
+ * @param type The type of the accessor
+ * @param componentType The datatype of components in the attribute
+ * @param count The number of attributes referenced by this accessor
+ * @param byteOffset The offset relative to the start of the bufferView in bytes
+ * @param minMax Minimum and maximum value of each component in this attribute
+ * @param normalized Specifies whether integer data values are normalized before usage
+ * @returns accessor for glTF
+ */
+export declare function CreateAccessor(bufferViewIndex: number, type: AccessorType, componentType: AccessorComponentType, count: number, byteOffset: Nullable<number>, minMax?: Nullable<{
+    min: number[];
+    max: number[];
+}>, normalized?: boolean): IAccessor;
+export declare function GetAccessorElementCount(accessorType: AccessorType): number;
+export declare function FloatsNeed16BitInteger(floatArray: FloatArray): boolean;
+export declare function IsStandardVertexAttribute(type: string): boolean;
+export declare function GetAccessorType(kind: string, hasVertexColorAlpha: boolean): AccessorType;
+export declare function GetAttributeType(kind: string): string;
+export declare function GetPrimitiveMode(fillMode: number): MeshPrimitiveMode;
+export declare function IsTriangleFillMode(fillMode: number): boolean;
+export declare function NormalizeTangent(tangent: Vector4 | Vector3): void;
+export declare function ConvertToRightHandedPosition(value: Vector3): Vector3;
+export declare function ConvertToRightHandedRotation(value: Quaternion): Quaternion;
+export declare function ConvertToRightHandedNode(value: INode): void;
+/**
+ * Rotation by 180 as glTF has a different convention than Babylon.
+ * @param rotation Target camera rotation.
+ * @returns Ref to camera rotation.
+ */
+export declare function ConvertCameraRotationToGLTF(rotation: Quaternion): Quaternion;
+export declare function RotateNode180Y(node: INode): void;
+/**
+ * Collapses GLTF parent and node into a single node. This is useful for removing nodes that were added by the GLTF importer.
+ * @param node Target parent node.
+ * @param parentNode Original GLTF node (Light or Camera).
+ */
+export declare function CollapseParentNode(node: INode, parentNode: INode): void;
+/**
+ * Sometimes the GLTF Importer can add extra transform nodes (for lights and cameras). This checks if a parent node was added by the GLTF Importer. If so, it should be removed during serialization.
+ * @param babylonNode Original GLTF node (Light or Camera).
+ * @param parentBabylonNode Target parent node.
+ * @returns True if the parent node was added by the GLTF importer.
+ */
+export declare function IsParentAddedByImporter(babylonNode: Node, parentBabylonNode: Node): boolean;
+export declare function IsNoopNode(node: Node, useRightHandedSystem: boolean): boolean;
+export declare function AreIndices32Bits(indices: Nullable<IndicesArray>, count: number): boolean;
+export declare function IndicesArrayToUint8Array(indices: IndicesArray, start: number, count: number, is32Bits: boolean): Uint8Array;
+export declare function DataArrayToUint8Array(data: DataArray): Uint8Array;
+export declare function GetMinMax(data: DataArray, vertexBuffer: VertexBuffer, start: number, count: number): {
+    min: number[];
+    max: number[];
+};
+/**
+ * Removes, in-place, object properties which have the same value as the default value.
+ * Useful for avoiding unnecessary properties in the glTF JSON.
+ * @param object the object to omit default values from
+ * @param defaultValues a partial object with default values
+ * @returns object with default values omitted
+ */
+export declare function OmitDefaultValues<T extends Object>(object: T, defaultValues: Partial<T>): T;