SaudiPlate 0.1.0

SaudiPlate

A production-ready .NET library for Saudi vehicle plate parsing, normalization, validation, formatting, and equality comparison.

Features

• Parse raw user input from Arabic, Latin, or mixed script input
• Normalize Arabic-Indic digits to ASCII for storage
• Validate Saudi plate structure with strict and standard modes
• Format plates for canonical storage, English display, and Arabic display
• Compare plate inputs by canonical identity
• Zero external dependencies

Saudi Letter Mapping

This library uses the official Saudi plate mapping (not general Arabic transliteration).

Installation

dotnet add package SaudiPlate

Quick Start

using SaudiPlate;

var result = SaudiPlateApi.NormalizePlate("١٢٣٤ ا ب ح");

Console.WriteLine(result.Success);     // true
Console.WriteLine(result.Canonical);  // ABJ-1234

Console.WriteLine(
    SaudiPlateApi.FormatPlate("ABJ1234", FormatStyle.DisplayAr)
);

var validation = SaudiPlateApi.ValidatePlate("1234 ABJ");
Console.WriteLine(validation.IsValid);

API

NormalizePlate

var result = SaudiPlateApi.NormalizePlate(input, options);

Returns:

• Success
• Canonical
• Plate
• Warnings
• Errors

ValidatePlate

var result = SaudiPlateApi.ValidatePlate(input, options);

Returns:

• IsValid
• Plate
• Issues

FormatPlate

SaudiPlateApi.FormatPlate(inputOrPlate, FormatStyle.DisplayAr);

Supported styles:

• Canonical
• DisplayEn
• DisplayAr

EqualsPlate

SaudiPlateApi.EqualsPlate(a, b, options);

Compares two inputs by canonical identity.

Strictness Modes

Strict

• No mixed Arabic and Latin letters
• No digits-before-letters input
• Exactly 4 digits required
• No folded Arabic characters (أ، إ، آ، ة، ى، ئ...)

Standard

• Mixed scripts allowed
• Reordered input allowed with warnings
• 1 to 4 digits allowed
• Folded Arabic characters normalized

Test Matrix

The following matrix summarizes the full test coverage (37/37 passing):

Valid Inputs

Normalization Cases

Invalid Inputs

Strict Mode Rejections

Arabic Mapping Examples

Equality Behavior

Notes

• Canonical format: LETTERS-DIGITS (e.g. ABJ-1234)
• Designed for validation, normalization, and formatting
• Not intended for OCR or vehicle registry lookup
• Fully deterministic and locale-independent

License

MIT