.TH "ROLLUP" "" "March 2021" "2.38.4" ""
.SH "NAME"
\fBrollup\fR
.TH "ROLLUP" "1" "March 2021" "2.38.4" ""
.SH "NAME"
\fBrollup\fR \- module bundler for JavaScript
.SH SYNOPSIS
.P
rollup [options] <entry file>
.SH OPTIONS
.P
\-c, \-\-config <filename>     Use this config file (if argument is used but value
.br
                              is unspecified, defaults to rollup\.config\.js)
.br
\-d, \-\-dir <dirname>         Directory for chunks (if absent, prints to stdout)
.br
\-e, \-\-external <ids>        Comma\-separate list of module IDs to exclude
.br
\-f, \-\-format <format>       Type of output (amd, cjs, es, iife, umd, system)
.br
\-g, \-\-globals <pairs>       Comma\-separate list of \fBmoduleID:Global\fP pairs
.br
\-h, \-\-help                  Show this help message
.br
\-i, \-\-input <filename>      Input (alternative to <entry file>)
.br
\-m, \-\-sourcemap             Generate sourcemap (\fB\-m inline\fP for inline map)
.br
\-n, \-\-name <name>           Name for UMD export
.br
\-o, \-\-file <output>         Single output file (if absent, prints to stdout)
.br
\-p, \-\-plugin <plugin>       Use the plugin specified (may be repeated)
.br
\-v, \-\-version               Show version number
.br
\-w, \-\-watch                 Watch files in bundle and rebuild on changes
.br
\-\-amd\.id <id>               ID for AMD module (default is anonymous)
.br
\-\-amd\.autoId                Generate the AMD ID based off the chunk name
.br
\-\-amd\.basePath <prefix>     Path to prepend to auto generated AMD ID
.br
\-\-amd\.define <name>         Function to use in place of \fBdefine\fP
.br
\-\-assetFileNames <pattern>  Name pattern for emitted assets
.br
\-\-banner <text>             Code to insert at top of bundle (outside wrapper)
.br
\-\-chunkFileNames <pattern>  Name pattern for emitted secondary chunks
.br
\-\-compact                   Minify wrapper code
.br
\-\-context <variable>        Specify top\-level \fBthis\fP value
.br
\-\-entryFileNames <pattern>  Name pattern for emitted entry chunks
.br
\-\-environment <values>      Settings passed to config file (see example)
.br
\-\-no\-esModule               Do not add __esModule property
.br
\-\-exports <mode>            Specify export mode (auto, default, named, none)
.br
\-\-extend                    Extend global variable defined by \-\-name
.br
\-\-no\-externalLiveBindings   Do not generate code to support live bindings
.br
\-\-failAfterWarnings         Exit with an error if the build produced warnings
.br
\-\-footer <text>             Code to insert at end of bundle (outside wrapper)
.br
\-\-no\-freeze                 Do not freeze namespace objects
.br
\-\-no\-hoistTransitiveImports Do not hoist transitive imports into entry chunks
.br
\-\-no\-indent                 Don't indent result
.br
\-\-no\-interop                Do not include interop block
.br
\-\-inlineDynamicImports      Create single bundle when using dynamic imports
.br
\-\-intro <text>              Code to insert at top of bundle (inside wrapper)
.br
\-\-minifyInternalExports     Force or disable minification of internal exports
.br
\-\-namespaceToStringTag      Create proper \fB\|\.toString\fP methods for namespaces
.br
\-\-noConflict                Generate a noConflict method for UMD globals
.br
\-\-outro <text>              Code to insert at end of bundle (inside wrapper)
.br
\-\-preferConst               Use \fBconst\fP instead of \fBvar\fP for exports
.br
\-\-no\-preserveEntrySignatures Avoid facade chunks for entry points
.br
\-\-preserveModules           Preserve module structure
.br
\-\-preserveModulesRoot       Put preserved modules under this path at root level
.br
\-\-preserveSymlinks          Do not follow symlinks when resolving files
.br
\-\-shimMissingExports        Create shim variables for missing exports
.br
\-\-silent                    Don't print warnings
.br
\-\-sourcemapExcludeSources   Do not include source code in source maps
.br
\-\-sourcemapFile <file>      Specify bundle position for source maps
.br
\-\-stdin=ext                 Specify file extension used for stdin input
.br
\-\-no\-stdin                  Do not read "\-" from stdin
.br
\-\-no\-strict                 Don't emit \fB"use strict";\fP in the generated modules
.br
\-\-strictDeprecations        Throw errors for deprecated features
.br
\-\-systemNullSetters         Replace empty SystemJS setters with \fBnull\fP
.br
\-\-no\-treeshake              Disable tree\-shaking optimisations
.br
\-\-no\-treeshake\.annotations  Ignore pure call annotations
.br
\-\-no\-treeshake\.moduleSideEffects Assume modules have no side\-effects
.br
\-\-no\-treeshake\.propertyReadSideEffects Ignore property access side\-effects
.br
\-\-no\-treeshake\.tryCatchDeoptimization Do not turn off try\-catch\-tree\-shaking
.br
\-\-no\-treeshake\.unknownGlobalSideEffects Assume unknown globals do not throw
.br
\-\-waitForBundleInput        Wait for bundle input files
.br
\-\-watch\.buildDelay <number> Throttle watch rebuilds
.br
\-\-no\-watch\.clearScreen      Do not clear the screen when rebuilding
.br
\-\-watch\.skipWrite           Do not write files to disk when watching
.br
\-\-watch\.exclude <files>     Exclude files from being watched
.br
\-\-watch\.include <files>     Limit watching to specified files
.SH EXAMPLES
.RS 0
.IP \(bu 2
use settings in config file
.P
.RS 2
.nf
rollup \-c
.fi
.RE
.IP \(bu 2
in config file, process\.env\.INCLUDE_DEPS === 'true'
.br
and process\.env\.BUILD === 'production'
.P
.RS 2
.nf
rollup \-c \-\-environment INCLUDE_DEPS,BUILD:production
.fi
.RE
.IP \(bu 2
create CommonJS bundle\.js from src/main\.js
.P
.RS 2
.nf
rollup \-\-format=cjs \-\-file=bundle\.js \-\- src/main\.js
.fi
.RE
.IP \(bu 2
create self\-executing IIFE using \fBwindow\.jQuery\fP
.br
and \fBwindow\._\fP as external globals
.P
.RS 2
.nf
rollup \-f iife \-\-globals jquery:jQuery,lodash:_ \\
\-i src/app\.js \-o build/app\.js \-m build/app\.js\.map
.fi
.RE

.RE
.SH NOTES
.RS 0
.IP \(bu 2
When piping to stdout, only inline sourcemaps are permitted

.RE
.P
For more information visit https://rollupjs\.org