next: некоторый рефакторинг ns.Model, ns.ModelCollection и совсем немного ns.View

Makefile

@@ -4,7 +4,7 @@ export NPM_BIN
 yate: test/tests.yate.js
 
 test/tests.yate.js: test/tests.yate
-	node_modules/.bin/yate test/tests.yate > test/tests.yate.js
+	$(NPM_BIN)/yate test/tests.yate > test/tests.yate.js
 
 node_modules: package.json
 	npm install
@@ -16,4 +16,7 @@ clean-node_modules:
 grunt: node_modules yate
 	$(NPM_BIN)/grunt
 
-.PHONY: clean-node_modules grunt yate
+test: grunt
+	$(NPM_BIN)/jscs .
+
+.PHONY: clean-node_modules grunt yate test

doc/api.md

@@ -0,0 +1,48 @@
+### `ns.Model`
+```js
+// Static API
+ns.Model.define(id, info, base)
+ns.Model.info(id)
+ns.Model.infoLite(id)
+ns.Model.key(id, params, info)
+ns.Model.get(id, params)
+ns.Model.getValid(id, params)
+ns.Model.isValid(id, params)
+ns.Model.invalidate(id, filter)
+ns.Model.destroy(model)
+ns.Model.destroyWith(targetModel, withModels)
+ns.Model.isCollection(model)
+
+// Instance API
+model.getRequestParams()
+model.prepareRequest(requestId)
+model.canRetry()
+model.extractData(result)
+model.extractError(result)
+model.preprocessData(data)
+model.setData(data, options) // options.silent
+model.set(jpath, value, options) // options.silent
+model.getData() // Returns whole data object
+model.get(jpath) // Returns some data object property
+model.select(jpath) // Returns an array of values, selected from data object (useful when there are many results returned by the same jpath)
+model.setError(error)
+model.getError()
+model.isValid()
+model.isDo()
+model.getVersion()
+model.touch()
+model.invalidate()
+```
+
+
+### `ns.ModelCollection`
+```js
+// Instance API
+collection.insert(models, index)
+collection.remove(models)
+collection.getSelfVersion()
+collection.clear()
+collection.onItemChanged(evt, model, jpath)
+collection.onItemTouched(evt, model)
+collection.onItemDestroyed(evt, model)
+```

src/ns.consts.events.js

@@ -22,6 +22,7 @@ ns.V.EVENTS = {
 ns.V.DOM_EVENTS = [
     'blur',
     'change',
+    'input',
     'click',
     'dblclick',
     'dragstart',

src/ns.consts.js

@@ -102,7 +102,7 @@ ns.R = {
      * Тут специально выбрано длинное название,
      * чтобы не пересечься с нормальными страницами.
      */
-     REDIRECT: 'ns-router-redirect'
+    REDIRECT: 'ns-router-redirect'
 };
 
 /**

src/ns.js

@@ -1,3 +1,5 @@
+/*jshint unused: vars */
+
 /**
  * noscript MVC framework
  * @namespace
@@ -145,6 +147,47 @@ ns.transaction = function(cb) {
     ns.page.go(ns.page._lastUrl);
 };
 
+/**
+ * Выполняет проверку, что первый аргумент истиннен.
+ * Если это не так - кидает ошибку.
+ * @param {?} truthy Любое значение, которое проверяется на истинность.
+ * @param {String} contextName Контекст для быстрого поиска места возникновения ошибки.
+ * @param {String} message Сообщение об ошибке.
+ */
+ns.assert = function(truthy, contextName, message) {
+    if (!truthy) {
+        ns.assert.fail.apply(this, Array.prototype.slice.call(arguments, 1));
+    }
+};
+
+/**
+ * Кидает ошибку с понятным сообщением.
+ * @param {String} contextName Контекст для быстрого поиска места возникновения ошибки.
+ * @param {String} message Сообщение об ошибке.
+ */
+ns.assert.fail = function(contextName, message) {
+    var messageArgs = Array.prototype.slice.call(arguments, 2);
+    for (var i = 0; i < messageArgs.length; i++) {
+        message = message.replace('%s', messageArgs[i]);
+    }
+    throw new Error('[' + contextName + '] ' + message);
+};
+
+/**
+ * Строит ключ по готовому объекту параметров.
+ * @param {string} prefix Префикс ключа.
+ * @param {Object} params Объект с параметрами составляющими ключ.
+ * @return {string} Строка ключа.
+ */
+ns.key = function(prefix, params) {
+    var key = prefix;
+    params = params || {};
+    for (var pName in params) {
+        key += '&' + pName + '=' + params[pName];
+    }
+    return key;
+};
+
 if (window['mocha']) {
 
     /**