Переменные и область видимости

// Все переменные по умолчанию неизменяемы
let имя = "Иван Топаз"
let возраст = 25
let активен = true

// Нельзя изменить после определения
// имя = "Другое имя"  // Ошибка компиляции!

// Используйте let mut, когда нужно изменять значения
let mut счёт = 100
let mut сообщение = "Начальное сообщение"

// Значение можно изменить
счёт = 95
сообщение = "Обновлённое сообщение"

print("Текущий счёт: {счёт}")  // "Текущий счёт: 95"

// Константы, определяемые во время компиляции
const MAX_SIZE: int = 1000
const APP_NAME: string = "Топаз Calculator"
const PI: float = 3.141592653589793

// Константы верхнего уровня, доступные ниже в этом файле
const настройкиПоУмолчанию = {
    язык: "Русский",
    тема: "тёмная",
    автосохранение: true
}

// Вывод типов (рекомендуется)
let выведенноеЧисло = 42           // int
let выведеннаяСтрока = "Привет"    // string
let выведенныйМассив = [1, 2, 3]   // Array<int>

// Явные типы (когда необходимо)
let явноеЧисло: int = 42
let явнаяСтрока: string = "Привет"
let явныйМассив: Array<int> = [1, 2, 3]

// Явные типы помогают в сложных случаях
let данныеПользователя: { имя: string, возраст: int } = {
    имя: "Разработчик Иванов",
    возраст: 30
}

// Верхний уровень файла - глобальная область видимости
let глобальнаяПеременная = "Доступна везде"
const глобальнаяКонстанта = 100

function использоватьВезде() {
    print(глобальнаяПеременная)      // Доступна
    print("{глобальнаяКонстанта}")   // Доступна
}

function калькулятор(a: int, b: int) -> int {
    // Параметры функции также принадлежат области видимости функции
    let результат = a + b        // Область видимости функции
    let mut временноеЗначение = a * 2 // Область видимости функции
    
    print("Результат: {результат}")
    return результат
}

// print(результат)  // Ошибка! Нельзя получить доступ вне функции

function примерОбластиВидимости() {
    let внешняяПеременная = "снаружи"
    
    if true {
        let внутренняяПеременная = "внутри"      // Блочная область видимости
        let mut блочнаяИзменяемая = 10               // Блочная область видимости
        
        print(внешняяПеременная)                 // Доступна (внешняя область)
        print(внутренняяПеременная)              // Доступна (та же область)
    }
    
    print(внешняяПеременная)                     // Доступна
    // print(внутренняяПеременная)               // Ошибка! Нельзя получить доступ вне блока
}

// Переменные цикла for имеют область видимости цикла
for i in 0..5 {
    let переменнаяЦикла = i * 2
    print("i: {i}, значение: {переменнаяЦикла}")
}

// print(i)  // Ошибка! Нельзя получить доступ вне цикла

let имя = "Иван Топаз"

function примерЗатенения() {
    let имя = "Разработчик Петров"        // Затеняет глобальное имя
    print("В функции: {имя}")             // "В функции: Разработчик Петров"
    
    {
        let имя = "Дизайнер Сидоров"       // Затеняет имя функции
        print("В блоке: {имя}")            // "В блоке: Дизайнер Сидоров"
    }
    
    print("После блока: {имя}")           // "После блока: Разработчик Петров"
}

print("Глобальное: {имя}")               // "Глобальное: Иван Топаз"
примерЗатенения()

function создатьСчётчик(начальноеЗначение: int) -> () -> int {
    let mut счёт = начальноеЗначение           // Захватывается замыканием
    
    return () => {
        счёт += 1                          // Доступ к переменной внешней области
        счёт
    }
}

let счётчик1 = создатьСчётчик(0)
let счётчик2 = создатьСчётчик(100)

print("{счётчик1()}")  // 1
print("{счётчик1()}")  // 2
print("{счётчик2()}")  // 101
print("{счётчик1()}")  // 3

let пользователь = {
    имя: "Иван Топаз",
    возраст: 28,
    работа: "Разработчик"
}

// Деструктурирование создаёт новые переменные
let { имя, возраст } = пользователь
print("Имя: {имя}, Возраст: {возраст}")

// Привязка переменных в match
match пользователь.возраст {
    case возраст if возраст < 20 => print("Вероятно, студент")
    case возраст if возраст < 30 => print("Молодой специалист")
    case возраст => print("Опытный: {возраст} лет")
}

// Сопоставление образцов массива
let оценки = [95, 87, 92, 88]
match оценки {
    case [первая, вторая, ..остальные] => {
        print("Первая: {первая}")
        print("Вторая: {вторая}")
        print("Остальные: {остальные}")
    }
    case _ => print("Нужно как минимум две оценки")
}

// Блок-выражение для изоляции области видимости
let результат = {
    let временныйРасчёт = 10 * 20
    let корректировка = 50
    временныйРасчёт + корректировка
}

print("{результат}")  // 250
// временныйРасчёт, корректировка недоступны вне блока

// Хорошо: используйте let по умолчанию
let конфигурация = {
    тема: "тёмная",
    язык: "Русский"
}

// Используйте let mut только при необходимости
let mut статусПрогресса = "начато"
статусПрогресса = "в процессе"
статусПрогресса = "завершено"

// Плохой пример
let a = списокПользователей.length
let b = a * 2

// Хороший пример  
let общееКоличествоПользователей = списокПользователей.length
let удвоеннаяЁмкость = общееКоличествоПользователей * 2

function обработатьДанные(исходныеДанные: Array<int>) -> Array<int> {
    let mut результат: Array<int> = []
    
    for элемент in исходныеДанные {
        // Переменные, нужные только в цикле, должны объявляться в цикле
        let преобразованноеЗначение = элемент * 2 + 1
        let проверенноеЗначение = if преобразованноеЗначение > 0 { преобразованноеЗначение } else { 0 }
        
        результат.push(проверенноеЗначение)
    }
    
    return результат
}

// Отслеживайте привязки интерполированными print
let глобальнаяМетка = "build-42"

function выводИнформацииООбласти() {
    let локальнаяПеременная = "локальная"
    
    print("Переменные в текущей функции:")
    print("- локальнаяПеременная: {локальнаяПеременная}")
    print("- глобальнаяМетка: {глобальнаяМетка}")   // внешние привязки остаются доступными
}