1) The prefixes 'Calibration' and 'DataMatrix' have been dropped to shorten and simplify various type names.

2) Some method and property names have been simplified.
3) Some types have been scoped as internal rather than public.
4) Language support has been added for all (24) EU official languages, and also for Norwegian and Icelandic.
5) Additional code clean-up has been performed through application of StyleCop rules.
6) A number of legacy (pre-C#9) record-type classes have been re-written as records.
7) Calibration data has been optimised for JSON by removing redundant ASCII 0s.
8) A new error type has been introduced for situations where no valid calibration is provided when calibrating.
9) Public API analysis support has been provided to help track breaking changes in future.

Author: SolidsoftReplyDevelopment

Solidsoft.Reply.Parsers.AnsiMhDi/Category.cs

@@ -1,8 +1,6 @@
 // --------------------------------------------------------------------------------------------------------------------
-// <copyright file="Category.cs" company="Solidsoft Reply Ltd.">
-//   (c) 2018-2024 Solidsoft Reply Ltd. All rights reserved.
-// </copyright>
-// <license>
+// <copyright file="Category.cs" company="Solidsoft Reply Ltd">
+// Copyright (c) 2018-2024 Solidsoft Reply Ltd. All rights reserved.
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
 // You may obtain a copy of the License at
@@ -14,23 +12,22 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-// </license>
+// </copyright>
 // <summary>
 // Defined ASC MH10.8.2 categories.
 // </summary>
 // --------------------------------------------------------------------------------------------------------------------
 
 // ReSharper disable UnusedMember.Global
-
 namespace Solidsoft.Reply.Parsers.AnsiMhDi;
 
 /// <summary>
-///   Defined ASC MH10.8.2 categories
+///   Defined ASC MH10.8.2 categories.
 /// </summary>
 [System.Diagnostics.CodeAnalysis.SuppressMessage("Naming", "CA1700:Do not name enum values 'Reserved'", Justification = "<Pending>")]
+
 // ReSharper disable once UnusedType.Global
-public enum Category
-{
+public enum Category {
     /// <summary>
     ///   CATEGORY 0 Special Characters Employed as Data Identifiers
     /// </summary>
@@ -165,5 +162,5 @@ public enum Category
     /// <summary>
     ///   CATEGORY 26 Mutually Defined
     /// </summary>
-    MutuallyDefined = 26
+    MutuallyDefined = 26,
 }

Solidsoft.Reply.Parsers.AnsiMhDi/DataIdentifier.cs

@@ -1,8 +1,6 @@
 // --------------------------------------------------------------------------------------------------------------------
-// <copyright file="DataIdentifier.cs" company="Solidsoft Reply Ltd.">
-//   (c) 2018-2024 Solidsoft Reply Ltd. All rights reserved.
-// </copyright>
-// <license>
+// <copyright file="DataIdentifier.cs" company="Solidsoft Reply Ltd">
+// Copyright (c) 2018-2024 Solidsoft Reply Ltd. All rights reserved.
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
 // You may obtain a copy of the License at
@@ -14,15 +12,14 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-// </license>
+// </copyright>
 // <summary>
 // ASC MH10.8 0 Data Identifiers.
 // </summary>
 // --------------------------------------------------------------------------------------------------------------------
 
 // ReSharper disable UnusedMember.Global
 // ReSharper disable CommentTypo
-
 namespace Solidsoft.Reply.Parsers.AnsiMhDi;
 
 using System.Diagnostics.CodeAnalysis;
@@ -36,8 +33,7 @@ namespace Solidsoft.Reply.Parsers.AnsiMhDi;
 ///   Identifier") not defined herein is reserved for future assignment by the body controlling
 ///   these guidelines.
 /// </remarks>
-public enum DataIdentifier
-{
+public enum DataIdentifier {
     /// <summary>
     ///   Unrecognised entity.
     /// </summary>
@@ -1298,7 +1294,7 @@ public enum DataIdentifier
     ///   DNV certificate reference.
     /// </summary>
     DnvCertificateReference = 16055,
-    
+
     /// <summary>
     ///   The quantity.
     /// </summary>
@@ -2508,5 +2504,5 @@ public enum DataIdentifier
     /// <summary>
     ///   The line 89.
     /// </summary>
-    Line89 = 26099
+    Line89 = 26099,
 }

Solidsoft.Reply.Parsers.AnsiMhDi/Descriptors/EntityDescriptor.cs

@@ -1,8 +1,6 @@
 // --------------------------------------------------------------------------------------------------------------------
-// <copyright file="EntityDescriptor.cs" company="Solidsoft Reply Ltd.">
-//   (c) 2018-2024 Solidsoft Reply Ltd. All rights reserved.
-// </copyright>
-// <license>
+// <copyright file="EntityDescriptor.cs" company="Solidsoft Reply Ltd">
+// Copyright (c) 2018-2024 Solidsoft Reply Ltd. All rights reserved.
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
 // You may obtain a copy of the License at
@@ -14,7 +12,7 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-// </license>
+// </copyright>
 // <summary>
 // A descriptor for an ASC MH10.8.2 entity.
 // </summary>
@@ -33,52 +31,43 @@ namespace Solidsoft.Reply.Parsers.AnsiMhDi.Descriptors;
 /// <summary>
 ///   A descriptor for an ASC MH10.8.2 entity.
 /// </summary>
-
+/// <remarks>
+///   Initializes a new instance of the <see cref="EntityDescriptor" /> class.
+/// </remarks>
+/// <param name="dataTitle">
+///   The data title.
+/// </param>
+/// <param name="description">
+///   The description.
+/// </param>
+/// <param name="pattern">
+///   The pattern.
+/// </param>
 // ReSharper disable once ClassWithVirtualMembersNeverInherited.Global
-public class EntityDescriptor
-{
+public class EntityDescriptor(string? dataTitle, string? description, Func<Regex> pattern) {
     /// <summary>
     ///   The regular expression pattern of the entity.
     /// </summary>
-    private readonly Func<Regex> _pattern;
+    private readonly Func<Regex> _pattern = pattern;
 
     /// <summary>
     ///   The regular expression pattern of the entity.
     /// </summary>
-    private Regex? _validator;
-
-    /// <summary>
-    ///   Initializes a new instance of the <see cref="EntityDescriptor" /> class.
-    /// </summary>
-    /// <param name="dataTitle">
-    ///   The data title.
-    /// </param>
-    /// <param name="description">
-    ///   The description.
-    /// </param>
-    /// <param name="pattern">
-    ///   The pattern.
-    /// </param>
-    public EntityDescriptor(string? dataTitle, string? description, Func<Regex> pattern) {
-        DataTitle = dataTitle;
-        Description = description;
-        _pattern = pattern;
-        _validator = null;
-    }
+    private Regex? _validator = null;
 
     /// <summary>
     ///   Gets the data title of the entity.
     /// </summary>
     // ReSharper disable once MemberCanBePrivate.Global
     // ReSharper disable once UnusedAutoPropertyAccessor.Global
-    public string? DataTitle { get; }
+    public string? DataTitle { get; } = dataTitle;
 
     /// <summary>
     ///   Gets the description of the entity.
     /// </summary>
     // ReSharper disable once MemberCanBePrivate.Global
     // ReSharper disable once UnusedAutoPropertyAccessor.Global
-    public string? Description { get; }
+    public string? Description { get; } = description;
 
     /// <summary>
     ///   Gets the compiled regular expression object for validating the entity.
@@ -92,14 +81,14 @@ public EntityDescriptor(string? dataTitle, string? description, Func<Regex> patt
     /// <param name="value">The data to be validated.</param>
     /// <param name="validationErrors">A list of validation errors.</param>
     /// <returns>True, if valid. Otherwise, false.</returns>
-    public virtual bool IsValid(string? value, out IList<ParserException> validationErrors)
-    {
+    public virtual bool IsValid(string? value, out IList<ParserException> validationErrors) {
+#pragma warning disable IDE0028 // Simplify collection initialization
         validationErrors = new List<ParserException>();
+#pragma warning restore IDE0028 // Simplify collection initialization
 
         var result = Pattern.IsMatch(value ?? string.Empty);
 
-        if (result)
-        {
+        if (result) {
             return true;
         }