@jaredwray/fumanchu 2.1.0 → 3.0.1

package/lib/object.js

@@ -1,290 +0,0 @@
-'use strict';
-
-var hasOwn = Object.hasOwnProperty;
-var util = require('handlebars-utils');
-var array = require('./array');
-var utils = require('./utils/');
-var helpers = module.exports;
-
-/**
- * Extend the context with the properties of other objects.
- * A shallow merge is performed to avoid mutating the context.
- *
- * @param {Object} `objects` One or more objects to extend.
- * @return {Object}
- * @api public
- */
-
-helpers.extend = function(/*objects*/) {
-  var args = [].slice.call(arguments);
-  var opts = {};
-
-  if (util.isOptions(args[args.length - 1])) {
-    // remove handlebars options object
-    opts = args.pop().hash;
-    // re-add handlebars options.hash object
-    args.push(opts);
-  }
-
-  var context = {};
-  for (var i = 0; i < args.length; i++) {
-    var obj = args[i];
-    if (util.isObject(obj)) {
-      var keys = Object.keys(obj);
-      for (var j = 0; j < keys.length; j++) {
-        var key = keys[j];
-        context[key] = obj[key];
-      }
-    }
-  }
-
-  return context;
-};
-
-/**
- * Block helper that iterates over the properties of
- * an object, exposing each key and value on the context.
- *
- * @param {Object} `context`
- * @param {Object} `options`
- * @return {String}
- * @block
- * @api public
- */
-
-helpers.forIn = function(obj, options) {
-  if (!util.isOptions(options)) {
-    return obj.inverse(this);
-  }
-
-  var data = utils.createFrame(options, options.hash);
-  var result = '';
-
-  for (var key in obj) {
-    data.key = key;
-    result += options.fn(obj[key], {data: data});
-  }
-  return result;
-};
-
-/**
- * Block helper that iterates over the **own** properties of
- * an object, exposing each key and value on the context.
- *
- * @param {Object} `obj` The object to iterate over.
- * @param {Object} `options`
- * @return {String}
- * @block
- * @api public
- */
-
-helpers.forOwn = function(obj, options) {
-  if (!util.isOptions(options)) {
-    return obj.inverse(this);
-  }
-
-  var data = utils.createFrame(options, options.hash);
-  var result = '';
-
-  for (var key in obj) {
-    if (obj.hasOwnProperty(key)) {
-      data.key = key;
-      result += options.fn(obj[key], {data: data});
-    }
-  }
-  return result;
-};
-
-/**
- * Take arguments and, if they are string or number, convert them to a dot-delineated object property path.
- *
- * @param {String|Number} `prop` The property segments to assemble (can be multiple).
- * @return {String}
- * @api public
- */
-
-helpers.toPath = function(/*prop*/) {
-  var prop = [];
-  for (var i = 0; i < arguments.length; i++) {
-    if (typeof arguments[i] === 'string' || typeof arguments[i] === 'number') {
-      prop.push(arguments[i]);
-    }
-  }
-  return prop.join('.');
-};
-
-/**
- * Use property paths (`a.b.c`) to get a value or nested value from
- * the context. Works as a regular helper or block helper.
- *
- * @param {String} `prop` The property to get, optionally using dot notation for nested properties.
- * @param {Object} `context` The context object
- * @param {Object} `options` The handlebars options object, if used as a block helper.
- * @return {String}
- * @block
- * @api public
- */
-
-helpers.get = function(prop, context, options) {
-  var val = utils.get(context, prop);
-  if (options && options.fn) {
-    return val ? options.fn(val) : options.inverse(context);
-  }
-  return val;
-};
-
-/**
- * Use property paths (`a.b.c`) to get an object from
- * the context. Differs from the `get` helper in that this
- * helper will return the actual object, including the
- * given property key. Also, this helper does not work as a
- * block helper.
- *
- * @param {String} `prop` The property to get, optionally using dot notation for nested properties.
- * @param {Object} `context` The context object
- * @return {String}
- * @api public
- */
-
-helpers.getObject = function(prop, context) {
-  return utils.getObject(context, prop);
-};
-
-/**
- * Return true if `key` is an own, enumerable property
- * of the given `context` object.
- *
- * ```handlebars
- * {{hasOwn context key}}
- * ```
- *
- * @param {String} `key`
- * @param {Object} `context` The context object.
- * @return {Boolean}
- * @api public
- */
-
-helpers.hasOwn = function(context, key) {
-  return hasOwn.call(context, key);
-};
-
-/**
- * Return true if `value` is an object.
- *
- * ```handlebars
- * {{isObject "foo"}}
- * //=> false
- * ```
- * @param {String} `value`
- * @return {Boolean}
- * @api public
- */
-
-helpers.isObject = function(value) {
-  return utils.typeOf(value) === 'object';
-};
-
-/**
- * Parses the given string using `JSON.parse`.
- *
- * ```handlebars
- * <!-- string: '{"foo": "bar"}' -->
- * {{JSONparse string}}
- * <!-- results in: { foo: 'bar' } -->
- * ```
- * @param {String} `string` The string to parse
- * @contributor github.com/keeganstreet
- * @block
- * @api public
- */
-
-helpers.JSONparse = function(str, options) {
-  return JSON.parse(str);
-};
-
-/**
- * Stringify an object using `JSON.stringify`.
- *
- * ```handlebars
- * <!-- object: { foo: 'bar' } -->
- * {{JSONstringify object}}
- * <!-- results in: '{"foo": "bar"}' -->
- * ```
- * @param {Object} `obj` Object to stringify
- * @return {String}
- * @api public
- */
-
-helpers.JSONstringify = function(obj, indent) {
-  if (!utils.isNumber(indent)) {
-    indent = 0;
-  }
-  return JSON.stringify(obj, null, indent);
-};
-
-/**
- * Deeply merge the properties of the given `objects` with the
- * context object.
- *
- * @param {Object} `object` The target object. Pass an empty object to shallow clone.
- * @param {Object} `objects`
- * @return {Object}
- * @api public
- */
-
-helpers.merge = function(context/*, objects, options*/) {
-  var args = [].slice.call(arguments);
-  var opts = {};
-
-  if (util.isOptions(args[args.length - 1])) {
-    // remove handlebars options object
-    opts = args.pop().hash;
-    // re-add options.hash
-    args.push(opts);
-  }
-
-  return Object.assign.apply(null, args);
-};
-
-/**
- * Alias for parseJSON. this will be
- * deprecated in a future release
- */
-
-helpers.parseJSON = helpers.JSONparse;
-
-/**
- * Pick properties from the context object.
- *
- * @param {Array|String} `properties` One or more properties to pick.
- * @param {Object} `context`
- * @param {Object} `options` Handlebars options object.
- * @return {Object} Returns an object with the picked values. If used as a block helper, the values are passed as context to the inner block. If no values are found, the context is passed to the inverse block.
- * @block
- * @api public
- */
-
-helpers.pick = function(props, context, options) {
-  var keys = array.arrayify(props);
-  var len = keys.length, i = -1;
-  var result = {};
-
-  while (++i < len) {
-    result = helpers.extend({}, result, utils.getObject(context, keys[i]));
-  }
-
-  if (options.fn) {
-    if (Object.keys(result).length) {
-      return options.fn(result);
-    }
-    return options.inverse(context);
-  }
-  return result;
-};
-
-/**
- * Alias for JSONstringify. this will be
- * deprecated in a future release
- */
-
-helpers.stringify = helpers.JSONstringify;

package/lib/path.js

@@ -1,181 +0,0 @@
-'use strict';
-
-var util = require('handlebars-utils');
-var path = require('path');
-var utils = require('./utils');
-var helpers = module.exports;
-
-utils.expectedType = (variableName, expectedType, variableValue) => {
-  const actualType = Object.prototype.toString.call(variableValue).slice(8, -1).toLowerCase();
-
-  if (actualType !== expectedType) {
-      throw new TypeError(`Expected ${variableName} to be of type ${expectedType}, but got ${actualType}`);
-  }
-};
-
-
-/**
- * Get the directory path segment from the given `filepath`.
- *
- * ```handlebars
- * {{absolute "docs/toc.md"}}
- * <!-- results in: 'docs' -->
- * ```
- * @param {String} `ext`
- * @return {String}
- * @api public
- */
-
-helpers.absolute = function(filepath, options) {
-  options = options || {data: {}};
-  var context = util.options(this, options);
-  var ctx = Object.assign({}, options.data.root, context);
-  var cwd = ctx.cwd || process.cwd();
-  return path.resolve(cwd, filepath);
-};
-
-/**
- * Get the directory path segment from the given `filepath`.
- *
- * ```handlebars
- * {{dirname "docs/toc.md"}}
- * <!-- results in: 'docs' -->
- * ```
- * @param {String} `ext`
- * @return {String}
- * @api public
- */
-
-helpers.dirname = function(filepath, options) {
-  if (typeof filepath !== 'string') {
-    throw new TypeError(utils.expectedType('filepath', 'string', filepath));
-  }
-  return path.dirname(filepath);
-};
-
-/**
- * Get the relative filepath from `a` to `b`.
- *
- * ```handlebars
- * {{relative a b}}
- * ```
- * @param {String} `a`
- * @param {String} `b`
- * @return {String}
- * @api public
- */
-
-helpers.relative = function(a, b) {
-  if (typeof a !== 'string') {
-    throw new TypeError(utils.expectedType('first path', 'string', a));
-  }
-  if (typeof b !== 'string') {
-    throw new TypeError(utils.expectedType('second path', 'string', b));
-  }
-  return utils.relative(a, b);
-};
-
-/**
- * Get the file extension from the given `filepath`.
- *
- * ```handlebars
- * {{basename "docs/toc.md"}}
- * <!-- results in: 'toc.md' -->
- * ```
- * @param {String} `ext`
- * @return {String}
- * @api public
- */
-
-helpers.basename = function(filepath) {
-  if (typeof filepath !== 'string') {
-    throw new TypeError(utils.expectedType('filepath', 'string', filepath));
-  }
-  return path.basename(filepath);
-};
-
-/**
- * Get the "stem" from the given `filepath`.
- *
- * ```handlebars
- * {{stem "docs/toc.md"}}
- * <!-- results in: 'toc' -->
- * ```
- * @param {String} `filepath`
- * @return {String}
- * @api public
- */
-
-helpers.stem = function(filepath) {
-  if (typeof filepath !== 'string') {
-    throw new TypeError(utils.expectedType('filepath', 'string', filepath));
-  }
-  return path.basename(filepath, path.extname(filepath));
-};
-
-/**
- * Get the file extension from the given `filepath`.
- *
- * ```handlebars
- * {{extname "docs/toc.md"}}
- * <!-- results in: '.md' -->
- * ```
- * @param {String} `filepath`
- * @return {String}
- * @api public
- */
-
-helpers.extname = function(filepath) {
-  if (typeof filepath !== 'string') {
-    throw new TypeError(utils.expectedType('filepath', 'string', filepath));
-  }
-  return path.extname(filepath);
-};
-
-/**
- * Resolve an absolute path from the given `filepath`.
- *
- * ```handlebars
- * {{resolve "docs/toc.md"}}
- * <!-- results in: '/User/dev/docs/toc.md' -->
- * ```
- * @param {String} `filepath`
- * @return {String}
- * @api public
- */
-
-helpers.resolve = function(filepath) {
-  var args = [].slice.call(arguments);
-  var opts = util.options(this, args.pop());
-  var cwd = path.resolve(opts.cwd || process.cwd());
-  args.unshift(cwd);
-  return path.resolve.apply(path, args);
-};
-
-/**
- * Get specific (joined) segments of a file path by passing a
- * range of array indices.
- *
- * ```handlebars
- * {{segments "a/b/c/d" "2" "3"}}
- * <!-- results in: 'c/d' -->
- *
- * {{segments "a/b/c/d" "1" "3"}}
- * <!-- results in: 'b/c/d' -->
- *
- * {{segments "a/b/c/d" "1" "2"}}
- * <!-- results in: 'b/c' -->
- * ```
- *
- * @param {String} `filepath` The file path to split into segments.
- * @return {String} Returns a single, joined file path.
- * @api public
- */
-
-helpers.segments = function(filepath, a, b) {
-  if (typeof filepath !== 'string') {
-    throw new TypeError(utils.expectedType('filepath', 'string', filepath));
-  }
-  var segments = filepath.split(/[\\\/]+/);
-  return segments.slice(a, b).join('/');
-};

package/lib/regex.js

@@ -1,50 +0,0 @@
-'use strict';
-
-var util = require('handlebars-utils');
-var utils = require('./utils');
-var helpers = module.exports;
-
-/**
- * Convert the given string to a regular expression.
- *
- * ```handlebars
- * {{toRegex "foo"}}
-  * <!-- results in: /foo/ -->
- * ```
- * @param {String} `str`
- * @return {RegExp}
- * @api public
- */
-
-helpers.toRegex = function(str, locals, options) {
-  var opts = util.options({}, locals, options);
-  return new RegExp(str, opts.flags);
-};
-
-/**
- * Returns true if the given `str` matches the given regex. A regex can
- * be passed on the context, or using the [toRegex](#toregex) helper as a
- * subexpression.
- *
- * ```handlebars
- * {{test "bar" (toRegex "foo")}}
-  * <!-- results in: false -->
- * {{test "foobar" (toRegex "foo")}}
-  * <!-- results in: true -->
- * {{test "foobar" (toRegex "^foo$")}}
-  * <!-- results in: false -->
- * ```
- * @param {String} `str`
- * @return {RegExp}
- * @api public
- */
-
-helpers.test = function(str, regex) {
-  if (!util.isString(str)) {
-    return false;
-  }
-  if (utils.typeOf(regex) !== 'regexp') {
-    throw new TypeError('expected a regular expression');
-  }
-  return regex.test(str);
-};