|
|
- /*!
- * use <https://github.com/jonschlinkert/use>
- *
- * Copyright (c) 2015-2017, Jon Schlinkert.
- * Released under the MIT License.
- */
-
- 'use strict';
-
- module.exports = function base(app, options) {
- if (!isObject(app) && typeof app !== 'function') {
- throw new TypeError('expected an object or function');
- }
-
- var opts = isObject(options) ? options : {};
- var prop = typeof opts.prop === 'string' ? opts.prop : 'fns';
- if (!Array.isArray(app[prop])) {
- define(app, prop, []);
- }
-
- /**
- * Define a plugin function to be passed to use. The only
- * parameter exposed to the plugin is `app`, the object or function.
- * passed to `use(app)`. `app` is also exposed as `this` in plugins.
- *
- * Additionally, **if a plugin returns a function, the function will
- * be pushed onto the `fns` array**, allowing the plugin to be
- * called at a later point by the `run` method.
- *
- * ```js
- * var use = require('use');
- *
- * // define a plugin
- * function foo(app) {
- * // do stuff
- * }
- *
- * var app = function(){};
- * use(app);
- *
- * // register plugins
- * app.use(foo);
- * app.use(bar);
- * app.use(baz);
- * ```
- * @name .use
- * @param {Function} `fn` plugin function to call
- * @api public
- */
-
- define(app, 'use', use);
-
- /**
- * Run all plugins on `fns`. Any plugin that returns a function
- * when called by `use` is pushed onto the `fns` array.
- *
- * ```js
- * var config = {};
- * app.run(config);
- * ```
- * @name .run
- * @param {Object} `value` Object to be modified by plugins.
- * @return {Object} Returns the object passed to `run`
- * @api public
- */
-
- define(app, 'run', function(val) {
- if (!isObject(val)) return;
-
- if (!val.use || !val.run) {
- define(val, prop, val[prop] || []);
- define(val, 'use', use);
- }
-
- if (!val[prop] || val[prop].indexOf(base) === -1) {
- val.use(base);
- }
-
- var self = this || app;
- var fns = self[prop];
- var len = fns.length;
- var idx = -1;
-
- while (++idx < len) {
- val.use(fns[idx]);
- }
- return val;
- });
-
- /**
- * Call plugin `fn`. If a function is returned push it into the
- * `fns` array to be called by the `run` method.
- */
-
- function use(type, fn, options) {
- var offset = 1;
-
- if (typeof type === 'string' || Array.isArray(type)) {
- fn = wrap(type, fn);
- offset++;
- } else {
- options = fn;
- fn = type;
- }
-
- if (typeof fn !== 'function') {
- throw new TypeError('expected a function');
- }
-
- var self = this || app;
- var fns = self[prop];
-
- var args = [].slice.call(arguments, offset);
- args.unshift(self);
-
- if (typeof opts.hook === 'function') {
- opts.hook.apply(self, args);
- }
-
- var val = fn.apply(self, args);
- if (typeof val === 'function' && fns.indexOf(val) === -1) {
- fns.push(val);
- }
- return self;
- }
-
- /**
- * Wrap a named plugin function so that it's only called on objects of the
- * given `type`
- *
- * @param {String} `type`
- * @param {Function} `fn` Plugin function
- * @return {Function}
- */
-
- function wrap(type, fn) {
- return function plugin() {
- return this.type === type ? fn.apply(this, arguments) : plugin;
- };
- }
-
- return app;
- };
-
- function isObject(val) {
- return val && typeof val === 'object' && !Array.isArray(val);
- }
-
- function define(obj, key, val) {
- Object.defineProperty(obj, key, {
- configurable: true,
- writable: true,
- value: val
- });
- }
|