add ability to create indented lists

Author: jrking4

README.md

@@ -632,7 +632,30 @@ pres
   });
 ```
 
-# Tipps and Tricks
+## Add Bulleted List
+
+You can add a bulleted list to a shape.
+
+```ts
+// Remove existing charts, images or shapes from added slide.
+const bulletPoints = ['first line', 'second line', 'third line'];
+const indentedBulletPoints = ['first line', [ 'indent 1-1', 'indent 1-2', [ 'indent 2-1', 'indent 2-2', ] ], 'second line', 'third line'];
+
+  pres.addSlide('general', 2, (slide) => {
+      slide.modifyElement(
+              'replaceText', //shape selector
+              modify.setBulletList(bulletPoints),
+      );
+    })
+    .addSlide('general', 2, (slide) => {
+      slide.modifyElement(
+              'replaceText', //shape selector
+              modify.setBulletList(indentedBulletPoints),
+      );
+    });
+```
+
+# Tips and Tricks
 
 ## Loop through the slides of a presentation
 

__tests__/modify-bullet-text.test.ts

@@ -0,0 +1,41 @@
+import Automizer, { modify } from '../src/index';
+
+const bulletPoints = ['first line', 'second line', 'third line'];
+const multiLevelBullet = [
+  'top line 1',
+  [
+    'indent 1-1',
+    'indent 1-2',
+    [
+      'indent 2-1',
+      'indent 2-2',
+    ],
+  ],
+  'top line 2',
+];
+
+test('create presentation, replace bullet list text.', async () => {
+  const automizer = new Automizer({
+    templateDir: `${__dirname}/pptx-templates`,
+    outputDir: `${__dirname}/pptx-output`,
+  });
+
+  const pres = automizer.loadRoot(`RootTemplate.pptx`).load(`TextReplace.pptx`);
+
+  const result = await pres
+
+    .addSlide('TextReplace.pptx', 2, (slide) => {
+      slide.modifyElement(
+        'replaceTextBullet1',
+        modify.setBulletList(bulletPoints),
+      );
+    }).addSlide('TextReplace.pptx', 2, (slide) => {
+      slide.modifyElement(
+        'replaceTextBullet1',
+        modify.setBulletList(multiLevelBullet),
+      );
+    })
+    .write(`replace-bullet-text.test.pptx`);
+
+   expect(result.slides).toBe(3);
+});

src/helper/modify-shape-helper.ts

@@ -40,6 +40,15 @@ export default class ModifyShapeHelper {
       ModifyTextHelper.setText(text)(element as XmlElement);
     };
 
+  /**
+   * Set content to bulleted list of modified shape
+   */
+  static setBulletList =
+    (list) =>
+    (element: XmlElement): void => {
+      ModifyTextHelper.setBulletList(list)(element as XmlElement);
+    };
+
   /**
    * Replace tagged text content within modified shape
    */

src/helper/modify-text-helper.ts

@@ -32,6 +32,61 @@ export default class ModifyTextHelper {
       }
     };
 
+  static setBulletList =
+    (list) => (element: XmlElement): void => {
+      const namespaceURIs = {
+        'a': 'http://schemas.openxmlformats.org/drawingml/2006/main',
+        'p': 'http://schemas.openxmlformats.org/presentationml/2006/main'
+      };
+      const doc = element.ownerDocument;
+
+      let txBody = element.getElementsByTagName('p:txBody')[0];
+      if (!txBody) {
+        txBody = doc.createElementNS(namespaceURIs['p'], 'p:txBody');
+        element.appendChild(txBody);
+      } else {
+        while (txBody.firstChild) {
+          txBody.removeChild(txBody.firstChild);
+        }
+      }
+
+      const bodyPr = doc.createElementNS(namespaceURIs['a'], 'a:bodyPr');
+      txBody.appendChild(bodyPr);
+      const lstStyle = doc.createElementNS(namespaceURIs['a'], 'a:lstStyle');
+      txBody.appendChild(lstStyle);
+
+      const processList = (items, level) => {
+        items.forEach((item) => {
+          if (Array.isArray(item)) {
+            processList(item, level + 1);
+          } else {
+            const p = doc.createElementNS(namespaceURIs['a'], 'a:p');
+
+            const pPr = doc.createElementNS(namespaceURIs['a'], 'a:pPr');
+            if (level > 0) {
+              pPr.setAttribute('lvl', String(level));
+            }
+            p.appendChild(pPr);
+
+            const r = doc.createElementNS(namespaceURIs['a'], 'a:r');
+
+            const rPr = doc.createElementNS(namespaceURIs['a'], 'a:rPr');
+            r.appendChild(rPr);
+
+            const t = doc.createElementNS(namespaceURIs['a'], 'a:t');
+            const textNode = doc.createTextNode(String(item));
+            t.appendChild(textNode);
+
+            r.appendChild(t);
+            p.appendChild(r);
+            txBody.appendChild(p);
+          }
+        });
+      };
+
+      processList(list, 0);
+    };
+
   static content =
     (label: number | string) =>
     (element: XmlElement): void => {
@@ -41,7 +96,7 @@ export default class ModifyTextHelper {
     };
 
   /**
-   * Set text style insinde an <a:rPr> element
+   * Set text style inside an <a:rPr> element
    */
   static style =
     (style: TextStyle) =>
@@ -71,7 +126,7 @@ export default class ModifyTextHelper {
     };
 
   /**
-   * Set size of text insinde an <a:rPr> element
+   * Set size of text inside an <a:rPr> element
    */
   static setSize =
     (size: number) =>

src/index.ts

@@ -49,6 +49,7 @@ const setAttribute = ModifyHelper.setAttribute;
 
 const setSolidFill = ModifyShapeHelper.setSolidFill;
 const setText = ModifyShapeHelper.setText;
+const setBulletList = ModifyShapeHelper.setBulletList;
 const replaceText = ModifyShapeHelper.replaceText;
 const setPosition = ModifyShapeHelper.setPosition;
 const updatePosition = ModifyShapeHelper.updatePosition;
@@ -118,6 +119,7 @@ export const modify = {
   setAttribute,
   setSolidFill,
   setText,
+  setBulletList,
   replaceText,
   setPosition,
   updatePosition,