Release (2025-11-11)

• broccoli 4.0.0 (major)

💥 Breaking Change

• broccoli
  • #510 Drop Node < 20; widen Node range up to 24, get CI running; revert unreleased change (@kategengler)

🐛 Bug Fix

• broccoli
  • #531 remove esm package and bump minimum node version to v20.19 (@mansona)
  • #513 Convert to pnpm + upgrades (@kategengler)

📝 Documentation

• broccoli
  • #517 Remove broken website link (@kategengler)

🏠 Internal

• broccoli
  • #530 Prepare Release v4.0.0 (@github-actions[bot])
  • #529 Add release-plan (@kategengler)
  • #528 Upgrade prettier (@kategengler)
  • #527 Upgrade dev deps (@kategengler)
  • #518 Update lockfile after removing https package (@kategengler)
  • #504 Remove https npm library as it doesn't and cannot do anything (@spthiel)
  • #516 Fixes after branch rename to main (@kategengler)

Committers: 4

• Chris Manson (@mansona)
• Katie Gengler (@kategengler)
• @github-actions[bot]
• @spthiel

🐛 Bug Fix

• #478 Manually exit process (@asakusuma)

Committers: 1

• Asa Kusuma (@asakusuma)

🚀 Enhancement

• #474 add the ability to ignore absolute paths from watcher (@ef4)

🐛 Bug Fix

• #473 remove vestigial filter option (@ef4)

📝 Documentation

• #470 Fix wrong package name in README (@ursm)

Committers: 2

• Edward Faulkner (@ef4)
• Keita Urashima (@ursm)

• Add input node change tracking (#419)
• Initial typescript conversion (#422)
• Fixup cli usage information (#421)
• Use a more appropriate data structure for nodeWrappers (#418)
• Support serving over HTTPS (#417)

• Add rebuild memoization support behind feature flag (#396)
  • BROCCOLI_ENABLED_MEMOIZE=true to turn on
• Add more watcher events (#398)
• Drop support for unsupported Node versions (#400)
  • Drop Node 6 support.
• Bump broccoli-node-info to v2.0.0
• Pass watchedNodes to Watcher/WatcherAdapter (#403)
  • Require watchedNodes arguments to Watcher/WatcherAdapter (#405)

The future is here, today!

Broccoli now supports a Brocfile.ts, and will auto compile this through ts-node 🎉

By default, ts-node uses TypeScript defaults for the compiler options. If you wish to add your own compiler options to make things stricter, you can add a tsconfig.json of your own and Broccoli should auto pick this up.

So now:

import merge = require('broccoli-merge-trees');
import uglify = require('broccoli-uglify-sourcemap');
import { BrocfileOptions } from 'broccoli';

export default (options: BrocfileOptions) => {
  let js = 'src/a';

  if (options.env === 'production') {
    js = uglify(js);
  }

  return merge([js, 'src/b']);
}

Should work, and your editor should get access to the types it can find.
Over time, we will push for plugin developers to define at least a type definition, and provide documentation for how to convert a plugin to TypeScript

Thanks to everyone who helped in reviewing this.

This release adds support for several new features.

ES Modules syntax

PR: #385
ES modules syntax is now supported in Broccoli using the esm npm package. You're now free to use this syntax for your Brocfile.js https://github.com/broccolijs/broccoli#using-plugins-in-a-brocfilejs
Welcome to the future!

import merge from 'broccoli-merge-trees';

export default merge(['a', 'b']);

Export function

PR: #386
Broccoli now supports exporting a function from the Brocfile.js, in the same way that Ember-CLI does https://github.com/broccolijs/broccoli#brocfilejs which paves the way for future enhancements to supply build parameters to the pipeline

import merge from 'broccoli-merge-trees';

export default () => {
  return merge(['a', 'b']);
}

Environment

PR: #387
Broccoli now supports --environment,-e,--prod,--dev CLI arguments similar to Ember-CLI. The environment flag is passed to the Brocfile in the options hash { env: ENVIRONMENT } and defaults to development.
Similar to the legacy BROCCOLI_CLI environment variable, this allows a build pipeline to be altered based on the destined environment, for example by minifying files for production.

import merge from 'broccoli-merge-trees';
import uglify from 'broccoli-uglify-js';

export default (options) => {
  let tree = merge(['a', 'b']);
  if (options.environment === 'production') {
    tree = uglify(tree);
  }
  return tree;
}