Справочник по TypeScript

Краткий индекс учебного раздела 5-10-typescript. Пошаговое обучение — карта и О разделе. Таблицы синтаксиса — в справочнике 301; здесь — куда идти за объяснением и практикой по каждому из 18 блоков 301.

Два слоя материалов

Учебные статьи (5-10-typescript/*.md) — примеры, «Разбор:», практика.
Справочник 301 — таблицы, полный перечень флагов tsconfig, advanced-типы без дублирования в каждой статье.

---

Карта: 18 блоков справочника 301

№	Тема (301)	Учебная статья	Таблицы и детали
1	Основы типизации	10 — типы, 11 — переменные	Справочник — основы типизации
2	Составные типы	10, 19 — коллекции	Справочник — составные типы
3	Объединения и пересечения	10, 12 — ветвления, 8 — синтаксис §&	Справочник — объединения и пересечения
4	Функции	14 — функции	Справочник — функции
5	Интерфейсы	8 — синтаксис, 10, 18	Справочник — интерфейсы
6	Классы	18 — объекты и классы	Справочник — классы
7	Утилитарные типы	10 §utility, 14 §утилиты, 24	Справочник — утилитарные типы
8	Расширенные возможности типов	24 — дженерики, 17	Справочник — расширенные типы
9	Модули и пространства имён	9 — подключение, 4 §модули, 8 §import type	Справочник — модули
10	Декларации	9 §декларации, 15 §.d.ts	Справочник — декларации
11	Конфигурация tsconfig.json	9, 4, 6	Справочник — tsconfig
12	Декораторы	23 — декораторы	Справочник — декораторы
13	DOM и окружение	20 — события и DOM	Справочник — DOM и окружение
14	Интеграция с фреймворками	21 — React, 22 — Node	Справочник — интеграция с фреймворками
15	Распространённые паттерны	28 — паттерны, 27 — ошибки	Справочник — распространённые паттерны
16	Лучшие практики	6 — рекомендации	Справочник — лучшие практики
17	Инструменты и CLI	4, 3 — экосистема, 15, 16	Справочник — инструменты и CLI
18	Расширение TypeScript	16 §расширение	Справочник — расширение TypeScript

---

Рекомендуемый порядок по блокам 301

Этап	Блоки 301	Статьи
Старт	1, 11, 17	4 → 10 → 9
Синтаксис типов	2, 3, 4, 5	19, 14, 8
ООП	6, 7	18, 10
Продвинутое	8, 12	24, 23
Прикладное	9, 10, 13, 14	9, 20, 21 или 22
Инженерия	15, 16, 18	28, 6, 16

---

Мини-шпаргалка

interface User {
  id: string;
  name: string;
  role: "admin" | "user";
}

// Union и narrowing
type Id = string | number;
function isString(x: Id): x is string {
  return typeof x === "string";
}

function formatId(id: Id): string {
  if (isString(id)) return id.toUpperCase();
  return id.toFixed(0);
}

// Utility
type PartialUser = Partial<Pick<User, "name">>;
type PublicUser = Omit<User, "role">;

// Generic
function first<T>(arr: T[]): T | undefined {
  return arr[0];
}

const admin = first<User>([{ id: "1", name: "Ann", role: "admin" }]);

Разбор:

• interface User — контракт объекта; role — literal union.
• isString — type predicate для narrowing.
• Partial<Pick<…>>, Omit — utility types (Справочник — утилитарные типы).
• first<User>(…) — generic с сохранением типа элемента.

---

Официальные источники

• TypeScript Handbook
• TSConfig Reference
• TypeScript Playground
• Обзор в JS-курсе: 30, таблицы: 301