import { Meta } from '@storybook/addon-docs/blocks'

<Meta title='@dxtmisha/ru/functional-basic/Functions/capitalize - Делает первую букву строки заглавной'/>

# `capitalize`

Делает первую букву строки заглавной. Возвращает ту же строку, если она пуста. Функция устойчива к некорректным входным данным и безопасно обрабатывает не-строковые значения.

**Параметры:**
- `value: string` — Исходная строка для капитализации.
- `isLocale: boolean` (опционально) — Если `true`, использует текущую глобальную локаль (через `Geo.getLocation()`) для правил капитализации.

**Возвращает:**
`string` — Строка с заглавной первой буквой.

```typescript
import { capitalize, Geo } from '@dxtmisha/functional-basic'

console.log(capitalize('hello')) // 'Hello'
console.log(capitalize('123'))   // '123'

// Капитализация с учетом локали (например, для турецкого 'i' -> 'İ')
Geo.set('tr-TR')
console.log(capitalize('i', true)) // 'İ'
```
