import { addExtension } from '@rollup/pluginutils';export default function myPlugin(options = {}) { return { resolveId(code, id) { // only adds an extension if there isn't one already id = addExtension(id); // `foo` -> `foo.js`, `foo.js` -> `foo.js` id = addExtension(id, '.myext'); // `foo` -> `foo.myext`, `foo.js` -> `foo.js` } };}
attachScopes
Attaches Scope objects to the relevant nodes of an AST. Each Scope object has a scope.contains(name) method that returns true if a given name is defined in the current scope or a parent scope.
import { attachScopes } from '@rollup/pluginutils';import { walk } from 'estree-walker';export default function myPlugin(options = {}) { return { transform(code) { const ast = this.parse(code); let scope = attachScopes(ast, 'scope'); walk(ast, { enter(node) { if (node.scope) scope = node.scope; if (!scope.contains('foo')) { // `foo` is not defined, so if we encounter it,
createFilter
Constructs a filter function which can be used to determine whether or not certain modules should be operated upon.
A valid picomatch pattern, or array of patterns. If options.include is omitted or has zero length, filter will return true by default. Otherwise, an ID must match one or more of the picomatch patterns, and must not match any of the options.exclude patterns.
Note that picomatch patterns are very similar to minimatch patterns, and in most use cases, they are interchangeable. If you have more specific pattern matching needs, you can view this comparison table to learn more about where the libraries differ.
options
resolve
Type: String | Boolean | null
Optionally resolves the patterns against a directory other than process.cwd(). If a String is specified, then the value will be used as the base directory. Relative paths will be resolved against process.cwd() first. If false, then the patterns will not be resolved against any directory. This can be useful if you want to create a filter for virtual module names.
Usage
import { createFilter } from '@rollup/pluginutils';export default function myPlugin(options = {}) { // assume that the myPlugin accepts options of `options.include` and `options.exclude` var filter = createFilter(options.include, options.exclude, { resolve: '/my/base/dir' }); return { transform(code, id) { if (!filter(id)) return; // proceed with the transformation... } };}
dataToEsm
Transforms objects into tree-shakable ES Module imports.