Configuration Options

interface FileFilterOptions {
  /** File globs to include in processing. Default ['**/*.sass', '**/*.scss'] */
  include?: string | string[];
  /** File globs to exclude from processing. Default 'node_modules/**' */
  exclude?: string | string[];
}

import sass from 'rollup-plugin-sass';

// Include additional CSS files
sass({
  include: ['**/*.css', '**/*.sass', '**/*.scss'],
});

// Exclude specific directories
sass({
  exclude: ['node_modules/**', 'test/**/*.scss'],
});

// Multiple patterns
sass({
  include: ['src/**/*.scss', 'styles/**/*.sass'],
  exclude: ['src/vendor/**', 'styles/temp/**'],
});

interface ApiModeOptions {
  /** API mode selection - 'legacy' (default) or 'modern' */
  api?: 'legacy' | 'modern';
  /** Sass compiler options specific to the selected API */
  options?: SassModernOptions | SassLegacyOptions;
}

// Legacy API (default)
sass({
  api: 'legacy',
  options: {
    outputStyle: 'compressed',
    includePaths: ['node_modules'],
  },
});

// Modern API
sass({
  api: 'modern',
  options: {
    style: 'compressed',
    loadPaths: ['node_modules'],
  },
});

// Modern API with NodePackageImporter for npm packages
import * as sass from 'sass';

sass({
  api: 'modern',
  options: {
    importers: [new sass.NodePackageImporter()],
  },
});

interface RuntimeOptions {
  /** Sass runtime instance - sass, node-sass or other compatible compiler */
  runtime?: any;
}

import * as sass from 'sass';
import * as nodeSass from 'node-sass';

// Use Dart Sass (default)
sass({
  runtime: sass,
});

// Use Node Sass
sass({
  runtime: nodeSass,
});

interface OutputOptions {
  /** 
   * Output control:
   * - false: no output (default)
   * - true: output as .css file alongside JS bundle
   * - string: specific file path
   * - function: custom output handler
   */
  output?: boolean | string | RollupPluginSassOutputFn;
}

type RollupPluginSassOutputFn = (
  styles: string,
  styleNodes: StyleSheetIdAndContent[]
) => unknown;

// No output (styles embedded in JS)
sass({
  output: false,
});

// Auto-generate CSS file
sass({
  output: true, // Creates bundle.css if bundle is bundle.js
});

// Specific output file
sass({
  output: 'dist/styles.css',
});

// Custom output handler
sass({
  output(styles, styleNodes) {
    console.log(`Generated ${styles.length} characters of CSS`);
    writeFileSync('custom-bundle.css', styles);
  },
});

interface StyleInjectionOptions {
  /** Insert compiled CSS into HTML head via utility function */
  insert?: boolean;
}

// Inject styles into document head
sass({
  insert: true,
});

// Combined with other options
sass({
  insert: true,
  output: false, // Don't create CSS file when injecting
});

interface DataOptions {
  /** Data to prepend to all Sass files */
  data?: string;
}

// Inject global variables
sass({
  options: {
    data: '$primary-color: #007bff; $font-size: 16px;',
  },
});

// Import global mixins and variables
sass({
  options: {
    data: '@import "src/styles/variables"; @import "src/styles/mixins";',
  },
});

import sass from 'rollup-plugin-sass';
import * as dartSass from 'sass';

export default {
  input: 'src/index.js',
  output: {
    file: 'dist/bundle.js',
    format: 'esm',
  },
  plugins: [
    sass({
      // File filtering
      include: ['src/**/*.scss', 'styles/**/*.sass'],
      exclude: ['node_modules/**', 'test/**'],
      
      // API configuration
      api: 'modern',
      runtime: dartSass,
      
      // Output configuration
      output: 'dist/styles.css',
      insert: false,
      
      // Sass options
      options: {
        style: 'compressed',
        loadPaths: ['node_modules', 'src/styles'],
        data: '@import "variables"; @import "mixins";',
      },
    }),
  ],
};