grapnel - npm Package Compare versions

+1

.babelrc

{"presets": ["es2015"]}

+34

.vscode/launch.json

		{
		// Use IntelliSense to learn about possible Node.js debug attributes.
		// Hover to view descriptions of existing attributes.
		// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
		"version": "0.2.0",
		"configurations": [
		{
		"type": "node",
		"request": "launch",
		"name": "Launch Program",
		"program": "${workspaceRoot}/dist/grapnel.js",
		"cwd": "${workspaceRoot}",
		"outFiles": [],
		"sourceMaps": true
		},
		{
		"type": "node",
		"request": "launch",
		"name": "Launch Debug",
		"program": "${workspaceRoot}/test/index.js",
		"cwd": "${workspaceRoot}",
		"outFiles": [],
		"sourceMaps": true
		},
		{
		"type": "node",
		"request": "attach",
		"name": "Attach to Process",
		"port": 5858,
		"outFiles": [],
		"sourceMaps": true
		}
		]
		}

+11

.vscode/tasks.json

		{
		// See https://go.microsoft.com/fwlink/?LinkId=733558
		// for the documentation about the tasks.json format
		"version": "0.1.0",
		"command": "tsc",
		"isShellCommand": true,
		"args": ["-w", "-p", "."],
		"showOutput": "silent",
		"isWatching": true,
		"problemMatcher": "$tsc-watch"
		}

+209

build/index.js

		"use strict";
		/****
		* Grapnel
		* https://github.com/baseprime/grapnel
		*
		* @author Greg Sabia Tucker <greg@narrowlabs.com>
		* @link http://basepri.me
		*
		* Released under MIT License. See LICENSE.txt or http://opensource.org/licenses/MIT
		*/
		Object.defineProperty(exports, "__esModule", { value: true });
		const events_1 = require("events");
		const route_1 = require("./route");
		class Grapnel extends events_1.EventEmitter {
		constructor(options) {
		super();
		this._maxListeners = Infinity;
		this.options = {};
		this.defaults = {
		root: '',
		target: ('object' === typeof window) ? window : {},
		isWindow: ('object' === typeof window),
		pushState: false,
		hashBang: false
		};
		this.options = Object.assign({}, this.defaults, options);
		if ('object' === typeof this.options.target && 'function' === typeof this.options.target.addEventListener) {
		this.options.target.addEventListener('hashchange', () => {
		this.emit('hashchange');
		});
		this.options.target.addEventListener('popstate', (e) => {
		// Make sure popstate doesn't run on init -- this is a common issue with Safari and old versions of Chrome
		if (this.state && this.state.previousState === null)
		return false;
		this.emit('navigate');
		});
		}
		}
		add(routePath) {
		let middleware = Array.prototype.slice.call(arguments, 1, -1);
		let handler = Array.prototype.slice.call(arguments, -1)[0];
		let fullPath = this.options.root + routePath;
		let route = new route_1.default(fullPath);
		let routeHandler = (function () {
		// Build request parameters
		let req = route.parse(this.path());
		// Check if matches are found
		if (req.match) {
		// Match found
		let extra = {
		req,
		route: fullPath,
		params: req.params,
		regex: req.match
		};
		// Create call stack -- add middleware first, then handler
		let stack = new MiddlewareStack(this, extra).enqueue(middleware.concat(handler));
		// emit main event
		this.emit('match', stack, req);
		// Continue?
		if (!stack.runCallback)
		return this;
		// Previous state becomes current state
		stack.previousState = this.state;
		// Save new state
		this.state = stack;
		// Prevent this handler from being called if parent handler in stack has instructed not to propagate any more events
		if (stack.parent() && stack.parent().propagateEvent === false) {
		stack.propagateEvent = false;
		return this;
		}
		// Call handler
		stack.callback();
		}
		// Returns self
		return this;
		}).bind(this);
		// Event name
		let eventName = (!this.options.pushState && this.options.isWindow) ? 'hashchange' : 'navigate';
		// Invoke when route is defined, and once again when app navigates
		return routeHandler().on(eventName, routeHandler);
		}
		get() {
		return this.add.apply(this, arguments);
		}
		trigger() {
		return this.emit.apply(this, arguments);
		}
		bind() {
		// Backwards compatibility with older versions which mimed jQuery's bind()
		return this.on.apply(this, arguments);
		}
		context(context) {
		let middleware = Array.prototype.slice.call(arguments, 1);
		return (...args) => {
		let value = args[0];
		let subMiddleware = (args.length > 2) ? Array.prototype.slice.call(args, 1, -1) : [];
		let handler = Array.prototype.slice.call(args, -1)[0];
		let prefix = (context.slice(-1) !== '/' && value !== '/' && value !== '') ? context + '/' : context;
		let path = (value.substr(0, 1) !== '/') ? value : value.substr(1);
		let pattern = prefix + path;
		return this.add.apply(this, [pattern].concat(middleware).concat(subMiddleware).concat([handler]));
		};
		}
		navigate(path, options) {
		this.path(path, options).emit('navigate');
		return this;
		}
		path(pathname, options = {}) {
		let root = this.options.target;
		let frag = undefined;
		let pageName = options.title;
		if ('string' === typeof pathname) {
		// Set path
		if (this.options.pushState && 'function' === typeof root.history.pushState) {
		let state = options.state \|\| root.history.state;
		frag = (this.options.root) ? (this.options.root + pathname) : pathname;
		root.history.pushState(state, pageName, frag);
		}
		else if (root.location) {
		let _frag = (this.options.root) ? (this.options.root + pathname) : pathname;
		root.location.hash = (this.options.hashBang ? '!' : '') + _frag;
		}
		else {
		root.pathname = pathname \|\| '';
		}
		return this;
		}
		else if ('undefined' === typeof pathname) {
		// Get path
		return (root.location && root.location.pathname) ? root.location.pathname : (root.pathname \|\| '');
		}
		else if (pathname === false) {
		// Clear path
		if (this.options.pushState && 'function' === typeof root.history.pushState) {
		let state = options.state \|\| root.history.state;
		root.history.pushState(state, pageName, this.options.root \|\| '/');
		}
		else if (root.location) {
		root.location.hash = (this.options.hashBang) ? '!' : '';
		}
		return this;
		}
		}
		static listen(...args) {
		let opts;
		let routes;
		if (args[0] && args[1]) {
		opts = args[0];
		routes = args[1];
		}
		else {
		routes = args[0];
		}
		// Return a new Grapnel instance
		return (function () {
		// TODO: Accept multi-level routes
		for (let key in routes) {
		this.add.call(this, key, routes[key]);
		}
		return this;
		}).call(new Grapnel(opts \|\| {}));
		}
		static toString() {
		return this.name;
		}
		}
		class MiddlewareStack {
		constructor(router, extendObj) {
		this.runCallback = true;
		this.callbackRan = true;
		this.propagateEvent = true;
		this.stack = MiddlewareStack.global.slice(0);
		this.router = router;
		this.value = router.path();
		Object.assign(this, extendObj);
		return this;
		}
		preventDefault() {
		this.runCallback = false;
		}
		stopPropagation() {
		this.propagateEvent = false;
		}
		parent() {
		let hasParentEvents = !!(this.previousState && this.previousState.value && this.previousState.value == this.value);
		return (hasParentEvents) ? this.previousState : false;
		}
		callback() {
		this.callbackRan = true;
		this.timeStamp = Date.now();
		this.next();
		}
		enqueue(handler, atIndex) {
		let handlers = (!Array.isArray(handler)) ? [handler] : ((atIndex < handler.length) ? handler.reverse() : handler);
		while (handlers.length) {
		this.stack.splice(atIndex \|\| this.stack.length + 1, 0, handlers.shift());
		}
		return this;
		}
		next() {
		return this.stack.shift().call(this.router, this.req, this, () => this.next());
		}
		}
		MiddlewareStack.global = [];
		Grapnel.MiddlewareStack = MiddlewareStack;
		Grapnel.Route = route_1.default;
		exports = module.exports = Grapnel;
		//# sourceMappingURL=index.js.map

+1

build/index.js.map

+51

build/route.js

		"use strict";
		Object.defineProperty(exports, "__esModule", { value: true });
		class Route {
		constructor(pathname, keys, sensitive, strict) {
		this.keys = [];
		this.strict = false;
		this.sensitive = false;
		this.path = pathname;
		this.regex = this.create();
		}
		parse(pathname) {
		let match = pathname.match(this.regex);
		let req = {
		match,
		params: {},
		keys: this.keys,
		matches: (match \|\| []).slice(1),
		};
		// Build parameters
		req.matches.forEach((value, i) => {
		var key = (this.keys[i] && this.keys[i].name) ? this.keys[i].name : i;
		// Parameter key will be its key or the iteration index. This is useful if a wildcard (*) is matched
		req.params[key] = (value) ? decodeURIComponent(value) : undefined;
		});
		return req;
		}
		create() {
		if (this.path instanceof RegExp)
		return this.path;
		if (this.path instanceof Array)
		this.path = '(' + this.path.join('\|') + ')';
		// Build route RegExp
		let newPath = this.path.concat(this.strict ? '' : '/?')
		.replace(/\/\(/g, '(?:/')
		.replace(/\+/g, '__plus__')
		.replace(/(\/)?(\.)?:(\w+)(?:($.*?$))?(\?)?/g, (_, slash, format, key, capture, optional) => {
		this.keys.push({
		name: key,
		optional: !!optional
		});
		slash = slash \|\| '';
		return '' + (optional ? '' : slash) + '(?:' + (optional ? slash : '') + (format \|\| '') + (capture \|\| (format && '([^/.]+?)' \|\| '([^/]+?)')) + ')' + (optional \|\| '');
		})
		.replace(/([\/.])/g, '\\$1')
		.replace(/__plus__/g, '(.+)')
		.replace(/\/g, '(.)');
		return new RegExp('^' + newPath + '$', this.sensitive ? '' : 'i');
		}
		}
		exports.default = Route;
		//# sourceMappingURL=route.js.map

+1

build/route.js.map

{"version":3,"file":"route.js","sourceRoot":"","sources":["../src/route.ts"],"names":[],"mappings":";;AACA;IAOI,YAAY,QAAa,EAAE,IAAY,EAAE,SAAmB,EAAE,MAAgB;QAL9E,SAAI,GAAwB,EAAE,CAAC;QAE/B,WAAM,GAAa,KAAK,CAAC;QACzB,cAAS,GAAa,KAAK,CAAC;QAGxB,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,QAAgB;QAClB,IAAI,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,GAAG,GAAgB;YACnB,KAAK;YACL,MAAM,EAAO,EAAE;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;SAClC,CAAC;QACF,mBAAmB;QACnB,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YAC7B,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACtE,oGAAoG;YACpG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACtE,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,CAAC;IACf,CAAC;IAED,MAAM;QACF,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,YAAY,MAAM,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QAClD,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,YAAY,KAAK,CAAC;YAAC,IAAI,CAAC,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QAC5E,qBAAqB;QACrB,IAAI,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClD,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC;aACxB,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC;aAC1B,OAAO,CAAC,sCAAsC,EAAE,CAAC,CAAM,EAAE,KAAU,EAAE,MAAW,EAAE,GAAQ,EAAE,OAAY,EAAE,QAAa,EAAE,EAAE;YACxH,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,GAAG;gBACT,QAAQ,EAAE,CAAC,CAAC,QAAQ;aACvB,CAAC,CAAC;YACH,KAAK,GAAG,KAAK,IAAI,EAAE,CAAC;YAEpB,MAAM,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,MAAM,IAAI,WAAW,IAAI,UAAU,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QACzK,CAAC,CAAC;aACD,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC;aAC3B,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC;aAC5B,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAE5B,MAAM,CAAC,IAAI,MAAM,CAAC,GAAG,GAAG,OAAO,GAAG,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACtE,CAAC;CACJ;AApDD,wBAoDC"}

+681

dist/grapnel.js

		/*!
		* Grapnel
		* https://github.com/baseprime/grapnel.git
		*
		* @author Greg Sabia Tucker <greg@narrowlabs.com>
		* @link http://basepri.me
		* @version 0.7.0
		*
		* Released under MIT License. See LICENSE.txt or http://opensource.org/licenses/MIT
		*/
		var Grapnel =
		/******/ (function(modules) { // webpackBootstrap
		/******/ // The module cache
		/******/ var installedModules = {};
		/******/
		/******/ // The require function
		/******/ function __webpack_require__(moduleId) {
		/******/
		/******/ // Check if module is in cache
		/******/ if(installedModules[moduleId])
		/******/ return installedModules[moduleId].exports;
		/******/
		/******/ // Create a new module (and put it into the cache)
		/******/ var module = installedModules[moduleId] = {
		/******/ exports: {},
		/******/ id: moduleId,
		/******/ loaded: false
		/******/ };
		/******/
		/******/ // Execute the module function
		/******/ modules[moduleId].call(module.exports, module, module.exports, __webpack_require__);
		/******/
		/******/ // Flag the module as loaded
		/******/ module.loaded = true;
		/******/
		/******/ // Return the exports of the module
		/******/ return module.exports;
		/******/ }
		/******/
		/******/
		/******/ // expose the modules object (__webpack_modules__)
		/******/ __webpack_require__.m = modules;
		/******/
		/******/ // expose the module cache
		/******/ __webpack_require__.c = installedModules;
		/******/
		/******/ // __webpack_public_path__
		/******/ __webpack_require__.p = "";
		/******/
		/******/ // Load entry module and return exports
		/******/ return __webpack_require__(0);
		/******/ })
		/************************************************************************/
		/******/ ([
		/* 0 */
		/***/ (function(module, exports, __webpack_require__) {

		"use strict";
		/****
		* Grapnel
		* https://github.com/baseprime/grapnel
		*
		* @author Greg Sabia Tucker <greg@narrowlabs.com>
		* @link http://basepri.me
		*
		* Released under MIT License. See LICENSE.txt or http://opensource.org/licenses/MIT
		*/

		var _typeof = typeof Symbol === "function" && typeof Symbol.iterator === "symbol" ? function (obj) { return typeof obj; } : function (obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; };

		var _createClass = function () { function defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable \|\| false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } } return function (Constructor, protoProps, staticProps) { if (protoProps) defineProperties(Constructor.prototype, protoProps); if (staticProps) defineProperties(Constructor, staticProps); return Constructor; }; }();

		function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }

		function _possibleConstructorReturn(self, call) { if (!self) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return call && (typeof call === "object" \|\| typeof call === "function") ? call : self; }

		function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function, not " + typeof superClass); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, enumerable: false, writable: true, configurable: true } }); if (superClass) Object.setPrototypeOf ? Object.setPrototypeOf(subClass, superClass) : subClass.__proto__ = superClass; }

		Object.defineProperty(exports, "__esModule", { value: true });
		var events_1 = __webpack_require__(1);
		var route_1 = __webpack_require__(2);

		var Grapnel = function (_events_1$EventEmitte) {
		_inherits(Grapnel, _events_1$EventEmitte);

		function Grapnel(options) {
		_classCallCheck(this, Grapnel);

		var _this = _possibleConstructorReturn(this, (Grapnel.__proto__ \|\| Object.getPrototypeOf(Grapnel)).call(this));

		_this._maxListeners = Infinity;
		_this.options = {};
		_this.defaults = {
		root: '',
		target: 'object' === (typeof window === "undefined" ? "undefined" : _typeof(window)) ? window : {},
		isWindow: 'object' === (typeof window === "undefined" ? "undefined" : _typeof(window)),
		pushState: false,
		hashBang: false
		};
		_this.options = Object.assign({}, _this.defaults, options);
		if ('object' === _typeof(_this.options.target) && 'function' === typeof _this.options.target.addEventListener) {
		_this.options.target.addEventListener('hashchange', function () {
		_this.emit('hashchange');
		});
		_this.options.target.addEventListener('popstate', function (e) {
		// Make sure popstate doesn't run on init -- this is a common issue with Safari and old versions of Chrome
		if (_this.state && _this.state.previousState === null) return false;
		_this.emit('navigate');
		});
		}
		return _this;
		}

		_createClass(Grapnel, [{
		key: "add",
		value: function add(routePath) {
		var middleware = Array.prototype.slice.call(arguments, 1, -1);
		var handler = Array.prototype.slice.call(arguments, -1)[0];
		var fullPath = this.options.root + routePath;
		var route = new route_1.default(fullPath);
		var routeHandler = function () {
		// Build request parameters
		var req = route.parse(this.path());
		// Check if matches are found
		if (req.match) {
		// Match found
		var extra = {
		req: req,
		route: fullPath,
		params: req.params,
		regex: req.match
		};
		// Create call stack -- add middleware first, then handler
		var stack = new MiddlewareStack(this, extra).enqueue(middleware.concat(handler));
		// emit main event
		this.emit('match', stack, req);
		// Continue?
		if (!stack.runCallback) return this;
		// Previous state becomes current state
		stack.previousState = this.state;
		// Save new state
		this.state = stack;
		// Prevent this handler from being called if parent handler in stack has instructed not to propagate any more events
		if (stack.parent() && stack.parent().propagateEvent === false) {
		stack.propagateEvent = false;
		return this;
		}
		// Call handler
		stack.callback();
		}
		// Returns self
		return this;
		}.bind(this);
		// Event name
		var eventName = !this.options.pushState && this.options.isWindow ? 'hashchange' : 'navigate';
		// Invoke when route is defined, and once again when app navigates
		return routeHandler().on(eventName, routeHandler);
		}
		}, {
		key: "get",
		value: function get() {
		return this.add.apply(this, arguments);
		}
		}, {
		key: "trigger",
		value: function trigger() {
		return this.emit.apply(this, arguments);
		}
		}, {
		key: "bind",
		value: function bind() {
		// Backwards compatibility with older versions which mimed jQuery's bind()
		return this.on.apply(this, arguments);
		}
		}, {
		key: "context",
		value: function context(_context) {
		var _this2 = this;

		var middleware = Array.prototype.slice.call(arguments, 1);
		return function () {
		for (var _len = arguments.length, args = Array(_len), _key = 0; _key < _len; _key++) {
		args[_key] = arguments[_key];
		}

		var value = args[0];
		var subMiddleware = args.length > 2 ? Array.prototype.slice.call(args, 1, -1) : [];
		var handler = Array.prototype.slice.call(args, -1)[0];
		var prefix = _context.slice(-1) !== '/' && value !== '/' && value !== '' ? _context + '/' : _context;
		var path = value.substr(0, 1) !== '/' ? value : value.substr(1);
		var pattern = prefix + path;
		return _this2.add.apply(_this2, [pattern].concat(middleware).concat(subMiddleware).concat([handler]));
		};
		}
		}, {
		key: "navigate",
		value: function navigate(path, options) {
		this.path(path, options).emit('navigate');
		return this;
		}
		}, {
		key: "path",
		value: function path(pathname) {
		var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};

		var root = this.options.target;
		var frag = undefined;
		var pageName = options.title;
		if ('string' === typeof pathname) {
		// Set path
		if (this.options.pushState && 'function' === typeof root.history.pushState) {
		var state = options.state \|\| root.history.state;
		frag = this.options.root ? this.options.root + pathname : pathname;
		root.history.pushState(state, pageName, frag);
		} else if (root.location) {
		var _frag = this.options.root ? this.options.root + pathname : pathname;
		root.location.hash = (this.options.hashBang ? '!' : '') + _frag;
		} else {
		root.pathname = pathname \|\| '';
		}
		return this;
		} else if ('undefined' === typeof pathname) {
		// Get path
		return root.location && root.location.pathname ? root.location.pathname : root.pathname \|\| '';
		} else if (pathname === false) {
		// Clear path
		if (this.options.pushState && 'function' === typeof root.history.pushState) {
		var _state = options.state \|\| root.history.state;
		root.history.pushState(_state, pageName, this.options.root \|\| '/');
		} else if (root.location) {
		root.location.hash = this.options.hashBang ? '!' : '';
		}
		return this;
		}
		}
		}], [{
		key: "listen",
		value: function listen() {
		var opts = void 0;
		var routes = void 0;
		if ((arguments.length <= 0 ? undefined : arguments[0]) && (arguments.length <= 1 ? undefined : arguments[1])) {
		opts = arguments.length <= 0 ? undefined : arguments[0];
		routes = arguments.length <= 1 ? undefined : arguments[1];
		} else {
		routes = arguments.length <= 0 ? undefined : arguments[0];
		}
		// Return a new Grapnel instance
		return function () {
		// TODO: Accept multi-level routes
		for (var key in routes) {
		this.add.call(this, key, routes[key]);
		}
		return this;
		}.call(new Grapnel(opts \|\| {}));
		}
		}, {
		key: "toString",
		value: function toString() {
		return this.name;
		}
		}]);

		return Grapnel;
		}(events_1.EventEmitter);

		var MiddlewareStack = function () {
		function MiddlewareStack(router, extendObj) {
		_classCallCheck(this, MiddlewareStack);

		this.runCallback = true;
		this.callbackRan = true;
		this.propagateEvent = true;
		this.stack = MiddlewareStack.global.slice(0);
		this.router = router;
		this.value = router.path();
		Object.assign(this, extendObj);
		return this;
		}

		_createClass(MiddlewareStack, [{
		key: "preventDefault",
		value: function preventDefault() {
		this.runCallback = false;
		}
		}, {
		key: "stopPropagation",
		value: function stopPropagation() {
		this.propagateEvent = false;
		}
		}, {
		key: "parent",
		value: function parent() {
		var hasParentEvents = !!(this.previousState && this.previousState.value && this.previousState.value == this.value);
		return hasParentEvents ? this.previousState : false;
		}
		}, {
		key: "callback",
		value: function callback() {
		this.callbackRan = true;
		this.timeStamp = Date.now();
		this.next();
		}
		}, {
		key: "enqueue",
		value: function enqueue(handler, atIndex) {
		var handlers = !Array.isArray(handler) ? [handler] : atIndex < handler.length ? handler.reverse() : handler;
		while (handlers.length) {
		this.stack.splice(atIndex \|\| this.stack.length + 1, 0, handlers.shift());
		}
		return this;
		}
		}, {
		key: "next",
		value: function next() {
		var _this3 = this;

		return this.stack.shift().call(this.router, this.req, this, function () {
		return _this3.next();
		});
		}
		}]);

		return MiddlewareStack;
		}();

		MiddlewareStack.global = [];
		Grapnel.MiddlewareStack = MiddlewareStack;
		Grapnel.Route = route_1.default;
		exports = module.exports = Grapnel;
		//# sourceMappingURL=index.js.map

		/***/ }),
		/* 1 */
		/***/ (function(module, exports) {

		'use strict';

		var _typeof = typeof Symbol === "function" && typeof Symbol.iterator === "symbol" ? function (obj) { return typeof obj; } : function (obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; };

		// Copyright Joyent, Inc. and other Node contributors.
		//
		// Permission is hereby granted, free of charge, to any person obtaining a
		// copy of this software and associated documentation files (the
		// "Software"), to deal in the Software without restriction, including
		// without limitation the rights to use, copy, modify, merge, publish,
		// distribute, sublicense, and/or sell copies of the Software, and to permit
		// persons to whom the Software is furnished to do so, subject to the
		// following conditions:
		//
		// The above copyright notice and this permission notice shall be included
		// in all copies or substantial portions of the Software.
		//
		// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
		// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
		// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
		// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
		// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
		// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
		// USE OR OTHER DEALINGS IN THE SOFTWARE.

		function EventEmitter() {
		this._events = this._events \|\| {};
		this._maxListeners = this._maxListeners \|\| undefined;
		}
		module.exports = EventEmitter;

		// Backwards-compat with node 0.10.x
		EventEmitter.EventEmitter = EventEmitter;

		EventEmitter.prototype._events = undefined;
		EventEmitter.prototype._maxListeners = undefined;

		// By default EventEmitters will print a warning if more than 10 listeners are
		// added to it. This is a useful default which helps finding memory leaks.
		EventEmitter.defaultMaxListeners = 10;

		// Obviously not all Emitters should be limited to 10. This function allows
		// that to be increased. Set to zero for unlimited.
		EventEmitter.prototype.setMaxListeners = function (n) {
		if (!isNumber(n) \|\| n < 0 \|\| isNaN(n)) throw TypeError('n must be a positive number');
		this._maxListeners = n;
		return this;
		};

		EventEmitter.prototype.emit = function (type) {
		var er, handler, len, args, i, listeners;

		if (!this._events) this._events = {};

		// If there is no 'error' event listener then throw.
		if (type === 'error') {
		if (!this._events.error \|\| isObject(this._events.error) && !this._events.error.length) {
		er = arguments[1];
		if (er instanceof Error) {
		throw er; // Unhandled 'error' event
		} else {
		// At least give some kind of context to the user
		var err = new Error('Uncaught, unspecified "error" event. (' + er + ')');
		err.context = er;
		throw err;
		}
		}
		}

		handler = this._events[type];

		if (isUndefined(handler)) return false;

		if (isFunction(handler)) {
		switch (arguments.length) {
		// fast cases
		case 1:
		handler.call(this);
		break;
		case 2:
		handler.call(this, arguments[1]);
		break;
		case 3:
		handler.call(this, arguments[1], arguments[2]);
		break;
		// slower
		default:
		args = Array.prototype.slice.call(arguments, 1);
		handler.apply(this, args);
		}
		} else if (isObject(handler)) {
		args = Array.prototype.slice.call(arguments, 1);
		listeners = handler.slice();
		len = listeners.length;
		for (i = 0; i < len; i++) {
		listeners[i].apply(this, args);
		}
		}

		return true;
		};

		EventEmitter.prototype.addListener = function (type, listener) {
		var m;

		if (!isFunction(listener)) throw TypeError('listener must be a function');

		if (!this._events) this._events = {};

		// To avoid recursion in the case that type === "newListener"! Before
		// adding it to the listeners, first emit "newListener".
		if (this._events.newListener) this.emit('newListener', type, isFunction(listener.listener) ? listener.listener : listener);

		if (!this._events[type])
		// Optimize the case of one listener. Don't need the extra array object.
		this._events[type] = listener;else if (isObject(this._events[type]))
		// If we've already got an array, just append.
		this._events[type].push(listener);else
		// Adding the second element, need to change to array.
		this._events[type] = [this._events[type], listener];

		// Check for listener leak
		if (isObject(this._events[type]) && !this._events[type].warned) {
		if (!isUndefined(this._maxListeners)) {
		m = this._maxListeners;
		} else {
		m = EventEmitter.defaultMaxListeners;
		}

		if (m && m > 0 && this._events[type].length > m) {
		this._events[type].warned = true;
		console.error('(node) warning: possible EventEmitter memory ' + 'leak detected. %d listeners added. ' + 'Use emitter.setMaxListeners() to increase limit.', this._events[type].length);
		if (typeof console.trace === 'function') {
		// not supported in IE 10
		console.trace();
		}
		}
		}

		return this;
		};

		EventEmitter.prototype.on = EventEmitter.prototype.addListener;

		EventEmitter.prototype.once = function (type, listener) {
		if (!isFunction(listener)) throw TypeError('listener must be a function');

		var fired = false;

		function g() {
		this.removeListener(type, g);

		if (!fired) {
		fired = true;
		listener.apply(this, arguments);
		}
		}

		g.listener = listener;
		this.on(type, g);

		return this;
		};

		// emits a 'removeListener' event iff the listener was removed
		EventEmitter.prototype.removeListener = function (type, listener) {
		var list, position, length, i;

		if (!isFunction(listener)) throw TypeError('listener must be a function');

		if (!this._events \|\| !this._events[type]) return this;

		list = this._events[type];
		length = list.length;
		position = -1;

		if (list === listener \|\| isFunction(list.listener) && list.listener === listener) {
		delete this._events[type];
		if (this._events.removeListener) this.emit('removeListener', type, listener);
		} else if (isObject(list)) {
		for (i = length; i-- > 0;) {
		if (list[i] === listener \|\| list[i].listener && list[i].listener === listener) {
		position = i;
		break;
		}
		}

		if (position < 0) return this;

		if (list.length === 1) {
		list.length = 0;
		delete this._events[type];
		} else {
		list.splice(position, 1);
		}

		if (this._events.removeListener) this.emit('removeListener', type, listener);
		}

		return this;
		};

		EventEmitter.prototype.removeAllListeners = function (type) {
		var key, listeners;

		if (!this._events) return this;

		// not listening for removeListener, no need to emit
		if (!this._events.removeListener) {
		if (arguments.length === 0) this._events = {};else if (this._events[type]) delete this._events[type];
		return this;
		}

		// emit removeListener for all listeners on all events
		if (arguments.length === 0) {
		for (key in this._events) {
		if (key === 'removeListener') continue;
		this.removeAllListeners(key);
		}
		this.removeAllListeners('removeListener');
		this._events = {};
		return this;
		}

		listeners = this._events[type];

		if (isFunction(listeners)) {
		this.removeListener(type, listeners);
		} else if (listeners) {
		// LIFO order
		while (listeners.length) {
		this.removeListener(type, listeners[listeners.length - 1]);
		}
		}
		delete this._events[type];

		return this;
		};

		EventEmitter.prototype.listeners = function (type) {
		var ret;
		if (!this._events \|\| !this._events[type]) ret = [];else if (isFunction(this._events[type])) ret = [this._events[type]];else ret = this._events[type].slice();
		return ret;
		};

		EventEmitter.prototype.listenerCount = function (type) {
		if (this._events) {
		var evlistener = this._events[type];

		if (isFunction(evlistener)) return 1;else if (evlistener) return evlistener.length;
		}
		return 0;
		};

		EventEmitter.listenerCount = function (emitter, type) {
		return emitter.listenerCount(type);
		};

		function isFunction(arg) {
		return typeof arg === 'function';
		}

		function isNumber(arg) {
		return typeof arg === 'number';
		}

		function isObject(arg) {
		return (typeof arg === 'undefined' ? 'undefined' : _typeof(arg)) === 'object' && arg !== null;
		}

		function isUndefined(arg) {
		return arg === void 0;
		}

		/***/ }),
		/* 2 */
		/***/ (function(module, exports) {

		"use strict";

		var _createClass = function () { function defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable \|\| false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } } return function (Constructor, protoProps, staticProps) { if (protoProps) defineProperties(Constructor.prototype, protoProps); if (staticProps) defineProperties(Constructor, staticProps); return Constructor; }; }();

		function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }

		Object.defineProperty(exports, "__esModule", { value: true });

		var Route = function () {
		function Route(pathname, keys, sensitive, strict) {
		_classCallCheck(this, Route);

		this.keys = [];
		this.strict = false;
		this.sensitive = false;
		this.path = pathname;
		this.regex = this.create();
		}

		_createClass(Route, [{
		key: "parse",
		value: function parse(pathname) {
		var _this = this;

		var match = pathname.match(this.regex);
		var req = {
		match: match,
		params: {},
		keys: this.keys,
		matches: (match \|\| []).slice(1)
		};
		// Build parameters
		req.matches.forEach(function (value, i) {
		var key = _this.keys[i] && _this.keys[i].name ? _this.keys[i].name : i;
		// Parameter key will be its key or the iteration index. This is useful if a wildcard (*) is matched
		req.params[key] = value ? decodeURIComponent(value) : undefined;
		});
		return req;
		}
		}, {
		key: "create",
		value: function create() {
		var _this2 = this;

		if (this.path instanceof RegExp) return this.path;
		if (this.path instanceof Array) this.path = '(' + this.path.join('\|') + ')';
		// Build route RegExp
		var newPath = this.path.concat(this.strict ? '' : '/?').replace(/\/$/g, '(?:/').replace(/\+/g, '__plus__').replace(/(\/)?(\.)?:(\w+)(?:(\(.*?$))?(\?)?/g, function (_, slash, format, key, capture, optional) {
		_this2.keys.push({
		name: key,
		optional: !!optional
		});
		slash = slash \|\| '';
		return '' + (optional ? '' : slash) + '(?:' + (optional ? slash : '') + (format \|\| '') + (capture \|\| format && '([^/.]+?)' \|\| '([^/]+?)') + ')' + (optional \|\| '');
		}).replace(/([\/.])/g, '\\$1').replace(/__plus__/g, '(.+)').replace(/\/g, '(.)');
		return new RegExp('^' + newPath + '$', this.sensitive ? '' : 'i');
		}
		}]);

		return Route;
		}();

		exports.default = Route;
		//# sourceMappingURL=route.js.map

		/***/ })
		/******/ ]);
		//# sourceMappingURL=grapnel.js.map

+1

dist/grapnel.js.map

+1

dist/grapnel.min.js.map

+256

src/index.ts

		/****
		* Grapnel
		* https://github.com/baseprime/grapnel
		*
		* @author Greg Sabia Tucker <greg@narrowlabs.com>
		* @link http://basepri.me
		*
		* Released under MIT License. See LICENSE.txt or http://opensource.org/licenses/MIT
		*/

		import { EventEmitter } from 'events';
		import Route, { ParsedRoute } from './route';

		class Grapnel extends EventEmitter {
		static MiddlewareStack: typeof MiddlewareStack;
		static Route: typeof Route;
		_maxListeners: number = Infinity;
		state: MiddlewareStack;
		options: GrapnelOptions = {};
		defaults: any = {
		root: '',
		target: ('object' === typeof window) ? window : {},
		isWindow: ('object' === typeof window),
		pushState: false,
		hashBang: false
		}

		constructor(options?: GrapnelOptions) {
		super();
		this.options = Object.assign({}, this.defaults, options);

		if ('object' === typeof this.options.target && 'function' === typeof this.options.target.addEventListener) {
		this.options.target.addEventListener('hashchange', () => {
		this.emit('hashchange');
		});

		this.options.target.addEventListener('popstate', (e: any) => {
		// Make sure popstate doesn't run on init -- this is a common issue with Safari and old versions of Chrome
		if (this.state && this.state.previousState === null) return false;

		this.emit('navigate');
		});
		}
		}

		add(routePath: string & RegExp): Grapnel {
		let middleware: Function[] = Array.prototype.slice.call(arguments, 1, -1);
		let handler: Function = Array.prototype.slice.call(arguments, -1)[0];
		let fullPath = this.options.root + routePath;
		let route = new Route(fullPath);

		let routeHandler = (function () {
		// Build request parameters
		let req: ParsedRoute = route.parse(this.path());
		// Check if matches are found
		if (req.match) {
		// Match found
		let extra = {
		req,
		route: fullPath,
		params: req.params,
		regex: req.match
		};
		// Create call stack -- add middleware first, then handler
		let stack = new MiddlewareStack(this, extra).enqueue(middleware.concat(handler));
		// emit main event
		this.emit('match', stack, req);
		// Continue?
		if (!stack.runCallback) return this;
		// Previous state becomes current state
		stack.previousState = this.state;
		// Save new state
		this.state = stack;
		// Prevent this handler from being called if parent handler in stack has instructed not to propagate any more events
		if (stack.parent() && stack.parent().propagateEvent === false) {
		stack.propagateEvent = false;
		return this;
		}
		// Call handler
		stack.callback();
		}
		// Returns self
		return this;
		}).bind(this);
		// Event name
		let eventName = (!this.options.pushState && this.options.isWindow) ? 'hashchange' : 'navigate';
		// Invoke when route is defined, and once again when app navigates
		return routeHandler().on(eventName, routeHandler);
		}

		get(): Grapnel {
		return this.add.apply(this, arguments);
		}

		trigger(): Grapnel {
		return this.emit.apply(this, arguments);
		}

		bind(): Grapnel {
		// Backwards compatibility with older versions which mimed jQuery's bind()
		return this.on.apply(this, arguments);
		}

		context(context: string & RegExp): () => Grapnel {
		let middleware = Array.prototype.slice.call(arguments, 1);

		return (...args: any[]) => {
		let value = args[0];
		let subMiddleware = (args.length > 2) ? Array.prototype.slice.call(args, 1, -1) : [];
		let handler = Array.prototype.slice.call(args, -1)[0];
		let prefix = (context.slice(-1) !== '/' && value !== '/' && value !== '') ? context + '/' : context;
		let path = (value.substr(0, 1) !== '/') ? value : value.substr(1);
		let pattern = prefix + path;

		return this.add.apply(this, [pattern].concat(middleware).concat(subMiddleware).concat([handler]));
		}
		}

		navigate(path: string, options: NavigateOptions): Grapnel {
		this.path(path, options).emit('navigate');
		return this;
		}

		path(pathname?: string, options: NavigateOptions = {}) {
		let root = this.options.target;
		let frag = undefined;
		let pageName = options.title;

		if ('string' === typeof pathname) {
		// Set path
		if (this.options.pushState && 'function' === typeof root.history.pushState) {
		let state = options.state \|\| root.history.state;
		frag = (this.options.root) ? (this.options.root + pathname) : pathname;
		root.history.pushState(state, pageName, frag);
		} else if (root.location) {
		let _frag = (this.options.root) ? (this.options.root + pathname) : pathname;
		root.location.hash = (this.options.hashBang ? '!' : '') + _frag;
		} else {
		root.pathname = pathname \|\| '';
		}

		return this;
		} else if ('undefined' === typeof pathname) {
		// Get path
		return (root.location && root.location.pathname) ? root.location.pathname : (root.pathname \|\| '');
		} else if (pathname === false) {
		// Clear path
		if (this.options.pushState && 'function' === typeof root.history.pushState) {
		let state = options.state \|\| root.history.state;
		root.history.pushState(state, pageName, this.options.root \|\| '/');
		} else if (root.location) {
		root.location.hash = (this.options.hashBang) ? '!' : '';
		}

		return this;
		}
		}

		static listen(...args: any[]): Grapnel {
		let opts: any;
		let routes: any;
		if (args[0] && args[1]) {
		opts = args[0];
		routes = args[1];
		} else {
		routes = args[0];
		}
		// Return a new Grapnel instance
		return (function () {
		// TODO: Accept multi-level routes
		for (let key in routes) {
		this.add.call(this, key, routes[key]);
		}

		return this;
		}).call(new Grapnel(opts \|\| {}));
		}

		static toString() {
		return this.name;
		}
		}

		class MiddlewareStack {
		stack: any[];
		router: Grapnel;
		runCallback: boolean = true;
		callbackRan: boolean = true;
		propagateEvent: boolean = true;
		value: string;
		req: any;
		previousState: any;
		timeStamp: Number;

		static global: any[] = [];

		constructor(router: Grapnel, extendObj?: any) {
		this.stack = MiddlewareStack.global.slice(0);
		this.router = router;
		this.value = router.path();

		Object.assign(this, extendObj);

		return this;
		}

		preventDefault() {
		this.runCallback = false;
		}

		stopPropagation() {
		this.propagateEvent = false;
		}

		parent() {
		let hasParentEvents = !!(this.previousState && this.previousState.value && this.previousState.value == this.value);
		return (hasParentEvents) ? this.previousState : false;
		}

		callback() {
		this.callbackRan = true;
		this.timeStamp = Date.now();
		this.next();
		}

		enqueue(handler: any, atIndex?: number) {
		let handlers = (!Array.isArray(handler)) ? [handler] : ((atIndex < handler.length) ? handler.reverse() : handler);

		while (handlers.length) {
		this.stack.splice(atIndex \|\| this.stack.length + 1, 0, handlers.shift());
		}

		return this;
		}

		next() {
		return this.stack.shift().call(this.router, this.req, this, () => this.next());
		}
		}

		export interface GrapnelOptions {
		pushState?: boolean;
		hashBang?: boolean;
		isWindow?: boolean;
		target?: any;
		root?: string;
		}

		export interface NavigateOptions {
		title?: string;
		state?: any;
		}

		Grapnel.MiddlewareStack = MiddlewareStack;
		Grapnel.Route = Route;
		exports = module.exports = Grapnel;

+61

src/route.ts


		export default class Route {
		path: string \| string[] \| RegExp;
		keys: ParsedRoute['keys'] = [];
		regex: RegExp;
		strict?: boolean = false;
		sensitive?: boolean = false;

		constructor(pathname: any, keys?: any[], sensitive?: boolean, strict?: boolean) {
		this.path = pathname;
		this.regex = this.create();
		}

		parse(pathname: string) {
		let match = pathname.match(this.regex);
		let req: ParsedRoute = {
		match,
		params: <any>{},
		keys: this.keys,
		matches: (match \|\| []).slice(1),
		};
		// Build parameters
		req.matches.forEach((value, i) => {
		var key = (this.keys[i] && this.keys[i].name) ? this.keys[i].name : i;
		// Parameter key will be its key or the iteration index. This is useful if a wildcard (*) is matched
		req.params[key] = (value) ? decodeURIComponent(value) : undefined;
		});

		return req;
		}

		create() {
		if (this.path instanceof RegExp) return this.path;
		if (this.path instanceof Array) this.path = '(' + this.path.join('\|') + ')';
		// Build route RegExp
		let newPath = this.path.concat(this.strict ? '' : '/?')
		.replace(/\/\(/g, '(?:/')
		.replace(/\+/g, '__plus__')
		.replace(/(\/)?(\.)?:(\w+)(?:($.*?$))?(\?)?/g, (_: any, slash: any, format: any, key: any, capture: any, optional: any) => {
		this.keys.push({
		name: key,
		optional: !!optional
		});
		slash = slash \|\| '';

		return '' + (optional ? '' : slash) + '(?:' + (optional ? slash : '') + (format \|\| '') + (capture \|\| (format && '([^/.]+?)' \|\| '([^/]+?)')) + ')' + (optional \|\| '');
		})
		.replace(/([\/.])/g, '\\$1')
		.replace(/__plus__/g, '(.+)')
		.replace(/\/g, '(.)');

		return new RegExp('^' + newPath + '$', this.sensitive ? '' : 'i');
		}
		}

		export interface ParsedRoute {
		params: any;
		keys: { name: string; optional: boolean; }[];
		matches: string[];
		match: string[];
		}

+15

tsconfig.json

		{
		"compilerOptions": {
		"target": "es2016",
		"module": "commonjs",
		"watch": true,
		"noImplicitAny": true,
		"removeComments": false,
		"preserveConstEnums": true,
		"sourceMap": true,
		"outDir": "build"
		},
		"include": [
		"src/*.ts"
		]
		}

+35

webpack.config.js

		const path = require('path');
		const webpack = require('webpack');
		const package = require('./package');

		module.exports = {
		entry: {
		'grapnel': './build/index.js',
		'grapnel.min': './build/index.js'
		},
		output: {
		path: './dist',
		filename: '[name].js',
		library: 'Grapnel',
		libraryTarget: 'var'
		},
		devtool: 'source-map',
		module: {
		loaders: [
		{
		test: /\.js$/,
		loader: 'babel-loader',
		query: {
		presets: [require.resolve('babel-preset-es2015')]
		}
		}
		]
		},
		plugins: [
		new webpack.optimize.UglifyJsPlugin({
		include: /\.min\.js$/,
		compress: { warnings: false }
		}),
		new webpack.BannerPlugin(`Grapnel\n${package.repository.url}\n\n@author ${package.author}\n@link ${package.link}\n@version ${package.version}\n\nReleased under MIT License. See LICENSE.txt or http://opensource.org/licenses/MIT`)
		]
		}

+4

-3

bower.json

		{
		"name": "grapnel",
		"version": "0.6.3",
		"version": "0.7.0",
		"homepage": "https://github.com/baseprime/grapnel",
		@@ -8,6 +8,7 @@ "authors": [
		],
		"description": "The smallest (1100 bytes gzipped!) JavaScript Router with PushState & Named Parameters",
		"description": "The first (and smallest!) JavaScript Router with PushState, Middleware, and Named Parameter support",
		"main": "dist/grapnel.min.js",
		"moduleType": [
		"amd",
		"node",
		"es6",
		"globals"
		@@ -14,0 +15,0 @@ ],

+11

-0

CHANGELOG.md

		## Changelog

		##### 0.7.0
		* Rewrote source in TypeScript
		* Remove unnecessary `env` from options (this was never in the documentation so it shouldn't have been used)
		* Move target out of constructor and into instance options so user can override
		* Use isWindow on options to check if window is present
		* Changed `Request()` constructor to `Route()` so we don't override native `Request`
		* Added tests
		* Bugfixes:
		* Fix router root issues
		* Navigate correctly returns self

		##### 0.6.2
		@@ -4,0 +15,0 @@ * Singular code style now enforced (bracket styles, line endings, etc.)

+8

-8

dist/grapnel.min.js

		@@ -1,12 +0,12 @@
		/****
		/*!
		* Grapnel
		* https://github.com/baseprime/grapnel
		*
		* https://github.com/baseprime/grapnel.git
		*
		* @author Greg Sabia Tucker <greg@narrowlabs.com>
		* @link http://basepri.me
		* @version 0.6.4
		*
		* @version 0.7.0
		*
		* Released under MIT License. See LICENSE.txt or http://opensource.org/licenses/MIT
		*/

		!function(a){function b(b){"use strict";var c=this;return this.events={},this.state=null,this.options=b\|\|{},this.options.env=this.options.env\|\|(0===Object.keys(a).length&&process&&process.browser!==!0?"server":"client"),this.options.mode=this.options.mode\|\|("server"!==this.options.env&&this.options.pushState&&a.history&&a.history.pushState?"pushState":"hashchange"),this.version="0.6.4","function"==typeof a.addEventListener&&(a.addEventListener("hashchange",function(){c.trigger("hashchange")}),a.addEventListener("popstate",function(a){return(!c.state\|\|null!==c.state.previousState)&&void c.trigger("navigate")})),this}function c(a,b){this.stack=c.global.slice(0),this.router=a,this.runCallback=!0,this.callbackRan=!1,this.propagateEvent=!0,this.value=a.path();for(var d in b)this[d]=b[d];return this}function d(a){this.route=a,this.keys=[],this.regex=b.regexRoute(a,this.keys)}b.regexRoute=function(a,b,c,d){return a instanceof RegExp?a:(a instanceof Array&&(a="("+a.join("\|")+")"),a=a.concat(d?"":"/?").replace(/\/$/g,"(?:/").replace(/\+/g,"__plus__").replace(/(\/)?(\.)?:(\w+)(?:(\(.?$))?(\?)?/g,function(a,c,d,e,f,g){return b.push({name:e,optional:!!g}),c=c\|\|"",""+(g?"":c)+"(?:"+(g?c:"")+(d\|\|"")+(f\|\|d&&"([^/.]+?)"\|\|"([^/]+?)")+")"+(g\|\|"")}).replace(/([\/.])/g,"\\$1").replace(/__plus__/g,"(.+)").replace(/\/g,"(.*)"),new RegExp("^"+a+"$",c?"":"i"))},b._forEach=function(a,b){return"function"==typeof Array.prototype.forEach?Array.prototype.forEach.call(a,b):function(a,b){for(var c=0,d=this.length;c<d;++c)a.call(b,this[c],c,this)}.call(a,b)},b.prototype.get=b.prototype.add=function(a){var b=this,e=Array.prototype.slice.call(arguments,1,-1),f=Array.prototype.slice.call(arguments,-1)[0],g=new d(a),h=function(){var d=g.parse(b.path());if(d.match){var h={route:a,params:d.params,req:d,regex:d.match},i=new c(b,h).enqueue(e.concat(f));if(b.trigger("match",i,d),!i.runCallback)return b;if(i.previousState=b.state,b.state=i,i.parent()&&i.parent().propagateEvent===!1)return i.propagateEvent=!1,b;i.callback()}return b},i="pushState"!==b.options.mode&&"server"!==b.options.env?"hashchange":"navigate";return h().on(i,h)},b.prototype.trigger=function(a){var c=this,d=Array.prototype.slice.call(arguments,1);return this.events[a]&&b._forEach(this.events[a],function(a){a.apply(c,d)}),this},b.prototype.on=b.prototype.bind=function(a,c){var d=this,e=a.split(" ");return b._forEach(e,function(a){d.events[a]?d.events[a].push(c):d.events[a]=[c]}),this},b.prototype.once=function(a,b){var c=!1;return this.on(a,function(){return!c&&(c=!0,b.apply(this,arguments),b=null,!0)})},b.prototype.context=function(a){var b=this,c=Array.prototype.slice.call(arguments,1);return function(){var d=arguments[0],e=arguments.length>2?Array.prototype.slice.call(arguments,1,-1):[],f=Array.prototype.slice.call(arguments,-1)[0],g="/"!==a.slice(-1)&&"/"!==d&&""!==d?a+"/":a,h="/"!==d.substr(0,1)?d:d.substr(1),i=g+h;return b.add.apply(b,[i].concat(c).concat(e).concat([f]))}},b.prototype.navigate=function(a){return this.path(a).trigger("navigate")},b.prototype.path=function(b){var c,d=this;return"string"==typeof b?("pushState"===d.options.mode?(c=d.options.root?d.options.root+b:b,a.history.pushState({},null,c)):a.location?a.location.hash=(d.options.hashBang?"!":"")+b:a._pathname=b\|\|"",this):"undefined"==typeof b?c="pushState"===d.options.mode?a.location.pathname.replace(d.options.root,""):"pushState"!==d.options.mode&&a.location?a.location.hash?a.location.hash.split(d.options.hashBang?"#!":"#")[1]:"":a._pathname\|\|"":b===!1?("pushState"===d.options.mode?a.history.pushState({},null,d.options.root\|\|"/"):a.location&&(a.location.hash=d.options.hashBang?"!":""),d):void 0},b.listen=function(){var a,c;return arguments[0]&&arguments[1]?(a=arguments[0],c=arguments[1]):c=arguments[0],function(){for(var a in c)this.add.call(this,a,c[a]);return this}.call(new b(a\|\|{}))},c.global=[],c.prototype.preventDefault=function(){this.runCallback=!1},c.prototype.stopPropagation=function(){this.propagateEvent=!1},c.prototype.parent=function(){var a=!(!this.previousState\|\|!this.previousState.value\|\|this.previousState.value!=this.value);return!!a&&this.previousState},c.prototype.callback=function(){this.callbackRan=!0,this.timeStamp=Date.now(),this.next()},c.prototype.enqueue=function(a,b){for(var c=Array.isArray(a)?b<a.length?a.reverse():a:[a];c.length;)this.stack.splice(b\|\|this.stack.length+1,0,c.shift());return this},c.prototype.next=function(){var a=this;return this.stack.shift().call(this.router,this.req,this,function(){a.next.call(a)})},d.prototype.parse=function(a){var c=a.match(this.regex),d=this,e={params:{},keys:this.keys,matches:(c\|\|[]).slice(1),match:c};return b._forEach(e.matches,function(a,b){var c=d.keys[b]&&d.keys[b].name?d.keys[b].name:b;e.params[c]=a?decodeURIComponent(a):void 0}),e},b.CallStack=c,b.Request=d,"function"!=typeof a.define\|\|a.define.amd.grapnel?"object"==typeof module&&"object"==typeof module.exports?module.exports=exports=b:a.Grapnel=b:a.define(function(c,d,e){return a.define.amd.grapnel=!0,b})}.call({},"object"==typeof window?window:this);
		*/
		var Grapnel=function(t){function e(i){if(n[i])return n[i].exports;var r=n[i]={exports:{},id:i,loaded:!1};return t[i].call(r.exports,r,r.exports,e),r.loaded=!0,r.exports}var n={};return e.m=t,e.c=n,e.p="",e(0)}([function(t,e,n){"use strict";function i(t,e){if(!(t instanceof e))throw new TypeError("Cannot call a class as a function")}function r(t,e){if(!t)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!e\|\|"object"!=typeof e&&"function"!=typeof e?t:e}function s(t,e){if("function"!=typeof e&&null!==e)throw new TypeError("Super expression must either be null or a function, not "+typeof e);t.prototype=Object.create(e&&e.prototype,{constructor:{value:t,enumerable:!1,writable:!0,configurable:!0}}),e&&(Object.setPrototypeOf?Object.setPrototypeOf(t,e):t.__proto__=e)}var o="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(t){return typeof t}:function(t){return t&&"function"==typeof Symbol&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t},a=function(){function t(t,e){for(var n=0;n<e.length;n++){var i=e[n];i.enumerable=i.enumerable\|\|!1,i.configurable=!0,"value"in i&&(i.writable=!0),Object.defineProperty(t,i.key,i)}}return function(e,n,i){return n&&t(e.prototype,n),i&&t(e,i),e}}();Object.defineProperty(e,"__esModule",{value:!0});var h=n(1),u=n(2),l=function(t){function e(t){i(this,e);var n=r(this,(e.__proto__\|\|Object.getPrototypeOf(e)).call(this));return n._maxListeners=1/0,n.options={},n.defaults={root:"",target:"object"===("undefined"==typeof window?"undefined":o(window))?window:{},isWindow:"object"===("undefined"==typeof window?"undefined":o(window)),pushState:!1,hashBang:!1},n.options=Object.assign({},n.defaults,t),"object"===o(n.options.target)&&"function"==typeof n.options.target.addEventListener&&(n.options.target.addEventListener("hashchange",function(){n.emit("hashchange")}),n.options.target.addEventListener("popstate",function(t){return(!n.state\|\|null!==n.state.previousState)&&void n.emit("navigate")})),n}return s(e,t),a(e,[{key:"add",value:function(t){var e=Array.prototype.slice.call(arguments,1,-1),n=Array.prototype.slice.call(arguments,-1)[0],i=this.options.root+t,r=new u.default(i),s=function(){var t=r.parse(this.path());if(t.match){var s={req:t,route:i,params:t.params,regex:t.match},o=new c(this,s).enqueue(e.concat(n));if(this.emit("match",o,t),!o.runCallback)return this;if(o.previousState=this.state,this.state=o,o.parent()&&o.parent().propagateEvent===!1)return o.propagateEvent=!1,this;o.callback()}return this}.bind(this),o=!this.options.pushState&&this.options.isWindow?"hashchange":"navigate";return s().on(o,s)}},{key:"get",value:function(){return this.add.apply(this,arguments)}},{key:"trigger",value:function(){return this.emit.apply(this,arguments)}},{key:"bind",value:function(){return this.on.apply(this,arguments)}},{key:"context",value:function(t){var e=this,n=Array.prototype.slice.call(arguments,1);return function(){for(var i=arguments.length,r=Array(i),s=0;s<i;s++)r[s]=arguments[s];var o=r[0],a=r.length>2?Array.prototype.slice.call(r,1,-1):[],h=Array.prototype.slice.call(r,-1)[0],u="/"!==t.slice(-1)&&"/"!==o&&""!==o?t+"/":t,l="/"!==o.substr(0,1)?o:o.substr(1),c=u+l;return e.add.apply(e,[c].concat(n).concat(a).concat([h]))}}},{key:"navigate",value:function(t,e){return this.path(t,e).emit("navigate"),this}},{key:"path",value:function(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},n=this.options.target,i=void 0,r=e.title;if("string"==typeof t){if(this.options.pushState&&"function"==typeof n.history.pushState){var s=e.state\|\|n.history.state;i=this.options.root?this.options.root+t:t,n.history.pushState(s,r,i)}else if(n.location){var o=this.options.root?this.options.root+t:t;n.location.hash=(this.options.hashBang?"!":"")+o}else n.pathname=t\|\|"";return this}if("undefined"==typeof t)return n.location&&n.location.pathname?n.location.pathname:n.pathname\|\|"";if(t===!1){if(this.options.pushState&&"function"==typeof n.history.pushState){var a=e.state\|\|n.history.state;n.history.pushState(a,r,this.options.root\|\|"/")}else n.location&&(n.location.hash=this.options.hashBang?"!":"");return this}}}],[{key:"listen",value:function(){var t=void 0,n=void 0;return(arguments.length<=0?void 0:arguments[0])&&(arguments.length<=1?void 0:arguments[1])?(t=arguments.length<=0?void 0:arguments[0],n=arguments.length<=1?void 0:arguments[1]):n=arguments.length<=0?void 0:arguments[0],function(){for(var t in n)this.add.call(this,t,n[t]);return this}.call(new e(t\|\|{}))}},{key:"toString",value:function(){return this.name}}]),e}(h.EventEmitter),c=function(){function t(e,n){return i(this,t),this.runCallback=!0,this.callbackRan=!0,this.propagateEvent=!0,this.stack=t.global.slice(0),this.router=e,this.value=e.path(),Object.assign(this,n),this}return a(t,[{key:"preventDefault",value:function(){this.runCallback=!1}},{key:"stopPropagation",value:function(){this.propagateEvent=!1}},{key:"parent",value:function(){var t=!(!this.previousState\|\|!this.previousState.value\|\|this.previousState.value!=this.value);return!!t&&this.previousState}},{key:"callback",value:function(){this.callbackRan=!0,this.timeStamp=Date.now(),this.next()}},{key:"enqueue",value:function(t,e){for(var n=Array.isArray(t)?e<t.length?t.reverse():t:[t];n.length;)this.stack.splice(e\|\|this.stack.length+1,0,n.shift());return this}},{key:"next",value:function(){var t=this;return this.stack.shift().call(this.router,this.req,this,function(){return t.next()})}}]),t}();c.global=[],l.MiddlewareStack=c,l.Route=u.default,e=t.exports=l},function(t,e){"use strict";function n(){this._events=this._events\|\|{},this._maxListeners=this._maxListeners\|\|void 0}function i(t){return"function"==typeof t}function r(t){return"number"==typeof t}function s(t){return"object"===("undefined"==typeof t?"undefined":a(t))&&null!==t}function o(t){return void 0===t}var a="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(t){return typeof t}:function(t){return t&&"function"==typeof Symbol&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t};t.exports=n,n.EventEmitter=n,n.prototype._events=void 0,n.prototype._maxListeners=void 0,n.defaultMaxListeners=10,n.prototype.setMaxListeners=function(t){if(!r(t)\|\|t<0\|\|isNaN(t))throw TypeError("n must be a positive number");return this._maxListeners=t,this},n.prototype.emit=function(t){var e,n,r,a,h,u;if(this._events\|\|(this._events={}),"error"===t&&(!this._events.error\|\|s(this._events.error)&&!this._events.error.length)){if(e=arguments[1],e instanceof Error)throw e;var l=new Error('Uncaught, unspecified "error" event. ('+e+")");throw l.context=e,l}if(n=this._events[t],o(n))return!1;if(i(n))switch(arguments.length){case 1:n.call(this);break;case 2:n.call(this,arguments[1]);break;case 3:n.call(this,arguments[1],arguments[2]);break;default:a=Array.prototype.slice.call(arguments,1),n.apply(this,a)}else if(s(n))for(a=Array.prototype.slice.call(arguments,1),u=n.slice(),r=u.length,h=0;h<r;h++)u[h].apply(this,a);return!0},n.prototype.addListener=function(t,e){var r;if(!i(e))throw TypeError("listener must be a function");return this._events\|\|(this._events={}),this._events.newListener&&this.emit("newListener",t,i(e.listener)?e.listener:e),this._events[t]?s(this._events[t])?this._events[t].push(e):this._events[t]=[this._events[t],e]:this._events[t]=e,s(this._events[t])&&!this._events[t].warned&&(r=o(this._maxListeners)?n.defaultMaxListeners:this._maxListeners,r&&r>0&&this._events[t].length>r&&(this._events[t].warned=!0,console.error("(node) warning: possible EventEmitter memory leak detected. %d listeners added. Use emitter.setMaxListeners() to increase limit.",this._events[t].length),"function"==typeof console.trace&&console.trace())),this},n.prototype.on=n.prototype.addListener,n.prototype.once=function(t,e){function n(){this.removeListener(t,n),r\|\|(r=!0,e.apply(this,arguments))}if(!i(e))throw TypeError("listener must be a function");var r=!1;return n.listener=e,this.on(t,n),this},n.prototype.removeListener=function(t,e){var n,r,o,a;if(!i(e))throw TypeError("listener must be a function");if(!this._events\|\|!this._events[t])return this;if(n=this._events[t],o=n.length,r=-1,n===e\|\|i(n.listener)&&n.listener===e)delete this._events[t],this._events.removeListener&&this.emit("removeListener",t,e);else if(s(n)){for(a=o;a-- >0;)if(n[a]===e\|\|n[a].listener&&n[a].listener===e){r=a;break}if(r<0)return this;1===n.length?(n.length=0,delete this._events[t]):n.splice(r,1),this._events.removeListener&&this.emit("removeListener",t,e)}return this},n.prototype.removeAllListeners=function(t){var e,n;if(!this._events)return this;if(!this._events.removeListener)return 0===arguments.length?this._events={}:this._events[t]&&delete this._events[t],this;if(0===arguments.length){for(e in this._events)"removeListener"!==e&&this.removeAllListeners(e);return this.removeAllListeners("removeListener"),this._events={},this}if(n=this._events[t],i(n))this.removeListener(t,n);else if(n)for(;n.length;)this.removeListener(t,n[n.length-1]);return delete this._events[t],this},n.prototype.listeners=function(t){var e;return e=this._events&&this._events[t]?i(this._events[t])?[this._events[t]]:this._events[t].slice():[]},n.prototype.listenerCount=function(t){if(this._events){var e=this._events[t];if(i(e))return 1;if(e)return e.length}return 0},n.listenerCount=function(t,e){return t.listenerCount(e)}},function(t,e){"use strict";function n(t,e){if(!(t instanceof e))throw new TypeError("Cannot call a class as a function")}var i=function(){function t(t,e){for(var n=0;n<e.length;n++){var i=e[n];i.enumerable=i.enumerable\|\|!1,i.configurable=!0,"value"in i&&(i.writable=!0),Object.defineProperty(t,i.key,i)}}return function(e,n,i){return n&&t(e.prototype,n),i&&t(e,i),e}}();Object.defineProperty(e,"__esModule",{value:!0});var r=function(){function t(e,i,r,s){n(this,t),this.keys=[],this.strict=!1,this.sensitive=!1,this.path=e,this.regex=this.create()}return i(t,[{key:"parse",value:function(t){var e=this,n=t.match(this.regex),i={match:n,params:{},keys:this.keys,matches:(n\|\|[]).slice(1)};return i.matches.forEach(function(t,n){var r=e.keys[n]&&e.keys[n].name?e.keys[n].name:n;i.params[r]=t?decodeURIComponent(t):void 0}),i}},{key:"create",value:function(){var t=this;if(this.path instanceof RegExp)return this.path;this.path instanceof Array&&(this.path="("+this.path.join("\|")+")");var e=this.path.concat(this.strict?"":"/?").replace(/\/$/g,"(?:/").replace(/\+/g,"__plus__").replace(/(\/)?(\.)?:(\w+)(?:(\(.?$))?(\?)?/g,function(e,n,i,r,s,o){return t.keys.push({name:r,optional:!!o}),n=n\|\|"",""+(o?"":n)+"(?:"+(o?n:"")+(i\|\|"")+(s\|\|i&&"([^/.]+?)"\|\|"([^/]+?)")+")"+(o\|\|"")}).replace(/([\/.])/g,"\\$1").replace(/__plus__/g,"(.+)").replace(/\/g,"(.*)");return new RegExp("^"+e+"$",this.sensitive?"":"i")}}]),t}();e.default=r}]);
		//# sourceMappingURL=grapnel.min.js.map

+28

-25

Gruntfile.js


		module.exports = function(grunt){
		module.exports = function (grunt) {

		grunt.initConfig({
		pkg: grunt.file.readJSON('package.json'),
		info : {
		banner : "/****\n"+
		" * Grapnel\n"+
		" * https://github.com/baseprime/grapnel\n"+
		" *\n"+
		" * @author <%= pkg.author %>\n"+
		" * @link <%= pkg.link %>\n"+
		" * @version <%= pkg.version %>\n"+
		" *\n"+
		" * Released under MIT License. See LICENSE.txt or http://opensource.org/licenses/MIT\n"+
		"*/\n\n"
		info: {
		banner: "/****\n" +
		" * Grapnel\n" +
		" * https://github.com/baseprime/grapnel\n" +
		" *\n" +
		" * @author <%= pkg.author %>\n" +
		" * @link <%= pkg.link %>\n" +
		" *\n" +
		" * Released under MIT License. See LICENSE.txt or http://opensource.org/licenses/MIT\n" +
		"*/\n\n"
		},
		uglify: {
		options: {
		banner: '<%= info.banner %>',
		banner: '<%= info.banner %>'
		},
		dist: {
		src: 'src/grapnel.js',
		dest : 'dist/grapnel.min.js'
		files: {
		'dist/grapnel.min.js': ['dist/grapnel.min.js']
		}
		}
		},
		concat : {
		options : {
		banner : '<%= info.banner %>'
		},
		dist: {
		src: 'src/grapnel.js',
		dest : 'src/grapnel.js'
		connect: {
		server: {
		options: {
		port: 3002,
		hostname: '*',
		base: './test'
		}
		}
		},
		qunit: {
		files: ['test/index.html']
		all: ['test/index.html']
		}
		});

		grunt.loadNpmTasks('grunt-contrib-concat');
		grunt.loadNpmTasks('grunt-contrib-uglify');
		grunt.loadNpmTasks('grunt-contrib-connect');
		grunt.loadNpmTasks('grunt-contrib-qunit');

		grunt.registerTask('default', ['uglify', 'concat', 'qunit']);
		grunt.registerTask('default', ['uglify', 'qunit']);
		grunt.registerTask('build', ['uglify', 'qunit']);
		grunt.registerTask('test', ['qunit']);
		grunt.registerTask('serve-tests', ['connect:server:keepalive']);

		}

+17

-8

package.json

		{
		"name": "grapnel",
		"version": "0.6.4",
		"description": "The smallest JavaScript Router with PushState & Named Parameter support",
		"main": "src/grapnel.js",
		"version": "0.7.0",
		"description": "The first (and smallest!) JavaScript Router with PushState, Middleware, and Named Parameter support",
		"main": "build/index.js",
		"scripts": {
		"test": "pushd ./test; python -m SimpleHTTPServer 3002; popd"
		"test": "grunt test",
		"serve-tests": "grunt serve-tests",
		"watch": "tsc & webpack --watch",
		"build": "grunt build"
		},
		@@ -39,7 +42,13 @@ "repository": {
		"devDependencies": {
		"grunt": "^0.4.5",
		"grunt-contrib-concat": "^0.5.0",
		"grunt-contrib-qunit": "^0.5.2",
		"grunt-contrib-uglify": "^0.7.0"
		"@types/node": "~9.4.0",
		"babel-core": "^6.26.0",
		"babel-loader": "^6.4.1",
		"babel-preset-es2015": "^6.24.1",
		"grunt": "^1.0.0",
		"grunt-contrib-concat": "^1.0.1",
		"grunt-contrib-connect": "^1.0.2",
		"grunt-contrib-qunit": "^1.2.0",
		"grunt-contrib-uglify": "^2.0.0",
		"webpack": "^1.15.0"
		}
		}

+102

-105

README.md

		Grapnel
		==========

		#### The smallest (1100 bytes gzipped!) Client/Server-Side JavaScript Router with Named Parameters, HTML5 pushState, and Middleware support.
		#### The first (started in 2010!) Client/Server-Side JavaScript Router with Named Parameters, HTML5 pushState, and Middleware support.

		@@ -11,3 +11,3 @@ ## Download/Installation
		- [Production](https://raw.githubusercontent.com/baseprime/grapnel/master/dist/grapnel.min.js)
		- [Development](https://raw.githubusercontent.com/baseprime/grapnel/master/src/grapnel.js)
		- [Development](https://raw.githubusercontent.com/baseprime/grapnel/development/dist/grapnel.js)

		@@ -22,3 +22,3 @@ Install with npm
		```
		Server only: (with HTTP methods added, [more info](https://github.com/baseprime/grapnel/tree/server-router))
		Server only: (with HTTP methods added, [more info](https://github.com/baseprime/grapnel-server))
		```bash
		@@ -31,7 +31,6 @@ npm install grapnel-server
		- Supports routing using `pushState` or `hashchange` concurrently
		- Supports Named Parameters similar to Sinatra, Restify, and Express
		- Supports Named Parameters similar to Express, Sinatra, and Restify
		- Middleware Support
		- Works on the client or server-side
		- Works on the client or server side
		- RegExp Support
		- RequreJS/AMD, Browserify, and CommonJS Compatibility
		- Supports `#` or `#!` for `hashchange` routing
		@@ -44,7 +43,7 @@ - Unobtrusive, supports multiple routers on the same page
		```javascript
		var router = new Grapnel();
		const router = new Grapnel();

		router.get('products/:category/:id?', function(req){
		var id = req.params.id,
		category = req.params.category;
		router.get('products/:category/:id?', function(req) {
		let id = req.params.id;
		let category = req.params.category;
		// GET http://mysite.com/#products/widgets/134
		@@ -56,10 +55,10 @@ console.log(category, id);

		## Using pushState
		## Using HTML5 pushState

		```javascript
		var router = new Grapnel({ pushState : true });
		const router = new Grapnel({ pushState : true });

		router.get('/products/:category/:id?', function(req){
		var id = req.params.id,
		category = req.params.category
		router.get('/products/:category/:id?', function(req) {
		let id = req.params.id;
		let category = req.params.category;

		@@ -77,9 +76,9 @@ console.log(category, id);
		```javascript
		router.get('products/:id?', function(req){
		router.get('products/:id?', function(req) {
		// GET /file.html#products/134
		req.params.id
		console.log(req.params.id);
		// => 134
		});

		router.get('products/*', function(req){
		router.get('products/*', function(req) {
		// The wildcard/asterisk will match anything after that point in the URL
		@@ -95,4 +94,4 @@ // Parameters are provided req.params using req.params[n], where n is the nth capture
		```javascript
		var auth = function(req, event, next){
		user.auth(function(err){
		let auth = function(req, event, next) {
		user.auth(function(err) {
		req.user = this;
		@@ -103,3 +102,3 @@ next();

		router.get('/*', auth, function(req){
		router.get('/*', auth, function(req) {
		console.log(req.user);
		@@ -114,9 +113,9 @@ });
		```javascript
		var usersRoute = router.context('/user/:id', getUser, getFollowers); // Middleware can be used here
		let usersRoute = router.context('/user/:id', getUser, getFollowers); // Middleware can be used here

		usersRoute('/', function(req, event){
		usersRoute('/', function(req, event) {
		console.log('Profile', req.params.id);
		});

		usersRoute('/followers', otherMiddleware, function(req, event){ // Middleware can be used here too
		usersRoute('/followers', otherMiddleware, function(req, event) { // Middleware can be used here too
		console.log('Followers', req.params.id);
		@@ -133,3 +132,17 @@ });
		## Works as a server-side router
		```javascript
		import { createServer } from 'http';
		import Grapnel from 'grapnel';
		const app = new Grapnel();

		app.get('/', function(req, route) {
		route.res.end('Hello World!', 200);
		});

		createServer(function(req, res) {
		app.once('match', function(route) {
		route.res = res;
		}).navigate(req.url);
		}).listen(3000);
		```
		This is now simplified as a separate package ([more info](https://github.com/baseprime/grapnel/tree/server-router))
		@@ -139,23 +152,13 @@ ```bash
		```
		```javascript
		var http = require('http'),
		app = require('grapnel-server');

		app.get('/', function(req, res, next){
		res.end('Hello World!', 200);
		});

		http.createServer(app.start()).listen(3000);
		```

		## Declaring Multiple Routes

		```javascript
		var routes = {
		'products' : function(req){
		let routes = {
		'products' : function(req) {
		// GET /file.html#products
		},
		'products/:category/:id?' : function(req){
		'products/:category/:id?' : function(req) {
		// GET /file.html#products/widgets/35
		req.params.category
		console.log(req.params.category);
		// => widgets
		@@ -171,3 +174,3 @@ }
		```javascript
		var router = new Grapnel({ pushState : true, root : '/' });
		const router = new Grapnel({ pushState : true, root : '/' });

		@@ -186,4 +189,4 @@ router.on('navigate', function(event){
		```javascript
		var expression = /^food\/tacos\/(.*)$/i;
		var router = new Grapnel();
		const router = new Grapnel();
		let expression = /^food\/tacos\/(.*)$/i;

		@@ -197,18 +200,2 @@ router.get(expression, function(req, event){

		## RequireJS/AMD, Browserify, and CommonJS Compatibility

		```javascript
		require(['lib/grapnel'], function(Grapnel){

		var router = new Grapnel({ pushState : true });

		router.bind('navigate', function(){
		console.log('It works!');
		});

		router.navigate('/');

		});
		```


		@@ -222,23 +209,8 @@
		```javascript
		var router = new Grapnel();
		const router = new Grapnel();
		```
		Or you can declare your routes with a literal object:

		```javascript
		Grapnel.listen({
		'products/:id' : function(req){
		// Handler
		}
		});
		```
		When declaring routes with a literal object, router options can be passed as the first parameter:
		```javascript
		var opts = { pushState : true };

		Grapnel.listen(opts, routes);
		```

		## Enabling PushState
		```javascript
		var router = new Grapnel({ pushState : true });
		const router = new Grapnel({ pushState : true });
		```
		@@ -248,13 +220,13 @@ You can also specify a root URL by setting it as an option:
		```javascript
		var router = new Grapnel({ root : '/public/search/', pushState : true });
		const router = new Grapnel({ root : '/app', pushState : true });
		```
		The root may require a beginning slash and a trailing slash depending on how your application utilizes the router.
		The root may require a beginning slash and a trailing slash depending on how you set up your routes.

		## Middleware
		Grapnel uses middleware similar to how Express uses middleware. Middleware has access to the `req` object, `event` object, and the next middleware in the call stack (commonly denoted as `next`). Middleware must call `next()` to pass control to the next middleware, otherwise the router will stop.
		Grapnel uses middleware similar to how Express uses middleware. Middleware has access to the `req` object, `route` object, and the next middleware in the call stack (commonly denoted as `next`). Middleware must call `next()` to pass control to the next middleware, otherwise the router will stop.

		For more information about how middleware works, see [Using Middleware](http://expressjs.com/guide/using-middleware.html).
		```javascript
		var user = function(req, event, next){
		user.get(function(err){
		let user = function(req, route, next) {
		user.get(function(err) {
		req.user = this;
		@@ -265,3 +237,3 @@ next();

		router.get('/user/*', user, function(req){
		router.get('/user/*', user, function(req) {
		console.log(req.user);
		@@ -271,2 +243,18 @@ });

		## Declaring your routes with an object literal:

		```javascript
		Grapnel.listen({
		'products/:id' : function(req) {
		// Handler
		}
		});
		```
		When declaring routes with a literal object, router options can be passed as the first parameter:
		```javascript
		let opts = { pushState : true };

		Grapnel.listen(opts, routes);
		```

		## Navigation
		@@ -280,4 +268,4 @@ If pushState is enabled, you can navigate through your application with `router.navigate`:
		```javascript
		router.on('match', function(event){
		event.preventDefault(); // Stops event handler
		router.on('match', function(routeEvent) {
		routeEvent.preventDefault(); // Stops event handler
		});
		@@ -288,7 +276,7 @@ ```
		```javascript
		router.get('/products/:id', function(req, event){
		event.stopPropagation(); // Stops propagation of the event
		router.get('/products/:id', function(req, routeEvent) {
		routeEvent.stopPropagation(); // Stops propagation of the event
		});

		router.get('/products/widgets', function(req, event){
		router.get('/products/widgets', function(req, routeEvent) {
		// This will not be executed
		@@ -301,16 +289,16 @@ });
		## 404 Pages
		You can specify a route that only uses a wildcard `*` as your final route, then use `event.parent()` which returns `false` if the call stack doesn't have any other routes to run.
		You can specify a route that only uses a wildcard `*` as your final route, then use `route.parent()` which returns `false` if the call stack doesn't have any other routes to run.
		```javascript
		var routes = {
		'/' : function(req, e){
		let routes = {
		'/' : function(req, route) {
		// Handle route
		},
		'/store/products/:id' : function(req, e){
		'/store/products/:id' : function(req, route) {
		// Handle route
		},
		'/category/:id' : function(req, e){
		'/category/:id' : function(req, route) {
		// Handle route
		},
		'/*' : function(req, e){
		if(!e.parent()){
		'/*' : function(req, route) {
		if(!route.parent()){
		// Handle 404
		@@ -324,2 +312,9 @@ }

		## Setting window state
		```javascript
		router.navigate('/', {
		state: { ...windowState }
		});
		```


		@@ -329,3 +324,3 @@

		# API Documentation
		# Documentation

		@@ -338,5 +333,5 @@ ##### `get` Adds a listeners and middleware for routes
		*/
		router.get('/store/:category/:id?', function(req, event){
		var category = req.params.category,
		id = req.params.id;
		router.get('/store/:category/:id?', function(req, route){
		let category = req.params.category;
		let id = req.params.id;

		@@ -351,4 +346,5 @@ console.log('Product #%s in %s', id, category);
		* @param {String} path relative to root
		* @param {Object} options navigation options
		*/
		router.navigate('/products/123');
		router.navigate('/products/123', ...options);
		```
		@@ -362,3 +358,3 @@
		*/
		router.on('myevent', function(event){
		router.on('myevent', function(event) {
		console.log('Grapnel works!');
		@@ -374,3 +370,3 @@ });
		*/
		router.once('init', function(){
		router.once('init', function() {
		console.log('This will only be executed once');
		@@ -380,9 +376,9 @@ });

		##### `trigger` Triggers an event
		##### `emit` Triggers an event
		```javascript
		/**
		* @param {String} event name
		* @param {Mixed} [attributes] Parameters that will be applied to event handler
		* @param {...Mixed} attributes Parameters that will be applied to event handler
		*/
		router.trigger('event', eventArg1, eventArg2, etc);
		router.emit('event', eventArg1, eventArg2, ...etc);
		```
		@@ -398,5 +394,5 @@
		*/
		var usersRoute = router.context('/user/:id');
		let usersRoute = router.context('/user/:id');

		usersRoute('/followers', function(req, event){
		usersRoute('/followers', function(req, route) {
		console.log('Followers', req.params.id);
		@@ -415,4 +411,4 @@ });
		##### `bind` An alias of `on`
		##### `trigger` An alias of `emit`
		##### `add` An alias of `get`
		##### `fragment` (Deprecated)

		@@ -422,2 +418,3 @@ ## Options
		* `root` Root of your app, all navigation will be relative to this
		* `target` Target object where the router will apply its changes (default: `window`)
		* `hashBang` Enable `#!` as the anchor of a `hashchange` router instead of using just a `#`
		@@ -424,0 +421,0 @@

-424

src/grapnel.js

		/****
		* Grapnel
		* https://github.com/baseprime/grapnel
		*
		* @author Greg Sabia Tucker <greg@narrowlabs.com>
		* @link http://basepri.me
		* @version 0.6.4
		*
		* Released under MIT License. See LICENSE.txt or http://opensource.org/licenses/MIT
		*/

		!(function(root) {

		function Grapnel(opts) {
		"use strict";

		var self = this; // Scope reference
		this.events = {}; // Event Listeners
		this.state = null; // Router state object
		this.options = opts \|\| {}; // Options
		this.options.env = this.options.env \|\| (!!(Object.keys(root).length === 0 && process && process.browser !== true) ? 'server' : 'client');
		this.options.mode = this.options.mode \|\| (!!(this.options.env !== 'server' && this.options.pushState && root.history && root.history.pushState) ? 'pushState' : 'hashchange');
		this.version = '0.6.4'; // Version

		if ('function' === typeof root.addEventListener) {
		root.addEventListener('hashchange', function() {
		self.trigger('hashchange');
		});

		root.addEventListener('popstate', function(e) {
		// Make sure popstate doesn't run on init -- this is a common issue with Safari and old versions of Chrome
		if (self.state && self.state.previousState === null) return false;

		self.trigger('navigate');
		});
		}

		return this;
		};
		/**
		* Create a RegExp Route from a string
		* This is the heart of the router and I've made it as small as possible!
		*
		* @param {String} Path of route
		* @param {Array} Array of keys to fill
		* @param {Bool} Case sensitive comparison
		* @param {Bool} Strict mode
		*/
		Grapnel.regexRoute = function(path, keys, sensitive, strict) {
		if (path instanceof RegExp) return path;
		if (path instanceof Array) path = '(' + path.join('\|') + ')';
		// Build route RegExp
		path = path.concat(strict ? '' : '/?')
		.replace(/\/\(/g, '(?:/')
		.replace(/\+/g, '__plus__')
		.replace(/(\/)?(\.)?:(\w+)(?:($.*?$))?(\?)?/g, function(_, slash, format, key, capture, optional) {
		keys.push({
		name: key,
		optional: !!optional
		});
		slash = slash \|\| '';

		return '' + (optional ? '' : slash) + '(?:' + (optional ? slash : '') + (format \|\| '') + (capture \|\| (format && '([^/.]+?)' \|\| '([^/]+?)')) + ')' + (optional \|\| '');
		})
		.replace(/([\/.])/g, '\\$1')
		.replace(/__plus__/g, '(.+)')
		.replace(/\/g, '(.)');

		return new RegExp('^' + path + '$', sensitive ? '' : 'i');
		};
		/**
		* ForEach workaround utility
		*
		* @param {Array} to iterate
		* @param {Function} callback
		*/
		Grapnel._forEach = function(a, callback) {
		if (typeof Array.prototype.forEach === 'function') return Array.prototype.forEach.call(a, callback);
		// Replicate forEach()
		return function(c, next) {
		for (var i = 0, n = this.length; i < n; ++i) {
		c.call(next, this[i], i, this);
		}
		}.call(a, callback);
		};
		/**
		* Add an route and handler
		*
		* @param {String\|RegExp} route name
		* @return {self} Router
		*/
		Grapnel.prototype.get = Grapnel.prototype.add = function(route) {
		var self = this,
		middleware = Array.prototype.slice.call(arguments, 1, -1),
		handler = Array.prototype.slice.call(arguments, -1)[0],
		request = new Request(route);

		var invoke = function RouteHandler() {
		// Build request parameters
		var req = request.parse(self.path());
		// Check if matches are found
		if (req.match) {
		// Match found
		var extra = {
		route: route,
		params: req.params,
		req: req,
		regex: req.match
		};
		// Create call stack -- add middleware first, then handler
		var stack = new CallStack(self, extra).enqueue(middleware.concat(handler));
		// Trigger main event
		self.trigger('match', stack, req);
		// Continue?
		if (!stack.runCallback) return self;
		// Previous state becomes current state
		stack.previousState = self.state;
		// Save new state
		self.state = stack;
		// Prevent this handler from being called if parent handler in stack has instructed not to propagate any more events
		if (stack.parent() && stack.parent().propagateEvent === false) {
		stack.propagateEvent = false;
		return self;
		}
		// Call handler
		stack.callback();
		}
		// Returns self
		return self;
		};
		// Event name
		var eventName = (self.options.mode !== 'pushState' && self.options.env !== 'server') ? 'hashchange' : 'navigate';
		// Invoke when route is defined, and once again when app navigates
		return invoke().on(eventName, invoke);
		};
		/**
		* Fire an event listener
		*
		* @param {String} event name
		* @param {Mixed} [attributes] Parameters that will be applied to event handler
		* @return {self} Router
		*/
		Grapnel.prototype.trigger = function(event) {
		var self = this,
		params = Array.prototype.slice.call(arguments, 1);
		// Call matching events
		if (this.events[event]) {
		Grapnel._forEach(this.events[event], function(fn) {
		fn.apply(self, params);
		});
		}

		return this;
		};
		/**
		* Add an event listener
		*
		* @param {String} event name (multiple events can be called when separated by a space " ")
		* @param {Function} callback
		* @return {self} Router
		*/
		Grapnel.prototype.on = Grapnel.prototype.bind = function(event, handler) {
		var self = this,
		events = event.split(' ');

		Grapnel._forEach(events, function(event) {
		if (self.events[event]) {
		self.events[event].push(handler);
		} else {
		self.events[event] = [handler];
		}
		});

		return this;
		};
		/**
		* Allow event to be called only once
		*
		* @param {String} event name(s)
		* @param {Function} callback
		* @return {self} Router
		*/
		Grapnel.prototype.once = function(event, handler) {
		var ran = false;

		return this.on(event, function() {
		if (ran) return false;
		ran = true;
		handler.apply(this, arguments);
		handler = null;
		return true;
		});
		};
		/**
		* @param {String} Route context (without trailing slash)
		* @param {[Function]} Middleware (optional)
		* @return {Function} Adds route to context
		*/
		Grapnel.prototype.context = function(context) {
		var self = this,
		middleware = Array.prototype.slice.call(arguments, 1);

		return function() {
		var value = arguments[0],
		submiddleware = (arguments.length > 2) ? Array.prototype.slice.call(arguments, 1, -1) : [],
		handler = Array.prototype.slice.call(arguments, -1)[0],
		prefix = (context.slice(-1) !== '/' && value !== '/' && value !== '') ? context + '/' : context,
		path = (value.substr(0, 1) !== '/') ? value : value.substr(1),
		pattern = prefix + path;

		return self.add.apply(self, [pattern].concat(middleware).concat(submiddleware).concat([handler]));
		}
		};
		/**
		* Navigate through history API
		*
		* @param {String} Pathname
		* @return {self} Router
		*/
		Grapnel.prototype.navigate = function(path) {
		return this.path(path).trigger('navigate');
		};

		Grapnel.prototype.path = function(pathname) {
		var self = this,
		frag;

		if ('string' === typeof pathname) {
		// Set path
		if (self.options.mode === 'pushState') {
		frag = (self.options.root) ? (self.options.root + pathname) : pathname;
		root.history.pushState({}, null, frag);
		} else if (root.location) {
		root.location.hash = (self.options.hashBang ? '!' : '') + pathname;
		} else {
		root._pathname = pathname \|\| '';
		}

		return this;
		} else if ('undefined' === typeof pathname) {
		// Get path
		if (self.options.mode === 'pushState') {
		frag = root.location.pathname.replace(self.options.root, '');
		} else if (self.options.mode !== 'pushState' && root.location) {
		frag = (root.location.hash) ? root.location.hash.split((self.options.hashBang ? '#!' : '#'))[1] : '';
		} else {
		frag = root._pathname \|\| '';
		}

		return frag;
		} else if (pathname === false) {
		// Clear path
		if (self.options.mode === 'pushState') {
		root.history.pushState({}, null, self.options.root \|\| '/');
		} else if (root.location) {
		root.location.hash = (self.options.hashBang) ? '!' : '';
		}

		return self;
		}
		};
		/**
		* Create routes based on an object
		*
		* @param {Object} [Options, Routes]
		* @param {Object Routes}
		* @return {self} Router
		*/
		Grapnel.listen = function() {
		var opts, routes;
		if (arguments[0] && arguments[1]) {
		opts = arguments[0];
		routes = arguments[1];
		} else {
		routes = arguments[0];
		}
		// Return a new Grapnel instance
		return (function() {
		// TODO: Accept multi-level routes
		for (var key in routes) {
		this.add.call(this, key, routes[key]);
		}

		return this;
		}).call(new Grapnel(opts \|\| {}));
		};
		/**
		* Create a call stack that can be enqueued by handlers and middleware
		*
		* @param {Object} Router
		* @param {Object} Extend
		* @return {self} CallStack
		*/
		function CallStack(router, extendObj) {
		this.stack = CallStack.global.slice(0);
		this.router = router;
		this.runCallback = true;
		this.callbackRan = false;
		this.propagateEvent = true;
		this.value = router.path();

		for (var key in extendObj) {
		this[key] = extendObj[key];
		}

		return this;
		};
		/**
		* Build request parameters and allow them to be checked against a string (usually the current path)
		*
		* @param {String} Route
		* @return {self} Request
		*/
		function Request(route) {
		this.route = route;
		this.keys = [];
		this.regex = Grapnel.regexRoute(route, this.keys);
		};
		// This allows global middleware
		CallStack.global = [];
		/**
		* Prevent a callback from being called
		*
		* @return {self} CallStack
		*/
		CallStack.prototype.preventDefault = function() {
		this.runCallback = false;
		};
		/**
		* Prevent any future callbacks from being called
		*
		* @return {self} CallStack
		*/
		CallStack.prototype.stopPropagation = function() {
		this.propagateEvent = false;
		};
		/**
		* Get parent state
		*
		* @return {Object} Previous state
		*/
		CallStack.prototype.parent = function() {
		var hasParentEvents = !!(this.previousState && this.previousState.value && this.previousState.value == this.value);
		return (hasParentEvents) ? this.previousState : false;
		};
		/**
		* Run a callback (calls to next)
		*
		* @return {self} CallStack
		*/
		CallStack.prototype.callback = function() {
		this.callbackRan = true;
		this.timeStamp = Date.now();
		this.next();
		};
		/**
		* Add handler or middleware to the stack
		*
		* @param {Function\|Array} Handler or a array of handlers
		* @param {Int} Index to start inserting
		* @return {self} CallStack
		*/
		CallStack.prototype.enqueue = function(handler, atIndex) {
		var handlers = (!Array.isArray(handler)) ? [handler] : ((atIndex < handler.length) ? handler.reverse() : handler);

		while (handlers.length) {
		this.stack.splice(atIndex \|\| this.stack.length + 1, 0, handlers.shift());
		}

		return this;
		};
		/**
		* Call to next item in stack -- this adds the `req`, `event`, and `next()` arguments to all middleware
		*
		* @return {self} CallStack
		*/
		CallStack.prototype.next = function() {
		var self = this;

		return this.stack.shift().call(this.router, this.req, this, function next() {
		self.next.call(self);
		});
		};
		/**
		* Match a path string -- returns a request object if there is a match -- returns false otherwise
		*
		* @return {Object} req
		*/
		Request.prototype.parse = function(path) {
		var match = path.match(this.regex),
		self = this;

		var req = {
		params: {},
		keys: this.keys,
		matches: (match \|\| []).slice(1),
		match: match
		};
		// Build parameters
		Grapnel._forEach(req.matches, function(value, i) {
		var key = (self.keys[i] && self.keys[i].name) ? self.keys[i].name : i;
		// Parameter key will be its key or the iteration index. This is useful if a wildcard (*) is matched
		req.params[key] = (value) ? decodeURIComponent(value) : undefined;
		});

		return req;
		};

		// Append utility constructors to Grapnel
		Grapnel.CallStack = CallStack;
		Grapnel.Request = Request;

		if ('function' === typeof root.define && !root.define.amd.grapnel) {
		root.define(function(require, exports, module) {
		root.define.amd.grapnel = true;
		return Grapnel;
		});
		} else if ('object' === typeof module && 'object' === typeof module.exports) {
		module.exports = exports = Grapnel;
		} else {
		root.Grapnel = Grapnel;
		}

		}).call({}, ('object' === typeof window) ? window : this);

.npmignore

Sorry, the diff of this file is not supported yet

grapnel - npm Package Compare versions

New alerts

Fixed alerts

Improved metrics

Worsened metrics