You can add custom plugins to be used during transpilation of the addon/ or
addon-test-support/ trees of your addon (or the app/ and tests/ trees of an application)
by registering a custom AST transform.
var SomeTransform = require('./some-path/transform');module.exports = { name: 'my-addon-name', included: function() { // we have to wrap these in an object so the ember-cli // registry doesn't try to call `new` on them (new is actually // called within htmlbars when compiling a given template). this.app.registry.add('htmlbars-ast-plugin', { name: 'some-transform', plugin: SomeTransform }); this._super.included.apply(this, arguments); }};
Options for registering a plugin
name - String. The name of the AST transform for debugging purposes.
dependencyInvalidation - Boolean. A flag that indicates the AST Plugin may, on a per-template basis, depend on other files that affect its output.
cacheKey - function that returns any JSON-compatible value - The value returned is used to invalidate the persistent cache across restarts, usually in the case of a dependency or configuration change.
baseDir - () => string. A function that returns the directory on disk of the npm module for the plugin. If provided, a basic cache invalidation is performed if any of the dependencies change (e.g. due to a npm install/upgrade).
Implementing Dependency Invalidation in an AST Plugin
Plugins that set the dependencyInvalidation option to true can provide function for the plugin of type ASTDependencyPlugin as given below.
Note: the plugin function is invoked without a value for this in context.
You can still provide a custom path to the template compiler (e.g. to test
custom template compiler tweaks in an application) by:
// ember-cli-build.jsmodule.exports = function(defaults) { let app = new EmberApp(defaults, { 'ember-cli-htmlbars': { templateCompilerPath: `some_path/to/ember-template-compiler.js`, } });};
Using as a Broccoli Plugin
var HtmlbarsCompiler = require('ember-cli-htmlbars');var templateTree = new HtmlbarsCompiler('app/templates', { isHTMLBars: true, // provide the templateCompiler that is paired with your Ember version templateCompiler: require('./bower_components/ember/ember-template-compiler')});