migrate-pcss-to-scss

Инструмент для миграции проектов из .pcss (PostCSS) в .scss (Sass/SCSS).

Этот пакет предоставляет как CLI-команду pcss-to-scss-migrator, так и программный API для запуска миграции из JavaScript/TypeScript-кода.

Установка

npm i -D migrate-pcss-to-scss

CLI

Примеры:

npx pcss-to-scss-files-renamer

Файлы переименовываются на .scss, их содержимое не преобразуется. Если вы пользуетесь git репозиторием, то после выполнения рекомендуется закоммитить изменение, чтобы в истории файлы были помечены как перемещенные.

npx pcss-to-scss-migrator

CLI запускает код, который рекурсивно ищет .pcss / .scss файлы в рабочей директории и выполняет преобразования.

Программный API

Пакет экспортирует набор классов для интеграции в Node-приложения:

• Migrator — основной класс для запуска полной миграции (сканирование, преобразование, запись файлов).
• FilesRenamer — утилита для переименования файлов .pcss → .scss (без конвертации содержимого).

Пример использования в TypeScript / Node:

// Пример: запустить миграцию программно
import { Migrator } from 'migrate-pcss-to-scss';

async function run() {
  const migrator = new Migrator();
  await migrator.run();
}

run().catch((err) => {
  console.error('Migration failed:', err);
  process.exit(1);
});

// Пример: только переименование файлов
import { FilesRenamer } from 'migrate-pcss-to-scss';

async function renameOnly() {
  const r = new FilesRenamer();
  await r.run();
}

renameOnly().catch(console.error);

Советы и безопасность

• Всегда делайте резервную копию или используйте git, прежде чем запускать миграцию: мигратор перезаписывает файлы в проекте.

Вклад и развитие

PR принимаются в репозиторий на GitHub: https://github.com/Graisvendir/migrate-pcss-to-scss

Пожалуйста, добавляйте тесты и держите API совместимым.

Лицензия

MIT