cush.config.js

[aleclarson]

// for javascript bundles only
exports.js = function() {
  this.plugin('markdown');    // enable .md modules
  this.plugin([ /* ... */ ]); // enable multiple plugins at once
  this.set('jsxPragma', 'h'); // use preact
  this.nebu.use([
    // nebu plugins goes here
  ]);
  console.log('dev:', this.dev);   // know if `this` is a development bundle
  console.log('root:', __dirname); // the project root
};

Since the exported function is called once per bundle, you may want to declare some variables outside if recreating them is costly, but I think that will be rare.

Bundle plugins must exist in the devDependencies of the project's package.json if you want to activate them using this.plugin. You can use the file: protocol to reference local plugins, if necessary.

It might be cool to share this API with bundle plugins, so once you're familiar with bundle configuration, you're capable of making a bundle plugin, too! That would mean making this API a little more flexible by adding this.hook for package-loading and module-loading functions. Maybe bundle plugins could provide their own hooks, too!

I'm open to suggestions on other capabilities. 😄

[aleclarson]

The hook API:

this.hook('config', () => {
  // Do something after `cush.config.js` has been applied.
});

// Provide a hook.
let hook = this.hook('my-hook');
hook.run(a, b, c);

The provider API may be expanded in the future. For example, the provider may want to run async hooks sequentially, instead of in parallel. Or the provider may want its hooks to have return values.

[aleclarson]

The BundleConfig class will always have these methods:

• get(path: string) access a bundle option
• set(path: string, value: any) update a bundle option
• plugin(name: string | string[]) activate a plugin or plugins
• hook(id: string, hook: ?function) create a provider or hook into one
• hookModules(ext: string, hook: function) hook into the module loader
• hookPackages(hook: function) hook into the package loader

...and these properties:

• dev: boolean development mode
• target: string the targeted platform
• root: string the project root path
• pack: object the data from "package.json"

[aleclarson]

Implemented in d4025db59fc5e9267aadf31fdace98ab46d2e9c5 🎉