gsap-carousel/config/build/buildLoaders.ts

import webpack from 'webpack'

import { buildBabelLoader } from './loaders/buildBabelLoader'
import { buildCssLoader } from './loaders/buildCssLoader'
import { buildFileLoader } from './loaders/buildFileLoader'
import { buildSvgrLoader } from './loaders/buildSvgrLoader'
import { BuildOptions } from './types/config'

/**
 * Собирает все webpack loaders в единый массив
 *
 * Порядок loaders важен! Webpack применяет их справа налево (снизу вверх).
 * Текущий порядок:
 * 1. fileLoader - обрабатывает изображения и шрифты
 * 2. svgrLoader - преобразует SVG в React компоненты
 * 3. babelLoader - транспилирует JS/JSX/TS/TSX с помощью Babel (включая TypeScript)
 * 4. cssLoader - обрабатывает CSS/SCSS с модулями
 *
 * Примечание: TypeScript компилируется через Babel (@babel/preset-typescript),
 * а не через ts-loader. Проверка типов выполняется отдельно через `tsc --noEmit`.
 *
 * @param {BuildOptions} options - Опции сборки
 * @param {boolean} options.isDev - Флаг режима разработки
 * @returns {webpack.RuleSetRule[]} Массив правил для webpack
 */
export function buildLoaders({ isDev }: BuildOptions): webpack.RuleSetRule[] {
  // Используем babel-loader для обработки JS и TS файлов
  // Это ускоряет сборку, так как babel работает быстрее ts-loader
  // Проверка типов должна выполняться отдельно (например, через tsc --noEmit)
  // Исключаем тестовые и storybook файлы из production сборки
  const codeBabelLoader = buildBabelLoader(isDev)

  const fileLoader = buildFileLoader()

  const svgrLoader = buildSvgrLoader()

  const cssLoader = buildCssLoader(isDev)

  return [fileLoader, svgrLoader, codeBabelLoader, cssLoader]
}