// ecss.config.ts
import { defineConfig } from '@ecss/config';
import { reactAdapter } from '@ecss/react-adapter';

export default defineConfig({
  adapters: [reactAdapter()],
  defaultAdapter: 'react',
});

📦 Установка

npm i -D @ecss/config

pnpm add -D @ecss/config

yarn add -D @ecss/config

🚀 Использование

@ecss/config — это слой конфигурации ECSS, не привязанный к конкретному сборщику. defineConfig используется в ecss.config.ts и даёт типы и автодополнение в IDE; плагины бандлеров (@ecss/vite-plugin и др.) читают конфиг через loadConfig.

Объектная форма:

// ecss.config.ts
import { defineConfig } from '@ecss/config';
import { reactAdapter } from '@ecss/react-adapter';

export default defineConfig({
  adapters: [reactAdapter()],
  defaultAdapter: 'react',
  aliases: { '#/*': './src/*' },
  globalImports: ['./src/tokens.ecss'],
});

Функциональная форма — получает env вашего сборщика, что удобно для значений, зависящих от команды:

// ecss.config.ts
import { defineConfig } from '@ecss/config';
import type { ConfigEnv } from 'vite';

export default defineConfig<ConfigEnv>(({ command }) => ({
  minifyNames: command === 'build',
  enableDebug: command === 'serve',
}));

Основные поля конфига:

• adapters — адаптеры фреймворков, генерирующие обёртки для ECSS-блоков.
• defaultAdapter — id адаптера, применяемого к .ecss-файлам по умолчанию (null — без обёрток).
• aliases — алиасы путей (поддерживают суффикс-маску *), как paths в TypeScript.
• globalImports — файлы, автоматически подключаемые как wildcard-импорты в начало каждого .ecss.
• generateDeclarations — писать ли .d.ts для каждого .ecss (по умолчанию true).
• enableDebug — компилировать @debug в рантайм-console.log (по умолчанию false).
• minifyNames — сокращать сгенерированные идентификаторы до хешей (по умолчанию false).
• runtimeValidation — включать рантайм-валидацию параметров через console.warn (по умолчанию false).

Полное описание всех полей — в документации.

🧩 API

• defineConfig(config) / defineConfig(env => config) — хелпер для ecss.config.*: добавляет типы и автодополнение, поддерживает объектную и функциональную формы.
• loadConfig(projectRoot, env?) — находит и читает ecss.config.{ts,js,mts,…} в указанном каталоге, возвращает EcssConfig (или {}, если файла нет). Функциональный конфиг вызывается с переданным env.
• readConfigCache(projectRoot) / writeConfigCache(projectRoot, config) — чтение и запись сериализованного снапшота конфига в <projectRoot>/.ecss/config.json; используется редакторным тулингом, которое не исполняет TypeScript.
• EcssConfig — тип объекта конфигурации.
• EcssConfigAdapter — минимальный контракт адаптера, на который ссылается EcssConfig.adapters.
• EcssConfigCache — тип снапшота конфига (aliases, globalImports).

👨‍💻 Автор

Разработка и поддержка: Руслан Мартынов

Если нашёл баг или есть предложение — открывай issue или отправляй pull request.

📄 Лицензия

Распространяется под лицензией MIT.