<!-- source-hash: a9286a0db522d161e966e9cc016fe3ad -->
OS utility functions for normalizing, displaying, and working with operating system types across different platforms and naming conventions.

## Key Components

- **`normalizeOSType()`** - Converts raw OS strings to standardized OSType enum values with case-insensitive matching
- **`getOSLabel()`** - Returns human-readable display labels for OS types
- **`getOSIcon()`** - Retrieves React icon components for visual OS representation
- **`getOSTypeDefinition()`** - Gets complete OS type definition objects
- **`getOSPlatformId()`** - Maps OS types to platform IDs for cross-referencing
- **`isOSPlatform()`** - Checks if a device OS matches a specific platform

## Usage Example

```typescript
import { normalizeOSType, getOSLabel, getOSIcon, isOSPlatform } from './os-utils'

// Normalize various OS name formats
const osType1 = normalizeOSType('darwin') // 'MACOS'
const osType2 = normalizeOSType('Windows 10 Pro') // 'WINDOWS'
const osType3 = normalizeOSType('Ubuntu 20.04') // 'LINUX'

// Get display labels and icons
const label = getOSLabel('darwin') // 'macOS'
const IconComponent = getOSIcon('windows')

// Platform matching for device filtering
const isMacDevice = isOSPlatform('Darwin', 'darwin') // true
const isWindowsDevice = isOSPlatform('Win32', 'windows') // true

// Render OS info in UI
function DeviceOSDisplay({ osString }: { osString: string }) {
  const Icon = getOSIcon(osString)
  const label = getOSLabel(osString)
  
  return (
    <div>
      {Icon && <Icon />}
      <span>{label}</span>
    </div>
  )
}
```

The utilities handle common OS detection challenges like case variations, version strings, and platform aliases, making it easy to work with device OS data consistently across the application.