removeRule() method created

Author: afonsopacifer

README.md

@@ -16,8 +16,28 @@
 - [CSS AST reference](#css-ast-reference)
 - [Methods list](#methods-list)
   - [Stylesheet Level - root](#stylesheet-level-root)
+    - findAllRules
+    - findAllRulesByType
+    - findAllRulesByType
+    - findAllRulesByType
+    - findAllRulesBySelectors
+    - addRule
+    - removeRule
+    - findAllSelectors
+    - findAllImport
+    - findAllDeclarations
+    - findAllDeclarationsBySelectors
+    - findAllDeclarationsByProperty
+    - findAllDeclarationsByValue
   - [Rule Level](#rule-level)
+    - findDeclarations
+    - findDeclarationsBySelectors
+    - findDeclarationsByProperty
+    - findDeclarationsByValue
   - [Declarations Level](#declarations-level)
+    - addDeclaration
+    - removeDeclaration
+    - getParam
 - [Development](#development)
   - [Code Style](#code-style)
   - [Tests](#tests)
@@ -97,6 +117,11 @@ stylesheet.findAllRulesBySelectors('.foo', (rule, ruleIndex) => {
 });
 ```
 
+*Add a single rule:*
+```js
+stylesheet.addRule(newRule, 0); //Rule position
+```
+
 *Remove a single rule:*
 ```js
 stylesheet.removeRule(0); //Rule position

package.json

@@ -1,7 +1,7 @@
 {
   "name": "css-ast-iterations",
   "description": "Provide a very simple API for complex iterations on the CSS abstract syntax tree (AST).",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "author": {
     "name": "afonsopacifer",
     "email": "[email protected]"

src/core/addRule.js

@@ -0,0 +1,16 @@
+const addRule = (astRoot) => {
+
+  const isObject = typeof astRoot === 'object';
+
+  if(isObject) {
+
+    astRoot.addRule = function (newRule, index) {
+      const rules = astRoot.stylesheet.rules;
+      rules.splice(index, 0, newRule);
+    };
+
+  }
+
+};
+
+module.exports = addRule;

src/index.js

@@ -4,6 +4,7 @@
 const findAllRules = require('./core/findAllRules');
 const findAllRulesByType = require('./core/findAllRulesByType');
 const findAllRulesBySelectors = require('./core/findAllRulesBySelectors');
+const addRule = require('./core/addRule');
 const removeRule = require('./core/removeRule');
 const findAllSelectors = require('./core/findAllSelectors');
 const findAllImport = require('./core/findAllImport');
@@ -29,6 +30,7 @@ const addIterations = (astRoot) => {
   findAllRules(astRoot);
   findAllRulesByType(astRoot);
   findAllRulesBySelectors(astRoot);
+  addRule(astRoot);
   removeRule(astRoot);
   findAllSelectors(astRoot);
   findAllImport(astRoot);

test/addRule.test.js

@@ -0,0 +1,71 @@
+/* eslint max-len: ["error", 120, 2] */
+
+const assert = require('assert');
+const css = require('css');
+const addRule = require('../src/core/addRule');
+
+describe('addRule()', () => {
+
+  // --------------------------
+
+  it('Should return a CSS with one rule added.', () => {
+
+    const ast = css.parse(`
+      .a {
+        width: 10px;
+      }
+
+      .b {
+        color: #000;
+      }
+    `);
+
+    // Add removeDeclaration method on Object
+    addRule(ast);
+
+    const newRule = css.parse(`
+      .foo {
+        height: 40px;
+      }
+    `);
+
+    ast.addRule(newRule, 0);
+
+    const result = css.stringify(ast);
+    const expect = '.foo {\n  height: 40px;\n}\n\n.a {\n  width: 10px;\n}\n\n.b {\n  color: #000;\n}';
+    assert.equal(result, expect);
+
+  });
+
+  // --------------------------
+
+  it('Should return a CSS with one rule added on position 1.', () => {
+
+    const ast = css.parse(`
+      .a {
+        width: 10px;
+      }
+
+      .b {
+        color: #000;
+      }
+    `);
+
+    // Add removeDeclaration method on Object
+    addRule(ast);
+
+    const newRule = css.parse(`
+      .foo {
+        height: 40px;
+      }
+    `);
+
+    ast.addRule(newRule, 1);
+
+    const result = css.stringify(ast);
+    const expect = '.a {\n  width: 10px;\n}\n\n.foo {\n  height: 40px;\n}\n\n.b {\n  color: #000;\n}';
+    assert.equal(result, expect);
+
+  });
+
+});

test/index.js

@@ -2,6 +2,7 @@
 require('./findAllRules.test.js');
 require('./findAllRulesByType.test.js');
 require('./findAllRulesBySelectors.test.js');
+require('./addRule.test.js');
 require('./removeRule.test.js');
 require('./findAllSelectors.test.js');
 require('./findAllImport.test.js');