Updated JSCS & other dependencies.

.jscsfilter

@@ -1,10 +1,8 @@
 'use strict';
 
-var _ = require('lodash');
-
 module.exports = function(e) {
   var report = true;
-  var isTestFile = _.startsWith(e.filename, './test/');
+  var isTestFile = !!e.filename.match(/^\.\/test\//);
   if (isTestFile && e.message === 'jsdoc definition required') {
     report = false;
   }

.jscsrc

@@ -28,9 +28,6 @@
     "ignoreSingleLine": true
   },
   "safeContextKeyword": "self",
-  "plugins": [
-    "jscs-jsdoc"
-  ],
   "jsDoc": {
     "checkAnnotations": {
       "preset": "jsdoc3",

lib/adapters/base.js

@@ -11,14 +11,21 @@ var Phrasing = require('../dialect/phrasing');
 var Procedures = require('../dialect/procedures');
 
 /**
+ * @class Adapter
+ * @classdesc
+ *
  * The base Adapter class is the extension point for custom database adapters.
  * As a user of Azul, you typically won't use this, but if you're looking to
  * add support for a custom database, you should start here.
- *
- * @public
- * @constructor
  */
 var Adapter = Class.extend(/** @lends Adapter# */ {
+
+  /**
+   * Create an adapter.
+   *
+   * @public
+   * @constructor
+   */
   init: function(connection) {
     var cls = this.__identity__;
     this._super();

lib/adapters/mixins/returning.js

@@ -8,17 +8,24 @@ var Promise = require('bluebird');
 var Statement = require('../../types/statement');
 
 /**
+ * @class PseudoReturn
+ * @classdesc
+ *
  * The pseudo-return class. This is used as a marker to allow embedding of a
  * pseudo-return item & extraction of that item by using type checking.
  *
  * It's really just a wrapper around a field name (string) that can be type
  * checked.
- *
- * @protected
- * @constructor PseudoReturn
- * @param {String} field The field name that's requested to be returned.
  */
 var PseudoReturn = Class.extend(/** @lends PseudoReturn# */ {
+
+  /**
+   * Create a pseudo return object.
+   *
+   * @protected
+   * @constructor PseudoReturn
+   * @param {String} field The field name that's requested to be returned.
+   */
   init: function(field) {
     this._field = field;
   },
@@ -44,6 +51,14 @@ var PseudoReturn = Class.extend(/** @lends PseudoReturn# */ {
  * @mixin EmbedPseudoReturn
  */
 var EmbedPseudoReturn = Mixin.create(/** @lends EmbedPseudoReturn# */ {
+
+  /**
+   * Override of {@link Phrasing#insert}.
+   *
+   * @method
+   * @public
+   * @see {@link Phrasing#insert}
+   */
   insert: function(data) {
     var returning = data.returning;
     var result = this._super(_.extend(data, { returning: undefined }));
@@ -54,6 +69,7 @@ var EmbedPseudoReturn = Mixin.create(/** @lends EmbedPseudoReturn# */ {
     }
     return Statement.create(value, args);
   },
+
 });
 
 /**

lib/adapters/sqlite3/sqlite3.js

@@ -12,13 +12,20 @@ var EmbedPseudoReturn = returning.EmbedPseudoReturn;
 var ExtractPseudoReturn = returning.ExtractPseudoReturn;
 
 /**
- * SQLite3 Adapter.
- *
- * @public
- * @constructor
+ * @class SQLite3Adapter
  * @extends Adapter
+ * @classdesc
+ *
+ * SQLite3 Adapter.
  */
 var SQLite3Adapter = Adapter.extend(/** @lends SQLite3Adapter# */ {
+
+  /**
+   * Create a SQLite3 adapter.
+   *
+   * @public
+   * @constructor
+   */
   init: function() {
     this._super.apply(this, arguments);
     this._connections = {};

lib/condition/condition.js

@@ -9,6 +9,9 @@ var Node = require('./node');
 
 
 /**
+ * @class Condition
+ * @classdesc
+ *
  * Conditions allow the construction of expressions to limit queries. They are
  * usually constructed using the more terse `w` syntax (an abbreviation for
  * where). This syntax will be used throughout the documentation here. Basic
@@ -34,13 +37,17 @@ var Node = require('./node');
  *
  *     select('cities').where({ name: 'Portland' })
  *     select('cities').where(w({ name: 'Portland' }))
- *
- * @public
- * @constructor
- * @param {...(Object|Condition)} conditions Objects used to express a
- * condition.
  */
 var Condition = Class.extend({ /** @lends Condition# */
+
+  /**
+   * Create a condition.
+   *
+   * @public
+   * @constructor
+   * @param {...(Object|Condition)} conditions Objects used to express a
+   * condition.
+   */
   init: function() {
     this._super();
 

lib/condition/node.js

@@ -4,15 +4,22 @@ var Class = require('corazon/class');
 var property = require('corazon/property');
 
 /**
- * A condition expression node (tree).
+ * @class Node
+ * @classdesc
  *
- * @private
- * @constructor
- * @param {String} type The node type.
- * @param {Array.<Node>} children The children of this node.
- * @param {Object} attrs The attributes for the node.
+ * A condition expression node (tree).
  */
 var Node = Class.extend(/** @lends Node# */ {
+
+  /**
+   * Create a node.
+   *
+   * @private
+   * @constructor
+   * @param {String} type The node type.
+   * @param {Array.<Node>} children The children of this node.
+   * @param {Object} attrs The attributes for the node.
+   */
   init: function(type, children, attrs) {
     this._super();
     this._type = type;

lib/condition/operation.js

@@ -3,13 +3,20 @@
 var Class = require('corazon/class');
 
 /**
- * The base operation class.
+ * @class Operation
+ * @classdesc
  *
- * @private
- * @constructor
- * @param {String} name The operation name/symbol.
+ * The base operation class.
  */
 var Operation = Class.extend(/** @lends Operation# */ {
+
+  /**
+   * Create an operation.
+   *
+   * @private
+   * @constructor
+   * @param {String} name The operation name/symbol.
+   */
   init: function(name) {
     this._super();
     this.name = name;

lib/dialect/phrasing.js

@@ -3,16 +3,23 @@
 var Class = require('corazon/class');
 
 /**
+ * @class Phrasing
+ * @classdesc
+ *
  * The phrasing class is used to build full statements to send to the database.
  * It is responsible for the ordering & overall structure of the queries, and
  * should use the {@link Grammar} and {@link Translator} classes to take care
  * of basic formatting & quick translations.
- *
- * @public
- * @constructor
- * @param {Grammar} grammar The grammar to use when building phrases.
  */
 var Phrasing = Class.extend(/** @lends Phrasing# */ {
+
+  /**
+   * Create a phrasing.
+   *
+   * @public
+   * @constructor
+   * @param {Grammar} grammar The grammar to use when building phrases.
+   */
   init: function(grammar, translator) {
     this._super();
     this._grammar = grammar;

lib/dialect/procedures.js

@@ -3,17 +3,23 @@
 var Class = require('corazon/class');
 var Promise = require('bluebird');
 
-
 /**
+ * @class Procedures
+ * @classdesc
+ *
  * The procedures class is responsible for complex procedures that cannot be
  * expressed in single queries.
- *
- * @public
- * @constructor
  */
 var Procedures = Class.extend();
 
 Procedures.reopen(/** @lends Procedures# */ {
+
+  /**
+   * Create a procedure.
+   *
+   * @public
+   * @constructor
+   */
   init: function(grammar, phrasing) {
     this._super();
     this._grammar = grammar;

lib/query/base.js

@@ -18,20 +18,27 @@ var property = require('corazon/property');
  */
 
 /**
+ * @class BaseQuery
+ * @classdesc
+ *
  * Queries are the building block of Azul's database abstraction layer. They
  * are immutable, chainable objects. Each operation that you perform on a query
  * will return a duplicated query rather than the original. The duplicated
  * query will be configured as requested.
  *
  * Generally, you will not create queries directly. Instead, you will receive
  * a query object via one of many convenience methods.
- *
- * @protected
- * @constructor BaseQuery
- * @mixes Transform
- * @param {Adapter} adapter The adapter to use when using the query.
  */
 var BaseQuery = Class.extend(/** @lends BaseQuery# */ {
+
+  /**
+   * Create a base query.
+   *
+   * @protected
+   * @constructor BaseQuery
+   * @mixes Transform
+   * @param {Adapter} adapter The adapter to use when using the query.
+   */
   init: function(adapter) {
     this._super();
     this._adapter = adapter;

lib/query/delete.js

@@ -24,23 +24,28 @@ var Transaction = require('./mixins/transaction');
  */
 
 /**
- * A delete query.
- *
- * You will not create this query object directly. Instead, you will
- * receive it via {@link EntryQuery#delete}.
- *
- * @protected
- * @constructor DeleteQuery
+ * @class DeleteQuery
  * @extends BaseQuery
  * @mixes Where
  * @mixes Transaction
+ * @classdesc
+ *
+ * A delete query.
  */
 var DeleteQuery = BaseQuery.extend();
 
 DeleteQuery.reopen(Where);
 DeleteQuery.reopen(Transaction);
 
 DeleteQuery.reopen(/** @lends DeleteQuery# */ {
+
+  /**
+   * You will not create this query object directly. Instead, you will
+   * receive it via {@link EntryQuery#delete}.
+   *
+   * @protected
+   * @constructor DeleteQuery
+   */
   init: function() { throw new Error('DeleteQuery must be spawned.'); },
 
   /**

lib/query/entry.js

@@ -9,6 +9,11 @@ _.mixin({ toSentenceSerial: _.str.toSentenceSerial });
 
 
 /**
+ * @class EntryQuery
+ * @extends BaseQuery
+ * @mixes Transaction
+ * @classdesc
+ *
  * Queries are the building block of Azul's database abstraction layer. They
  * are immutable, chainable objects. Each operation that you perform on a query
  * will return a duplicated query rather than the original. The duplicated
@@ -20,8 +25,6 @@ _.mixin({ toSentenceSerial: _.str.toSentenceSerial });
  * @protected
  * @constructor EntryQuery
  * @param {Adapter} adapter The adapter to use when using the query.
- * @extends BaseQuery
- * @mixes Transaction
  */
 var EntryQuery = BaseQuery.extend();
 

lib/query/insert.js

@@ -25,17 +25,22 @@ var Transaction = require('./mixins/transaction');
  */
 
 /**
- * An insert query.
- *
- * You will not create this query object directly. Instead, you will
- * receive it via {@link EntryQuery#insert}.
- *
- * @protected
- * @constructor InsertQuery
+ * @class InsertQuery
  * @extends BaseQuery
  * @mixes Transaction
+ * @classdesc
+ *
+ * An insert query.
  */
 var InsertQuery = BaseQuery.extend(Transaction, /** @lends InsertQuery# */ {
+
+  /**
+   * You will not create this query object directly. Instead, you will
+   * receive it via {@link EntryQuery#insert}.
+   *
+   * @protected
+   * @constructor InsertQuery
+   */
   init: function() { throw new Error('InsertQuery must be spawned.'); },
 
   /**

lib/query/mixins/group_by.js

@@ -8,6 +8,10 @@ var Mixin = require('corazon/mixin');
  * @mixin GroupBy
  */
 module.exports = Mixin.create(/** @lends GroupBy# */ {
+
+  /**
+   * Mixin initialization.
+   */
   init: function() {
     this._super();
     this._groupBy = undefined;