---
title: SAIF.Business.Utilities overview
summary: High-level purpose, scope, and responsibilities for this library.
status: draft
owner: <owner>
last_reviewed: 2026-07-24
library: SAIF.Business.Utilities
reference_type: package
---

# SAIF.Business.Utilities overview

> **Documentation context:** Packaged Component (NuGet)

SAIF.Business.Utilities is a self-contained VB.NET class library that provides string-formatting and text-conversion helper functions used by other SAIF BOF components. It has no project references, no BOF business-object base classes, and no data-access, UI, or service-hosting responsibilities.

## Purpose
- Convert free-text strings to title case, applying domain-specific casing rules for abbreviations, minor words, mixed-case exceptions, and possessive suffixes.
- Provide convenience string-extension methods for proper-casing, capital-letter padding, array-level case conversion, numeric-only checks, and sentence casing.
- Convert numeric amounts into their English-words representation (e.g., for printed check/dollar amounts).
- Consumed by other SAIF.BOF components that need consistent text formatting for names, addresses, and monetary amounts.

## Responsibilities
- Encapsulate title-casing rule tables and algorithm in the `TitleCase` class.
- Expose string-extension convenience wrappers via the `TitleCaseExtensions` module.
- Encapsulate numeric-to-text conversion and sentence-casing in the `mdlTextConversion` module.

## Key components
- `TitleCase`: static utility class implementing the title-casing algorithm and its private word-list rule tables.
- `TitleCaseExtensions`: extension-method module over `String`, delegating to `TitleCase` or VB's built-in `StrConv`.
- `mdlTextConversion`: module providing `NumberToText` numeric-to-words conversion and the `ToSentenceCase` string extension.

## Related documentation
- [Index](index.md)
- [Architecture](architecture.md)
- [Dependencies](dependencies.md)
- [Operations and processes](operations-processes.md)
- [Business rules](business-rules.md)
- [API reference](api/index.md)

## Sources
- `Business\SAIF.Business.Utilities\TitleCase.vb`
- `Business\SAIF.Business.Utilities\mdlTextConversion.vb`
- `Business\SAIF.Business.Utilities\SAIF.BOF.Business.Utilities.vbproj`