@mat3ra/made 2026.6.29-0 → 2026.7.4-0

package/dist/js/cell/conventional_cell.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isConventionalCellSameAsPrimitiveForLatticeType = exports.PRIMITIVE_TO_CONVENTIONAL_CELL_LATTICE_TYPES = exports.PRIMITIVE_TO_CONVENTIONAL_CELL_MULTIPLIERS = void 0;
+exports.PRIMITIVE_TO_CONVENTIONAL_CELL_LATTICE_TYPES = exports.PRIMITIVE_TO_CONVENTIONAL_CELL_MULTIPLIERS = void 0;
+exports.isConventionalCellSameAsPrimitiveForLatticeType = isConventionalCellSameAsPrimitiveForLatticeType;
 /**
  * Routines for calculating conventional cell vectors from primitive cell Bravais parameters.
  * Following Setyawan, W., & Curtarolo, S. (2010). doi:10.1016/j.commatsci.2010.05.010
@@ -77,4 +78,3 @@ function isConventionalCellSameAsPrimitiveForLatticeType(latticeType) {
     const multiplier = exports.PRIMITIVE_TO_CONVENTIONAL_CELL_MULTIPLIERS[latticeType || "TRI"];
     return multiplier === unitMatrix;
 }
-exports.isConventionalCellSameAsPrimitiveForLatticeType = isConventionalCellSameAsPrimitiveForLatticeType;

package/dist/js/cell/primitive_cell.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getPrimitiveLatticeVectorsFromConfig = void 0;
+exports.getPrimitiveLatticeVectorsFromConfig = getPrimitiveLatticeVectorsFromConfig;
 const math_1 = require("@mat3ra/code/dist/js/math");
 /**
  * Routines for calculating primitive cell vectors from conventional cell Bravais parameters.
@@ -143,4 +143,3 @@ function getPrimitiveLatticeVectorsFromConfig(latticeConfig) {
     const [vectorA, vectorB, vectorC] = primitiveCellGenerator(latticeConfig);
     return [vectorA, vectorB, vectorC];
 }
-exports.getPrimitiveLatticeVectorsFromConfig = getPrimitiveLatticeVectorsFromConfig;

package/dist/js/lattice/lattice.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Lattice = exports.LatticeVectors = exports.molecularLatticePaddingFactor = exports.diatomicLatticePaddingFactor = exports.defaultNonPeriodicMinimumLatticeSize = void 0;
 const constants_1 = require("@mat3ra/code/dist/js/constants");

package/dist/js/lattice/lattice_types.js

@@ -27,7 +27,7 @@ var LatticeTypeExtended;
     LatticeTypeExtended["TRI_1a"] = "TRI_1a";
     LatticeTypeExtended["TRI_2a"] = "TRI_2a";
     LatticeTypeExtended["TRI_1b"] = "TRI_1b";
-})(LatticeTypeExtended = exports.LatticeTypeExtended || (exports.LatticeTypeExtended = {}));
+})(LatticeTypeExtended || (exports.LatticeTypeExtended = LatticeTypeExtended = {}));
 exports.DEFAULT_LATTICE_UNITS = {
     // by default lattice vectors shall be measured in angstrom, angles - in degrees
     length: {

package/dist/js/lattice/reciprocal/symmetry_points.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.symmetryPoints = void 0;
+exports.symmetryPoints = symmetryPoints;
 const POINTS = {
     CUB: () => {
         return [
@@ -863,4 +863,3 @@ function symmetryPoints(lattice) {
         },
     ].concat(POINTS[lattice.type](lattice) || []);
 }
-exports.symmetryPoints = symmetryPoints;

package/dist/js/material.d.ts

@@ -37,34 +37,34 @@ declare class Material extends InMemoryEntity implements Schema {
      * @summary Returns the specific derived property (as specified by name) for a material.
      */
     getDerivedPropertyByName(name: string): {
-        name?: "volume" | undefined;
-        units?: "angstrom^3" | undefined;
+        name?: "volume";
+        units?: "angstrom^3";
         value: number;
     } | {
-        name?: "density" | undefined;
-        units?: "g/cm^3" | undefined;
+        name?: "density";
+        units?: "g/cm^3";
         value: number;
     } | {
-        pointGroupSymbol?: string | undefined;
-        spaceGroupSymbol?: string | undefined;
+        pointGroupSymbol?: string;
+        spaceGroupSymbol?: string;
         tolerance?: {
-            units?: "angstrom" | undefined;
+            units?: "angstrom";
             value: number;
-        } | undefined;
-        name?: "symmetry" | undefined;
+        };
+        name?: "symmetry";
     } | {
-        name?: "elemental_ratio" | undefined;
+        name?: "elemental_ratio";
         value: number;
-        element?: string | undefined;
+        element?: string;
     } | {
-        name?: "p-norm" | undefined;
-        degree?: number | undefined;
+        name?: "p-norm";
+        degree?: number;
         value: number;
     } | {
-        name?: "inchi" | undefined;
+        name?: "inchi";
         value: string;
     } | {
-        name?: "inchi_key" | undefined;
+        name?: "inchi_key";
         value: string;
     } | undefined;
     /**

package/dist/js/parsers/poscar.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.atomsCount = void 0;
+exports.atomsCount = atomsCount;
 const math_1 = require("@mat3ra/code/dist/js/math");
 const utils_1 = require("@mat3ra/utils");
 const underscore_string_1 = __importDefault(require("underscore.string"));
@@ -63,7 +63,6 @@ function atomsCount(poscarFileContent) {
     const atomsLine = lines[6].split(/\s+/);
     return atomsLine.map((x) => parseInt(x, 10)).reduce((a, b) => a + b);
 }
-exports.atomsCount = atomsCount;
 /**
  * Parses POSCAR file into a Material config object.
  * @param fileContent - POSCAR file content.

package/dist/js/parsers/xyz.js

@@ -3,7 +3,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validate = exports.XYZ_COORDINATE_PRECISION = void 0;
+exports.XYZ_COORDINATE_PRECISION = void 0;
+exports.validate = validate;
 const lodash_1 = require("lodash");
 const underscore_string_1 = __importDefault(require("underscore.string"));
 const constrained_basis_1 = require("../basis/constrained_basis");
@@ -43,7 +44,6 @@ function validate(xyzTxt) {
         .filter((x) => x.trim() !== "")
         .forEach(validateLine);
 }
-exports.validate = validate;
 /**
  * Parses XYZ line and returns an object.
  * @param line - line of text

package/dist/js/parsers/xyz_combinatorial_basis.d.ts

@@ -1,3 +1,4 @@
+import { BasisSchema } from "@mat3ra/esse/dist/js/types";
 import { ElementsAndCoordinatesConfig } from "../basis/basis";
 import { AtomicCoordinateValue } from "../basis/coordinates";
 import { AtomicElementValue } from "../basis/elements";
@@ -37,7 +38,7 @@ export declare class CombinatorialBasis {
      * @return {String[]}
      */
     get uniqueElements(): any[];
-    static toBasisConfigForElementsAndCoordinates(array: ElementWithCoordinate[], units?: "crystal" | "cartesian" | undefined, cell?: Cell): ElementsAndCoordinatesConfig;
+    static toBasisConfigForElementsAndCoordinates(array: ElementWithCoordinate[], units?: BasisSchema["units"], cell?: Cell): ElementsAndCoordinatesConfig;
     /**
      * Returns array of regular bases extracted from current combinatorial basis.
      * @return {Basis[]|Object[]}

package/dist/js/parsers/xyz_combinatorial_basis.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CombinatorialBasis = exports.WrongBasisFormat = void 0;
 const math_1 = require("@mat3ra/code/dist/js/math");

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mat3ra/made",
-    "version": "2026.6.29-0",
+    "version": "2026.7.4-0",
     "description": "MAterials DEsign library",
     "scripts": {
         "lint": "eslint --cache src/js tests/js && prettier --write src/js tests/js",
@@ -14,68 +14,68 @@
     },
     "repository": {
         "type": "git",
-        "url": "https://github.com/Exabyte-io/made.git"
+        "url": "https://github.com/mat3ra/made.git"
     },
     "main": "dist/js/made.js",
     "author": "Exabyte Inc.",
     "bugs": {
-        "url": "https://github.com/Exabyte-io/made/issues"
+        "url": "https://github.com/mat3ra/made/issues"
     },
     "license": "Apache-2.0",
-    "homepage": "https://github.com/Exabyte-io/made",
+    "homepage": "https://github.com/mat3ra/made",
     "engines": {
         "node": ">=0.14"
     },
     "devDependencies": {
-        "@babel/eslint-parser": "^7.16.3",
-        "@babel/plugin-proposal-class-properties": "^7.16.0",
-        "@babel/preset-env": "^7.16.4",
-        "@babel/preset-react": "^7.16.7",
-        "@babel/register": "^7.22.15",
-        "@babel/runtime-corejs3": "^7.16.8",
-        "@exabyte-io/eslint-config": "2025.5.13-0",
-        "@mat3ra/code": "2026.5.27-0",
-        "@mat3ra/esse": "2026.5.27-0",
-        "@mat3ra/tsconfig": "2024.6.3-0",
-        "@mat3ra/utils": "^2026.6.11-0",
+        "@babel/eslint-parser": "^7.29.7",
+        "@babel/plugin-proposal-class-properties": "^7.18.6",
+        "@babel/preset-env": "^7.29.7",
+        "@babel/preset-react": "^7.29.7",
+        "@babel/register": "^7.29.7",
+        "@babel/runtime-corejs3": "^7.29.7",
+        "@exabyte-io/eslint-config": "^2026.7.3-0",
+        "@mat3ra/code": "^2026.5.27-0",
+        "@mat3ra/esse": "^2026.6.30-0",
+        "@mat3ra/tsconfig": "^2024.6.3-0",
+        "@mat3ra/utils": "^2026.7.3-0",
         "@types/crypto-js": "^4.2.2",
-        "@typescript-eslint/eslint-plugin": "^5.9.1",
-        "@typescript-eslint/parser": "^5.9.1",
-        "chai": "^4.3.4",
+        "@typescript-eslint/eslint-plugin": "^5.62.0",
+        "@typescript-eslint/parser": "^5.62.0",
+        "chai": "^4.5.0",
         "chai-almost": "^1.0.1",
         "eslint": "^7.32.0",
-        "eslint-config-airbnb": "^19.0.2",
-        "eslint-config-prettier": "^8.5.0",
+        "eslint-config-airbnb": "^19.0.4",
+        "eslint-config-prettier": "^8.10.2",
         "eslint-import-resolver-exports": "^1.0.0-beta.5",
         "eslint-import-resolver-meteor": "^0.4.0",
-        "eslint-import-resolver-node": "^0.3.9",
-        "eslint-plugin-import": "^2.25.3",
-        "eslint-plugin-jsdoc": "^37.1.0",
-        "eslint-plugin-jsx-a11y": "^6.5.1",
+        "eslint-import-resolver-node": "^0.3.10",
+        "eslint-plugin-import": "^2.32.0",
+        "eslint-plugin-jsdoc": "^37.9.7",
+        "eslint-plugin-jsx-a11y": "^6.10.2",
         "eslint-plugin-mui-path-imports": "0.0.15",
-        "eslint-plugin-prettier": "^4.2.1",
-        "eslint-plugin-react": "^7.30.0",
+        "eslint-plugin-prettier": "^4.2.5",
+        "eslint-plugin-react": "^7.37.5",
         "eslint-plugin-simple-import-sort": "^7.0.0",
         "husky": "^7.0.4",
-        "lint-staged": "^12.1.2",
-        "mocha": "10.3.0",
-        "prettier": "^2.5.1",
+        "lint-staged": "^12.5.0",
+        "mocha": "10.8.2",
+        "prettier": "^2.8.8",
         "nyc": "^15.1.0"
     },
     "dependencies": {
-        "@babel/core": "7.24.1",
-        "@exabyte-io/periodic-table.js": "2022.5.28-0",
-        "@types/chai": "^4.3.5",
+        "@babel/core": "^7.29.7",
+        "@exabyte-io/periodic-table.js": "^2023.12.23-3",
+        "@types/chai": "^4.3.20",
         "@types/chai-almost": "^1.0.3",
-        "@types/mocha": "^10.0.1",
-        "@types/node": "^20.4.2",
-        "@types/underscore.string": "^0.0.40",
+        "@types/mocha": "^10.0.10",
+        "@types/node": "^20.19.43",
+        "@types/underscore.string": "^0.0.42",
         "array-almost-equal": "^1.0.0",
-        "crypto-js": "4.2.0",
-        "lodash": "^4.17.*",
-        "ts-node": "^10.9.1",
-        "typescript": "^4.5.5",
-        "underscore.string": "^3.3.4"
+        "crypto-js": "^4.2.0",
+        "lodash": "^4.18.*",
+        "ts-node": "^10.9.2",
+        "typescript": "^5.9.3",
+        "underscore.string": "^3.3.6"
     },
     "peerDependencies": {
         "@mat3ra/code": "*",

package/pyproject.toml

@@ -3,7 +3,7 @@ name = "mat3ra-made"
 dynamic = ["version"]
 description = "MAterials DEfinitions and/or MAterials DEsign library."
 readme = "README.md"
-requires-python = ">=3.8"
+requires-python = ">=3.10"
 license = {file = "LICENSE.md"}
 authors = [
     { name = "Exabyte Inc.", email = "info@mat3ra.com" }
@@ -15,12 +15,11 @@ classifiers = [
     "Topic :: Software Development",
 ]
 dependencies = [
-    # add requirements here
+    "mat3ra-code",
+    "mat3ra-esse>=2026.6.30.post0",
+    "mat3ra-utils>=2026.7.3.post0",
     # new verison of numpy==2.0.0 is not handled by pymatgen yet
     "numpy<=1.26.4",
-    "mat3ra-utils",
-    "mat3ra-esse",
-    "mat3ra-code"
 ]
 
 [project.optional-dependencies]
@@ -81,7 +80,7 @@ where = ["src/py"]
 
 [tool.black]
 line-length = 120
-target-version = ['py38']
+target-version = ['py310']
 # 'extend-exclude' excludes files or directories in addition to the defaults
 extend-exclude = '''
 (
@@ -99,7 +98,7 @@ extend-exclude = [
     "tests/py/unit/fixtures"
 ]
 line-length = 120
-target-version = "py38"
+target-version = "py310"
 
 [tool.ruff.per-file-ignores]
 "__init__.py" = ["F401"]

package/src/py/mat3ra/made/cell/primitive_cell.py

@@ -0,0 +1,156 @@
+"""
+Routines for calculating primitive cell vectors from conventional cell Bravais parameters.
+Python equivalent of src/js/cell/primitive_cell.ts.
+
+Following Setyawan, W., & Curtarolo, S. (2010). doi:10.1016/j.commatsci.2010.05.010
+"""
+
+import math
+from typing import List
+
+from mat3ra.esse.models.properties_directory.structural.lattice import LatticeSchema
+from mat3ra.made.cell import Cell
+
+Matrix3x3 = List[List[float]]
+
+
+def _rhl(p: LatticeSchema) -> Matrix3x3:
+    a = p.a
+    alpha_rad = math.radians(p.alpha)
+
+    cos_alpha = math.cos(alpha_rad)
+    cos_half_alpha = math.cos(alpha_rad / 2.0)
+    sin_half_alpha = math.sin(alpha_rad / 2.0)
+
+    z_comp = a * math.sqrt(1.0 - (cos_alpha / cos_half_alpha) ** 2)
+
+    return [
+        [a * cos_half_alpha, -a * sin_half_alpha, 0.0],
+        [a * cos_half_alpha, a * sin_half_alpha, 0.0],
+        [(a * cos_alpha) / cos_half_alpha, 0.0, z_comp],
+    ]
+
+
+def _tri(p: LatticeSchema) -> Matrix3x3:
+    """
+    Algorithm from pymatgen (from_params).
+    Mirrors the TRI case in primitive_cell.ts exactly.
+    """
+    alpha = math.radians(p.alpha)
+    beta = math.radians(p.beta)
+    gamma = math.radians(p.gamma)
+
+    cos_alpha = math.cos(alpha)
+    cos_beta = math.cos(beta)
+    cos_gamma = math.cos(gamma)
+    sin_alpha = math.sin(alpha)
+    sin_beta = math.sin(beta)
+
+    acos_arg = (cos_alpha * cos_beta - cos_gamma) / (sin_alpha * sin_beta)
+    # Clamp to [-1, 1] to guard against floating-point drift
+    acos_arg = max(-1.0, min(1.0, acos_arg))
+
+    gamma_star = math.acos(acos_arg)
+    cos_gamma_star = math.cos(gamma_star)
+    sin_gamma_star = math.sin(gamma_star)
+
+    a, b, c = p.a, p.b, p.c
+    return [
+        [a * sin_beta, 0.0, a * cos_beta],
+        [-b * sin_alpha * cos_gamma_star, b * sin_alpha * sin_gamma_star, b * cos_alpha],
+        [0.0, 0.0, c],
+    ]
+
+
+PRIMITIVE_CELLS = {
+    "CUB": lambda p: [
+        [p.a, 0, 0],
+        [0, p.a, 0],
+        [0, 0, p.a],
+    ],
+    "FCC": lambda p: [
+        [0.0, p.a / 2, p.a / 2],
+        [p.a / 2, 0.0, p.a / 2],
+        [p.a / 2, p.a / 2, 0.0],
+    ],
+    "BCC": lambda p: [
+        [-p.a / 2, p.a / 2, p.a / 2],
+        [p.a / 2, -p.a / 2, p.a / 2],
+        [p.a / 2, p.a / 2, -p.a / 2],
+    ],
+    "TET": lambda p: [
+        [p.a, 0, 0],
+        [0, p.a, 0],
+        [0, 0, p.c],
+    ],
+    "BCT": lambda p: [
+        [-p.a / 2, p.a / 2, p.c / 2],
+        [p.a / 2, -p.a / 2, p.c / 2],
+        [p.a / 2, p.a / 2, -p.c / 2],
+    ],
+    "ORC": lambda p: [
+        [p.a, 0, 0],
+        [0, p.b, 0],
+        [0, 0, p.c],
+    ],
+    "ORCF": lambda p: [
+        [0, p.b / 2, p.c / 2],
+        [p.a / 2, 0, p.c / 2],
+        [p.a / 2, p.b / 2, 0],
+    ],
+    "ORCI": lambda p: [
+        [-p.a / 2, p.b / 2, p.c / 2],
+        [p.a / 2, -p.b / 2, p.c / 2],
+        [p.a / 2, p.b / 2, -p.c / 2],
+    ],
+    "ORCC": lambda p: [
+        [p.a / 2, p.b / 2, 0],
+        [-p.a / 2, p.b / 2, 0],
+        [0, 0, p.c],
+    ],
+    "HEX": lambda p: [
+        [p.a / 2, -(p.a * math.sqrt(3)) / 2, 0],
+        [p.a / 2, (p.a * math.sqrt(3)) / 2, 0],
+        [0, 0, p.c],
+    ],
+    "RHL": _rhl,
+    "MCL": lambda p: [
+        [p.a, 0, 0],
+        [0, p.b, 0],
+        [0, p.c * math.cos(math.radians(p.alpha)), p.c * math.sin(math.radians(p.alpha))],
+    ],
+    "MCLC": lambda p: [
+        [p.a / 2, p.b / 2, 0],
+        [-p.a / 2, p.b / 2, 0],
+        [0, p.c * math.cos(math.radians(p.alpha)), p.c * math.sin(math.radians(p.alpha))],
+    ],
+    "TRI": _tri,
+}
+
+
+def get_primitive_lattice_vectors_from_config(lattice_config: LatticeSchema) -> Matrix3x3:
+    """
+    Returns lattice vectors for a primitive cell for a given lattice config.
+    Python equivalent of getPrimitiveLatticeVectorsFromConfig() in primitive_cell.ts.
+
+    Args:
+        lattice_config: LatticeSchema instance with fields:
+            type, a, b, c, alpha, beta, gamma.
+
+    Returns:
+        3x3 list of lists (rows = vectors a, b, c) in the same units as the
+        input lattice parameters (typically Angstroms).
+    """
+    lattice_type = lattice_config.type.value if lattice_config.type else "TRI"
+    generator = PRIMITIVE_CELLS.get(lattice_type)
+    if generator is None:
+        raise ValueError(
+            f"Unsupported lattice type '{lattice_type}'. " f"Must be one of: {list(PRIMITIVE_CELLS.keys())}"
+        )
+    return generator(lattice_config)
+
+
+def get_primitive_cell_from_config(lattice_config: LatticeSchema) -> Cell:
+    """Returns a full Cell object instantiated with the primitive lattice vectors."""
+    vectors = get_primitive_lattice_vectors_from_config(lattice_config)
+    return Cell.from_vectors_array(vectors)

package/tests/py/conftest.py

@@ -26,7 +26,7 @@ def custom_warn(message, category=None, *args, **kwargs):
     # These warnings always appear to come from inside spglib itself.
     # This patch intercepts `warnings.warn` to ignore only those specific messages.
 
-    if isinstance(message, str) and "SpglibDataset" in message and category == DeprecationWarning:
+    if isinstance(message, str) and "SpglibDataset" in message and category is DeprecationWarning:
         return  # suppress
     return _orig_warn(message, category, *args, **kwargs)
 

package/tests/py/unit/test_primitive_cell.py

@@ -0,0 +1,118 @@
+import math
+import pytest
+
+from mat3ra.made.cell.primitive_cell import get_primitive_lattice_vectors_from_config
+from mat3ra.made.lattice import Lattice, LatticeTypeEnum
+from tests.py.unit.utils import assert_two_entities_deep_almost_equal
+
+EXPECTED_PRIMITIVE_CELL_NA4CL4 = [
+    [5.691694, 0.0, 0.0],
+    [0.0, 5.691694, 0.0],
+    [0.0, 0.0, 5.691694],
+]
+
+
+def test_primitive_lattice_vectors_na4cl4():
+    """
+    Replicates the TypeScript test for Na4Cl4 (CUB cell).
+    Translates from: tests/js/cell/primitive_cell.ts
+    """
+    lattice = Lattice(type=LatticeTypeEnum.CUB, a=5.691694)
+    actual_primitive_cell = get_primitive_lattice_vectors_from_config(lattice)
+
+    assert_two_entities_deep_almost_equal(EXPECTED_PRIMITIVE_CELL_NA4CL4, actual_primitive_cell)
+
+
+@pytest.mark.parametrize(
+    "l_type, kwargs, expected",
+    [
+        (LatticeTypeEnum.CUB, {"a": 2.0}, [[2.0, 0.0, 0.0], [0.0, 2.0, 0.0], [0.0, 0.0, 2.0]]),
+        (LatticeTypeEnum.FCC, {"a": 2.0}, [[0.0, 1.0, 1.0], [1.0, 0.0, 1.0], [1.0, 1.0, 0.0]]),
+        (LatticeTypeEnum.BCC, {"a": 2.0}, [[-1.0, 1.0, 1.0], [1.0, -1.0, 1.0], [1.0, 1.0, -1.0]]),
+        (LatticeTypeEnum.TET, {"a": 2.0, "c": 3.0}, [[2.0, 0.0, 0.0], [0.0, 2.0, 0.0], [0.0, 0.0, 3.0]]),
+        (LatticeTypeEnum.BCT, {"a": 2.0, "c": 3.0}, [[-1.0, 1.0, 1.5], [1.0, -1.0, 1.5], [1.0, 1.0, -1.5]]),
+        (LatticeTypeEnum.ORC, {"a": 2.0, "b": 3.0, "c": 4.0}, [[2.0, 0.0, 0.0], [0.0, 3.0, 0.0], [0.0, 0.0, 4.0]]),
+        (
+            LatticeTypeEnum.ORCF,
+            {"a": 2.0, "b": 3.0, "c": 4.0},
+            [[0.0, 1.5, 2.0], [1.0, 0.0, 2.0], [1.0, 1.5, 0.0]],
+        ),
+        (
+            LatticeTypeEnum.ORCI,
+            {"a": 2.0, "b": 3.0, "c": 4.0},
+            [[-1.0, 1.5, 2.0], [1.0, -1.5, 2.0], [1.0, 1.5, -2.0]],
+        ),
+        (
+            LatticeTypeEnum.ORCC,
+            {"a": 2.0, "b": 3.0, "c": 4.0},
+            [[1.0, 1.5, 0.0], [-1.0, 1.5, 0.0], [0.0, 0.0, 4.0]],
+        ),
+        (
+            LatticeTypeEnum.HEX,
+            {"a": 2.0, "c": 3.0},
+            [[1.0, -math.sqrt(3), 0.0], [1.0, math.sqrt(3), 0.0], [0.0, 0.0, 3.0]],
+        ),
+        (
+            LatticeTypeEnum.RHL,
+            {"a": 2.0, "alpha": 60.0},
+            [[1.7320508, -1.0, 0.0], [1.7320508, 1.0, 0.0], [1.1547005, 0.0, 1.6329931]],
+        ),
+        (
+            LatticeTypeEnum.MCL,
+            {"a": 2.0, "b": 3.0, "c": 4.0, "alpha": 60.0},
+            [[2.0, 0.0, 0.0], [0.0, 3.0, 0.0], [0.0, 2.0, 3.4641016]],
+        ),
+        (
+            LatticeTypeEnum.MCLC,
+            {"a": 2.0, "b": 3.0, "c": 4.0, "alpha": 60.0},
+            [[1.0, 1.5, 0.0], [-1.0, 1.5, 0.0], [0.0, 2.0, 3.4641016]],
+        ),
+        (
+            LatticeTypeEnum.TRI,
+            {"a": 2.0, "b": 3.0, "c": 4.0, "alpha": 90.0, "beta": 90.0, "gamma": 90.0},
+            [[2.0, 0.0, 0.0], [0.0, 3.0, 0.0], [0.0, 0.0, 4.0]],
+        ),
+    ],
+)
+def test_primitive_lattice_generators(l_type, kwargs, expected):
+    """Validates the math generators for all 14 Bravais lattice scenarios."""
+    lattice = Lattice(type=l_type, **kwargs)
+    result = get_primitive_lattice_vectors_from_config(lattice)
+    assert_two_entities_deep_almost_equal(expected, result)
+
+
+def test_fallback_to_tri_when_type_is_none():
+    """Tests default fallback to 'TRI' when lattice_config.type is None."""
+    # Use a simple dummy class to bypass Pydantic's strict validation
+    # and simulate a malformed or incomplete Lattice config.
+    class MockLattice:
+        type = None
+        a, b, c = 2.0, 2.0, 2.0
+        alpha, beta, gamma = 90.0, 90.0, 90.0
+
+    lattice = MockLattice()
+    result = get_primitive_lattice_vectors_from_config(lattice)
+    expected = [[2.0, 0.0, 0.0], [0.0, 2.0, 0.0], [0.0, 0.0, 2.0]]
+
+    assert_two_entities_deep_almost_equal(expected, result)
+
+
+def test_unsupported_lattice_type_raises_value_error():
+    """Ensures a ValueError is raised for an unknown lattice type mapping."""
+    # Using a MagicMock specifically here to force an invalid type value
+    # since LatticeTypeEnum won't allow arbitrary strings
+    class MockType:
+        value = "INVALID_TYPE"
+
+    class MockLattice:
+        type = MockType()
+        # Provide dummy parameters just in case
+        a, b, c = 2.0, 2.0, 2.0
+        alpha, beta, gamma = 90.0, 90.0, 90.0
+
+    lattice = MockLattice()
+
+    with pytest.raises(ValueError) as exc_info:
+        get_primitive_lattice_vectors_from_config(lattice)
+
+    assert "Unsupported lattice type 'INVALID_TYPE'" in str(exc_info.value)