{"id":22209,"library":"rollup-plugin-sass-migrator","title":"rollup-plugin-sass-migrator","description":"Rollup/Vite plugin to run the sass-migrator tool on SASS files during development and build, primarily to eliminate deprecation warnings from the SASS compiler. Version 1.0.5 (stable) has a peer dependency on sass-migrator ^1. Designed to simplify automatic migration by integrating into the build pipeline, with special support for Quasar projects via a convenience function. Unlike manual migration, it automates migration on every build, ensuring existing warnings are resolved.","status":"active","version":"1.0.5","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","sass","vite","quasar","rollup","migrate","typescript"],"install":[{"cmd":"npm install rollup-plugin-sass-migrator","lang":"bash","label":"npm"},{"cmd":"yarn add rollup-plugin-sass-migrator","lang":"bash","label":"yarn"},{"cmd":"pnpm add rollup-plugin-sass-migrator","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency; the plugin runs the sass-migrator CLI tool.","package":"sass-migrator","optional":false}],"imports":[{"note":"Named export, not default. Available in ES modules.","wrong":"import sassMigrator from 'rollup-plugin-sass-migrator'","symbol":"sassMigrator","correct":"import { sassMigrator } from 'rollup-plugin-sass-migrator'"},{"note":"ESM-only; require will not work. This is a convenience function for Quasar projects.","wrong":"const sassMigratorQuasar = require('rollup-plugin-sass-migrator')","symbol":"sassMigratorQuasar","correct":"import { sassMigratorQuasar } from 'rollup-plugin-sass-migrator'"},{"note":"CJS destructuring works in Rollup context; do not use .default.","wrong":"const sassMigrator = require('rollup-plugin-sass-migrator').default;","symbol":"sassMigrator (Rollup)","correct":"const { sassMigrator } = require('rollup-plugin-sass-migrator');"}],"quickstart":{"code":"// vite.config.js\nimport { defineConfig } from 'vite';\nimport { sassMigrator } from 'rollup-plugin-sass-migrator';\n\nexport default defineConfig({\n  plugins: [\n    sassMigrator({\n      indexPath: 'node_modules/quasar/src/css/index.sass',\n      debug: false,\n      dryRun: false,\n    })\n  ]\n});","lang":"typescript","description":"Basic Vite plugin setup that runs sass-migrator on a specific index SASS file, with debug and dry run flags."},"warnings":[{"fix":"Install peer dependency: npm install -D sass-migrator or yarn add -D sass-migrator","message":"Peer dependency 'sass-migrator' is required but may be missing if not installed.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Use import syntax or ensure your build tool handles CJS require of ESM packages (e.g., using a bundler like Rollup).","message":"Plugin only supports ESM imports; CommonJS require may fail in some setups.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Pass either indexPath option to sassMigrator or use sassMigratorQuasar() for Quasar projects.","message":"The plugin does not automatically detect sass-migrator configuration; you must specify indexPath or use the Quasar convenience function.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"npm install -D sass-migrator","cause":"Missing peer dependency sass-migrator","error":"Error: Cannot find module 'sass-migrator'"},{"fix":"Use import { sassMigrator } from 'rollup-plugin-sass-migrator'","cause":"Importing default export instead of named export","error":"TypeError: sass_migrator is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}