esroll

library1.2.3jsnpmunverified

Build tool combining esbuild and rollup for bundling TypeScript and JavaScript with declaration generation and API documentation. Current stable version is 1.2.3, released with active development and regular updates. Requires Node >=24. It integrates esbuild's fast bundling with rollup's plugin ecosystem and adds declaratino generation via API Extractor and docgen. Differentiators include unified pipeline, built-in doc generation, and first-class TypeScript support.

devops web-framework

npm install esroll

github ↗package ↗

INSTALL

IMPORT

SIG · ESROLL

esroll

devopsjavascriptv1.2.3

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

build

✓ import { build } from 'esroll'

✗ const { build } = require('esroll')

ESM-only since v1.0.0

default

✓ import esroll from 'esroll'

✗ import * as esroll from 'esroll'

Default export is the main API function (equivalent to build)

type

✓ import type { Options } from 'esroll'

✗ imort { Options } from 'esroll'

Options type import for TypeScript users

Shows basic usage of esroll to bundle a TypeScript entry point with declaration generation and API docs.

import { build } from 'esroll'; await build({ entryPoints: ['src/index.ts'], outdir: 'dist', format: 'esm', dts: true, doc: true, }); // Output: ESM bundle + .d.ts declarations + API documentation

esroll --version

Debug

Known issues

breakingNode >=24 required; earlier versions are not supported.

fix

Use v0.x if Node <24, or upgrade Node to >=24.

affects: <1.0.0

deprecatedThe options `declaration` and `docs` have been renamed to `dts` and `doc` respectively.

fix

Use `dts: true` and `doc: true` instead.

affects: >=1.0.0

gotchaSourcemaps from esbuild may be lost during rollup handoff if not properly configured.

fix

Ensure `sourcemap` option is set in both esbuild and rollup configs.

affects: >=1.2.0

gotchaBundle may fail or produce unexpected output when using non-standard file extensions.

fix

Only use .ts, .tsx, .js, .jsx, .mjs, .cjs as entry points.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'esroll'

Package not installed or module resolution misconfigured.

fix

npm install esroll --save-dev

TypeError: esroll.build is not a function

Using named import incorrectly or mixing ESM/CJS.

fix

Use `import { build } from 'esroll'` (ESM) instead of `const { build } = require('esroll')` (CJS).

Error: RollupError: Could not resolve entry module

Entry point file path is incorrect or missing.

fix

Check that `entryPoints` array contains valid paths relative to cwd.

Error: esbuild: Build failed with 1 error:...

Syntax error or missing dependency in source code.

fix

Fix the TypeScript/JS error indicated in the message.

Upgrade

Version history

1.2.3latest on npm

Audit

Dependencies

esbuildrequiredcore bundling engine

rolluprequiredadditional bundling and plugin system

Agent activity

8 hits · last 30 days

node

Resources

githubhttps://github.com/escapace/esroll ↗

packagehttps://www.npmjs.com/package/esroll ↗