@mat3ra/esse 2026.6.5-0 → 2026.6.12-0

package/dist/js/types.d.ts

@@ -5090,6 +5090,40 @@ export interface FileMetadata {
      */
     filetype?: string;
 }
+/** Schema dist/js/schema/core/reusable/formation_energy_contribution.json */
+/**
+ * Total energy contribution of one material used in formation energy calculation.
+ */
+export interface FormationEnergyContributionSchema {
+    /**
+     * formula or label for the material used in the formation energy calculation
+     */
+    formula: string;
+    /**
+     * number of atoms in the material
+     */
+    n_atoms: number;
+    /**
+     * whether the material is an elemental reference
+     */
+    is_elemental: boolean;
+    /**
+     * total energy of the material
+     */
+    total_energy: number;
+    /**
+     * total energy per atom of the material
+     */
+    total_energy_per_atom: number;
+    /**
+     * precision value for the total energy property
+     */
+    precision_value: number;
+    /**
+     * metric used to report total energy precision
+     */
+    precision_metric: "unknown" | "KPPRA" | "spacing";
+}
 /** Schema dist/js/schema/core/reusable/frequency_function_matrix.json */
 /**
  * Schema for a function of frequency yielding a nx3 matrix
@@ -52211,7 +52245,7 @@ export type ExternalSource = "ICSD" | "MaterialsProject" | "MaterialsProjectLega
  * This interface was referenced by `PropertiesDirectoryEnumOptions`'s JSON-Schema
  * via the `definition` "PropertyType".
  */
-export type PropertyType = "scalar" | "non-scalar" | "tensor" | "object";
+export type PropertyType = "scalar" | "non-scalar" | "tensor" | "object" | "array-of-objects";
 /**
  * This interface was referenced by `PropertiesDirectoryEnumOptions`'s JSON-Schema
  * via the `definition` "ScalarPropertyEnum".
@@ -52232,6 +52266,11 @@ export type TensorPropertyEnum = "atomic_forces" | "magnetic_moments" | "stress_
  * via the `definition` "ObjectPropertyEnum".
  */
 export type ObjectPropertyEnum = "total_energy_contributions";
+/**
+ * This interface was referenced by `PropertiesDirectoryEnumOptions`'s JSON-Schema
+ * via the `definition` "ArrayOfObjectsPropertyEnum".
+ */
+export type ArrayOfObjectsPropertyEnum = "formation_energy_contributions";
 /**
  * This interface was referenced by `PropertiesDirectoryEnumOptions`'s JSON-Schema
  * via the `definition` "ProtoPropertyEnum".
@@ -52513,6 +52552,43 @@ export interface FinalStructurePropertySchema {
      */
     materialId: string;
 }
+/** Schema dist/js/schema/properties_directory/non_scalar/formation_energy_contributions.json */
+/**
+ * Elemental reference total energies used to calculate formation energy.
+ */
+export interface FormationEnergyContributionsPropertySchema {
+    name: "formation_energy_contributions";
+    values: {
+        /**
+         * formula or label for the material used in the formation energy calculation
+         */
+        formula: string;
+        /**
+         * number of atoms in the material
+         */
+        n_atoms: number;
+        /**
+         * whether the material is an elemental reference
+         */
+        is_elemental: boolean;
+        /**
+         * total energy of the material
+         */
+        total_energy: number;
+        /**
+         * total energy per atom of the material
+         */
+        total_energy_per_atom: number;
+        /**
+         * precision value for the total energy property
+         */
+        precision_value: number;
+        /**
+         * metric used to report total energy precision
+         */
+        precision_metric: "unknown" | "KPPRA" | "spacing";
+    }[];
+}
 /** Schema dist/js/schema/properties_directory/non_scalar/hubbard_u.json */
 /**
  * Hubbard U values in eV corresponding to atomic species, orbital and site number.
@@ -56178,6 +56254,38 @@ export interface PropertyHolderSchema {
         };
         name: "total_energy_contributions";
         units?: "kcal/mol" | "kJ/mol" | "eV" | "J/mol" | "hartree" | "cm-1" | "Ry" | "eV/atom";
+    } | {
+        name: "formation_energy_contributions";
+        values: {
+            /**
+             * formula or label for the material used in the formation energy calculation
+             */
+            formula: string;
+            /**
+             * number of atoms in the material
+             */
+            n_atoms: number;
+            /**
+             * whether the material is an elemental reference
+             */
+            is_elemental: boolean;
+            /**
+             * total energy of the material
+             */
+            total_energy: number;
+            /**
+             * total energy per atom of the material
+             */
+            total_energy_per_atom: number;
+            /**
+             * precision value for the total energy property
+             */
+            precision_value: number;
+            /**
+             * metric used to report total energy precision
+             */
+            precision_metric: "unknown" | "KPPRA" | "spacing";
+        }[];
     } | {
         xAxis: {
             /**

package/example/core/reusable/formation_energy_contribution.json

@@ -0,0 +1,9 @@
+{
+    "formula": "SiC",
+    "n_atoms": 4,
+    "is_elemental": false,
+    "total_energy": -520.004,
+    "total_energy_per_atom": -130.001,
+    "precision_value": 8192,
+    "precision_metric": "KPPRA"
+}

package/example/properties_directory/non-scalar/formation_energy_contributions.json

@@ -0,0 +1,32 @@
+{
+    "name": "formation_energy_contributions",
+    "values": [
+        {
+            "formula": "SiC",
+            "n_atoms": 4,
+            "is_elemental": false,
+            "total_energy": -520.003969643439,
+            "total_energy_per_atom": -130.00099241085975,
+            "precision_value": 8192,
+            "precision_metric": "KPPRA"
+        },
+        {
+            "formula": "Si",
+            "n_atoms": 2,
+            "is_elemental": true,
+            "total_energy": -261.003969643439,
+            "total_energy_per_atom": -130.5019848217195,
+            "precision_value": 8192,
+            "precision_metric": "KPPRA"
+        },
+        {
+            "formula": "C",
+            "n_atoms": 2,
+            "is_elemental": true,
+            "total_energy": -321.003969643439,
+            "total_energy_per_atom": -160.5019848217195,
+            "precision_value": 8000,
+            "precision_metric": "KPPRA"
+        }
+    ]
+}

package/manifest/properties.yaml

@@ -129,6 +129,11 @@ total_energy_contributions:
   schemaId: properties-directory/non-scalar/total-energy-contributions
   isResult: true
 
+formation_energy_contributions:
+  defaults:
+  schemaId: properties-directory/non-scalar/formation-energy-contributions
+  isResult: true
+
 band_gaps:
   types:
     - direct

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mat3ra/esse",
-    "version": "2026.6.5-0",
+    "version": "2026.6.12-0",
     "description": "Mat3ra's Excellent Source of Schemas and Examples (ESSE) for Digital Materials R&D",
     "scripts": {
         "transpile": "tsc -p tsconfig-transpile.json",

package/schema/core/reusable/formation_energy_contribution.json

@@ -0,0 +1,53 @@
+{
+    "$id": "core/reusable/formation-energy-contribution",
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "Formation energy contribution schema",
+    "description": "Total energy contribution of one material used in formation energy calculation.",
+    "type": "object",
+    "properties": {
+        "formula": {
+            "description": "formula or label for the material used in the formation energy calculation",
+            "type": "string"
+        },
+        "n_atoms": {
+            "description": "number of atoms in the material",
+            "type": "integer"
+        },
+        "is_elemental": {
+            "description": "whether the material is an elemental reference",
+            "type": "boolean"
+        },
+        "total_energy": {
+            "description": "total energy of the material",
+            "type": "number"
+        },
+        "total_energy_per_atom": {
+            "description": "total energy per atom of the material",
+            "type": "number"
+        },
+        "precision_value": {
+            "description": "precision value for the total energy property",
+            "type": "number",
+            "default": -1
+        },
+        "precision_metric": {
+            "description": "metric used to report total energy precision",
+            "type": "string",
+            "enum": [
+                "unknown",
+                "KPPRA",
+                "spacing"
+            ],
+            "default": "unknown"
+        }
+    },
+    "required": [
+        "formula",
+        "n_atoms",
+        "is_elemental",
+        "total_energy",
+        "total_energy_per_atom",
+        "precision_metric",
+        "precision_value"
+    ]
+}

package/schema/properties_directory/enum_options.json

@@ -15,7 +15,8 @@
                 "scalar",
                 "non-scalar",
                 "tensor",
-                "object"
+                "object",
+                "array-of-objects"
             ]
         },
         "ScalarPropertyEnum": {
@@ -77,6 +78,12 @@
                 "total_energy_contributions"
             ]
         },
+        "ArrayOfObjectsPropertyEnum": {
+            "type": "string",
+            "enum": [
+                "formation_energy_contributions"
+            ]
+        },
         "ProtoPropertyEnum": {
             "type": "string",
             "enum": [

package/schema/properties_directory/non-scalar/formation_energy_contributions.json

@@ -0,0 +1,24 @@
+{
+    "$id": "properties-directory/non-scalar/formation-energy-contributions",
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "Formation energy contributions property schema",
+    "description": "Elemental reference total energies used to calculate formation energy.",
+    "type": "object",
+    "properties": {
+        "name": {
+            "enum": [
+                "formation_energy_contributions"
+            ]
+        },
+        "values": {
+            "type": "array",
+            "items": {
+                "$ref": "../../core/reusable/formation_energy_contribution.json"
+            }
+        }
+    },
+    "required": [
+        "name",
+        "values"
+    ]
+}

package/schema/property/holder.json

@@ -75,6 +75,9 @@
                 {
                     "$ref": "../properties_directory/non-scalar/total_energy_contributions.json"
                 },
+                {
+                    "$ref": "../properties_directory/non-scalar/formation_energy_contributions.json"
+                },
                 {
                     "$ref": "../properties_directory/non-scalar/phonon_dos.json"
                 },