feat: #17 Add 'Deprecated' info wherever used 'modName, modVal'

index.js

@@ -3,6 +3,8 @@
 const assert = require('assert');
 const util = require('util');
 
+const deprecate = require('depd')('bem-cell');
+
 const BemEntityName = require('@bem/entity-name');
 
 module.exports = class BemCell {
@@ -101,15 +103,21 @@ module.exports = class BemCell {
      * @deprecated - just for compatibility and can be dropped in future
      * @returns {String|undefined} - modifier name
      */
-    get modName() { return this._entity.modName; }
+    get modName() {
+        deprecate('modName: just for compatibility and can be dropped in future');
+        return this._entity.modName;
+    }
 
     /**
-     * Proxies `modName` field from entity.
+     * Proxies `modVal` field from entity.
      *
      * @deprecated - just for compatibility and can be dropped in future
      * @returns {String|true|undefined} - modifier value
      */
-    get modVal() { return this._entity.modVal; }
+    get modVal() {
+        deprecate('modVal: just for compatibility and can be dropped in future');
+        return this._entity.modVal;
+    }
 
     /**
      * Returns the identifier of this cell.
@@ -274,8 +282,6 @@ module.exports = class BemCell {
      * const BemCell = require('@bem/cell');
      *
      * BemCell.create({ block: 'my-button', mod: 'theme', val: 'red', tech: 'css' });
-     * BemCell.create({ block: 'my-button', modName: 'theme', modVal: 'red', tech: 'css' });
-     * BemCell.create({ entity: { block: 'my-button', modName: 'theme', modVal: 'red' }, tech: 'css' });
      * // BemCell { block: 'my-button', mod: { name: 'theme', val: 'red' }, tech: 'css' }
      *
      * @param {Object} obj — representation of cell.

package.json

@@ -24,7 +24,8 @@
     "node": ">= 4.0"
   },
   "dependencies": {
-    "@bem/entity-name": "1.3.1"
+    "@bem/entity-name": "1.3.1",
+    "depd": "^1.1.0"
   },
   "devDependencies": {
     "ava": "^0.17.0",