VerseLabel class final

The verse label of one text entry in a Bible translation.

A source may store combined verses under a label such as 3-4, or divide a verse into entries such as 5a and 5b. This model preserves that exact source while exposing normalized verse numbers and subdivision letters. It describes one source entry; an ordinary VerseRangeRef describes only the range and does not imply that its verses share a text entry.

Labels contain a verse number, optionally followed by one letter a-z, and an optional ascending endpoint in the same chapter. Uppercase letters and the Unicode syntax supported by ReferenceInputNormalizer are accepted. Numbers use the same broad sanity limits as VerseRef.

final label = VerseLabel.parse('3–4');
print(label.source); // 3–4
print(label.displayString); // 3-4
final reference = label.toReference(book: BibleBookEnum.john, chapter: 1);