@jsxtools/rollup-plugin-copy

@jsxtools/rollup-plugin-copy is a rollup plugin for copying files during the build process.

Installation

``shell
npm install @jsxtools/rollup-plugin-copy
`

Usage

`javascript
import { rollupPluginCopy } from '@jsxtools/rollup-plugin-copy';

export default {
input: 'src/index.js',
output: {
file: 'dist/bundle.js',
format: 'es'
},
plugins: [
rollupPluginCopy({
rootDir: 'src',
distDir: 'dist',
include: ['src//.css', 'src//.png', 'src/*/.svg'],
exclude: ['src/*/.test.*']
})
]
};
`

Features

- Copies files from source to destination with glob pattern support.
- Only copies files that have changed using modification time and SHA-256 hash comparison.
- Maintains a cache to avoid unnecessary file operations.
- Handles file additions, changes, and deletions during development.
- Uses Copy-on-Write (CoW) optimization when available (APFS, Btrfs, XFS).
- Integrates with Rollup's asset system.

Configuration Options

- cacheFile - Cache file for tracking changes (default: cpconfig.cpbuildinfo).
- include - Glob patterns for files to include (string or array).
- exclude - Glob patterns for files to exclude (string or array).
- distDir - Destination directory to copy files to (default: dist).
- workDir - Current working directory (default: current process directory).
- rootDir - Source directory to copy files from (default: src)

Examples

$3

`javascript
rollupPluginCopy({
rootDir: 'src',
distDir: 'dist',
include: [
'src/*/.css',
'src/*/.png',
'src/*/.jpg',
'src/*/.svg'
]
})
`

$3

`javascript
rollupPluginCopy({
rootDir: 'assets',
distDir: 'public',
include: ['assets/*/'],
exclude: [
'assets/*/.test.*',
'assets/*/.'
]
})
`

Caching

The plugin maintains a cache file (default: cpconfig.cpbuildinfo) that tracks file modification times and SHA-256 hashes. This enables:

- Only changed files are copied (based on mtime comparison)
- Content verification using SHA-256 hashes when mtime differs
- Detection of removed files for cleanup
- Minimal file system operations during development
- Incremental builds with accurate change detection

API

The plugin exports both the main plugin and a separate API:

- rollupPluginCopy() - The main Rollup plugin
- CopyAPI - Available via @jsxtools/rollup-plugin-copy/api

`javascript
import { CopyAPI } from '@jsxtools/rollup-plugin-copy/api';

const copyApi = new CopyAPI();
copyApi.init({
rootDir: 'src',
distDir: 'dist',
include: ['src/*/.css']
});
`

Peer Dependencies

- rollup` ^4.6.0

License

MIT-0