Update README.md

README.md

@@ -22,7 +22,7 @@ const run = async () => {
 run();
 ```
 
-Original article.json
+Original article.json:
 
 ```json
 {
@@ -62,7 +62,7 @@ Inline will replace named references of `titleLayout` and `titleStyle` with obje
 
 Purge any unused references to layouts, styles, or text styles not referenced by name within the components array.
 
-This optimization removes lengthy templated style definitions that may be stubbed into an article boilerplate, leaving only definitions that are actually used.  Note this does not purge empty object definitions.
+This optimization removes lengthy templated style definitions that may be stubbed into an article boilerplate, leaving only definitions that are actually used.  Note this does not purge empty object definitions - use `removeEmptyDefinitions()`.
 
 Example:
 
@@ -82,6 +82,62 @@ run();
 ```
 
 
+## Remove Empty Definitions
+
+Purge any empty definitions within layouts, styles, or text styles as well as their named reference within the components array.
+
+This optimization removes lengthy templated style definitions that may be stubbed into an article boilerplate.
+
+Example:
+
+```js
+const fs = require("fs");
+const anf = require("apple-news-compiler")
+
+const run = async () => {
+  var article = JSON.parse(fs.readFileSync("article.json"), 'utf8');
+
+  anf.article.removeEmptyDefinitions(article);
+
+  console.log(JSON.stringify(article, null, 2));
+}
+
+run();
+```
+
+Original article.json
+
+```json
+"components": [
+  {
+    "role": "title",
+    "text": "Title on Scrim",
+    "layout": "titleLayout",
+    "textStyle": "titleStyle"
+  }
+],
+"componentTextStyles": {
+  "titleStyle": {
+  }
+}
+```
+
+In the example above, `titleStyle` is empty - no style was defined in the object.  Therefore, the resulting optimizaiton would remove `titleStyle` from the component's `textStyle` as well as the `titleStyle` from the `componentTextStyles`:
+
+```json
+"components": [
+  {
+    "role": "title",
+    "text": "Title on Scrim",
+    "layout": "titleLayout"
+  }
+],
+"componentTextStyles": {}
+```
+
+
+
+
 ## Remove Comments
 
 Purge any comments from components, layouts, styles, or text styles that use either the following conventions: