misc.js

'use strict';

var util = require('./utils/handlebarsUtils');
var helpers = module.exports;
const getValue = require('get-value');
const createFrame = require('./utils/createFrame');

/**
 * Block helper for exposing private `@` variables on the context
 */

helpers.frame = function(context, options) {
  if (typeof(context) === 'object' && context.hash) {
    options = context;
    context = options.data;
  }

  var frame = createFrame(context);
  if (typeof(options) !== 'object') {
    options = {};
  }

  // extend the frame with hash arguments
  frame.extend(options.hash);
  return options.fn(this, { data: frame });
};

/**
 * Return the given value of `prop` from `this.options`.
 *
 * ```handlebars
 * <!-- context = {options: {a: {b: {c: 'ddd'}}}} -->
 * {{option 'a.b.c'}}
 * <!-- results => `ddd` -->
 * ```
 * @param {String} `prop`
 * @return {any}
 * @api public
 */

helpers.option = function(prop, locals, options) {
  return getValue(util.options(this, locals, options), prop);
};

/**
 * Block helper that renders the block without taking any arguments.
 *
 * @param {Object} `options`
 * @return {String}
 * @block
 * @api public
 */

helpers.noop = function(options) {
  return options.fn(this);
};

/**
 * Get the native type of the given `value`
 *
 * ```handlebars
 * {{typeOf 1}}
 * //=> 'number'
 * {{typeOf '1'}}
 * //=> 'string'
 * {{typeOf 'foo'}}
 * //=> 'string'
 * ```
 * @param {any} `value`
 * @return {String} Returns the type of value.
 * @api public
 */

helpers.typeOf = function(val) { return typeof val; };

/**
 * Block helper that builds the context for the block
 * from the options hash.
 *
 * @param {Object} `options` Handlebars provided options object.
 * @contributor Vladimir Kuznetsov <https://github.com/mistakster>
 * @block
 * @api public
 */

helpers.withHash = function(options) {
  if (options.hash && Object.keys(options.hash).length) {
    return options.fn(options.hash);
  } else {
    return options.inverse(this);
  }
};