Что вам известно об index-файлах, например index.ts или index.js?

Index-файл — это соглашение, принятое в большинстве модульных систем (Node.js, Webpack, TypeScript, bundlers). Когда вы пишете import x from './utils', резолвер ищет файл ./utils/index.js (или index.ts, index.jsx и т.д.). Это поведение встроено в алгоритм разрешения модулей и не требует дополнительной настройки.

Зачем нужен index-файл

• Точка входа пакета: в package.json поле main часто указывает на index.js.
• Barrel-файл: реэкспорт множества модулей из одной папки, чтобы импортировать их одной строкой.
• Инкапсуляция: внешний код не знает о внутренней структуре папки, а импортирует только публичное API.

Пример barrel-файла

// utils/index.ts
export { formatDate } from './formatDate';
export { parseDate } from './parseDate';
export { isValidDate } from './validate';

// где-то в коде
import { formatDate, parseDate } from './utils';

Без index-файла пришлось бы писать три отдельные строки импорта с полными путями. Barrel-файлы особенно удобны в больших проектах, где компоненты или утилиты разбиты по папкам.

Подводные камни

• Циклические зависимости: barrel-файлы легко создают циклы, если модули ссылаются друг на друга через index.
• Tree shaking: некоторые сборщики хуже удаляют неиспользуемый код при реэкспорте через barrel.
• Производительность сборки: большой index-файл может замедлить резолвинг и увеличить время сборки.

В TypeScript также важно помнить, что index.ts не влияет на типы — он просто реэкспортирует их так же, как значения.

Итог: index-файлы стоит применять для организации публичного API модуля или папки, но избегать их в горячих путях и при риске циклических зависимостей.