SAIF.Business.Utilities overview

Documentation context: Front-End Application Component Documented via: LegalMaintenance (LegalMaintenance.sln)

A stateless text-formatting utility library that normalizes legacy uppercase-stored text into display-ready casing and renders numbers as English words. Despite its SAIF.Business.* name, this library contains no business entities, BOF business objects, persistence, or service calls — it is pure, side-effect-free formatting.

Purpose

• Convert free-form name/address/description text (typically all-caps legacy data) into display-ready title case while preserving original delimiter characters via TitleCase.ToTitleCase and its extension-method façade.
• Render whole numbers as English words (e.g. for written amounts on legal or printed output).
• Provide supporting string normalization utilities: sentence casing, proper casing, capital-letter padding, numeric validation.

Responsibilities

• Title-case text using a rules-driven engine with recognizer lists for acronyms, minor words, irregular spellings, and ordinal suffixes.
• Validate and format strings for consistent display presentation across the application.
• Serve as a leaf formatting utility consumed by the view/presentation-model layer.

Key components

• TitleCase (class) + TitleCaseExtensions (module): Rules-driven casing engine with extension-method surface for convenient string formatting.
• mdlTextConversion (module): Number-to-words conversion and sentence-case formatting, independent of title casing.

Related documentation

• Index
• Architecture
• Dependencies
• Operations and processes
• Business rules
• API reference

Sources

• SAIF.Business.Utilities/SAIF.Business.Utilities.vbproj
• SAIF.Business.Utilities/TitleCase.vb
• SAIF.Business.Utilities/mdlTextConversion.vb
• SAIF.Business.Utilities/My Project/AssemblyInfo.vb