@mat3ra/made 2026.8.7-0 → 2026.8.18-0

package/dist/js/basis/basis.d.ts

@@ -1,5 +1,5 @@
 import { InMemoryEntity } from "@mat3ra/code/dist/js/entity";
-import { BasisSchema, Coordinate3DSchema, Vector3DSchema } from "@mat3ra/esse/dist/js/types";
+import { BaseInMemoryEntitySchema, BasisSchema, Coordinate3DSchema, Vector3DSchema } from "@mat3ra/esse/dist/js/types";
 import { Cell } from "../cell/cell";
 import { AtomicCoordinateValue, Coordinates } from "./coordinates";
 import { AtomicElementValue, Elements } from "./elements";
@@ -30,7 +30,8 @@ export interface ElementsAndCoordinatesConfig {
     units?: BasisSchema["units"];
     cell?: Cell;
 }
-export declare class Basis extends InMemoryEntity implements BasisSchema {
+type BasisEntitySchema<S extends BasisConfig = BasisConfig> = S & BaseInMemoryEntitySchema;
+export declare class Basis<S extends BasisConfig = BasisConfig> extends InMemoryEntity<BasisEntitySchema<S>> implements BasisSchema {
     static defaultConfig: BasisSchema;
     units: BasisSchema["units"];
     cell: Cell;
@@ -39,15 +40,15 @@ export declare class Basis extends InMemoryEntity implements BasisSchema {
     _labels: Labels;
     static _convertValuesToConfig({ elements, coordinates, units, cell, labels, }: ElementsAndCoordinatesConfig): BasisConfig;
     static fromElementsAndCoordinates({ elements, coordinates, units, cell, labels, }: ElementsAndCoordinatesConfig): Basis;
-    constructor(config?: BasisConfig);
+    constructor(config?: NoInfer<S>);
     get elements(): BasisSchema["elements"];
     set elements(elements: BasisSchema["elements"]);
     get coordinates(): BasisSchema["coordinates"];
     set coordinates(coordinates: BasisSchema["coordinates"]);
     get labels(): BasisSchema["labels"];
     set labels(labels: BasisSchema["labels"]);
-    toJSON(exclude?: string[]): BasisSchema;
-    clone(): Basis;
+    toJSON(exclude?: (keyof BasisEntitySchema<S>)[]): BasisEntitySchema<S>;
+    clone(): this;
     removeAllAtoms(): void;
     get cellRounded(): import("@mat3ra/esse/dist/js/types").Matrix3X3Schema;
     get elementsArray(): object[];
@@ -55,8 +56,8 @@ export declare class Basis extends InMemoryEntity implements BasisSchema {
     get coordinatesAsArray(): Coordinate3DSchema[];
     get isInCartesianUnits(): boolean;
     get isInCrystalUnits(): boolean;
-    toCartesian(): void;
-    toCrystal(): void;
+    toCartesian(): this;
+    toCrystal(): this;
     getElementByIndex(idx: number): AtomicElementValue;
     getElementById(id: number): AtomicElementValue;
     getCoordinateValueByIndex(idx: number): AtomicCoordinateValue;
@@ -140,12 +141,16 @@ export declare class Basis extends InMemoryEntity implements BasisSchema {
      * @summary Returns true if bases are equal, otherwise - false.
      * @param anotherBasisClsInstance {Basis} Another Basis.
      */
-    isEqualTo(anotherBasisClsInstance: Basis): boolean;
+    isEqualTo(anotherBasisClsInstance: {
+        hashString: string;
+    }): boolean;
     /**
      * @summary Returns true if basis cells are equal, otherwise - false.
      * @param anotherBasisClsInstance {Basis} Another Basis.
      */
-    hasEquivalentCellTo(anotherBasisClsInstance: Basis): boolean;
+    hasEquivalentCellTo(anotherBasisClsInstance: {
+        cell: Cell;
+    }): boolean;
     /**
      * @summary Returns the minimum cubic lattice size for a non-periodic structure.
      * Single-atom structures use the element atomic radius floored at defaultMinimumLatticeSize.

package/dist/js/basis/basis.js

@@ -35,6 +35,8 @@ const DEFAULT_BASIS_CONFIG = {
     ],
     units: "crystal",
 };
+// Keep `{` on same line as `implements` to satisfy brace-style (conflicts with Prettier multi-line heritage).
+// prettier-ignore
 class Basis extends entity_1.InMemoryEntity {
     static _convertValuesToConfig({ elements = [], coordinates = [], units = constants_1.ATOMIC_COORD_UNITS.crystal, cell = new cell_1.Cell(), labels = [], }) {
         const elementsArrayWithIdsJSON = elements_1.Elements.fromValues(elements).toJSON();
@@ -57,6 +59,7 @@ class Basis extends entity_1.InMemoryEntity {
             labels,
         }));
     }
+    // NoInfer: keep default S (or an explicit type arg) instead of inferring S from the config literal.
     constructor(config = Basis.defaultConfig) {
         super(config);
         const { elements, coordinates, units, labels } = config;
@@ -84,8 +87,6 @@ class Basis extends entity_1.InMemoryEntity {
     set labels(labels) {
         this._labels = labels_1.Labels.fromObjects(labels || []);
     }
-    // TODO: figure out how to override toJSON in the parent class with generic classes
-    // @ts-ignore
     toJSON(exclude = ["cell"]) {
         var _a;
         return {
@@ -96,7 +97,6 @@ class Basis extends entity_1.InMemoryEntity {
             ...(((_a = this.labels) === null || _a === void 0 ? void 0 : _a.length) ? { labels: this.labels } : {}),
         };
     }
-    // @ts-ignore
     clone() {
         const instance = super.clone();
         instance.cell = this.cell.clone();
@@ -127,15 +127,17 @@ class Basis extends entity_1.InMemoryEntity {
     }
     toCartesian() {
         if (this.isInCartesianUnits)
-            return;
+            return this;
         this._coordinates.mapArrayInPlace((point) => this.cell.convertPointToCartesian(point));
         this.units = constants_1.ATOMIC_COORD_UNITS.cartesian;
+        return this;
     }
     toCrystal() {
         if (this.isInCrystalUnits)
-            return;
+            return this;
         this._coordinates.mapArrayInPlace((point) => this.cell.convertPointToCrystal(point));
         this.units = constants_1.ATOMIC_COORD_UNITS.crystal;
+        return this;
     }
     getElementByIndex(idx) {
         return this._elements.getElementValueByIndex(idx);
@@ -310,7 +312,7 @@ class Basis extends entity_1.InMemoryEntity {
     /* Returns array of atomic labels E.g., ["1", "2", "", ""] */
     get atomicLabelsArray() {
         var _a;
-        const labelsArray = Array.from({ length: this.elements.length }, (_) => "");
+        const labelsArray = Array.from({ length: this.elements.length }, () => "");
         // https://dev.to/maafaishal/benchmarking-for-while-forof-and-arrayforeach-using-performancenow-1jjg
         if ((_a = this.labels) === null || _a === void 0 ? void 0 : _a.length) {
             for (let i = 0; i < this.labels.length; i++) {
@@ -447,13 +449,13 @@ class Basis extends entity_1.InMemoryEntity {
             for (let i = 0; i < this._elements.values.length; i++) {
                 for (let j = i + 1; j < this._elements.values.length; j++) {
                     const distance = utils_1.Utils.math.vDist(this._coordinates.getElementValueByIndex(i), this._coordinates.getElementValueByIndex(j));
-                    if (!distance)
-                        continue;
-                    if (extremum === "max" && distance > resultDistance) {
-                        resultDistance = distance;
-                    }
-                    if (extremum === "min" && distance < resultDistance) {
-                        resultDistance = distance;
+                    if (distance) {
+                        if (extremum === "max" && distance > resultDistance) {
+                            resultDistance = distance;
+                        }
+                        if (extremum === "min" && distance < resultDistance) {
+                            resultDistance = distance;
+                        }
                     }
                 }
             }

package/dist/js/basis/constrained_basis.d.ts

@@ -1,11 +1,13 @@
-import { AtomicConstraintsSchema } from "@mat3ra/esse/dist/js/types";
+import { AtomicConstraintsSchema, BasisConstrainedSchema } from "@mat3ra/esse/dist/js/types";
+import { Cell } from "../cell/cell";
 import { AtomicConstraints, AtomicConstraintValue } from "../constraints/constraints";
-import { Basis, BasisConfig, ElementsAndCoordinatesConfig } from "./basis";
+import { Basis, ElementsAndCoordinatesConfig } from "./basis";
 import { AtomicCoordinateValue } from "./coordinates";
 import { AtomicElementValue } from "./elements";
 import { AtomicLabelValue } from "./labels";
-export interface ConstrainedBasisConfig extends BasisConfig {
-    constraints: AtomicConstraintsSchema;
+export interface ConstrainedBasisConfig extends BasisConstrainedSchema {
+    cell?: Cell;
+    isEmpty?: boolean;
 }
 export interface ElementsCoordinatesAndConstraintsConfig extends ElementsAndCoordinatesConfig {
     constraints: AtomicConstraintValue[];
@@ -14,14 +16,14 @@ export interface ElementsCoordinatesAndConstraintsConfig extends ElementsAndCoor
  * @summary Extension of the Basis class able to deal with atomic constraints.
  * @extends Basis
  */
-export declare class ConstrainedBasis extends Basis {
-    _constraints: AtomicConstraints;
+export declare class ConstrainedBasis extends Basis<ConstrainedBasisConfig> {
+    private _constraints;
     constructor(config: ConstrainedBasisConfig);
     static fromElementsCoordinatesAndConstraints(config: ElementsCoordinatesAndConstraintsConfig): ConstrainedBasis;
     get constraints(): AtomicConstraintsSchema;
     set constraints(constraints: AtomicConstraintsSchema);
     get AtomicConstraints(): AtomicConstraints;
-    toJSON(): ConstrainedBasisConfig;
+    toJSON(exclude?: (keyof ConstrainedBasisConfig)[]): ConstrainedBasisConfig;
     getConstraintByIndex(idx: number): AtomicConstraintValue;
     getConstraintById(id: number): AtomicConstraintValue;
     /**

package/dist/js/basis/constrained_basis.js

@@ -11,9 +11,9 @@ const helpers_1 = require("./helpers");
  */
 class ConstrainedBasis extends basis_1.Basis {
     constructor(config) {
+        var _a;
         super(config);
-        const { constraints } = config;
-        this._constraints = constraints_1.AtomicConstraints.fromObjects(constraints || []); // `constraints` is an Array with ids
+        this._constraints = constraints_1.AtomicConstraints.fromObjects((_a = config.constraints) !== null && _a !== void 0 ? _a : []); // `constraints` is an Array with ids
     }
     static fromElementsCoordinatesAndConstraints(config) {
         const basisConfig = this._convertValuesToConfig(config);
@@ -32,9 +32,9 @@ class ConstrainedBasis extends basis_1.Basis {
     get AtomicConstraints() {
         return constraints_1.AtomicConstraints.fromObjects(this.constraints);
     }
-    toJSON() {
+    toJSON(exclude = ["cell"]) {
         return {
-            ...super.toJSON(),
+            ...super.toJSON(exclude),
             constraints: this.constraints,
         };
     }

package/dist/js/generated/MaterialSchemaMixin.d.ts

@@ -0,0 +1,5 @@
+import type { InMemoryEntity } from "@mat3ra/code/dist/js/entity";
+import type { BaseInMemoryEntitySchema, MaterialPropertiesSchema } from "@mat3ra/esse/dist/js/types";
+export type MaterialSchemaMixin = MaterialPropertiesSchema;
+export type MaterialInMemoryEntity = InMemoryEntity<BaseInMemoryEntitySchema & MaterialSchemaMixin>;
+export declare function materialSchemaMixin<T extends InMemoryEntity>(item: InMemoryEntity): asserts item is T & MaterialSchemaMixin;

package/dist/js/generated/MaterialSchemaMixin.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.materialSchemaMixin = materialSchemaMixin;
+function materialSchemaMixin(item) {
+    // @ts-expect-error
+    const properties = {
+        get formula() {
+            return this.prop("formula");
+        },
+        set formula(value) {
+            this.setProp("formula", value);
+        },
+        get unitCellFormula() {
+            return this.prop("unitCellFormula");
+        },
+        set unitCellFormula(value) {
+            this.setProp("unitCellFormula", value);
+        },
+        get basis() {
+            return this.requiredProp("basis");
+        },
+        set basis(value) {
+            this.setProp("basis", value);
+        },
+        get lattice() {
+            return this.requiredProp("lattice");
+        },
+        set lattice(value) {
+            this.setProp("lattice", value);
+        },
+        get derivedProperties() {
+            return this.prop("derivedProperties");
+        },
+        set derivedProperties(value) {
+            this.setProp("derivedProperties", value);
+        },
+        get external() {
+            return this.prop("external");
+        },
+        set external(value) {
+            this.setProp("external", value);
+        },
+        get src() {
+            return this.prop("src");
+        },
+        set src(value) {
+            this.setProp("src", value);
+        },
+        get icsdId() {
+            return this.prop("icsdId");
+        },
+        set icsdId(value) {
+            this.setProp("icsdId", value);
+        },
+        get isNonPeriodic() {
+            return this.prop("isNonPeriodic");
+        },
+        set isNonPeriodic(value) {
+            this.setProp("isNonPeriodic", value);
+        },
+        get consistencyChecks() {
+            return this.prop("consistencyChecks");
+        },
+        set consistencyChecks(value) {
+            this.setProp("consistencyChecks", value);
+        },
+    };
+    Object.defineProperties(item, Object.getOwnPropertyDescriptors(properties));
+}

package/dist/js/lattice/lattice.d.ts

@@ -1,5 +1,5 @@
 import { InMemoryEntity } from "@mat3ra/code/dist/js/entity";
-import { LatticeSchema, LatticeTypeEnum, LatticeTypeExtendedEnum, LatticeVectorsSchema, Matrix3X3Schema } from "@mat3ra/esse/dist/js/types";
+import { BaseInMemoryEntitySchema, LatticeSchema, LatticeTypeEnum, LatticeTypeExtendedEnum, LatticeVectorsSchema, Matrix3X3Schema } from "@mat3ra/esse/dist/js/types";
 import { Cell } from "../cell/cell";
 import { UnitCell } from "./unit_cell";
 /**
@@ -10,7 +10,8 @@ export { defaultNonPeriodicMinimumLatticeSize, diatomicLatticePaddingFactor, mol
 export declare class LatticeVectors extends Cell implements LatticeVectorsSchema {
 }
 export type { LatticeVectorsSchema };
-export declare class Lattice extends InMemoryEntity implements LatticeSchema {
+type LatticeEntitySchema = LatticeSchema & BaseInMemoryEntitySchema;
+export declare class Lattice extends InMemoryEntity<LatticeEntitySchema> implements LatticeSchema {
     static defaultConfig: LatticeSchema;
     a: LatticeSchema["a"];
     b: LatticeSchema["b"];
@@ -63,5 +64,5 @@ export declare class Lattice extends InMemoryEntity implements LatticeSchema {
      * @example {a: true, b: false, c: false, alpha: true, beta: false, gamma: false}
      */
     get editables(): {};
-    toJSON(exclude?: string[]): LatticeSchema;
+    toJSON(exclude?: (keyof LatticeSchema)[]): LatticeSchema;
 }

package/dist/js/lattice/lattice.js

@@ -258,8 +258,7 @@ class Lattice extends entity_1.InMemoryEntity {
         }
         return object;
     }
-    // @ts-ignore
-    toJSON(exclude) {
+    toJSON(exclude = []) {
         return {
             ...super.toJSON(exclude),
             vectors: this.vectors.toJSON(),

package/dist/js/made.d.ts

@@ -6,7 +6,7 @@ import { defaultNonPeriodicMinimumLatticeSize, diatomicLatticePaddingFactor, Lat
 import { DEFAULT_LATTICE_UNITS, LATTICE_TYPE_CONFIGS } from "./lattice/lattice_types";
 import { ReciprocalLattice } from "./lattice/reciprocal/lattice_reciprocal";
 import { UnitCell } from "./lattice/unit_cell";
-import { defaultMaterialConfig, Material } from "./material";
+import Material, { defaultMaterialConfig } from "./Material";
 import parsers from "./parsers/parsers";
 import tools from "./tools/index";
 export declare const Made: {
@@ -33,7 +33,7 @@ export declare const Made: {
         cartesian: string;
     };
     Material: typeof Material;
-    defaultMaterialConfig: import("@mat3ra/esse/dist/js/types").MaterialSchema;
+    defaultMaterialConfig: import("@mat3ra/esse/dist/js/types").MaterialEnhancedSchema;
     Lattice: typeof Lattice;
     Cell: typeof Cell;
     UnitCell: typeof UnitCell;
@@ -46,15 +46,15 @@ export declare const Made: {
     parsers: {
         xyz: {
             validate: typeof import("./parsers/xyz").validate;
-            fromMaterial: (materialOrConfig: import("@mat3ra/esse/dist/js/types").MaterialSchema, fractional?: boolean) => string;
+            fromMaterial: (materialOrConfig: import("@mat3ra/esse/dist/js/types").MaterialSchema | import("@mat3ra/esse/dist/js/types").MaterialEnhancedSchema, fractional?: boolean) => string;
             toBasisConfig: (txt: string, units?: string, cell?: Cell) => import("./basis/constrained_basis").ConstrainedBasisConfig;
             fromBasis: (basisClsInstance: import("./basis/constrained_basis").ConstrainedBasis, coordinatePrintFormat: string) => string;
             CombinatorialBasis: typeof import("./parsers/xyz_combinatorial_basis").CombinatorialBasis;
         };
         poscar: {
             isPoscar: (text: string) => boolean;
-            toPoscar: (materialOrConfig: import("@mat3ra/esse/dist/js/types").MaterialSchema, omitConstraints?: boolean) => string;
-            fromPoscar: (fileContent: string) => object;
+            toPoscar: (materialOrConfig: import("@mat3ra/esse/dist/js/types").MaterialSchema | import("@mat3ra/esse/dist/js/types").MaterialEnhancedSchema, omitConstraints?: boolean) => string;
+            fromPoscar: (fileContent: string) => import("./Material").MaterialConfig;
             atomicConstraintsCharFromBool: (bool: boolean) => string;
             atomsCount: typeof import("./parsers/poscar").atomsCount;
         };
@@ -62,21 +62,21 @@ export declare const Made: {
             parseMeta: (txt: string) => import("./parsers/cif").Meta;
         };
         espresso: {
-            toEspressoFormat: (materialOrConfig: import("@mat3ra/esse/dist/js/types").MaterialSchema) => string;
+            toEspressoFormat: (materialOrConfig: import("@mat3ra/esse/dist/js/types").MaterialSchema | import("@mat3ra/esse/dist/js/types").MaterialEnhancedSchema) => string;
         };
         nativeFormatParsers: {
-            detectFormat: (text: string) => string;
-            convertFromNativeFormat: (text: string) => any;
+            detectFormat: (text: string) => "json" | "poscar" | "unknown";
+            convertFromNativeFormat: (text: string) => import("./Material").MaterialConfig;
         };
     };
     tools: {
         surface: {
-            generateConfig: (material: Material, millerIndices: import("@mat3ra/esse/dist/js/types").Coordinate3DSchema, numberOfLayers?: number, vx?: number, vy?: number) => import("./tools/surface").SlabConfigSchema;
+            generateConfig: <Schemas extends import("./Material").MaterialSchemaMap = import("./Material").MaterialSchemaMap>(material: Material<Schemas>, millerIndices: import("@mat3ra/esse/dist/js/types").Coordinate3DSchema, numberOfLayers?: number, vx?: number, vy?: number) => import("./tools/surface").SlabConfigSchema;
         };
         supercell: {
-            generateConfig: (material: Material, supercellMatrix: import("@mat3ra/esse/dist/js/types").Matrix3X3Schema) => {
+            generateConfig: <Schemas extends import("./Material").MaterialSchemaMap = import("./Material").MaterialSchemaMap>(material: Material<Schemas>, supercellMatrix: import("@mat3ra/esse/dist/js/types").Matrix3X3Schema) => {
                 name: string;
-                basis: import("@mat3ra/esse/dist/js/types").BasisSchema;
+                basis: import("./basis/basis").BasisConfig & import("@mat3ra/esse/dist/js/types").BaseInMemoryEntitySchema;
                 lattice: import("@mat3ra/esse/dist/js/types").LatticeSchema;
             };
             generateNewBasisWithinSupercell: (basis: Basis | import("./basis/constrained_basis").ConstrainedBasis, cell: Cell, supercell: Cell, supercellMatrix: import("@mat3ra/esse/dist/js/types").Matrix3X3Schema) => Basis;
@@ -88,7 +88,7 @@ export declare const Made: {
         };
         basis: {
             repeat: (basis: Basis, repetitions: number[]) => Basis;
-            interpolate: (initialBasis: Basis, finalBasis: Basis, numberOfSteps?: number) => Basis[];
+            interpolate: (initialBasis: Basis, finalBasis: Basis, numberOfSteps?: number) => Basis<import("./basis/basis").BasisConfig>[];
         };
     };
     LATTICE_TYPE_CONFIGS: import("./lattice/lattice_types").LatticeTypeConfig[];

package/dist/js/made.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+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;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -27,9 +60,9 @@ const lattice_reciprocal_1 = require("./lattice/reciprocal/lattice_reciprocal");
 Object.defineProperty(exports, "ReciprocalLattice", { enumerable: true, get: function () { return lattice_reciprocal_1.ReciprocalLattice; } });
 const unit_cell_1 = require("./lattice/unit_cell");
 Object.defineProperty(exports, "UnitCell", { enumerable: true, get: function () { return unit_cell_1.UnitCell; } });
-const material_1 = require("./material");
-Object.defineProperty(exports, "defaultMaterialConfig", { enumerable: true, get: function () { return material_1.defaultMaterialConfig; } });
-Object.defineProperty(exports, "Material", { enumerable: true, get: function () { return material_1.Material; } });
+const Material_1 = __importStar(require("./Material"));
+exports.Material = Material_1.default;
+Object.defineProperty(exports, "defaultMaterialConfig", { enumerable: true, get: function () { return Material_1.defaultMaterialConfig; } });
 const parsers_1 = __importDefault(require("./parsers/parsers"));
 exports.parsers = parsers_1.default;
 const index_1 = __importDefault(require("./tools/index"));
@@ -39,8 +72,8 @@ exports.Made = {
     tolerance: constants_1.tolerance,
     units: constants_1.units,
     ATOMIC_COORD_UNITS: constants_1.ATOMIC_COORD_UNITS,
-    Material: material_1.Material,
-    defaultMaterialConfig: material_1.defaultMaterialConfig,
+    Material: Material_1.default,
+    defaultMaterialConfig: Material_1.defaultMaterialConfig,
     Lattice: lattice_1.Lattice,
     Cell: cell_1.Cell,
     UnitCell: unit_cell_1.UnitCell,

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

@@ -1,9 +1,8 @@
-import { MaterialSchema } from "@mat3ra/esse/dist/js/types";
+import { MaterialEnhancedSchema, MaterialSchema } from "@mat3ra/esse/dist/js/types";
 /**
  * Construct textual representation of a materialOrConfig according to Quantum ESPRESSO pw.x input format.
- * @param materialOrConfig - material class instance or its config object
  */
-declare function toEspressoFormat(materialOrConfig: MaterialSchema): string;
+declare function toEspressoFormat(materialOrConfig: MaterialSchema | MaterialEnhancedSchema): string;
 declare const _default: {
     toEspressoFormat: typeof toEspressoFormat;
 };

package/dist/js/parsers/espresso.js

@@ -9,7 +9,6 @@ const lattice_1 = require("../lattice/lattice");
 const xyz_1 = __importDefault(require("./xyz"));
 /**
  * Construct textual representation of a materialOrConfig according to Quantum ESPRESSO pw.x input format.
- * @param materialOrConfig - material class instance or its config object
  */
 function toEspressoFormat(materialOrConfig) {
     const l = new lattice_1.Lattice(materialOrConfig.lattice);

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

@@ -1,17 +1,18 @@
+import type { MaterialConfig } from "../Material";
 /**
  * @summary Detects the format of the input string
- * @throws {Error} - If the input string is unknown format
- * @param {string} text -  input string to detect format
- * @returns {NATIVE_FORMAT} - Format of the input string
+ * @throws If the input string is unknown format
+ * @param text input string to detect format
+ * @returns Format of the input string
  */
-declare function detectFormat(text: string): string;
+declare function detectFormat(text: string): "json" | "poscar" | "unknown";
 /**
  * @summary Function to handle conversion from native formats
- * @param {String} text - input string to detect format and convert
- * @throws {Error} - If the input string is of unknown format
- * @return {Object} - Material config
+ * @param text - input string to detect format and convert
+ * @throws If the input string is of unknown format
+ * @return Material config
  */
-declare function convertFromNativeFormat(text: string): any;
+declare function convertFromNativeFormat(text: string): MaterialConfig;
 declare const _default: {
     detectFormat: typeof detectFormat;
     convertFromNativeFormat: typeof convertFromNativeFormat;

package/dist/js/parsers/native_format_parsers.js

@@ -14,9 +14,9 @@ const NATIVE_FORMAT = {
 };
 /**
  * @summary Detects the format of the input string
- * @throws {Error} - If the input string is unknown format
- * @param {string} text -  input string to detect format
- * @returns {NATIVE_FORMAT} - Format of the input string
+ * @throws If the input string is unknown format
+ * @param text input string to detect format
+ * @returns Format of the input string
  */
 function detectFormat(text) {
     const jsonRegex = /^\s*\{/;
@@ -28,9 +28,9 @@ function detectFormat(text) {
 }
 /**
  * @summary Function to handle conversion from native formats
- * @param {String} text - input string to detect format and convert
- * @throws {Error} - If the input string is of unknown format
- * @return {Object} - Material config
+ * @param text - input string to detect format and convert
+ * @throws If the input string is of unknown format
+ * @return Material config
  */
 function convertFromNativeFormat(text) {
     const format = detectFormat(text);

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

@@ -1,15 +1,15 @@
 declare const _default: {
     xyz: {
         validate: typeof import("./xyz").validate;
-        fromMaterial: (materialOrConfig: import("@mat3ra/esse/dist/js/types").MaterialSchema, fractional?: boolean) => string;
+        fromMaterial: (materialOrConfig: import("@mat3ra/esse/dist/js/types").MaterialSchema | import("@mat3ra/esse/dist/js/types").MaterialEnhancedSchema, fractional?: boolean) => string;
         toBasisConfig: (txt: string, units?: string, cell?: import("../made").Cell) => import("../basis/constrained_basis").ConstrainedBasisConfig;
         fromBasis: (basisClsInstance: import("../basis/constrained_basis").ConstrainedBasis, coordinatePrintFormat: string) => string;
         CombinatorialBasis: typeof import("./xyz_combinatorial_basis").CombinatorialBasis;
     };
     poscar: {
         isPoscar: (text: string) => boolean;
-        toPoscar: (materialOrConfig: import("@mat3ra/esse/dist/js/types").MaterialSchema, omitConstraints?: boolean) => string;
-        fromPoscar: (fileContent: string) => object;
+        toPoscar: (materialOrConfig: import("@mat3ra/esse/dist/js/types").MaterialSchema | import("@mat3ra/esse/dist/js/types").MaterialEnhancedSchema, omitConstraints?: boolean) => string;
+        fromPoscar: (fileContent: string) => import("../Material").MaterialConfig;
         atomicConstraintsCharFromBool: (bool: boolean) => string;
         atomsCount: typeof import("./poscar").atomsCount;
     };
@@ -17,11 +17,11 @@ declare const _default: {
         parseMeta: (txt: string) => import("./cif").Meta;
     };
     espresso: {
-        toEspressoFormat: (materialOrConfig: import("@mat3ra/esse/dist/js/types").MaterialSchema) => string;
+        toEspressoFormat: (materialOrConfig: import("@mat3ra/esse/dist/js/types").MaterialSchema | import("@mat3ra/esse/dist/js/types").MaterialEnhancedSchema) => string;
     };
     nativeFormatParsers: {
-        detectFormat: (text: string) => string;
-        convertFromNativeFormat: (text: string) => any;
+        detectFormat: (text: string) => "json" | "poscar" | "unknown";
+        convertFromNativeFormat: (text: string) => import("../Material").MaterialConfig;
     };
 };
 export default _default;

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

@@ -1,10 +1,11 @@
-import { MaterialSchema } from "@mat3ra/esse/dist/js/types";
+import { MaterialEnhancedSchema, MaterialSchema } from "@mat3ra/esse/dist/js/types";
+import type { MaterialConfig } from "../Material";
 /**
  * Obtain a textual representation of a material in POSCAR format.
  * @param materialOrConfig - material class instance or config object.
- * @param omitConstraints - whether to discard constraints passed with material.
+ * @param omitConstraints - whether to discard constraints when serializing.
  */
-declare function toPoscar(materialOrConfig: MaterialSchema, omitConstraints?: boolean): string;
+declare function toPoscar(materialOrConfig: MaterialSchema | MaterialEnhancedSchema, omitConstraints?: boolean): string;
 /**
  * @summary calculates the number of atoms in a poscar file based on the summation of the numbers in line 7 of the file.
  * Poscar file formatting: https://www.vasp.at/wiki/index.php/POSCAR
@@ -15,7 +16,7 @@ export declare function atomsCount(poscarFileContent: string): number;
  * @param fileContent - POSCAR file content.
  * @return Material config.
  */
-declare function fromPoscar(fileContent: string): object;
+declare function fromPoscar(fileContent: string): MaterialConfig;
 /**
  * @summary Checks if a string has a POSCAR format (first 8 lines are read)
  * @param text - string to check

package/dist/js/parsers/poscar.js

@@ -16,15 +16,16 @@ const atomicConstraintsCharFromBool = (bool) => (bool ? "T" : "F");
 /**
  * Obtain a textual representation of a material in POSCAR format.
  * @param materialOrConfig - material class instance or config object.
- * @param omitConstraints - whether to discard constraints passed with material.
+ * @param omitConstraints - whether to discard constraints when serializing.
  */
 function toPoscar(materialOrConfig, omitConstraints = false) {
     const lattice = new lattice_1.Lattice(materialOrConfig.lattice);
     const vectorsAsString = _latticeVectorsToString(lattice.vectorArrays);
-    // @ts-ignore
+    const constraints = "constraints" in materialOrConfig.basis ? materialOrConfig.basis.constraints : [];
     const basis = new constrained_basis_1.ConstrainedBasis({
         ...materialOrConfig.basis,
         cell: cell_1.Cell.fromVectorsArray(lattice.vectorArrays),
+        constraints: omitConstraints ? [] : constraints,
     });
     const BasisLines = [];
     let addSelectiveDynamics = false;

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

@@ -1,4 +1,4 @@
-import { MaterialSchema } from "@mat3ra/esse/dist/js/types";
+import { MaterialEnhancedSchema, MaterialSchema } from "@mat3ra/esse/dist/js/types";
 import { ConstrainedBasis, ConstrainedBasisConfig } from "../basis/constrained_basis";
 import { AtomicCoordinateValue } from "../basis/coordinates";
 import { AtomicElementValue } from "../basis/elements";
@@ -32,11 +32,9 @@ declare function toBasisConfig(txt: string, units?: string, cell?: Cell): Constr
 declare function fromBasis(basisClsInstance: ConstrainedBasis, coordinatePrintFormat: string): string;
 /**
  * Create XYZ from Material class instance (or its JSON config).
- * @param materialOrConfig Material.
- * @param fractional Coordinate units as fractional.
- * @return Class Instance
+ * Prefer fromBasis when you already have a ConstrainedBasis instance.
  */
-declare function fromMaterial(materialOrConfig: MaterialSchema, fractional?: boolean): string;
+declare function fromMaterial(materialOrConfig: MaterialSchema | MaterialEnhancedSchema, fractional?: boolean): string;
 declare const _default: {
     validate: typeof validate;
     fromMaterial: typeof fromMaterial;