90 lines
3.2 KiB
JavaScript
90 lines
3.2 KiB
JavaScript
/*
|
|
* decaffeinate suggestions:
|
|
* DS102: Remove unnecessary code created because of implicit returns
|
|
* Full docs: https://github.com/decaffeinate/decaffeinate/blob/master/docs/suggestions.md
|
|
*/
|
|
|
|
/**
|
|
Template helper definitions for Handlebars.
|
|
@license MIT. See LICENSE.md for details.
|
|
@module handlebars-helpers.js
|
|
*/
|
|
|
|
const HANDLEBARS = require('handlebars');
|
|
const _ = require('underscore');
|
|
const helpers = require('./generic-helpers');
|
|
const path = require('path');
|
|
const blockHelpers = require('./block-helpers');
|
|
const HMS = require('../core/status-codes');
|
|
|
|
/**
|
|
Register useful Handlebars helpers.
|
|
@method registerHelpers
|
|
*/
|
|
|
|
module.exports = function( theme, rez, opts ) {
|
|
|
|
helpers.theme = theme;
|
|
helpers.opts = opts;
|
|
helpers.type = 'handlebars';
|
|
|
|
// Prepare generic helpers for use with Handlebars. We do this by wrapping them
|
|
// in a Handlebars-aware wrapper which calls the helper internally.
|
|
const wrappedHelpers = _.mapObject(helpers, function( hVal/*, hKey*/ ) {
|
|
if (_.isFunction(hVal)) {
|
|
return _.wrap(hVal, function(func) {
|
|
const args = Array.prototype.slice.call(arguments);
|
|
args.shift(); // lose the 1st element (func) [^1]
|
|
//args.pop() # lose the last element (HB options hash)
|
|
args[ args.length - 1 ] = rez; // replace w/ resume object
|
|
return func.apply(this, args);
|
|
}); // call the generic helper
|
|
}
|
|
return hVal;
|
|
}
|
|
, this);
|
|
HANDLEBARS.registerHelper(wrappedHelpers);
|
|
|
|
// Prepare Handlebars-specific helpers - "blockHelpers" is really a misnomer
|
|
// since any kind of Handlebars-specific helper can live here
|
|
HANDLEBARS.registerHelper(blockHelpers);
|
|
|
|
// Register any theme-provided custom helpers...
|
|
|
|
// Normalize "theme.helpers" (string or array) to an array
|
|
if (_.isString(theme.helpers)) { theme.helpers = [ theme.helpers ]; }
|
|
|
|
if (_.isArray(theme.helpers)) {
|
|
const glob = require('glob');
|
|
const slash = require('slash');
|
|
let curGlob = null;
|
|
try {
|
|
_.each(theme.helpers, function(fGlob) { // foreach theme.helpers entry
|
|
curGlob = fGlob; // ..cache in case of exception
|
|
fGlob = path.join(theme.folder, fGlob); // ..make relative to theme
|
|
const files = glob.sync(slash(fGlob)); // ..expand the glob
|
|
if (files.length > 0) { // ..guard against empty glob
|
|
_.each(files, function(f) { // ..loop over concrete paths
|
|
HANDLEBARS.registerHelper(require(f)); // ..register the path
|
|
});
|
|
} else {
|
|
throw {fluenterror: HMS.themeHelperLoad, inner: null, glob: fGlob};
|
|
}
|
|
});
|
|
return;
|
|
} catch (ex) {
|
|
throw{
|
|
fluenterror: HMS.themeHelperLoad,
|
|
inner: ex,
|
|
glob: curGlob, exit: true
|
|
};
|
|
}
|
|
}
|
|
};
|
|
|
|
// [^1]: This little bit of acrobatics ensures that our generic helpers are
|
|
// called as generic helpers, not as Handlebars-specific helpers. This allows
|
|
// them to be used in other templating engines, like Underscore. If you need a
|
|
// Handlebars-specific helper with normal Handlebars context and options, put it
|
|
// in block-helpers.coffee.
|