Mutable: снятие readonly

Принципы

• Утилита Mutable<T> снимает модификатор readonly со всех свойств типа T.
• Это удобно, когда нужно изменить объект, пришедший как неизменяемый, в контролируемом участке кода.
• Тип-помощник — двусторонний: позволяет иметь и неизменяемую, и изменяемую версии одной модели.

Пример

import { Mutable } from 'ts-cookbook';

interface ImmutablePerson {
  readonly name: string;
  readonly age: number;
}

const immutablePerson: ImmutablePerson = { name: 'Danny', age: 50 };
// immutablePerson.age = 51; // Ошибка

const person: Mutable<ImmutablePerson> = { name: 'Eric', age: 34 };
person.age = 35; // ОК

Практика

• Применяйте Mutable только локально, чтобы не потерять гарантию неизменяемости на уровне API.
• Для частичного снятия readonly используйте кастомные типы (MutableKeys<T, K>).
• Помните, что Mutable влияет только на типы; в runtime объект может быть по-прежнему заморожен (Object.freeze).