Version bump

* #2388 - Check for undefined rather than falsey

* Add default tab stop

* Add back tab stop positions

* Add test for default tab stop

.cspell.json

@@ -17,6 +17,7 @@
         "dolan",
         "execa",
         "falsey",
+        "horz",
         "iife",
         "Initializable",
         "iroha",

.eslintrc.yml

@@ -7,7 +7,6 @@ parser: "@typescript-eslint/parser"
 parserOptions:
     project:
         - tsconfig.json
-        - demo/tsconfig.json
     sourceType: module
 plugins:
     - eslint-plugin-import
@@ -214,8 +213,7 @@ rules:
     valid-typeof: "off"
     functional/immutable-data:
         - error
-        - assumeTypes: true
+        - ignoreImmediateMutation: true
-          ignoreImmediateMutation: true
           ignoreAccessorPattern:
               - "**.root*"
               - "**.numberingReferences*"

.github/workflows/demos.yml

@@ -38,7 +38,7 @@ jobs:
                   name: build
                   path: build
             - name: Run Demo
-              run: npm run ts-node -- ./demo/1-basic.ts
+              run: npm run run-ts -- ./demo/1-basic.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -47,7 +47,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/2-declaritive-styles.ts
+              run: npm run run-ts -- ./demo/2-declaritive-styles.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -56,7 +56,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/3-numbering-and-bullet-points.ts
+              run: npm run run-ts -- ./demo/3-numbering-and-bullet-points.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -65,7 +65,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/4-basic-table.ts
+              run: npm run run-ts -- ./demo/4-basic-table.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -74,7 +74,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/5-images.ts
+              run: npm run run-ts -- ./demo/5-images.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -83,7 +83,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/6-page-borders.ts
+              run: npm run run-ts -- ./demo/6-page-borders.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -92,7 +92,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/7-landscape.ts
+              run: npm run run-ts -- ./demo/7-landscape.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -101,7 +101,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/8-header-footer.ts
+              run: npm run run-ts -- ./demo/8-header-footer.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -110,7 +110,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/9-images-in-header-and-footer.ts
+              run: npm run run-ts -- ./demo/9-images-in-header-and-footer.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -119,7 +119,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/10-my-cv.ts
+              run: npm run run-ts -- ./demo/10-my-cv.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -128,7 +128,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/11-declaritive-styles-2.ts
+              run: npm run run-ts -- ./demo/11-declaritive-styles-2.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -137,7 +137,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/12-scaling-images.ts
+              run: npm run run-ts -- ./demo/12-scaling-images.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -146,7 +146,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/13-xml-styles.ts
+              run: npm run run-ts -- ./demo/13-xml-styles.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -155,7 +155,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/14-page-numbers.ts
+              run: npm run run-ts -- ./demo/14-page-numbers.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -164,7 +164,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/15-page-break-before.ts
+              run: npm run run-ts -- ./demo/15-page-break-before.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -173,7 +173,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/16-multiple-sections.ts
+              run: npm run run-ts -- ./demo/16-multiple-sections.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -182,7 +182,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/17-footnotes.ts
+              run: npm run run-ts -- ./demo/17-footnotes.ts
             - name: Extract Word Document
               run: npm run extract
             # element r: Schemas validity error : Element '{http://schemas.openxmlformats.org/wordprocessingml/2006/main}r': This element is not expected.
@@ -192,7 +192,7 @@ jobs:
             #     xml-file: build/extracted-doc/word/document.xml
             #     xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/18-image-from-buffer.ts
+              run: npm run run-ts -- ./demo/18-image-from-buffer.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -201,7 +201,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/19-export-to-base64.ts
+              run: npm run run-ts -- ./demo/19-export-to-base64.ts
             # Base 64 No longer works, abruptly. Node issue?
             # - name: Extract Word Document
             #   run: npm run extract
@@ -211,7 +211,7 @@ jobs:
             #       xml-file: build/extracted-doc/word/document.xml
             #       xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/20-table-cell-borders.ts
+              run: npm run run-ts -- ./demo/20-table-cell-borders.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -220,7 +220,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/21-bookmarks.ts
+              run: npm run run-ts -- ./demo/21-bookmarks.ts
             - name: Extract Word Document
               run: npm run extract
             # Bad ID - need numeric ID
@@ -230,7 +230,7 @@ jobs:
             #     xml-file: build/extracted-doc/word/document.xml
             #     xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/22-right-to-left-text.ts
+              run: npm run run-ts -- ./demo/22-right-to-left-text.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -239,7 +239,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/23-base64-images.ts
+              run: npm run run-ts -- ./demo/23-base64-images.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -248,7 +248,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/24-images-to-table-cell.ts
+              run: npm run run-ts -- ./demo/24-images-to-table-cell.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -257,7 +257,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/25-table-xml-styles.ts
+              run: npm run run-ts -- ./demo/25-table-xml-styles.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -266,7 +266,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/26-paragraph-borders.ts
+              run: npm run run-ts -- ./demo/26-paragraph-borders.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -275,7 +275,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/27-declaritive-styles-3.ts
+              run: npm run run-ts -- ./demo/27-declaritive-styles-3.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -284,7 +284,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/28-table-of-contents.ts
+              run: npm run run-ts -- ./demo/28-table-of-contents.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -293,7 +293,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/29-numbered-lists.ts
+              run: npm run run-ts -- ./demo/29-numbered-lists.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -302,7 +302,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/31-tables.ts
+              run: npm run run-ts -- ./demo/31-tables.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -311,7 +311,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/32-merge-and-shade-table-cells.ts
+              run: npm run run-ts -- ./demo/32-merge-and-shade-table-cells.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -320,7 +320,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/33-sequential-captions.ts
+              run: npm run run-ts -- ./demo/33-sequential-captions.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -329,7 +329,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/34-floating-tables.ts
+              run: npm run run-ts -- ./demo/34-floating-tables.ts
             - name: Extract Word Document
               run: npm run extract
             # element tblpPr: Schemas validity error : Element '{http://schemas.openxmlformats.org/wordprocessingml/2006/main}tblpPr', attribute 'overlap': The attribute 'overlap' is not allowed.
@@ -340,7 +340,7 @@ jobs:
             #     xml-file: build/extracted-doc/word/document.xml
             #     xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/35-hyperlinks.ts
+              run: npm run run-ts -- ./demo/35-hyperlinks.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -349,7 +349,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/36-image-to-table-cell.ts
+              run: npm run run-ts -- ./demo/36-image-to-table-cell.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -358,7 +358,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/37-images-to-header-and-footer.ts
+              run: npm run run-ts -- ./demo/37-images-to-header-and-footer.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -367,7 +367,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/38-text-wrapping.ts
+              run: npm run run-ts -- ./demo/38-text-wrapping.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -376,7 +376,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/39-page-numbers.ts
+              run: npm run run-ts -- ./demo/39-page-numbers.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -385,7 +385,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/40-line-numbers.ts
+              run: npm run run-ts -- ./demo/40-line-numbers.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -394,7 +394,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/41-merge-table-cells-2.ts
+              run: npm run run-ts -- ./demo/41-merge-table-cells-2.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -403,7 +403,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/42-restart-page-numbers.ts
+              run: npm run run-ts -- ./demo/42-restart-page-numbers.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -412,7 +412,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/43-images-to-table-cell-2.ts
+              run: npm run run-ts -- ./demo/43-images-to-table-cell-2.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -421,7 +421,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/44-multiple-columns.ts
+              run: npm run run-ts -- ./demo/44-multiple-columns.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -430,7 +430,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/45-highlighting-text.ts
+              run: npm run run-ts -- ./demo/45-highlighting-text.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -439,7 +439,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/46-shading-text.ts
+              run: npm run run-ts -- ./demo/46-shading-text.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -448,7 +448,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/47-number-of-total-pages-section.ts
+              run: npm run run-ts -- ./demo/47-number-of-total-pages-section.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -457,7 +457,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/48-vertical-align.ts
+              run: npm run run-ts -- ./demo/48-vertical-align.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -466,7 +466,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/49-table-borders.ts
+              run: npm run run-ts -- ./demo/49-table-borders.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -475,7 +475,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/50-readme-demo.ts
+              run: npm run run-ts -- ./demo/50-readme-demo.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -484,7 +484,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/51-character-styles.ts
+              run: npm run run-ts -- ./demo/51-character-styles.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -493,7 +493,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/52-japanese.ts
+              run: npm run run-ts -- ./demo/52-japanese.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -502,7 +502,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/53-chinese.ts
+              run: npm run run-ts -- ./demo/53-chinese.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -511,7 +511,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/54-custom-properties.ts
+              run: npm run run-ts -- ./demo/54-custom-properties.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -520,7 +520,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/55-math.ts
+              run: npm run run-ts -- ./demo/55-math.ts
             - name: Extract Word Document
               run: npm run extract
             #: element subHide: Schemas validity error : Element '{http://schemas.openxmlformats.org/officeDocument/2006/math}subHide': This element is not expected. Expected is ( {http://schemas.openxmlformats.org/officeDocument/2006/math}ctrlPr ).
@@ -533,7 +533,7 @@ jobs:
             #     xml-file: build/extracted-doc/word/document.xml
             #     xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/56-background-color.ts
+              run: npm run run-ts -- ./demo/56-background-color.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -542,7 +542,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/57-add-parent-numbered-lists.ts
+              run: npm run run-ts -- ./demo/57-add-parent-numbered-lists.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -551,7 +551,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/58-section-types.ts
+              run: npm run run-ts -- ./demo/58-section-types.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -560,7 +560,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/59-header-footer-margins.ts
+              run: npm run run-ts -- ./demo/59-header-footer-margins.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -569,7 +569,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/60-track-revisions.ts
+              run: npm run run-ts -- ./demo/60-track-revisions.ts
             - name: Extract Word Document
               run: npm run extract
             # element r: Schemas validity error : Element '{http://schemas.openxmlformats.org/wordprocessingml/2006/main}r': This element is not expected.
@@ -579,7 +579,7 @@ jobs:
             #     xml-file: build/extracted-doc/word/document.xml
             #     xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/61-text-frame.ts
+              run: npm run run-ts -- ./demo/61-text-frame.ts
             - name: Extract Word Document
               run: npm run extract
             # element left: Schemas validity error : Element '{http://schemas.openxmlformats.org/wordprocessingml/2006/main}left': This element is not expected. Expected is one of ( {http://schemas.openxmlformats.org/wordprocessingml/2006/main}right, {http://schemas.openxmlformats.org/wordprocessingml/2006/main}between, {http://schemas.openxmlformats.org/wordprocessingml/2006/main}bar ).
@@ -589,7 +589,7 @@ jobs:
             #     xml-file: build/extracted-doc/word/document.xml
             #     xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/62-paragraph-spacing.ts
+              run: npm run run-ts -- ./demo/62-paragraph-spacing.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -598,7 +598,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/63-odd-even-header-footer.ts
+              run: npm run run-ts -- ./demo/63-odd-even-header-footer.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -607,7 +607,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/64-complex-numbering-text.ts
+              run: npm run run-ts -- ./demo/64-complex-numbering-text.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -616,7 +616,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/65-page-sizes.ts
+              run: npm run run-ts -- ./demo/65-page-sizes.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -625,7 +625,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/66-fields.ts
+              run: npm run run-ts -- ./demo/66-fields.ts
             - name: Extract Word Document
               run: npm run extract
             # element bookmarkStart: Schemas validity error : Element '{http://schemas.openxmlformats.org/wordprocessingml/2006/main}bookmarkStart', attribute '{http://schemas.openxmlformats.org/wordprocessingml/2006/main}id': '-irrswq-ln94j4fdgdjxs' is not a valid value of the atomic type '{http://schemas.openxmlformats.org/wordprocessingml/2006/main}ST_DecimalNumber'.
@@ -636,7 +636,7 @@ jobs:
             #     xml-file: build/extracted-doc/word/document.xml
             #     xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/67-column-break.ts
+              run: npm run run-ts -- ./demo/67-column-break.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -645,7 +645,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/68-numbering-instances-and-starting-number.ts
+              run: npm run run-ts -- ./demo/68-numbering-instances-and-starting-number.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -654,7 +654,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/69-different-width-columns.ts
+              run: npm run run-ts -- ./demo/69-different-width-columns.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -663,7 +663,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/70-line-numbers-suppression.ts
+              run: npm run run-ts -- ./demo/70-line-numbers-suppression.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -672,7 +672,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/71-page-borders-2.ts
+              run: npm run run-ts -- ./demo/71-page-borders-2.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -681,7 +681,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/72-word-wrap.ts
+              run: npm run run-ts -- ./demo/72-word-wrap.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -690,7 +690,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/73-comments.ts
+              run: npm run run-ts -- ./demo/73-comments.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -699,7 +699,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/73-comments.ts
+              run: npm run run-ts -- ./demo/73-comments.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -708,7 +708,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             # - name: Run Demo
-            #   run: npm run ts-node -- ./demo/75-tab-stops.ts
+            #   run: npm run run-ts -- ./demo/75-tab-stops.ts
             # - name: Extract Word Document
             #   run: npm run extract
             # - name: Validate XML
@@ -717,7 +717,7 @@ jobs:
             #       xml-file: build/extracted-doc/word/document.xml
             #       xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/76-compatibility.ts
+              run: npm run run-ts -- ./demo/76-compatibility.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -726,7 +726,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/77-side-by-side-tables.ts
+              run: npm run run-ts -- ./demo/77-side-by-side-tables.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -735,7 +735,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/78-thai-distributed.ts
+              run: npm run run-ts -- ./demo/78-thai-distributed.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -744,7 +744,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/79-table-from-data-source.ts
+              run: npm run run-ts -- ./demo/79-table-from-data-source.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -753,7 +753,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/80-thai-distributed.ts
+              run: npm run run-ts -- ./demo/80-thai-distributed.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -762,7 +762,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/81-continuous-header.ts
+              run: npm run run-ts -- ./demo/81-continuous-header.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -771,7 +771,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/82-new-headers-new-section.ts
+              run: npm run run-ts -- ./demo/82-new-headers-new-section.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -780,7 +780,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/83-setting-languages.ts
+              run: npm run run-ts -- ./demo/83-setting-languages.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML
@@ -789,7 +789,7 @@ jobs:
                   xml-file: build/extracted-doc/word/document.xml
                   xml-schema-file: ooxml-schemas/microsoft/wml-2010.xsd
             - name: Run Demo
-              run: npm run ts-node -- ./demo/84-positional-tabs.ts
+              run: npm run run-ts -- ./demo/84-positional-tabs.ts
             - name: Extract Word Document
               run: npm run extract
             - name: Validate XML

.vscode/launch.json

@@ -1,18 +1,4 @@
 {
     "version": "0.2.0",
-    "configurations": [
+    "configurations": []
-        {
-            "name": "Run Demo",
-            "type": "node",
-            "request": "launch",
-            "runtimeArgs": [
-                "-r",
-                "${workspaceFolder}/node_modules/ts-node/register",
-                "-r",
-                "${workspaceFolder}/node_modules/tsconfig-paths/register"
-            ],
-            "cwd": "${workspaceRoot}",
-            "program": "${workspaceFolder}/demo/85-template-document.ts"
-        }
-    ]
 }

.vscode/tasks.json

@@ -2,23 +2,5 @@
     // See https://go.microsoft.com/fwlink/?LinkId=733558
     // for the documentation about the tasks.json format
     "version": "2.0.0",
-    "tasks": [
+    "tasks": []
-        {
-            "type": "typescript",
-            "tsconfig": "tsconfig.json",
-            "option": "watch",
-            "problemMatcher": [
-                "$tsc-watch"
-            ]
-        },
-        {
-            "type": "npm",
-            "script": "ts-node",
-            "problemMatcher": [],
-            "group": {
-                "kind": "build",
-                "isDefault": true
-            }
-        }
-    ]
 }

demo/75-tab-stops.ts

@@ -18,6 +18,7 @@ const receiptTabStops = [
 const twoTabStops = [{ type: TabStopType.RIGHT, position: TabStopPosition.MAX }];
 
 const doc = new Document({
+    defaultTabStop: 0,
     sections: [
         {
             properties: {},

demo/browser-demo.html

@@ -1,4 +1,4 @@
-<!DOCTYPE html>
+<!doctype html>
 <html>
     <head>
         <script src="../build/index.umd.js"></script>

demo/index.ts

@@ -55,7 +55,7 @@ if (files.length === 0) {
     const filePath = path.join(dir, files[0]);
 
     console.log(`Running demo ${demoNumber}: ${files[0]}`);
-    const { stdout } = await $`ts-node --project demo/tsconfig.json ${filePath}`;
+    const { stdout } = await $`tsx ${filePath}`;
     console.log(stdout);
     console.log("Successfully created document!");
 }

demo/tsconfig.json

@@ -1,10 +0,0 @@
-{
-    "extends": "../tsconfig.json",
-    "compilerOptions": {
-        "rootDir": "./",
-        "paths": {
-            "docx": ["../build"]
-        }
-    },
-    "include": ["../demo"]
-}

docs/usage/numbering.md

@@ -1,5 +1,7 @@
 # Bullets and Numbering
 
+!> Bullets and Numbering requires an understanding of [Sections](usage/sections.md) and [Paragraphs](usage/paragraph.md).
+
 `docx` is quite flexible in its bullets and numbering system, allowing
 the user great freedom in how bullets and numbers are to be styled and
 displayed. E.g., numbers can be shown using Arabic numerals, roman
@@ -8,112 +10,128 @@ format also supports re-using bullets/numbering styles throughout the
 document, so that different lists using the same style need not
 redefine them.
 
-Because of this flexibility, bullets and numbering in DOCX involves a
+## Configuration
-couple of moving pieces:
 
-1.  Document-level bullets/numbering definitions (abstract)
+Numbering is configured by adding config into `Document`:
-2.  Document-level bullets/numbering definitions (concrete)
-3.  Paragraph-level bullets/numbering selection
-
-## Document-level bullets/numbering definitions (abstract)
-
-Every document contains a set of abstract bullets/numbering
-definitions which define the formatting and layout of paragraphs using
-those bullets/numbering. An abstract numbering system defines how
-bullets/numbers are to be shown for lists, including any sublists that
-may be used. Thus each abstract definition includes a series of
-_levels_ which form a sequence starting at 0 indicating the top-level
-list look and increasing from there to describe the sublists, then
-sub-sublists, etc. Each level includes the following properties:
-
-*   **level**: This is its 0-based index in the definition stack
-*   **numberFormat**: This indicates how the bullet or number should be
-    generated. Options include `bullet` (meaning don't count), `decimal`
-    (arabic numerals), `upperRoman`, `lowerRoman`, `hex`, and many
-    more.
-*   **levelText**: This is a format string using the output of the
-    `numberFormat` function and generating a string to insert before
-    every item in the list. You may use `%1`, `%2`, ... to reference the
-    numbers from each numbering level before this one. Thus a level
-    text of `%d)` with a number format of `lowerLetter` would result in
-    the sequence "a)", "b)", ...
-*   and a few others, which you can see in the OOXML spec section 17.9.6
-
-## Document-level bullets/numbering definitions (concrete)
-
-Concrete definitions are sort of like concrete subclasses of the
-abstract definitions. They indicate their parent and are allowed to
-override certain level definitions. Thus two lists that differ only in
-how sub-sub-lists are to be displayed can share the same abstract
-numbering definition and have slightly different concrete definitions.
-
-## Paragraph-level bullets/numbering selection
-
-In order to use a bullets/numbering definition (which must be
-concrete), paragraphs need to select it, similar to applying a CSS
-class to an element, using both the concrete numbering definition ID
-and the level number that the paragraph should be at. Additionally, MS
-Word and LibreOffice typically apply a "ListParagraph" style to
-paragraphs that are being numbered.
-
-## Using bullets/numbering in `docx`
-
-`docx` includes a pre-defined bullet style which you can add to your
-paragraphs using `para.bullets()`. If you require different bullet
-styles or numbering of any kind, you'll have to use the
-`docx.Numbering` class.
-
-First you need to create a new numbering container class and use it to
-create your abstract numbering style, define your levels, and create
-your concrete numbering style:
 
 ```ts
-const numbering = new docx.Numbering();
+new Document({
-
+    numbering: {
-const abstractNum = numbering.createAbstractNumbering();
+        config: [...]
-abstractNum.createLevel(0, "upperRoman", "%1", "start").addParagraphProperty(new Indent(720, 260));
+    }
-abstractNum.createLevel(1, "decimal", "%2.", "start").addParagraphProperty(new Indent(1440, 980));
+})
-abstractNum.createLevel(2, "lowerLetter", "%3)", "start").addParagraphProperty(new Indent(2160, 1700));
-
-const concrete = numbering.createConcreteNumbering(abstractNum);
 ```
 
-You can then apply your concrete style to paragraphs using the
+Each `config` entry includes the following properties:
-`setNumbering` method:
+
+. Each level includes the following properties:
+
+| Property  | Type              | Notes    | Possible Values                                                                                                                                                        |
+| --------- | ----------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| reference | `string`          | Required | A unique `string`                                                                                                                                                      |
+| levels    | `ILevelOptions[]` | Required | a series of _levels_ which form a sequence starting at 0 indicating the top-level list look and increasing from there to describe the sublists, then sub-sublists, etc |
+
+### Level Options
+
+Levels define the numbering definition itself, what it looks like, the indention, the alignment and the style. The reason why it is an array is because it allows the ability to create sub-lists. A sub list will have a different configuration because you may want the sub-list to have a different indentation or different bullet.
+
+| Property  | Type          | Notes    | Possible Values                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| --------- | ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| level     | `number`      | Required | The list level this definition is for. `0` is for the root level, `1` is for a sub list, `2` is for a sub-sub-list etc.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| format    | `LevelFormat` | Optional | `DECIMAL`, `UPPER_ROMAN`, `LOWER_ROMAN`, `UPPER_LETTER`, `LOWER_LETTER`, `ORDINAL`, `CARDINAL_TEXT`, `ORDINAL_TEXT`, `HEX`, `CHICAGO`, `IDEOGRAPH__DIGITAL`, `JAPANESE_COUNTING`, `AIUEO`, `IROHA`, `DECIMAL_FULL_WIDTH`, `DECIMAL_HALF_WIDTH`, `JAPANESE_LEGAL`, `JAPANESE_DIGITAL_TEN_THOUSAND`, `DECIMAL_ENCLOSED_CIRCLE`, `DECIMAL_FULL_WIDTH2`, `AIUEO_FULL_WIDTH`, `IROHA_FULL_WIDTH`, `DECIMAL_ZERO`, `BULLET`, `GANADA`, `CHOSUNG`, `DECIMAL_ENCLOSED_FULLSTOP`, `DECIMAL_ENCLOSED_PARENTHESES`, `DECIMAL_ENCLOSED_CIRCLE_CHINESE`, `IDEOGRAPH_ENCLOSED_CIRCLE`, `IDEOGRAPH_TRADITIONAL`, `IDEOGRAPH_ZODIAC`, `IDEOGRAPH_ZODIAC_TRADITIONAL`, `TAIWANESE_COUNTING`, `IDEOGRAPH_LEGAL_TRADITIONAL`, `TAIWANESE_COUNTING_THOUSAND`, `TAIWANESE_DIGITAL`, `CHINESE_COUNTING`, `CHINESE_LEGAL_SIMPLIFIED`, `CHINESE_COUNTING_THOUSAND`, `KOREAN_DIGITAL`, `KOREAN_COUNTING`, `KOREAN_LEGAL`, `KOREAN_DIGITAL2`, `VIETNAMESE_COUNTING`, `RUSSIAN_LOWER`, `RUSSIAN_UPPER`, `NONE`, `NUMBER_IN_DASH`, `HEBREW1`, `HEBREW2`, `ARABIC_ALPHA`, `ARABIC_ABJAD`, `HINDI_VOWELS`, `HINDI_CONSONANTS`, `HINDI_NUMBERS`, `HINDI_COUNTING`, `THAI_LETTERS`, `THAI_NUMBERS`, `THAI_COUNTING`, `BAHT_TEXT`, `DOLLAR_TEXT`, `CUSTOM` |
+| text      | `string`      | Optional | A unique `string` to describe the shape of the bullet                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| alignment | `string`      | Required | `START`, `CENTER`, `END`, `BOTH`, `MEDIUM_KASHIDA`, `DISTRIBUTE`, `NUM_TAB`, `HIGH_KASHIDA`, `LOW_KASHIDA`, `THAI_DISTRIBUTE`, `LEFT`, `RIGHT`, `JUSTIFIED`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| style     | `string`      | Optional | [Sections](usage/styling-with-js.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+
+## Using ordered lists in `docx`
+
+Add a `numbering` section to the `Document` to numbering style, define your levels. Use `LevelFormat.UPPER_ROMAN` for the `format` in `levels`:
 
 ```ts
-topLevelP.setNumbering(concrete, 0);
+const doc = new Document({
-subP.setNumbering(concrete, 1);
+    ...
-subSubP.setNumbering(concrete, 2);
+    numbering: {
-```
+        config: [
-
+            {
-## Unindent numbering 
+                reference: "my-numbering",
-
+                levels: [
-Default:1.  test
+                    {
-
-After:1.test
-
-Use default numbering have indent,If you want unindent numbering
-
-How to custom number see the demo:
-https://runkit.com/dolanmiu/docx-demo3
-
-```ts
-
-enum LevelSuffix {
-    NOTHING = "nothing",
-    SPACE = "space",
-    TAB = "tab"
-}
-
-// custom numbering 
-const levels=[
-{
                         level: 0,
-    format: "decimal",
+                        format: LevelFormat.UPPER_ROMAN,
-    text: "%1.",
+                        text: "%1",
                         alignment: AlignmentType.START,
-    suffix: LevelSuffix.NOTHING,    // Cancel intent
+                        style: {
-}]
+                            paragraph: {
-    
+                                indent: { left: 2880, hanging: 2420 },
+                            },
+                        },
+                    },
+                    ...
+                ],
+            },
+        ],
+    },
+    ...
+});
 ```
+
+And then on a `Paragraph`, we can add use the numbering created:
+
+```ts
+new Paragraph({
+    text: "Hey you!",
+    numbering: {
+        reference: "my-numbering",
+        level: 0,
+    },
+}),
+```
+
+## Un-ordered lists / Bullet points
+
+Add a `numbering` section to the `Document` to numbering style, define your levels. Use `LevelFormat.BULLET` for the `format` in `levels`:
+
+```ts
+const doc = new Document({
+    ...
+    numbering: {
+        config: [
+            {
+                reference: "my-bullet-points",
+                levels: [
+                    {
+                        level: 0,
+                        format: LevelFormat.BULLET,
+                        text: "\u1F60",
+                        alignment: AlignmentType.LEFT,
+                        style: {
+                            paragraph: {
+                                indent: { left: convertInchesToTwip(0.5), hanging: convertInchesToTwip(0.25) },
+                            },
+                        },
+                    },
+                ],
+            },
+        ],
+    },
+    ...
+});
+```
+
+And then on a `Paragraph`, we can add use the numbering created:
+
+```ts
+new Paragraph({
+    text: "Hey you!",
+    numbering: {
+        reference: "my-bullet-points",
+        level: 0,
+    },
+}),
+```
+
+## Full Example
+
+[Example](https://raw.githubusercontent.com/dolanmiu/docx/master/demo/3-numbering-and-bullet-points.ts ":include")
+
+_Source: https://github.com/dolanmiu/docx/blob/master/demo/3-numbering-and-bullet-points.ts_

docs/usage/styling-with-xml.md

@@ -9,11 +9,16 @@
     ![image](https://user-images.githubusercontent.com/2917613/41195113-65edebfa-6c1f-11e8-97b4-77de2d60044a.png)
     ![image](https://user-images.githubusercontent.com/2917613/41195126-ca99c36c-6c1f-11e8-9e58-19e5f69b3b87.png)
 
+    *Note*: Font and color selection from the theme are currently not supported.
+
 3.  You can even create a totally new `Style`:
 
     ![image](https://user-images.githubusercontent.com/2917613/41195135-f0f7862a-6c1f-11e8-8be4-dd6d8fe5be03.png)
     ![image](https://user-images.githubusercontent.com/2917613/41195139-0ec52130-6c20-11e8-8fae-f6b44b43fdf8.png)
 
+    *Note*: When selecting the style type, it is important to consider the component being used.
+
+
 4.  Save
 5.  Re-name the saved `.docx` file to `.zip` and un-zip
 6.  Find `styles.xml`

package.json

@@ -1,17 +1,17 @@
 {
     "name": "docx",
-    "version": "8.2.2",
+    "version": "8.4.0",
     "description": "Easily generate .docx files with JS/TS with a nice declarative API. Works for Node and on the Browser.",
     "type": "module",
     "main": "build/index.umd.js",
-    "module": "./build/index.js",
+    "module": "./build/index.mjs",
     "types": "./build/index.d.ts",
     "exports": {
         ".": {
             "require": "./build/index.cjs",
             "types": "./build/index.d.ts",
-            "import": "./build/index.js",
+            "import": "./build/index.mjs",
-            "default": "./build/index.js"
+            "default": "./build/index.mjs"
         }
     },
     "files": [
@@ -24,14 +24,14 @@
         "prepublishOnly": "npm run build --omit=dev",
         "lint": "eslint --ext .ts src",
         "predemo": "npm run build",
-        "demo": "ts-node --project demo/tsconfig.json ./demo/index.ts",
+        "demo": "tsx ./demo/index.ts",
         "typedoc": "typedoc src/index.ts --tsconfig tsconfig.typedoc.json",
         "style": "prettier -l \"{src,scripts,demo}/**/*.{ts,html}\"",
         "style.fix": "npm run style -- --write",
         "cspell": "cspell \"{src,demo,docs,scripts}/**/*.{ts,scss,html,md}\" && cspell \"./*.*\"",
         "serve.docs": "cd docs && docsify serve",
-        "extract": "ts-node scripts/extract-document.ts",
+        "extract": "tsx scripts/extract-document.ts",
-        "ts-node": "ts-node --project demo/tsconfig.json"
+        "run-ts": "tsx"
     },
     "pre-commit": [
         "style",
@@ -56,7 +56,7 @@
     "dependencies": {
         "@types/node": "^20.3.1",
         "jszip": "^3.10.1",
-        "nanoid": "^4.0.2",
+        "nanoid": "^5.0.4",
         "xml": "^1.0.1",
         "xml-js": "^1.6.8"
     },
@@ -67,36 +67,35 @@
     },
     "homepage": "https://docx.js.org",
     "devDependencies": {
-        "@esbuild/win32-x64": "^0.18.3",
         "@types/inquirer": "^9.0.3",
         "@types/prompt": "^1.1.1",
         "@types/unzipper": "^0.10.4",
         "@types/xml": "^1.0.8",
-        "@typescript-eslint/eslint-plugin": "^5.36.1",
+        "@typescript-eslint/eslint-plugin": "^6.9.1",
-        "@typescript-eslint/parser": "^5.36.1",
+        "@typescript-eslint/parser": "^6.9.1",
-        "@vitest/coverage-v8": "^0.33.0",
+        "@vitest/coverage-v8": "^0.34.6",
         "@vitest/ui": "^0.33.0",
-        "cspell": "^6.2.2",
+        "cspell": "^7.3.8",
         "docsify-cli": "^4.3.0",
         "eslint": "^8.23.0",
-        "eslint-plugin-functional": "^5.0.8",
+        "eslint-plugin-functional": "^6.0.0",
         "eslint-plugin-import": "^2.26.0",
         "eslint-plugin-jsdoc": "^46.2.6",
         "eslint-plugin-no-null": "^1.0.2",
         "eslint-plugin-prefer-arrow": "^1.2.3",
-        "eslint-plugin-unicorn": "^47.0.0",
+        "eslint-plugin-unicorn": "^50.0.1",
-        "execa": "^7.1.1",
+        "execa": "^8.0.1",
         "glob": "^10.2.7",
         "inquirer": "^9.2.7",
         "jsdom": "^22.1.0",
         "pre-commit": "^1.2.2",
-        "prettier": "^2.3.1",
+        "prettier": "^3.0.0",
-        "ts-node": "^10.2.1",
         "tsconfig-paths": "^4.0.0",
+        "tsx": "^4.7.0",
         "typedoc": "^0.24.8",
         "typescript": "5.1.6",
         "unzipper": "^0.10.11",
-        "vite": "^4.3.2",
+        "vite": "^5.0.10",
         "vite-plugin-dts": "^3.3.1",
         "vite-plugin-node-polyfills": "^0.9.0",
         "vite-tsconfig-paths": "^4.2.0",

src/export/packer/next-compiler.ts

@@ -44,7 +44,7 @@ export class Compiler {
         this.numberingReplacer = new NumberingReplacer();
     }
 
-    public compile(file: File, prettifyXml?: PrettifyType): JSZip {
+    public compile(file: File, prettifyXml?: (typeof PrettifyType)[keyof typeof PrettifyType]): JSZip {
         const zip = new JSZip();
         const xmlifiedFileMapping = this.xmlifyFile(file, prettifyXml);
         const map = new Map<string, IXmlifyedFile | readonly IXmlifyedFile[]>(Object.entries(xmlifiedFileMapping));
@@ -66,7 +66,7 @@ export class Compiler {
         return zip;
     }
 
-    private xmlifyFile(file: File, prettify?: PrettifyType): IXmlifyedFileMapping {
+    private xmlifyFile(file: File, prettify?: (typeof PrettifyType)[keyof typeof PrettifyType]): IXmlifyedFileMapping {
         const documentRelationshipCount = file.Document.Relationships.RelationshipCount + 1;
 
         const documentXmlData = xml(

src/export/packer/packer.ts

@@ -6,18 +6,21 @@ import { Compiler } from "./next-compiler";
 /**
  * Use blanks to prettify
  */
-export enum PrettifyType {
+export const PrettifyType = {
-    NONE = "",
+    NONE: "",
-    WITH_2_BLANKS = "  ",
+    WITH_2_BLANKS: "  ",
-    WITH_4_BLANKS = "    ",
+    WITH_4_BLANKS: "    ",
-    WITH_TAB = "\t",
+    // eslint-disable-next-line @typescript-eslint/naming-convention
-}
+    WITH_TAB: "\t",
+} as const;
 
-const convertPrettifyType = (prettify?: boolean | PrettifyType): PrettifyType | undefined =>
+const convertPrettifyType = (
+    prettify?: boolean | (typeof PrettifyType)[keyof typeof PrettifyType],
+): (typeof PrettifyType)[keyof typeof PrettifyType] | undefined =>
     prettify === true ? PrettifyType.WITH_2_BLANKS : prettify === false ? undefined : prettify;
 
 export class Packer {
-    public static async toString(file: File, prettify?: boolean | PrettifyType): Promise<string> {
+    public static async toString(file: File, prettify?: boolean | (typeof PrettifyType)[keyof typeof PrettifyType]): Promise<string> {
         const zip = this.compiler.compile(file, convertPrettifyType(prettify));
         const zipData = await zip.generateAsync({
             type: "string",
@@ -28,7 +31,7 @@ export class Packer {
         return zipData;
     }
 
-    public static async toBuffer(file: File, prettify?: boolean | PrettifyType): Promise<Buffer> {
+    public static async toBuffer(file: File, prettify?: boolean | (typeof PrettifyType)[keyof typeof PrettifyType]): Promise<Buffer> {
         const zip = this.compiler.compile(file, convertPrettifyType(prettify));
         const zipData = await zip.generateAsync({
             type: "nodebuffer",
@@ -39,7 +42,7 @@ export class Packer {
         return zipData;
     }
 
-    public static async toBase64String(file: File, prettify?: boolean | PrettifyType): Promise<string> {
+    public static async toBase64String(file: File, prettify?: boolean | (typeof PrettifyType)[keyof typeof PrettifyType]): Promise<string> {
         const zip = this.compiler.compile(file, convertPrettifyType(prettify));
         const zipData = await zip.generateAsync({
             type: "base64",
@@ -50,7 +53,7 @@ export class Packer {
         return zipData;
     }
 
-    public static async toBlob(file: File, prettify?: boolean | PrettifyType): Promise<Blob> {
+    public static async toBlob(file: File, prettify?: boolean | (typeof PrettifyType)[keyof typeof PrettifyType]): Promise<Blob> {
         const zip = this.compiler.compile(file, convertPrettifyType(prettify));
         const zipData = await zip.generateAsync({
             type: "blob",
@@ -61,7 +64,7 @@ export class Packer {
         return zipData;
     }
 
-    public static toStream(file: File, prettify?: boolean | PrettifyType): Stream {
+    public static toStream(file: File, prettify?: boolean | (typeof PrettifyType)[keyof typeof PrettifyType]): Stream {
         const stream = new Stream();
         const zip = this.compiler.compile(file, convertPrettifyType(prettify));
 

src/file/border/border.ts

@@ -23,7 +23,7 @@ import { XmlAttributeComponent, XmlComponent } from "@file/xml-components";
 import { eighthPointMeasureValue, hexColorValue, pointMeasureValue } from "@util/values";
 
 export interface IBorderOptions {
-    readonly style: BorderStyle;
+    readonly style: (typeof BorderStyle)[keyof typeof BorderStyle];
     /** Border color, in hex (eg 'FF00AA') */
     readonly color?: string;
     /** Size of the border in 1/8 pt */
@@ -55,32 +55,34 @@ class BordersAttributes extends XmlAttributeComponent<IBorderOptions> {
     };
 }
 
-export enum BorderStyle {
+/* eslint-disable @typescript-eslint/naming-convention */
-    SINGLE = "single",
+export const BorderStyle = {
-    DASH_DOT_STROKED = "dashDotStroked",
+    SINGLE: "single",
-    DASHED = "dashed",
+    DASH_DOT_STROKED: "dashDotStroked",
-    DASH_SMALL_GAP = "dashSmallGap",
+    DASHED: "dashed",
-    DOT_DASH = "dotDash",
+    DASH_SMALL_GAP: "dashSmallGap",
-    DOT_DOT_DASH = "dotDotDash",
+    DOT_DASH: "dotDash",
-    DOTTED = "dotted",
+    DOT_DOT_DASH: "dotDotDash",
-    DOUBLE = "double",
+    DOTTED: "dotted",
-    DOUBLE_WAVE = "doubleWave",
+    DOUBLE: "double",
-    INSET = "inset",
+    DOUBLE_WAVE: "doubleWave",
-    NIL = "nil",
+    INSET: "inset",
-    NONE = "none",
+    NIL: "nil",
-    OUTSET = "outset",
+    NONE: "none",
-    THICK = "thick",
+    OUTSET: "outset",
-    THICK_THIN_LARGE_GAP = "thickThinLargeGap",
+    THICK: "thick",
-    THICK_THIN_MEDIUM_GAP = "thickThinMediumGap",
+    THICK_THIN_LARGE_GAP: "thickThinLargeGap",
-    THICK_THIN_SMALL_GAP = "thickThinSmallGap",
+    THICK_THIN_MEDIUM_GAP: "thickThinMediumGap",
-    THIN_THICK_LARGE_GAP = "thinThickLargeGap",
+    THICK_THIN_SMALL_GAP: "thickThinSmallGap",
-    THIN_THICK_MEDIUM_GAP = "thinThickMediumGap",
+    THIN_THICK_LARGE_GAP: "thinThickLargeGap",
-    THIN_THICK_SMALL_GAP = "thinThickSmallGap",
+    THIN_THICK_MEDIUM_GAP: "thinThickMediumGap",
-    THIN_THICK_THIN_LARGE_GAP = "thinThickThinLargeGap",
+    THIN_THICK_SMALL_GAP: "thinThickSmallGap",
-    THIN_THICK_THIN_MEDIUM_GAP = "thinThickThinMediumGap",
+    THIN_THICK_THIN_LARGE_GAP: "thinThickThinLargeGap",
-    THIN_THICK_THIN_SMALL_GAP = "thinThickThinSmallGap",
+    THIN_THICK_THIN_MEDIUM_GAP: "thinThickThinMediumGap",
-    THREE_D_EMBOSS = "threeDEmboss",
+    THIN_THICK_THIN_SMALL_GAP: "thinThickThinSmallGap",
-    THREE_D_ENGRAVE = "threeDEngrave",
+    THREE_D_EMBOSS: "threeDEmboss",
-    TRIPLE = "triple",
+    THREE_D_ENGRAVE: "threeDEngrave",
-    WAVE = "wave",
+    TRIPLE: "triple",
-}
+    WAVE: "wave",
+} as const;
+/* eslint-enable */

src/file/core-properties/properties.ts

@@ -39,6 +39,7 @@ export interface IPropertiesOptions {
     readonly compatibility?: ICompatibilityOptions;
     readonly customProperties?: readonly ICustomPropertyOptions[];
     readonly evenAndOddHeaderAndFooters?: boolean;
+    readonly defaultTabStop?: number;
 }
 
 // <xs:element name="coreProperties" type="CT_CoreProperties"/>

src/file/document/body/section-properties/properties/doc-grid.ts

@@ -17,14 +17,17 @@ import { decimalNumber } from "@util/values";
 //     <xsd:attribute name="charSpace" type="ST_DecimalNumber"/>
 // </xsd:complexType>
 
-export enum DocumentGridType {
+/* eslint-disable @typescript-eslint/naming-convention */
-    DEFAULT = "default",
+export const DocumentGridType = {
-    LINES = "lines",
+    DEFAULT: "default",
-    LINES_AND_CHARS = "linesAndChars",
+    LINES: "lines",
-    SNAP_TO_CHARS = "snapToChars",
+    LINES_AND_CHARS: "linesAndChars",
-}
+    SNAP_TO_CHARS: "snapToChars",
+} as const;
+
+/* eslint-enable */
 export interface IDocGridAttributesProperties {
-    readonly type?: DocumentGridType;
+    readonly type?: (typeof DocumentGridType)[keyof typeof DocumentGridType];
     readonly linePitch?: number;
     readonly charSpace?: number;
 }
@@ -38,7 +41,7 @@ export class DocGridAttributes extends XmlAttributeComponent<IDocGridAttributesP
 }
 
 export class DocumentGrid extends XmlComponent {
-    public constructor(linePitch: number, charSpace?: number, type?: DocumentGridType) {
+    public constructor(linePitch: number, charSpace?: number, type?: (typeof DocumentGridType)[keyof typeof DocumentGridType]) {
         super("w:docGrid");
 
         this.root.push(

src/file/document/body/section-properties/properties/header-footer-reference.ts

@@ -7,11 +7,11 @@ import { XmlAttributeComponent, XmlComponent } from "@file/xml-components";
 //   <xsd:enumeration value="first"/>
 // </xsd:restriction>
 // </xsd:simpleType>
-export enum HeaderFooterReferenceType {
+export const HeaderFooterReferenceType = {
-    DEFAULT = "default",
+    DEFAULT: "default",
-    FIRST = "first",
+    FIRST: "first",
-    EVEN = "even",
+    EVEN: "even",
-}
+} as const;
 
 // </xsd:complexType>
 // <xsd:group name="EG_HdrFtrReferences">
@@ -33,12 +33,12 @@ export enum HeaderFooterReferenceType {
 // </xsd:complexType>
 
 export interface IHeaderFooterOptions {
-    readonly type?: HeaderFooterReferenceType;
+    readonly type?: (typeof HeaderFooterReferenceType)[keyof typeof HeaderFooterReferenceType];
     readonly id?: number;
 }
 
 class FooterReferenceAttributes extends XmlAttributeComponent<{
-    readonly type: HeaderFooterReferenceType;
+    readonly type: (typeof HeaderFooterReferenceType)[keyof typeof HeaderFooterReferenceType];
     readonly id: string;
 }> {
     protected readonly xmlKeys = {
@@ -47,12 +47,13 @@ class FooterReferenceAttributes extends XmlAttributeComponent<{
     };
 }
 
-export enum HeaderFooterType {
+export const HeaderFooterType = {
-    HEADER = "w:headerReference",
+    HEADER: "w:headerReference",
-    FOOTER = "w:footerReference",
+    FOOTER: "w:footerReference",
-}
+} as const;
+
 export class HeaderFooterReference extends XmlComponent {
-    public constructor(type: HeaderFooterType, options: IHeaderFooterOptions) {
+    public constructor(type: (typeof HeaderFooterType)[keyof typeof HeaderFooterType], options: IHeaderFooterOptions) {
         super(type);
 
         this.root.push(

src/file/document/body/section-properties/properties/line-number.ts

@@ -9,11 +9,14 @@ import { decimalNumber, PositiveUniversalMeasure, twipsMeasureValue } from "@uti
 //   <xsd:enumeration value="continuous"/>
 // </xsd:restriction>
 // </xsd:simpleType>
-export enum LineNumberRestartFormat {
+
-    NEW_PAGE = "newPage",
+/* eslint-disable @typescript-eslint/naming-convention */
-    NEW_SECTION = "newSection",
+export const LineNumberRestartFormat = {
-    CONTINUOUS = "continuous",
+    NEW_PAGE: "newPage",
-}
+    NEW_SECTION: "newSection",
+    CONTINUOUS: "continuous",
+} as const;
+/* eslint-enable */
 
 // <xsd:complexType name="CT_LineNumber">
 //     <xsd:attribute name="countBy" type="ST_DecimalNumber" use="optional"/>
@@ -25,7 +28,7 @@ export enum LineNumberRestartFormat {
 export interface ILineNumberAttributes {
     readonly countBy?: number;
     readonly start?: number;
-    readonly restart?: LineNumberRestartFormat;
+    readonly restart?: (typeof LineNumberRestartFormat)[keyof typeof LineNumberRestartFormat];
     readonly distance?: number | PositiveUniversalMeasure;
 }
 
@@ -36,13 +39,16 @@ export class LineNumberType extends XmlComponent {
             new NextAttributeComponent<{
                 readonly countBy?: number;
                 readonly start?: number;
-                readonly restart?: LineNumberRestartFormat;
+                readonly restart?: (typeof LineNumberRestartFormat)[keyof typeof LineNumberRestartFormat];
                 readonly distance?: number | PositiveUniversalMeasure;
             }>({
                 countBy: { key: "w:countBy", value: countBy === undefined ? undefined : decimalNumber(countBy) },
                 start: { key: "w:start", value: start === undefined ? undefined : decimalNumber(start) },
                 restart: { key: "w:restart", value: restart },
-                distance: { key: "w:distance", value: distance === undefined ? undefined : twipsMeasureValue(distance) },
+                distance: {
+                    key: "w:distance",
+                    value: distance === undefined ? undefined : twipsMeasureValue(distance),
+                },
             }),
         );
     }

src/file/document/body/section-properties/properties/page-borders.ts

@@ -9,11 +9,14 @@ import { IgnoreIfEmptyXmlComponent, XmlAttributeComponent } from "@file/xml-comp
 //   <xsd:enumeration value="notFirstPage"/>
 // </xsd:restriction>
 // </xsd:simpleType>
-export enum PageBorderDisplay {
+
-    ALL_PAGES = "allPages",
+/* eslint-disable @typescript-eslint/naming-convention */
-    FIRST_PAGE = "firstPage",
+export const PageBorderDisplay = {
-    NOT_FIRST_PAGE = "notFirstPage",
+    ALL_PAGES: "allPages",
-}
+    FIRST_PAGE: "firstPage",
+    NOT_FIRST_PAGE: "notFirstPage",
+} as const;
+/* eslint-enable */
 
 // <xsd:simpleType name="ST_PageBorderOffset">
 // <xsd:restriction base="xsd:string">
@@ -21,10 +24,10 @@ export enum PageBorderDisplay {
 //   <xsd:enumeration value="text"/>
 // </xsd:restriction>
 // </xsd:simpleType>
-export enum PageBorderOffsetFrom {
+export const PageBorderOffsetFrom = {
-    PAGE = "page",
+    PAGE: "page",
-    TEXT = "text",
+    TEXT: "text",
-}
+} as const;
 
 // <xsd:simpleType name="ST_PageBorderZOrder">
 // <xsd:restriction base="xsd:string">
@@ -32,15 +35,15 @@ export enum PageBorderOffsetFrom {
 //   <xsd:enumeration value="back"/>
 // </xsd:restriction>
 // </xsd:simpleType>
-export enum PageBorderZOrder {
+export const PageBorderZOrder = {
-    BACK = "back",
+    BACK: "back",
-    FRONT = "front",
+    FRONT: "front",
-}
+} as const;
 
 export interface IPageBorderAttributes {
-    readonly display?: PageBorderDisplay;
+    readonly display?: (typeof PageBorderDisplay)[keyof typeof PageBorderDisplay];
-    readonly offsetFrom?: PageBorderOffsetFrom;
+    readonly offsetFrom?: (typeof PageBorderOffsetFrom)[keyof typeof PageBorderOffsetFrom];
-    readonly zOrder?: PageBorderZOrder;
+    readonly zOrder?: (typeof PageBorderZOrder)[keyof typeof PageBorderZOrder];
 }
 
 export interface IPageBordersOptions {

src/file/document/body/section-properties/properties/page-number.ts

@@ -12,18 +12,22 @@ import { decimalNumber } from "@util/values";
 //   <xsd:enumeration value="enDash"/>
 // </xsd:restriction>
 // </xsd:simpleType>
-export enum PageNumberSeparator {
+
-    HYPHEN = "hyphen",
+/* eslint-disable @typescript-eslint/naming-convention */
-    PERIOD = "period",
+export const PageNumberSeparator = {
-    COLON = "colon",
+    HYPHEN: "hyphen",
-    EM_DASH = "emDash",
+    PERIOD: "period",
-    EN_DASH = "endash",
+    COLON: "colon",
-}
+    EM_DASH: "emDash",
+    EN_DASH: "endash",
+} as const;
+
+/* eslint-enable */
 
 export interface IPageNumberTypeAttributes {
     readonly start?: number;
-    readonly formatType?: NumberFormat;
+    readonly formatType?: (typeof NumberFormat)[keyof typeof NumberFormat];
-    readonly separator?: PageNumberSeparator;
+    readonly separator?: (typeof PageNumberSeparator)[keyof typeof PageNumberSeparator];
 }
 
 // <xsd:complexType name="CT_PageNumber">
@@ -40,6 +44,7 @@ export class PageNumberTypeAttributes extends XmlAttributeComponent<IPageNumberT
         separator: "w:chapSep",
     };
 }
+
 export class PageNumberType extends XmlComponent {
     public constructor({ start, formatType, separator }: IPageNumberTypeAttributes) {
         super("w:pgNumType");

src/file/document/body/section-properties/properties/page-size.ts

@@ -7,10 +7,10 @@ import { PositiveUniversalMeasure, twipsMeasureValue } from "@util/values";
 //   <xsd:enumeration value="landscape"/>
 // </xsd:restriction>
 // </xsd:simpleType>
-export enum PageOrientation {
+export const PageOrientation = {
-    PORTRAIT = "portrait",
+    PORTRAIT: "portrait",
-    LANDSCAPE = "landscape",
+    LANDSCAPE: "landscape",
-}
+} as const;
 
 // <xsd:complexType name="CT_PageSz">
 //     <xsd:attribute name="w" type="s:ST_TwipsMeasure"/>
@@ -21,11 +21,15 @@ export enum PageOrientation {
 export type IPageSizeAttributes = {
     readonly width?: number | PositiveUniversalMeasure;
     readonly height?: number | PositiveUniversalMeasure;
-    readonly orientation?: PageOrientation;
+    readonly orientation?: (typeof PageOrientation)[keyof typeof PageOrientation];
 };
 
 export class PageSize extends XmlComponent {
-    public constructor(width: number | PositiveUniversalMeasure, height: number | PositiveUniversalMeasure, orientation: PageOrientation) {
+    public constructor(
+        width: number | PositiveUniversalMeasure,
+        height: number | PositiveUniversalMeasure,
+        orientation: (typeof PageOrientation)[keyof typeof PageOrientation],
+    ) {
         super("w:pgSz");
 
         const flip = orientation === PageOrientation.LANDSCAPE;

src/file/document/body/section-properties/properties/page-text-direction.ts

@@ -1,16 +1,21 @@
 import { XmlAttributeComponent, XmlComponent } from "@file/xml-components";
 
-export enum PageTextDirectionType {
+/* eslint-disable @typescript-eslint/naming-convention */
-    LEFT_TO_RIGHT_TOP_TO_BOTTOM = "lrTb",
+export const PageTextDirectionType = {
-    TOP_TO_BOTTOM_RIGHT_TO_LEFT = "tbRl",
+    LEFT_TO_RIGHT_TOP_TO_BOTTOM: "lrTb",
-}
+    TOP_TO_BOTTOM_RIGHT_TO_LEFT: "tbRl",
+} as const;
 
-class PageTextDirectionAttributes extends XmlAttributeComponent<{ readonly val: PageTextDirectionType }> {
+/* eslint-enable */
+
+class PageTextDirectionAttributes extends XmlAttributeComponent<{
+    readonly val: (typeof PageTextDirectionType)[keyof typeof PageTextDirectionType];
+}> {
     protected readonly xmlKeys = { val: "w:val" };
 }
 
 export class PageTextDirection extends XmlComponent {
-    public constructor(value: PageTextDirectionType) {
+    public constructor(value: (typeof PageTextDirectionType)[keyof typeof PageTextDirectionType]) {
         super("w:textDirection");
 
         this.root.push(

src/file/document/body/section-properties/properties/section-type.ts

@@ -10,19 +10,22 @@ import { XmlAttributeComponent, XmlComponent } from "@file/xml-components";
 //   <xsd:enumeration value="oddPage"/>
 // </xsd:restriction>
 // </xsd:simpleType>
-export enum SectionType {
+
-    NEXT_PAGE = "nextPage",
+/* eslint-disable @typescript-eslint/naming-convention */
-    NEXT_COLUMN = "nextColumn",
+export const SectionType = {
-    CONTINUOUS = "continuous",
+    NEXT_PAGE: "nextPage",
-    EVEN_PAGE = "evenPage",
+    NEXT_COLUMN: "nextColumn",
-    ODD_PAGE = "oddPage",
+    CONTINUOUS: "continuous",
-}
+    EVEN_PAGE: "evenPage",
+    ODD_PAGE: "oddPage",
+} as const;
+/* eslint-enable */
 
 // <xsd:complexType name="CT_SectType">
 //     <xsd:attribute name="val" type="ST_SectionMark"/>
 // </xsd:complexType>
 export class SectionTypeAttributes extends XmlAttributeComponent<{
-    readonly val: SectionType;
+    readonly val: (typeof SectionType)[keyof typeof SectionType];
 }> {
     protected readonly xmlKeys = {
         val: "w:val",
@@ -30,7 +33,7 @@ export class SectionTypeAttributes extends XmlAttributeComponent<{
 }
 
 export class Type extends XmlComponent {
-    public constructor(value: SectionType) {
+    public constructor(value: (typeof SectionType)[keyof typeof SectionType]) {
         super("w:type");
         this.root.push(new SectionTypeAttributes({ val: value }));
     }

src/file/document/body/section-properties/section-properties.ts

@@ -5,7 +5,6 @@ import { FooterWrapper } from "@file/footer-wrapper";
 import { HeaderWrapper } from "@file/header-wrapper";
 import { VerticalAlign, VerticalAlignElement } from "@file/vertical-align";
 import { OnOffElement, XmlComponent } from "@file/xml-components";
-import { PositiveUniversalMeasure, UniversalMeasure } from "@util/values";
 
 import { HeaderFooterReference, HeaderFooterReferenceType, HeaderFooterType } from "./properties/header-footer-reference";
 import { Columns, IColumnsAttributes } from "./properties/columns";
@@ -30,16 +29,16 @@ export interface ISectionPropertiesOptions {
         readonly margin?: IPageMarginAttributes;
         readonly pageNumbers?: IPageNumberTypeAttributes;
         readonly borders?: IPageBordersOptions;
-        readonly textDirection?: PageTextDirectionType;
+        readonly textDirection?: (typeof PageTextDirectionType)[keyof typeof PageTextDirectionType];
     };
     readonly grid?: IDocGridAttributesProperties;
     readonly headerWrapperGroup?: IHeaderFooterGroup<HeaderWrapper>;
     readonly footerWrapperGroup?: IHeaderFooterGroup<FooterWrapper>;
     readonly lineNumbers?: ILineNumberAttributes;
     readonly titlePage?: boolean;
-    readonly verticalAlign?: VerticalAlign;
+    readonly verticalAlign?: (typeof VerticalAlign)[keyof typeof VerticalAlign];
     readonly column?: IColumnsAttributes;
-    readonly type?: SectionType;
+    readonly type?: (typeof SectionType)[keyof typeof SectionType];
 }
 
 // <xsd:complexType name="CT_SectPr">
@@ -76,10 +75,10 @@ export interface ISectionPropertiesOptions {
 // </xsd:group>
 
 export const sectionMarginDefaults = {
-    TOP: "1in" as UniversalMeasure,
+    TOP: 1440,
-    RIGHT: "1in" as PositiveUniversalMeasure,
+    RIGHT: 1440,
-    BOTTOM: "1in" as UniversalMeasure,
+    BOTTOM: 1440,
-    LEFT: "1in" as PositiveUniversalMeasure,
+    LEFT: 1440,
     HEADER: 708,
     FOOTER: 708,
     GUTTER: 0,
@@ -163,7 +162,7 @@ export class SectionProperties extends XmlComponent {
     }
 
     private addHeaderFooterGroup(
-        type: HeaderFooterType,
+        type: (typeof HeaderFooterType)[keyof typeof HeaderFooterType],
         group: IHeaderFooterGroup<HeaderWrapper> | IHeaderFooterGroup<FooterWrapper>,
     ): void {
         if (group.default) {

src/file/document/document.ts

@@ -80,6 +80,7 @@ export class Document extends XmlComponent {
     }
 
     public add(item: Paragraph | Table | TableOfContents | ConcreteHyperlink): Document {
+        // eslint-disable-next-line functional/immutable-data
         this.body.push(item);
         return this;
     }

src/file/drawing/floating/align.ts

@@ -3,7 +3,11 @@ import { HorizontalPositionAlign, VerticalPositionAlign } from "@file/shared/ali
 import { XmlComponent } from "@file/xml-components";
 
 export class Align extends XmlComponent {
-    public constructor(value: HorizontalPositionAlign | VerticalPositionAlign) {
+    public constructor(
+        value:
+            | (typeof HorizontalPositionAlign)[keyof typeof HorizontalPositionAlign]
+            | (typeof VerticalPositionAlign)[keyof typeof VerticalPositionAlign],
+    ) {
         super("wp:align");
         this.root.push(value);
     }

src/file/drawing/floating/floating-position.ts

@@ -4,37 +4,39 @@ import { HorizontalPositionAlign, VerticalPositionAlign } from "@file/shared/ali
 
 import { ITextWrapping } from "../text-wrap";
 
-export enum HorizontalPositionRelativeFrom {
+/* eslint-disable @typescript-eslint/naming-convention */
-    CHARACTER = "character",
+export const HorizontalPositionRelativeFrom = {
-    COLUMN = "column",
+    CHARACTER: "character",
-    INSIDE_MARGIN = "insideMargin",
+    COLUMN: "column",
-    LEFT_MARGIN = "leftMargin",
+    INSIDE_MARGIN: "insideMargin",
-    MARGIN = "margin",
+    LEFT_MARGIN: "leftMargin",
-    OUTSIDE_MARGIN = "outsideMargin",
+    MARGIN: "margin",
-    PAGE = "page",
+    OUTSIDE_MARGIN: "outsideMargin",
-    RIGHT_MARGIN = "rightMargin",
+    PAGE: "page",
-}
+    RIGHT_MARGIN: "rightMargin",
+} as const;
 
-export enum VerticalPositionRelativeFrom {
+export const VerticalPositionRelativeFrom = {
-    BOTTOM_MARGIN = "bottomMargin",
+    BOTTOM_MARGIN: "bottomMargin",
-    INSIDE_MARGIN = "insideMargin",
+    INSIDE_MARGIN: "insideMargin",
-    LINE = "line",
+    LINE: "line",
-    MARGIN = "margin",
+    MARGIN: "margin",
-    OUTSIDE_MARGIN = "outsideMargin",
+    OUTSIDE_MARGIN: "outsideMargin",
-    PAGE = "page",
+    PAGE: "page",
-    PARAGRAPH = "paragraph",
+    PARAGRAPH: "paragraph",
-    TOP_MARGIN = "topMargin",
+    TOP_MARGIN: "topMargin",
-}
+} as const;
 
+/* eslint-enable */
 export interface IHorizontalPositionOptions {
-    readonly relative?: HorizontalPositionRelativeFrom;
+    readonly relative?: (typeof HorizontalPositionRelativeFrom)[keyof typeof HorizontalPositionRelativeFrom];
-    readonly align?: HorizontalPositionAlign;
+    readonly align?: (typeof HorizontalPositionAlign)[keyof typeof HorizontalPositionAlign];
     readonly offset?: number;
 }
 
 export interface IVerticalPositionOptions {
-    readonly relative?: VerticalPositionRelativeFrom;
+    readonly relative?: (typeof VerticalPositionRelativeFrom)[keyof typeof VerticalPositionRelativeFrom];
-    readonly align?: VerticalPositionAlign;
+    readonly align?: (typeof VerticalPositionAlign)[keyof typeof VerticalPositionAlign];
     readonly offset?: number;
 }
 

src/file/drawing/floating/horizontal-position.ts

@@ -5,7 +5,7 @@ import { HorizontalPositionRelativeFrom, IHorizontalPositionOptions } from "./fl
 import { PositionOffset } from "./position-offset";
 
 class HorizontalPositionAttributes extends XmlAttributeComponent<{
-    readonly relativeFrom: HorizontalPositionRelativeFrom;
+    readonly relativeFrom: (typeof HorizontalPositionRelativeFrom)[keyof typeof HorizontalPositionRelativeFrom];
 }> {
     protected readonly xmlKeys = {
         relativeFrom: "relativeFrom",

src/file/drawing/floating/vertical-position.ts

@@ -5,7 +5,7 @@ import { IVerticalPositionOptions, VerticalPositionRelativeFrom } from "./floati
 import { PositionOffset } from "./position-offset";
 
 class VerticalPositionAttributes extends XmlAttributeComponent<{
-    readonly relativeFrom: VerticalPositionRelativeFrom;
+    readonly relativeFrom: (typeof VerticalPositionRelativeFrom)[keyof typeof VerticalPositionRelativeFrom];
 }> {
     protected readonly xmlKeys = {
         relativeFrom: "relativeFrom",

src/file/drawing/text-wrap/text-wrapping.ts

@@ -1,22 +1,25 @@
 // http://officeopenxml.com/drwPicFloating-textWrap.php
 import { IDistance } from "../drawing";
 
-export enum TextWrappingType {
+/* eslint-disable @typescript-eslint/naming-convention */
-    NONE,
+export const TextWrappingType = {
-    SQUARE,
+    NONE: 0,
-    TIGHT,
+    SQUARE: 1,
-    TOP_AND_BOTTOM,
+    TIGHT: 2,
-}
+    TOP_AND_BOTTOM: 3,
+} as const;
 
-export enum TextWrappingSide {
+export const TextWrappingSide = {
-    BOTH_SIDES = "bothSides",
+    BOTH_SIDES: "bothSides",
-    LEFT = "left",
+    LEFT: "left",
-    RIGHT = "right",
+    RIGHT: "right",
-    LARGEST = "largest",
+    LARGEST: "largest",
-}
+} as const;
+
+/* eslint-enable */
 
 export interface ITextWrapping {
-    readonly type: TextWrappingType;
+    readonly type: (typeof TextWrappingType)[keyof typeof TextWrappingType];
-    readonly side?: TextWrappingSide;
+    readonly side?: (typeof TextWrappingSide)[keyof typeof TextWrappingSide];
     readonly margins?: IDistance;
 }

src/file/drawing/text-wrap/wrap-square.ts

@@ -6,7 +6,7 @@ import { IMargins } from "../floating";
 import { ITextWrapping, TextWrappingSide } from "./text-wrapping";
 
 interface IWrapSquareAttributes extends IDistance {
-    readonly wrapText?: TextWrappingSide;
+    readonly wrapText?: (typeof TextWrappingSide)[keyof typeof TextWrappingSide];
 }
 
 class WrapSquareAttributes extends XmlAttributeComponent<IWrapSquareAttributes> {

src/file/file.ts

@@ -77,6 +77,7 @@ export class File {
             evenAndOddHeaders: options.evenAndOddHeaderAndFooters ? true : false,
             trackRevisions: options.features?.trackRevisions,
             updateFields: options.features?.updateFields,
+            defaultTabStop: options.defaultTabStop,
         });
 
         this.media = new Media();
@@ -154,7 +155,10 @@ export class File {
         return wrapper;
     }
 
-    private addHeaderToDocument(header: HeaderWrapper, type: HeaderFooterReferenceType = HeaderFooterReferenceType.DEFAULT): void {
+    private addHeaderToDocument(
+        header: HeaderWrapper,
+        type: (typeof HeaderFooterReferenceType)[keyof typeof HeaderFooterReferenceType] = HeaderFooterReferenceType.DEFAULT,
+    ): void {
         // eslint-disable-next-line functional/immutable-data
         this.headers.push({ header, type });
         this.documentWrapper.Relationships.createRelationship(
@@ -165,7 +169,10 @@ export class File {
         this.contentTypes.addHeader(this.headers.length);
     }
 
-    private addFooterToDocument(footer: FooterWrapper, type: HeaderFooterReferenceType = HeaderFooterReferenceType.DEFAULT): void {
+    private addFooterToDocument(
+        footer: FooterWrapper,
+        type: (typeof HeaderFooterReferenceType)[keyof typeof HeaderFooterReferenceType] = HeaderFooterReferenceType.DEFAULT,
+    ): void {
         // eslint-disable-next-line functional/immutable-data
         this.footers.push({ footer, type });
         this.documentWrapper.Relationships.createRelationship(

src/file/footer-wrapper.ts

@@ -10,14 +10,18 @@ import { Table } from "./table";
 
 export interface IDocumentFooter {
     readonly footer: FooterWrapper;
-    readonly type: HeaderFooterReferenceType;
+    readonly type: (typeof HeaderFooterReferenceType)[keyof typeof HeaderFooterReferenceType];
 }
 
 export class FooterWrapper implements IViewWrapper {
     private readonly footer: Footer;
     private readonly relationships: Relationships;
 
-    public constructor(private readonly media: Media, referenceId: number, initContent?: XmlComponent) {
+    public constructor(
+        private readonly media: Media,
+        referenceId: number,
+        initContent?: XmlComponent,
+    ) {
         this.footer = new Footer(referenceId, initContent);
         this.relationships = new Relationships();
     }

src/file/footnotes/footnote/footnote.ts

@@ -4,14 +4,15 @@ import { XmlComponent } from "@file/xml-components";
 import { FootnoteAttributes } from "./footnote-attributes";
 import { FootnoteRefRun } from "./run/footnote-ref-run";
 
-export enum FootnoteType {
+export const FootnoteType = {
-    SEPERATOR = "separator",
+    SEPERATOR: "separator",
-    CONTINUATION_SEPERATOR = "continuationSeparator",
+    // eslint-disable-next-line @typescript-eslint/naming-convention
-}
+    CONTINUATION_SEPERATOR: "continuationSeparator",
+} as const;
 
 export interface IFootnoteOptions {
     readonly id: number;
-    readonly type?: FootnoteType;
+    readonly type?: (typeof FootnoteType)[keyof typeof FootnoteType];
     readonly children: readonly Paragraph[];
 }
 

src/file/header-wrapper.ts

@@ -10,14 +10,18 @@ import { Table } from "./table";
 
 export interface IDocumentHeader {
     readonly header: HeaderWrapper;
-    readonly type: HeaderFooterReferenceType;
+    readonly type: (typeof HeaderFooterReferenceType)[keyof typeof HeaderFooterReferenceType];
 }
 
 export class HeaderWrapper implements IViewWrapper {
     private readonly header: Header;
     private readonly relationships: Relationships;
 
-    public constructor(private readonly media: Media, referenceId: number, initContent?: XmlComponent) {
+    public constructor(
+        private readonly media: Media,
+        referenceId: number,
+        initContent?: XmlComponent,
+    ) {
         this.header = new Header(referenceId, initContent);
         this.relationships = new Relationships();
     }

src/file/numbering/level.ts

@@ -75,71 +75,75 @@ import { IRunStylePropertiesOptions, RunProperties } from "../paragraph/run/prop
 //         <xsd:enumeration value="custom"/>
 //     </xsd:restriction>
 // </xsd:simpleType>
-export enum LevelFormat {
+
-    DECIMAL = "decimal",
+/* eslint-disable @typescript-eslint/naming-convention */
-    UPPER_ROMAN = "upperRoman",
+export const LevelFormat = {
-    LOWER_ROMAN = "lowerRoman",
+    DECIMAL: "decimal",
-    UPPER_LETTER = "upperLetter",
+    UPPER_ROMAN: "upperRoman",
-    LOWER_LETTER = "lowerLetter",
+    LOWER_ROMAN: "lowerRoman",
-    ORDINAL = "ordinal",
+    UPPER_LETTER: "upperLetter",
-    CARDINAL_TEXT = "cardinalText",
+    LOWER_LETTER: "lowerLetter",
-    ORDINAL_TEXT = "ordinalText",
+    ORDINAL: "ordinal",
-    HEX = "hex",
+    CARDINAL_TEXT: "cardinalText",
-    CHICAGO = "chicago",
+    ORDINAL_TEXT: "ordinalText",
-    IDEOGRAPH__DIGITAL = "ideographDigital",
+    HEX: "hex",
-    JAPANESE_COUNTING = "japaneseCounting",
+    CHICAGO: "chicago",
-    AIUEO = "aiueo",
+    IDEOGRAPH__DIGITAL: "ideographDigital",
-    IROHA = "iroha",
+    JAPANESE_COUNTING: "japaneseCounting",
-    DECIMAL_FULL_WIDTH = "decimalFullWidth",
+    AIUEO: "aiueo",
-    DECIMAL_HALF_WIDTH = "decimalHalfWidth",
+    IROHA: "iroha",
-    JAPANESE_LEGAL = "japaneseLegal",
+    DECIMAL_FULL_WIDTH: "decimalFullWidth",
-    JAPANESE_DIGITAL_TEN_THOUSAND = "japaneseDigitalTenThousand",
+    DECIMAL_HALF_WIDTH: "decimalHalfWidth",
-    DECIMAL_ENCLOSED_CIRCLE = "decimalEnclosedCircle",
+    JAPANESE_LEGAL: "japaneseLegal",
-    DECIMAL_FULL_WIDTH2 = "decimalFullWidth2",
+    JAPANESE_DIGITAL_TEN_THOUSAND: "japaneseDigitalTenThousand",
-    AIUEO_FULL_WIDTH = "aiueoFullWidth",
+    DECIMAL_ENCLOSED_CIRCLE: "decimalEnclosedCircle",
-    IROHA_FULL_WIDTH = "irohaFullWidth",
+    DECIMAL_FULL_WIDTH2: "decimalFullWidth2",
-    DECIMAL_ZERO = "decimalZero",
+    AIUEO_FULL_WIDTH: "aiueoFullWidth",
-    BULLET = "bullet",
+    IROHA_FULL_WIDTH: "irohaFullWidth",
-    GANADA = "ganada",
+    DECIMAL_ZERO: "decimalZero",
-    CHOSUNG = "chosung",
+    BULLET: "bullet",
-    DECIMAL_ENCLOSED_FULLSTOP = "decimalEnclosedFullstop",
+    GANADA: "ganada",
-    DECIMAL_ENCLOSED_PARENTHESES = "decimalEnclosedParen",
+    CHOSUNG: "chosung",
-    DECIMAL_ENCLOSED_CIRCLE_CHINESE = "decimalEnclosedCircleChinese",
+    DECIMAL_ENCLOSED_FULLSTOP: "decimalEnclosedFullstop",
-    IDEOGRAPH_ENCLOSED_CIRCLE = "ideographEnclosedCircle",
+    DECIMAL_ENCLOSED_PARENTHESES: "decimalEnclosedParen",
-    IDEOGRAPH_TRADITIONAL = "ideographTraditional",
+    DECIMAL_ENCLOSED_CIRCLE_CHINESE: "decimalEnclosedCircleChinese",
-    IDEOGRAPH_ZODIAC = "ideographZodiac",
+    IDEOGRAPH_ENCLOSED_CIRCLE: "ideographEnclosedCircle",
-    IDEOGRAPH_ZODIAC_TRADITIONAL = "ideographZodiacTraditional",
+    IDEOGRAPH_TRADITIONAL: "ideographTraditional",
-    TAIWANESE_COUNTING = "taiwaneseCounting",
+    IDEOGRAPH_ZODIAC: "ideographZodiac",
-    IDEOGRAPH_LEGAL_TRADITIONAL = "ideographLegalTraditional",
+    IDEOGRAPH_ZODIAC_TRADITIONAL: "ideographZodiacTraditional",
-    TAIWANESE_COUNTING_THOUSAND = "taiwaneseCountingThousand",
+    TAIWANESE_COUNTING: "taiwaneseCounting",
-    TAIWANESE_DIGITAL = "taiwaneseDigital",
+    IDEOGRAPH_LEGAL_TRADITIONAL: "ideographLegalTraditional",
-    CHINESE_COUNTING = "chineseCounting",
+    TAIWANESE_COUNTING_THOUSAND: "taiwaneseCountingThousand",
-    CHINESE_LEGAL_SIMPLIFIED = "chineseLegalSimplified",
+    TAIWANESE_DIGITAL: "taiwaneseDigital",
-    CHINESE_COUNTING_THOUSAND = "chineseCountingThousand",
+    CHINESE_COUNTING: "chineseCounting",
-    KOREAN_DIGITAL = "koreanDigital",
+    CHINESE_LEGAL_SIMPLIFIED: "chineseLegalSimplified",
-    KOREAN_COUNTING = "koreanCounting",
+    CHINESE_COUNTING_THOUSAND: "chineseCountingThousand",
-    KOREAN_LEGAL = "koreanLegal",
+    KOREAN_DIGITAL: "koreanDigital",
-    KOREAN_DIGITAL2 = "koreanDigital2",
+    KOREAN_COUNTING: "koreanCounting",
-    VIETNAMESE_COUNTING = "vietnameseCounting",
+    KOREAN_LEGAL: "koreanLegal",
-    RUSSIAN_LOWER = "russianLower",
+    KOREAN_DIGITAL2: "koreanDigital2",
-    RUSSIAN_UPPER = "russianUpper",
+    VIETNAMESE_COUNTING: "vietnameseCounting",
-    NONE = "none",
+    RUSSIAN_LOWER: "russianLower",
-    NUMBER_IN_DASH = "numberInDash",
+    RUSSIAN_UPPER: "russianUpper",
-    HEBREW1 = "hebrew1",
+    NONE: "none",
-    HEBREW2 = "hebrew2",
+    NUMBER_IN_DASH: "numberInDash",
-    ARABIC_ALPHA = "arabicAlpha",
+    HEBREW1: "hebrew1",
-    ARABIC_ABJAD = "arabicAbjad",
+    HEBREW2: "hebrew2",
-    HINDI_VOWELS = "hindiVowels",
+    ARABIC_ALPHA: "arabicAlpha",
-    HINDI_CONSONANTS = "hindiConsonants",
+    ARABIC_ABJAD: "arabicAbjad",
-    HINDI_NUMBERS = "hindiNumbers",
+    HINDI_VOWELS: "hindiVowels",
-    HINDI_COUNTING = "hindiCounting",
+    HINDI_CONSONANTS: "hindiConsonants",
-    THAI_LETTERS = "thaiLetters",
+    HINDI_NUMBERS: "hindiNumbers",
-    THAI_NUMBERS = "thaiNumbers",
+    HINDI_COUNTING: "hindiCounting",
-    THAI_COUNTING = "thaiCounting",
+    THAI_LETTERS: "thaiLetters",
-    BAHT_TEXT = "bahtText",
+    THAI_NUMBERS: "thaiNumbers",
-    DOLLAR_TEXT = "dollarText",
+    THAI_COUNTING: "thaiCounting",
-    CUSTOM = "custom",
+    BAHT_TEXT: "bahtText",
-}
+    DOLLAR_TEXT: "dollarText",
+    CUSTOM: "custom",
+} as const;
+
+/* eslint-enable */
 
 class LevelAttributes extends XmlAttributeComponent<{
     readonly ilvl?: number;
@@ -182,7 +186,7 @@ class LevelText extends XmlComponent {
 }
 
 class LevelJc extends XmlComponent {
-    public constructor(value: AlignmentType) {
+    public constructor(value: (typeof AlignmentType)[keyof typeof AlignmentType]) {
         super("w:lvlJc");
         this.root.push(
             new Attributes({
@@ -192,19 +196,19 @@ class LevelJc extends XmlComponent {
     }
 }
 
-export enum LevelSuffix {
+export const LevelSuffix = {
-    NOTHING = "nothing",
+    NOTHING: "nothing",
-    SPACE = "space",
+    SPACE: "space",
-    TAB = "tab",
+    TAB: "tab",
-}
+} as const;
 
 export interface ILevelsOptions {
     readonly level: number;
-    readonly format?: LevelFormat;
+    readonly format?: (typeof LevelFormat)[keyof typeof LevelFormat];
     readonly text?: string;
-    readonly alignment?: AlignmentType;
+    readonly alignment?: (typeof AlignmentType)[keyof typeof AlignmentType];
     readonly start?: number;
-    readonly suffix?: LevelSuffix;
+    readonly suffix?: (typeof LevelSuffix)[keyof typeof LevelSuffix];
     readonly isLegalNumberingStyle?: boolean;
     readonly style?: {
         readonly run?: IRunStylePropertiesOptions;
@@ -223,7 +227,7 @@ export interface ILevelsOptions {
 //         </xsd:restriction>
 //     </xsd:simpleType>
 class Suffix extends XmlComponent {
-    public constructor(value: LevelSuffix) {
+    public constructor(value: (typeof LevelSuffix)[keyof typeof LevelSuffix]) {
         super("w:suff");
         this.root.push(
             new Attributes({

src/file/numbering/numbering.ts

@@ -216,7 +216,7 @@ export class Numbering extends XmlComponent {
             abstractNumId: abstractNumbering.id,
             reference,
             instance,
-            overrideLevel:
+            overrideLevels: [
                 firstLevelStartNumber && Number.isInteger(firstLevelStartNumber)
                     ? {
                           num: 0,
@@ -226,6 +226,7 @@ export class Numbering extends XmlComponent {
                           num: 0,
                           start: 1,
                       },
+            ],
         };
 
         this.concreteNumberingMap.set(fullReference, new ConcreteNumbering(concreteNumberingSettings));

src/file/paragraph/formatting/alignment.ts

@@ -19,41 +19,47 @@ import { XmlAttributeComponent, XmlComponent } from "@file/xml-components";
 //         <xsd:enumeration value="right"/>
 //     </xsd:restriction>
 // </xsd:simpleType>
-export enum AlignmentType {
-    /** Align Start */
-    START = "start",
-    /** Align Center */
-    CENTER = "center",
-    /** End */
-    END = "end",
-    /** Justified */
-    BOTH = "both",
-    /** Medium Kashida Length */
-    MEDIUM_KASHIDA = "mediumKashida",
-    /** Distribute All Characters Equally */
-    DISTRIBUTE = "distribute",
-    /** Align to List Tab */
-    NUM_TAB = "numTab",
-    /** Widest Kashida Length */
-    HIGH_KASHIDA = "highKashida",
-    /** Low Kashida Length */
-    LOW_KASHIDA = "lowKashida",
-    /** Thai Language Justification */
-    THAI_DISTRIBUTE = "thaiDistribute",
-    /** Align Left */
-    LEFT = "left",
-    /** Align Right */
-    RIGHT = "right",
-    /** Justified */
-    JUSTIFIED = "both",
-}
 
-export class AlignmentAttributes extends XmlAttributeComponent<{ readonly val: AlignmentType }> {
+/* eslint-disable @typescript-eslint/naming-convention */
+export const AlignmentType = {
+    /** Align Start */
+    START: "start",
+    /** Align Center */
+    CENTER: "center",
+    /** End */
+    END: "end",
+    /** Justified */
+    BOTH: "both",
+    /** Medium Kashida Length */
+    MEDIUM_KASHIDA: "mediumKashida",
+    /** Distribute All Characters Equally */
+    DISTRIBUTE: "distribute",
+    /** Align to List Tab */
+    NUM_TAB: "numTab",
+    /** Widest Kashida Length */
+    HIGH_KASHIDA: "highKashida",
+    /** Low Kashida Length */
+    LOW_KASHIDA: "lowKashida",
+    /** Thai Language Justification */
+    THAI_DISTRIBUTE: "thaiDistribute",
+    /** Align Left */
+    LEFT: "left",
+    /** Align Right */
+    RIGHT: "right",
+    /** Justified */
+    JUSTIFIED: "both",
+} as const;
+
+/* eslint-enable */
+
+export class AlignmentAttributes extends XmlAttributeComponent<{
+    readonly val: (typeof AlignmentType)[keyof typeof AlignmentType];
+}> {
     protected readonly xmlKeys = { val: "w:val" };
 }
 
 export class Alignment extends XmlComponent {
-    public constructor(type: AlignmentType) {
+    public constructor(type: (typeof AlignmentType)[keyof typeof AlignmentType]) {
         super("w:jc");
         this.root.push(new AlignmentAttributes({ val: type }));
     }

src/file/paragraph/formatting/break.ts

@@ -2,14 +2,14 @@
 import { Attributes, XmlComponent } from "@file/xml-components";
 import { Run } from "../run";
 
-enum BreakType {
+const BreakType = {
-    COLUMN = "column",
+    COLUMN: "column",
-    PAGE = "page",
+    PAGE: "page",
     // textWrapping breaks are the default and already exposed via the "Run" class
-}
+} as const;
 
 class Break extends XmlComponent {
-    public constructor(type: BreakType) {
+    public constructor(type: (typeof BreakType)[keyof typeof BreakType]) {
         super("w:br");
         this.root.push(
             new Attributes({

src/file/paragraph/formatting/spacing.ts

@@ -1,17 +1,19 @@
 // http://officeopenxml.com/WPspacing.php
 import { XmlAttributeComponent, XmlComponent } from "@file/xml-components";
 
-export enum LineRuleType {
+export const LineRuleType = {
-    AT_LEAST = "atLeast",
+    // eslint-disable-next-line @typescript-eslint/naming-convention
-    EXACTLY = "exactly",
+    AT_LEAST: "atLeast",
-    EXACT = "exact",
+    EXACTLY: "exactly",
-    AUTO = "auto",
+    EXACT: "exact",
-}
+    AUTO: "auto",
+} as const;
+
 export interface ISpacingProperties {
     readonly after?: number;
     readonly before?: number;
     readonly line?: number;
-    readonly lineRule?: LineRuleType;
+    readonly lineRule?: (typeof LineRuleType)[keyof typeof LineRuleType];
     readonly beforeAutoSpacing?: boolean;
     readonly afterAutoSpacing?: boolean;
 }

src/file/paragraph/formatting/style.ts

@@ -1,14 +1,14 @@
 import { Attributes, XmlComponent } from "@file/xml-components";
 
-export enum HeadingLevel {
+export const HeadingLevel = {
-    HEADING_1 = "Heading1",
+    HEADING_1: "Heading1",
-    HEADING_2 = "Heading2",
+    HEADING_2: "Heading2",
-    HEADING_3 = "Heading3",
+    HEADING_3: "Heading3",
-    HEADING_4 = "Heading4",
+    HEADING_4: "Heading4",
-    HEADING_5 = "Heading5",
+    HEADING_5: "Heading5",
-    HEADING_6 = "Heading6",
+    HEADING_6: "Heading6",
-    TITLE = "Title",
+    TITLE: "Title",
-}
+} as const;
 
 export class Style extends XmlComponent {
     public constructor(styleId: string) {

src/file/paragraph/formatting/tab-stop.ts

@@ -2,9 +2,9 @@
 import { XmlAttributeComponent, XmlComponent } from "@file/xml-components";
 
 export interface TabStopDefinition {
-    readonly type: TabStopType;
+    readonly type: (typeof TabStopType)[keyof typeof TabStopType];
-    readonly position: number | TabStopPosition;
+    readonly position: number | (typeof TabStopPosition)[keyof typeof TabStopPosition];
-    readonly leader?: LeaderType;
+    readonly leader?: (typeof LeaderType)[keyof typeof LeaderType];
 }
 
 export class TabStop extends XmlComponent {
@@ -17,34 +17,35 @@ export class TabStop extends XmlComponent {
     }
 }
 
-export enum TabStopType {
+export const TabStopType = {
-    LEFT = "left",
+    LEFT: "left",
-    RIGHT = "right",
+    RIGHT: "right",
-    CENTER = "center",
+    CENTER: "center",
-    BAR = "bar",
+    BAR: "bar",
-    CLEAR = "clear",
+    CLEAR: "clear",
-    DECIMAL = "decimal",
+    DECIMAL: "decimal",
-    END = "end",
+    END: "end",
-    NUM = "num",
+    NUM: "num",
-    START = "start",
+    START: "start",
-}
+} as const;
 
-export enum LeaderType {
+export const LeaderType = {
-    DOT = "dot",
+    DOT: "dot",
-    HYPHEN = "hyphen",
+    HYPHEN: "hyphen",
-    MIDDLE_DOT = "middleDot",
+    // eslint-disable-next-line @typescript-eslint/naming-convention
-    NONE = "none",
+    MIDDLE_DOT: "middleDot",
-    UNDERSCORE = "underscore",
+    NONE: "none",
-}
+    UNDERSCORE: "underscore",
+} as const;
 
-export enum TabStopPosition {
+export const TabStopPosition = {
-    MAX = 9026,
+    MAX: 9026,
-}
+} as const;
 
 export class TabAttributes extends XmlAttributeComponent<{
-    readonly val: TabStopType;
+    readonly val: (typeof TabStopType)[keyof typeof TabStopType];
     readonly pos: string | number;
-    readonly leader?: LeaderType;
+    readonly leader?: (typeof LeaderType)[keyof typeof LeaderType];
 }> {
     protected readonly xmlKeys = { val: "w:val", pos: "w:pos", leader: "w:leader" };
 }

src/file/paragraph/frame/frame-properties.ts

@@ -3,43 +3,44 @@ import { HorizontalPositionAlign, VerticalPositionAlign } from "@file/shared/ali
 import { HeightRule } from "@file/table";
 import { XmlAttributeComponent, XmlComponent } from "@file/xml-components";
 
-export enum DropCapType {
+export const DropCapType = {
-    NONE = "none",
+    NONE: "none",
-    DROP = "drop",
+    DROP: "drop",
-    MARGIN = "margin",
+    MARGIN: "margin",
-}
+} as const;
 
-export enum FrameAnchorType {
+export const FrameAnchorType = {
-    MARGIN = "margin",
+    MARGIN: "margin",
-    PAGE = "page",
+    PAGE: "page",
-    TEXT = "text",
+    TEXT: "text",
-}
+} as const;
 
-export enum FrameWrap {
+export const FrameWrap = {
-    AROUND = "around",
+    AROUND: "around",
-    AUTO = "auto",
+    AUTO: "auto",
-    NONE = "none",
+    NONE: "none",
-    NOT_BESIDE = "notBeside",
+    // eslint-disable-next-line @typescript-eslint/naming-convention
-    THROUGH = "through",
+    NOT_BESIDE: "notBeside",
-    TIGHT = "tight",
+    THROUGH: "through",
-}
+    TIGHT: "tight",
+} as const;
 
 interface IBaseFrameOptions {
     readonly anchorLock?: boolean;
-    readonly dropCap?: DropCapType;
+    readonly dropCap?: (typeof DropCapType)[keyof typeof DropCapType];
     readonly width: number;
     readonly height: number;
-    readonly wrap?: FrameWrap;
+    readonly wrap?: (typeof FrameWrap)[keyof typeof FrameWrap];
     readonly lines?: number;
     readonly anchor: {
-        readonly horizontal: FrameAnchorType;
+        readonly horizontal: (typeof FrameAnchorType)[keyof typeof FrameAnchorType];
-        readonly vertical: FrameAnchorType;
+        readonly vertical: (typeof FrameAnchorType)[keyof typeof FrameAnchorType];
     };
     readonly space?: {
         readonly horizontal: number;
         readonly vertical: number;
     };
-    readonly rule?: HeightRule;
+    readonly rule?: (typeof HeightRule)[keyof typeof HeightRule];
 }
 
 export interface IXYFrameOptions extends IBaseFrameOptions {
@@ -51,8 +52,8 @@ export interface IXYFrameOptions extends IBaseFrameOptions {
 
 export interface IAlignmentFrameOptions extends IBaseFrameOptions {
     readonly alignment: {
-        readonly x: HorizontalPositionAlign;
+        readonly x: (typeof HorizontalPositionAlign)[keyof typeof HorizontalPositionAlign];
-        readonly y: VerticalPositionAlign;
+        readonly y: (typeof VerticalPositionAlign)[keyof typeof VerticalPositionAlign];
     };
 }
 
@@ -62,20 +63,20 @@ export type IFrameOptions = IXYFrameOptions | IAlignmentFrameOptions;
 
 export class FramePropertiesAttributes extends XmlAttributeComponent<{
     readonly anchorLock?: boolean;
-    readonly dropCap?: DropCapType;
+    readonly dropCap?: (typeof DropCapType)[keyof typeof DropCapType];
     readonly width: number;
     readonly height: number;
     readonly x?: number;
     readonly y?: number;
-    readonly wrap?: FrameWrap;
+    readonly wrap?: (typeof FrameWrap)[keyof typeof FrameWrap];
     readonly lines?: number;
-    readonly anchorHorizontal?: FrameAnchorType;
+    readonly anchorHorizontal?: (typeof FrameAnchorType)[keyof typeof FrameAnchorType];
-    readonly anchorVertical?: FrameAnchorType;
+    readonly anchorVertical?: (typeof FrameAnchorType)[keyof typeof FrameAnchorType];
     readonly spaceHorizontal?: number;
     readonly spaceVertical?: number;
-    readonly rule?: HeightRule;
+    readonly rule?: (typeof HeightRule)[keyof typeof HeightRule];
-    readonly alignmentX?: HorizontalPositionAlign;
+    readonly alignmentX?: (typeof HorizontalPositionAlign)[keyof typeof HorizontalPositionAlign];
-    readonly alignmentY?: VerticalPositionAlign;
+    readonly alignmentY?: (typeof VerticalPositionAlign)[keyof typeof VerticalPositionAlign];
 }> {
     protected readonly xmlKeys = {
         anchorLock: "w:anchorLock",

src/file/paragraph/links/hyperlink.ts

@@ -5,10 +5,10 @@ import { uniqueId } from "@util/convenience-functions";
 import { ParagraphChild } from "../paragraph";
 import { HyperlinkAttributes, IHyperlinkAttributesProperties } from "./hyperlink-attributes";
 
-export enum HyperlinkType {
+export const HyperlinkType = {
-    INTERNAL = "INTERNAL",
+    INTERNAL: "INTERNAL",
-    EXTERNAL = "EXTERNAL",
+    EXTERNAL: "EXTERNAL",
-}
+} as const;
 
 export class ConcreteHyperlink extends XmlComponent {
     public readonly linkId: string;
@@ -39,7 +39,12 @@ export class InternalHyperlink extends ConcreteHyperlink {
 }
 
 export class ExternalHyperlink extends XmlComponent {
-    public constructor(public readonly options: { readonly children: readonly ParagraphChild[]; readonly link: string }) {
+    public constructor(
+        public readonly options: {
+            readonly children: readonly ParagraphChild[];
+            readonly link: string;
+        },
+    ) {
         super("w:externalHyperlink");
     }
 }

src/file/paragraph/properties.spec.ts

@@ -158,5 +158,37 @@ describe("ParagraphProperties", () => {
                 ],
             });
         });
+
+        it("should create with the run property", () => {
+            const properties = new ParagraphProperties({
+                run: {
+                    size: "10pt",
+                },
+            });
+            const tree = new Formatter().format(properties);
+
+            expect(tree).to.deep.equal({
+                "w:pPr": [
+                    {
+                        "w:rPr": [
+                            {
+                                "w:sz": {
+                                    _attr: {
+                                        "w:val": "10pt",
+                                    },
+                                },
+                            },
+                            {
+                                "w:szCs": {
+                                    _attr: {
+                                        "w:val": "10pt",
+                                    },
+                                },
+                            },
+                        ],
+                    },
+                ],
+            });
+        });
     });
 });

src/file/paragraph/properties.ts

@@ -1,5 +1,6 @@
 // http://officeopenxml.com/WPparagraphProperties.php
 // https://c-rex.net/projects/samples/ooxml/e1/Part4/OOXML_P4_DOCX_suppressLineNumbers_topic_ID0ECJAO.html
+/* eslint-disable functional/immutable-data */
 import { IContext, IgnoreIfEmptyXmlComponent, IXmlableObject, OnOffElement, XmlComponent } from "@file/xml-components";
 import { DocumentWrapper } from "../document-wrapper";
 import { IShadingAttributesProperties, Shading } from "../shading";
@@ -14,9 +15,10 @@ import { NumberProperties } from "./formatting/unordered-list";
 import { WordWrap } from "./formatting/word-wrap";
 import { FrameProperties, IFrameOptions } from "./frame/frame-properties";
 import { OutlineLevel } from "./links";
+import { IRunOptions, RunProperties } from ".";
 
 export interface ILevelParagraphStylePropertiesOptions {
-    readonly alignment?: AlignmentType;
+    readonly alignment?: (typeof AlignmentType)[keyof typeof AlignmentType];
     readonly thematicBreak?: boolean;
     readonly contextualSpacing?: boolean;
     readonly rightTabStop?: number;
@@ -45,7 +47,7 @@ export interface IParagraphStylePropertiesOptions extends ILevelParagraphStylePr
 
 export interface IParagraphPropertiesOptions extends IParagraphStylePropertiesOptions {
     readonly border?: IBordersOptions;
-    readonly heading?: HeadingLevel;
+    readonly heading?: (typeof HeadingLevel)[keyof typeof HeadingLevel];
     readonly bidirectional?: boolean;
     readonly pageBreakBefore?: boolean;
     readonly tabStops?: readonly TabStopDefinition[];
@@ -64,6 +66,10 @@ export interface IParagraphPropertiesOptions extends IParagraphStylePropertiesOp
      * This only works in Microsoft Word. It is not part of the ECMA-376 OOXML standard.
      */
     readonly autoSpaceEastAsianText?: boolean;
+    /**
+     * Reference: ECMA-376, 3rd Edition (June, 2011), Fundamentals and Markup Language Reference § 17.3.1.29.
+     */
+    readonly run?: IRunOptions;
 }
 
 export class ParagraphProperties extends IgnoreIfEmptyXmlComponent {
@@ -151,9 +157,9 @@ export class ParagraphProperties extends IgnoreIfEmptyXmlComponent {
          * Ensure there is only one w:tabs tag with multiple w:tab
          */
         const tabDefinitions: readonly TabStopDefinition[] = [
-            ...(options.rightTabStop ? [{ type: TabStopType.RIGHT, position: options.rightTabStop }] : []),
+            ...(options.rightTabStop !== undefined ? [{ type: TabStopType.RIGHT, position: options.rightTabStop }] : []),
             ...(options.tabStops ? options.tabStops : []),
-            ...(options.leftTabStop ? [{ type: TabStopType.LEFT, position: options.leftTabStop }] : []),
+            ...(options.leftTabStop !== undefined ? [{ type: TabStopType.LEFT, position: options.leftTabStop }] : []),
         ];
 
         if (tabDefinitions.length > 0) {
@@ -194,6 +200,10 @@ export class ParagraphProperties extends IgnoreIfEmptyXmlComponent {
         if (options.autoSpaceEastAsianText !== undefined) {
             this.push(new OnOffElement("w:autoSpaceDN", options.autoSpaceEastAsianText));
         }
+
+        if (options.run) {
+            this.push(new RunProperties(options.run));
+        }
     }
 
     public push(item: XmlComponent): void {

src/file/paragraph/run/emphasis-mark.ts

@@ -1,11 +1,11 @@
 import { Attributes, XmlComponent } from "@file/xml-components";
 
-export enum EmphasisMarkType {
+export const EmphasisMarkType = {
-    DOT = "dot",
+    DOT: "dot",
-}
+} as const;
 
 export abstract class BaseEmphasisMark extends XmlComponent {
-    protected constructor(emphasisMarkType: EmphasisMarkType) {
+    protected constructor(emphasisMarkType: (typeof EmphasisMarkType)[keyof typeof EmphasisMarkType]) {
         super("w:em");
         this.root.push(
             new Attributes({
@@ -16,7 +16,7 @@ export abstract class BaseEmphasisMark extends XmlComponent {
 }
 
 export class EmphasisMark extends BaseEmphasisMark {
-    public constructor(emphasisMarkType: EmphasisMarkType = EmphasisMarkType.DOT) {
+    public constructor(emphasisMarkType: (typeof EmphasisMarkType)[keyof typeof EmphasisMarkType] = EmphasisMarkType.DOT) {
         super(emphasisMarkType);
     }
 }

src/file/paragraph/run/field.ts

@@ -1,12 +1,15 @@
 import { XmlAttributeComponent, XmlComponent } from "@file/xml-components";
 
-enum FieldCharacterType {
+const FieldCharacterType = {
-    BEGIN = "begin",
+    BEGIN: "begin",
-    END = "end",
+    END: "end",
-    SEPARATE = "separate",
+    SEPARATE: "separate",
-}
+} as const;
 
-class FidCharAttrs extends XmlAttributeComponent<{ readonly type: FieldCharacterType; readonly dirty?: boolean }> {
+class FidCharAttrs extends XmlAttributeComponent<{
+    readonly type: (typeof FieldCharacterType)[keyof typeof FieldCharacterType];
+    readonly dirty?: boolean;
+}> {
     protected readonly xmlKeys = { type: "w:fldCharType", dirty: "w:dirty" };
 }
 

src/file/paragraph/run/positional-tab.ts

@@ -7,11 +7,11 @@ import { NextAttributeComponent, XmlComponent } from "@file/xml-components";
 //         <xsd:enumeration value="right" />
 //     </xsd:restriction>
 // </xsd:simpleType>
-export enum PositionalTabAlignment {
+export const PositionalTabAlignment = {
-    LEFT = "left",
+    LEFT: "left",
-    CENTER = "center",
+    CENTER: "center",
-    RIGHT = "right",
+    RIGHT: "right",
-}
+} as const;
 
 // <xsd:simpleType name="ST_PTabRelativeTo">
 //     <xsd:restriction base="xsd:string">
@@ -19,10 +19,10 @@ export enum PositionalTabAlignment {
 //         <xsd:enumeration value="indent" />
 //     </xsd:restriction>
 // </xsd:simpleType>
-export enum PositionalTabRelativeTo {
+export const PositionalTabRelativeTo = {
-    MARGIN = "margin",
+    MARGIN: "margin",
-    INDENT = "indent",
+    INDENT: "indent",
-}
+} as const;
 
 // <xsd:simpleType name="ST_PTabLeader">
 //     <xsd:restriction base="xsd:string">
@@ -33,18 +33,19 @@ export enum PositionalTabRelativeTo {
 //         <xsd:enumeration value="middleDot" />
 //     </xsd:restriction>
 // </xsd:simpleType>
-export enum PositionalTabLeader {
+export const PositionalTabLeader = {
-    NONE = "none",
+    NONE: "none",
-    DOT = "dot",
+    DOT: "dot",
-    HYPHEN = "hyphen",
+    HYPHEN: "hyphen",
-    UNDERSCORE = "underscore",
+    UNDERSCORE: "underscore",
-    MIDDLE_DOT = "middleDot",
+    // eslint-disable-next-line @typescript-eslint/naming-convention
-}
+    MIDDLE_DOT: "middleDot",
+} as const;
 
 export interface PositionalTabOptions {
-    readonly alignment: PositionalTabAlignment;
+    readonly alignment: (typeof PositionalTabAlignment)[keyof typeof PositionalTabAlignment];
-    readonly relativeTo: PositionalTabRelativeTo;
+    readonly relativeTo: (typeof PositionalTabRelativeTo)[keyof typeof PositionalTabRelativeTo];
-    readonly leader: PositionalTabLeader;
+    readonly leader: (typeof PositionalTabLeader)[keyof typeof PositionalTabLeader];
 }
 
 // <xsd:complexType name="CT_PTab">
@@ -58,9 +59,9 @@ export class PositionalTab extends XmlComponent {
 
         this.root.push(
             new NextAttributeComponent<{
-                readonly alignment: PositionalTabAlignment;
+                readonly alignment: (typeof PositionalTabAlignment)[keyof typeof PositionalTabAlignment];
-                readonly relativeTo: PositionalTabRelativeTo;
+                readonly relativeTo: (typeof PositionalTabRelativeTo)[keyof typeof PositionalTabRelativeTo];
-                readonly leader: PositionalTabLeader;
+                readonly leader: (typeof PositionalTabLeader)[keyof typeof PositionalTabLeader];
             }>({
                 alignment: {
                     key: "w:alignment",

src/file/paragraph/run/properties.ts

@@ -1,4 +1,5 @@
 // https://www.ecma-international.org/wp-content/uploads/ECMA-376-1_5th_edition_december_2016.zip page 297, section 17.3.2.21
+/* eslint-disable functional/immutable-data */
 import { BorderElement, IBorderOptions } from "@file/border";
 import { IShadingAttributesProperties, Shading } from "@file/shading";
 import { ChangeAttributes, IChangedAttributesProperties } from "@file/track-revision/track-revision";
@@ -24,15 +25,18 @@ interface IFontOptions {
     readonly hint?: string;
 }
 
-export enum TextEffect {
+/* eslint-disable @typescript-eslint/naming-convention */
-    BLINK_BACKGROUND = "blinkBackground",
+export const TextEffect = {
-    LIGHTS = "lights",
+    BLINK_BACKGROUND: "blinkBackground",
-    ANTS_BLACK = "antsBlack",
+    LIGHTS: "lights",
-    ANTS_RED = "antsRed",
+    ANTS_BLACK: "antsBlack",
-    SHIMMER = "shimmer",
+    ANTS_RED: "antsRed",
-    SPARKLE = "sparkle",
+    SHIMMER: "shimmer",
-    NONE = "none",
+    SPARKLE: "sparkle",
-}
+    NONE: "none",
+} as const;
+
+/* eslint-enable */
 
 export interface IRunStylePropertiesOptions {
     readonly noProof?: boolean;
@@ -42,11 +46,11 @@ export interface IRunStylePropertiesOptions {
     readonly italicsComplexScript?: boolean;
     readonly underline?: {
         readonly color?: string;
-        readonly type?: UnderlineType;
+        readonly type?: (typeof UnderlineType)[keyof typeof UnderlineType];
     };
-    readonly effect?: TextEffect;
+    readonly effect?: (typeof TextEffect)[keyof typeof TextEffect];
     readonly emphasisMark?: {
-        readonly type?: EmphasisMarkType;
+        readonly type?: (typeof EmphasisMarkType)[keyof typeof EmphasisMarkType];
     };
     readonly color?: string;
     readonly kern?: number | PositiveUniversalMeasure;
@@ -126,6 +130,8 @@ export interface IRunPropertiesChangeOptions extends IRunPropertiesOptions, ICha
 //     <xsd:element name="oMath" type="CT_OnOff"/>
 //     </xsd:choice>
 // </xsd:group>
+/* eslint-disable functional/immutable-data */
+
 export class RunProperties extends IgnoreIfEmptyXmlComponent {
     public constructor(options?: IRunPropertiesOptions) {
         super("w:rPr");
@@ -260,7 +266,7 @@ export class RunProperties extends IgnoreIfEmptyXmlComponent {
             this.push(new BorderElement("w:bdr", options.border));
         }
 
-        if (options.snapToGrid) {
+        if (options.snapToGrid !== undefined) {
             this.push(new OnOffElement("w:snapToGrid", options.snapToGrid));
         }
 
@@ -293,6 +299,8 @@ export class RunProperties extends IgnoreIfEmptyXmlComponent {
     }
 }
 
+/* eslint-enable */
+
 export class RunPropertiesChange extends XmlComponent {
     public constructor(options: IRunPropertiesChangeOptions) {
         super("w:rPrChange");

src/file/paragraph/run/run-components/text.ts

@@ -12,7 +12,7 @@ import { TextAttributes } from "../text-attributes";
 // </xsd:complexType>
 
 interface ITextOptions {
-    readonly space?: SpaceType;
+    readonly space?: (typeof SpaceType)[keyof typeof SpaceType];
     readonly text?: string;
 }
 

src/file/paragraph/run/run.ts

@@ -71,7 +71,7 @@ export interface IRunOptions extends IRunPropertiesOptions {
         | FieldInstruction
         | Separate
         | End
-        | PageNumber
+        | (typeof PageNumber)[keyof typeof PageNumber]
         | FootnoteReferenceRun
         | Break
         | AnnotationReference
@@ -98,11 +98,14 @@ export interface IRunOptions extends IRunPropertiesOptions {
     readonly text?: string;
 }
 
-export enum PageNumber {
+/* eslint-disable @typescript-eslint/naming-convention */
-    CURRENT = "CURRENT",
+export const PageNumber = {
-    TOTAL_PAGES = "TOTAL_PAGES",
+    CURRENT: "CURRENT",
-    TOTAL_PAGES_IN_SECTION = "TOTAL_PAGES_IN_SECTION",
+    TOTAL_PAGES: "TOTAL_PAGES",
-}
+    TOTAL_PAGES_IN_SECTION: "TOTAL_PAGES_IN_SECTION",
+} as const;
+
+/* eslint-enable */
 
 export class Run extends XmlComponent {
     protected readonly properties: RunProperties;

src/file/paragraph/run/text-attributes.ts

@@ -1,6 +1,8 @@
 import { SpaceType } from "@file/shared";
 import { XmlAttributeComponent } from "@file/xml-components";
 
-export class TextAttributes extends XmlAttributeComponent<{ readonly space: SpaceType }> {
+export class TextAttributes extends XmlAttributeComponent<{
+    readonly space: (typeof SpaceType)[keyof typeof SpaceType];
+}> {
     protected readonly xmlKeys = { space: "xml:space" };
 }

src/file/paragraph/run/underline.ts

@@ -1,29 +1,29 @@
 import { Attributes, XmlComponent } from "@file/xml-components";
 import { hexColorValue } from "@util/values";
 
-export enum UnderlineType {
+export const UnderlineType = {
-    SINGLE = "single",
+    SINGLE: "single",
-    WORDS = "words",
+    WORDS: "words",
-    DOUBLE = "double",
+    DOUBLE: "double",
-    THICK = "thick",
+    THICK: "thick",
-    DOTTED = "dotted",
+    DOTTED: "dotted",
-    DOTTEDHEAVY = "dottedHeavy",
+    DOTTEDHEAVY: "dottedHeavy",
-    DASH = "dash",
+    DASH: "dash",
-    DASHEDHEAVY = "dashedHeavy",
+    DASHEDHEAVY: "dashedHeavy",
-    DASHLONG = "dashLong",
+    DASHLONG: "dashLong",
-    DASHLONGHEAVY = "dashLongHeavy",
+    DASHLONGHEAVY: "dashLongHeavy",
-    DOTDASH = "dotDash",
+    DOTDASH: "dotDash",
-    DASHDOTHEAVY = "dashDotHeavy",
+    DASHDOTHEAVY: "dashDotHeavy",
-    DOTDOTDASH = "dotDotDash",
+    DOTDOTDASH: "dotDotDash",
-    DASHDOTDOTHEAVY = "dashDotDotHeavy",
+    DASHDOTDOTHEAVY: "dashDotDotHeavy",
-    WAVE = "wave",
+    WAVE: "wave",
-    WAVYHEAVY = "wavyHeavy",
+    WAVYHEAVY: "wavyHeavy",
-    WAVYDOUBLE = "wavyDouble",
+    WAVYDOUBLE: "wavyDouble",
-    NONE = "none",
+    NONE: "none",
-}
+} as const;
 
 export class Underline extends XmlComponent {
-    public constructor(underlineType: UnderlineType = UnderlineType.SINGLE, color?: string) {
+    public constructor(underlineType: (typeof UnderlineType)[keyof typeof UnderlineType] = UnderlineType.SINGLE, color?: string) {
         super("w:u");
         this.root.push(
             new Attributes({

src/file/relationships/relationship/relationship.ts

@@ -19,12 +19,17 @@ export type RelationshipType =
     | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/footnotes"
     | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments";
 
-export enum TargetModeType {
+export const TargetModeType = {
-    EXTERNAL = "External",
+    EXTERNAL: "External",
-}
+} as const;
 
 export class Relationship extends XmlComponent {
-    public constructor(id: string, type: RelationshipType, target: string, targetMode?: TargetModeType) {
+    public constructor(
+        id: string,
+        type: RelationshipType,
+        target: string,
+        targetMode?: (typeof TargetModeType)[keyof typeof TargetModeType],
+    ) {
         super("Relationship");
 
         this.root.push(

src/file/relationships/relationships.ts

@@ -12,7 +12,12 @@ export class Relationships extends XmlComponent {
         );
     }
 
-    public createRelationship(id: number | string, type: RelationshipType, target: string, targetMode?: TargetModeType): Relationship {
+    public createRelationship(
+        id: number | string,
+        type: RelationshipType,
+        target: string,
+        targetMode?: (typeof TargetModeType)[keyof typeof TargetModeType],
+    ): Relationship {
         const relationship = new Relationship(`rId${id}`, type, target, targetMode);
         this.root.push(relationship);
 

src/file/settings/settings.spec.ts

@@ -112,6 +112,23 @@ describe("Settings", () => {
             });
         });
 
+        it("should add defaultTabStop setting with version", () => {
+            const settings = new Settings({
+                defaultTabStop: 100,
+            });
+
+            const tree = new Formatter().format(settings);
+            expect(Object.keys(tree)).has.length(1);
+            expect(tree["w:settings"]).to.be.an("array");
+            expect(tree["w:settings"]).to.deep.include({
+                "w:defaultTabStop": {
+                    _attr: {
+                        "w:val": 100,
+                    },
+                },
+            });
+        });
+
         // TODO: Remove when deprecating compatibilityModeVersion
         it("should add compatibility setting with legacy version", () => {
             const settings = new Settings({

src/file/settings/settings.ts

@@ -1,4 +1,4 @@
-import { OnOffElement, XmlAttributeComponent, XmlComponent } from "@file/xml-components";
+import { NumberValueElement, OnOffElement, XmlAttributeComponent, XmlComponent } from "@file/xml-components";
 
 import { Compatibility, ICompatibilityOptions } from "./compatibility";
 
@@ -152,6 +152,7 @@ export interface ISettingsOptions {
     readonly trackRevisions?: boolean;
     readonly updateFields?: boolean;
     readonly compatibility?: ICompatibilityOptions;
+    readonly defaultTabStop?: number;
 }
 
 export class Settings extends XmlComponent {
@@ -198,6 +199,11 @@ export class Settings extends XmlComponent {
             this.root.push(new OnOffElement("w:updateFields", options.updateFields));
         }
 
+        // https://c-rex.net/samples/ooxml/e1/Part4/OOXML_P4_DOCX_defaultTabStop_topic_ID0EIXSX.html
+        if (options.defaultTabStop !== undefined) {
+            this.root.push(new NumberValueElement("w:defaultTabStop", options.defaultTabStop));
+        }
+
         this.root.push(
             new Compatibility({
                 ...(options.compatibility ?? {}),

src/file/shading/shading.ts

@@ -23,7 +23,7 @@ import { hexColorValue } from "@util/values";
 export interface IShadingAttributesProperties {
     readonly fill?: string;
     readonly color?: string;
-    readonly type?: ShadingType;
+    readonly type?: (typeof ShadingType)[keyof typeof ShadingType];
 }
 
 class ShadingAttributes extends XmlAttributeComponent<IShadingAttributesProperties> {
@@ -47,42 +47,44 @@ export class Shading extends XmlComponent {
     }
 }
 
-export enum ShadingType {
+/* eslint-disable @typescript-eslint/naming-convention */
-    CLEAR = "clear",
+export const ShadingType = {
-    DIAGONAL_CROSS = "diagCross",
+    CLEAR: "clear",
-    DIAGONAL_STRIPE = "diagStripe",
+    DIAGONAL_CROSS: "diagCross",
-    HORIZONTAL_CROSS = "horzCross",
+    DIAGONAL_STRIPE: "diagStripe",
-    HORIZONTAL_STRIPE = "horzStripe",
+    HORIZONTAL_CROSS: "horzCross",
-    NIL = "nil",
+    HORIZONTAL_STRIPE: "horzStripe",
-    PERCENT_5 = "pct5",
+    NIL: "nil",
-    PERCENT_10 = "pct10",
+    PERCENT_5: "pct5",
-    PERCENT_12 = "pct12",
+    PERCENT_10: "pct10",
-    PERCENT_15 = "pct15",
+    PERCENT_12: "pct12",
-    PERCENT_20 = "pct20",
+    PERCENT_15: "pct15",
-    PERCENT_25 = "pct25",
+    PERCENT_20: "pct20",
-    PERCENT_30 = "pct30",
+    PERCENT_25: "pct25",
-    PERCENT_35 = "pct35",
+    PERCENT_30: "pct30",
-    PERCENT_37 = "pct37",
+    PERCENT_35: "pct35",
-    PERCENT_40 = "pct40",
+    PERCENT_37: "pct37",
-    PERCENT_45 = "pct45",
+    PERCENT_40: "pct40",
-    PERCENT_50 = "pct50",
+    PERCENT_45: "pct45",
-    PERCENT_55 = "pct55",
+    PERCENT_50: "pct50",
-    PERCENT_60 = "pct60",
+    PERCENT_55: "pct55",
-    PERCENT_62 = "pct62",
+    PERCENT_60: "pct60",
-    PERCENT_65 = "pct65",
+    PERCENT_62: "pct62",
-    PERCENT_70 = "pct70",
+    PERCENT_65: "pct65",
-    PERCENT_75 = "pct75",
+    PERCENT_70: "pct70",
-    PERCENT_80 = "pct80",
+    PERCENT_75: "pct75",
-    PERCENT_85 = "pct85",
+    PERCENT_80: "pct80",
-    PERCENT_87 = "pct87",
+    PERCENT_85: "pct85",
-    PERCENT_90 = "pct90",
+    PERCENT_87: "pct87",
-    PERCENT_95 = "pct95",
+    PERCENT_90: "pct90",
-    REVERSE_DIAGONAL_STRIPE = "reverseDiagStripe",
+    PERCENT_95: "pct95",
-    SOLID = "solid",
+    REVERSE_DIAGONAL_STRIPE: "reverseDiagStripe",
-    THIN_DIAGONAL_CROSS = "thinDiagCross",
+    SOLID: "solid",
-    THIN_DIAGONAL_STRIPE = "thinDiagStripe",
+    THIN_DIAGONAL_CROSS: "thinDiagCross",
-    THIN_HORIZONTAL_CROSS = "thinHorzCross",
+    THIN_DIAGONAL_STRIPE: "thinDiagStripe",
-    THIN_REVERSE_DIAGONAL_STRIPE = "thinReverseDiagStripe",
+    THIN_HORIZONTAL_CROSS: "thinHorzCross",
-    THIN_VERTICAL_STRIPE = "thinVertStripe",
+    THIN_REVERSE_DIAGONAL_STRIPE: "thinReverseDiagStripe",
-    VERTICAL_STRIPE = "vertStripe",
+    THIN_VERTICAL_STRIPE: "thinVertStripe",
-}
+    VERTICAL_STRIPE: "vertStripe",
+} as const;
+/* eslint-enable */

src/file/shared/alignment.ts

@@ -1,15 +1,15 @@
-export enum HorizontalPositionAlign {
+export const HorizontalPositionAlign = {
-    CENTER = "center",
+    CENTER: "center",
-    INSIDE = "inside",
+    INSIDE: "inside",
-    LEFT = "left",
+    LEFT: "left",
-    OUTSIDE = "outside",
+    OUTSIDE: "outside",
-    RIGHT = "right",
+    RIGHT: "right",
-}
+} as const;
 
-export enum VerticalPositionAlign {
+export const VerticalPositionAlign = {
-    BOTTOM = "bottom",
+    BOTTOM: "bottom",
-    CENTER = "center",
+    CENTER: "center",
-    INSIDE = "inside",
+    INSIDE: "inside",
-    OUTSIDE = "outside",
+    OUTSIDE: "outside",
-    TOP = "top",
+    TOP: "top",
-}
+} as const;

src/file/shared/number-format.ts

@@ -66,68 +66,70 @@
 // </xsd:restriction>
 // </xsd:simpleType>
 
-export enum NumberFormat {
+/* eslint-disable @typescript-eslint/naming-convention*/
-    DECIMAL = "decimal",
+export const NumberFormat = {
-    UPPER_ROMAN = "upperRoman",
+    DECIMAL: "decimal",
-    LOWER_ROMAN = "lowerRoman",
+    UPPER_ROMAN: "upperRoman",
-    UPPER_LETTER = "upperLetter",
+    LOWER_ROMAN: "lowerRoman",
-    LOWER_LETTER = "lowerLetter",
+    UPPER_LETTER: "upperLetter",
-    ORDINAL = "ordinal",
+    LOWER_LETTER: "lowerLetter",
-    CARDINAL_TEXT = "cardinalText",
+    ORDINAL: "ordinal",
-    ORDINAL_TEXT = "ordinalText",
+    CARDINAL_TEXT: "cardinalText",
-    HEX = "hex",
+    ORDINAL_TEXT: "ordinalText",
-    CHICAGO = "chicago",
+    HEX: "hex",
-    IDEOGRAPH_DIGITAL = "ideographDigital",
+    CHICAGO: "chicago",
-    JAPANESE_COUNTING = "japaneseCounting",
+    IDEOGRAPH_DIGITAL: "ideographDigital",
-    AIUEO = "aiueo",
+    JAPANESE_COUNTING: "japaneseCounting",
-    IROHA = "iroha",
+    AIUEO: "aiueo",
-    DECIMAL_FULL_WIDTH = "decimalFullWidth",
+    IROHA: "iroha",
-    DECIMAL_HALF_WIDTH = "decimalHalfWidth",
+    DECIMAL_FULL_WIDTH: "decimalFullWidth",
-    JAPANESE_LEGAL = "japaneseLegal",
+    DECIMAL_HALF_WIDTH: "decimalHalfWidth",
-    JAPANESE_DIGITAL_TEN_THOUSAND = "japaneseDigitalTenThousand",
+    JAPANESE_LEGAL: "japaneseLegal",
-    DECIMAL_ENCLOSED_CIRCLE = "decimalEnclosedCircle",
+    JAPANESE_DIGITAL_TEN_THOUSAND: "japaneseDigitalTenThousand",
-    DECIMAL_FULL_WIDTH_2 = "decimalFullWidth2",
+    DECIMAL_ENCLOSED_CIRCLE: "decimalEnclosedCircle",
-    AIUEO_FULL_WIDTH = "aiueoFullWidth",
+    DECIMAL_FULL_WIDTH_2: "decimalFullWidth2",
-    IROHA_FULL_WIDTH = "irohaFullWidth",
+    AIUEO_FULL_WIDTH: "aiueoFullWidth",
-    DECIMAL_ZERO = "decimalZero",
+    IROHA_FULL_WIDTH: "irohaFullWidth",
-    BULLET = "bullet",
+    DECIMAL_ZERO: "decimalZero",
-    GANADA = "ganada",
+    BULLET: "bullet",
-    CHOSUNG = "chosung",
+    GANADA: "ganada",
-    DECIMAL_ENCLOSED_FULL_STOP = "decimalEnclosedFullstop",
+    CHOSUNG: "chosung",
-    DECIMAL_ENCLOSED_PAREN = "decimalEnclosedParen",
+    DECIMAL_ENCLOSED_FULL_STOP: "decimalEnclosedFullstop",
-    DECIMAL_ENCLOSED_CIRCLE_CHINESE = "decimalEnclosedCircleChinese",
+    DECIMAL_ENCLOSED_PAREN: "decimalEnclosedParen",
-    IDEOGRAPH_ENCLOSED_CIRCLE = "ideographEnclosedCircle",
+    DECIMAL_ENCLOSED_CIRCLE_CHINESE: "decimalEnclosedCircleChinese",
-    IDEOGRAPH_TRADITIONAL = "ideographTraditional",
+    IDEOGRAPH_ENCLOSED_CIRCLE: "ideographEnclosedCircle",
-    IDEOGRAPH_ZODIAC = "ideographZodiac",
+    IDEOGRAPH_TRADITIONAL: "ideographTraditional",
-    IDEOGRAPH_ZODIAC_TRADITIONAL = "ideographZodiacTraditional",
+    IDEOGRAPH_ZODIAC: "ideographZodiac",
-    TAIWANESE_COUNTING = "taiwaneseCounting",
+    IDEOGRAPH_ZODIAC_TRADITIONAL: "ideographZodiacTraditional",
-    IDEOGRAPH_LEGAL_TRADITIONAL = "ideographLegalTraditional",
+    TAIWANESE_COUNTING: "taiwaneseCounting",
-    TAIWANESE_COUNTING_THOUSAND = "taiwaneseCountingThousand",
+    IDEOGRAPH_LEGAL_TRADITIONAL: "ideographLegalTraditional",
-    TAIWANESE_DIGITAL = "taiwaneseDigital",
+    TAIWANESE_COUNTING_THOUSAND: "taiwaneseCountingThousand",
-    CHINESE_COUNTING = "chineseCounting",
+    TAIWANESE_DIGITAL: "taiwaneseDigital",
-    CHINESE_LEGAL_SIMPLIFIED = "chineseLegalSimplified",
+    CHINESE_COUNTING: "chineseCounting",
-    CHINESE_COUNTING_TEN_THOUSAND = "chineseCountingThousand",
+    CHINESE_LEGAL_SIMPLIFIED: "chineseLegalSimplified",
-    KOREAN_DIGITAL = "koreanDigital",
+    CHINESE_COUNTING_TEN_THOUSAND: "chineseCountingThousand",
-    KOREAN_COUNTING = "koreanCounting",
+    KOREAN_DIGITAL: "koreanDigital",
-    KOREAN_LEGAL = "koreanLegal",
+    KOREAN_COUNTING: "koreanCounting",
-    KOREAN_DIGITAL_2 = "koreanDigital2",
+    KOREAN_LEGAL: "koreanLegal",
-    VIETNAMESE_COUNTING = "vietnameseCounting",
+    KOREAN_DIGITAL_2: "koreanDigital2",
-    RUSSIAN_LOWER = "russianLower",
+    VIETNAMESE_COUNTING: "vietnameseCounting",
-    RUSSIAN_UPPER = "russianUpper",
+    RUSSIAN_LOWER: "russianLower",
-    NONE = "none",
+    RUSSIAN_UPPER: "russianUpper",
-    NUMBER_IN_DASH = "numberInDash",
+    NONE: "none",
-    HEBREW_1 = "hebrew1",
+    NUMBER_IN_DASH: "numberInDash",
-    HEBREW_2 = "hebrew2",
+    HEBREW_1: "hebrew1",
-    ARABIC_ALPHA = "arabicAlpha",
+    HEBREW_2: "hebrew2",
-    ARABIC_ABJAD = "arabicAbjad",
+    ARABIC_ALPHA: "arabicAlpha",
-    HINDI_VOWELS = "hindiVowels",
+    ARABIC_ABJAD: "arabicAbjad",
-    HINDI_CONSONANTS = "hindiConsonants",
+    HINDI_VOWELS: "hindiVowels",
-    HINDI_NUMBERS = "hindiNumbers",
+    HINDI_CONSONANTS: "hindiConsonants",
-    HINDI_COUNTING = "hindiCounting",
+    HINDI_NUMBERS: "hindiNumbers",
-    THAI_LETTERS = "thaiLetters",
+    HINDI_COUNTING: "hindiCounting",
-    THAI_NUMBERS = "thaiNumbers",
+    THAI_LETTERS: "thaiLetters",
-    THAI_COUNTING = "thaiCounting",
+    THAI_NUMBERS: "thaiNumbers",
-    BAHT_TEXT = "bahtText",
+    THAI_COUNTING: "thaiCounting",
-    DOLLAR_TEXT = "dollarText",
+    BAHT_TEXT: "bahtText",
+    DOLLAR_TEXT: "dollarText",
     //   <xsd:enumeration value="custom"/>
-}
+} as const;
+/* eslint-enable */

src/file/shared/space-type.ts

@@ -1,4 +1,4 @@
-export enum SpaceType {
+export const SpaceType = {
-    DEFAULT = "default",
+    DEFAULT: "default",
-    PRESERVE = "preserve",
+    PRESERVE: "preserve",
-}
+} as const;

src/file/table/table-cell/table-cell-components.ts

@@ -80,18 +80,20 @@ export class GridSpan extends XmlComponent {
 /**
  * Vertical merge types.
  */
-export enum VerticalMergeType {
+export const VerticalMergeType = {
     /**
      * Cell that is merged with upper one.
      */
-    CONTINUE = "continue",
+    CONTINUE: "continue",
     /**
      * Cell that is starting the vertical merge.
      */
-    RESTART = "restart",
+    RESTART: "restart",
-}
+} as const;
 
-class VerticalMergeAttributes extends XmlAttributeComponent<{ readonly val: VerticalMergeType }> {
+class VerticalMergeAttributes extends XmlAttributeComponent<{
+    readonly val: (typeof VerticalMergeType)[keyof typeof VerticalMergeType];
+}> {
     protected readonly xmlKeys = { val: "w:val" };
 }
 
@@ -99,7 +101,7 @@ class VerticalMergeAttributes extends XmlAttributeComponent<{ readonly val: Vert
  * Vertical merge element. Should be used in a table cell.
  */
 export class VerticalMerge extends XmlComponent {
-    public constructor(value: VerticalMergeType) {
+    public constructor(value: (typeof VerticalMergeType)[keyof typeof VerticalMergeType]) {
         super("w:vMerge");
 
         this.root.push(
@@ -110,13 +112,18 @@ export class VerticalMerge extends XmlComponent {
     }
 }
 
-export enum TextDirection {
+export const TextDirection = {
-    BOTTOM_TO_TOP_LEFT_TO_RIGHT = "btLr",
+    // eslint-disable-next-line @typescript-eslint/naming-convention
-    LEFT_TO_RIGHT_TOP_TO_BOTTOM = "lrTb",
+    BOTTOM_TO_TOP_LEFT_TO_RIGHT: "btLr",
-    TOP_TO_BOTTOM_RIGHT_TO_LEFT = "tbRl",
+    // eslint-disable-next-line @typescript-eslint/naming-convention
-}
+    LEFT_TO_RIGHT_TOP_TO_BOTTOM: "lrTb",
+    // eslint-disable-next-line @typescript-eslint/naming-convention
+    TOP_TO_BOTTOM_RIGHT_TO_LEFT: "tbRl",
+} as const;
 
-class TDirectionAttributes extends XmlAttributeComponent<{ readonly val: TextDirection }> {
+class TDirectionAttributes extends XmlAttributeComponent<{
+    readonly val: (typeof TextDirection)[keyof typeof TextDirection];
+}> {
     protected readonly xmlKeys = { val: "w:val" };
 }
 
@@ -124,7 +131,7 @@ class TDirectionAttributes extends XmlAttributeComponent<{ readonly val: TextDir
  * Text Direction within a table cell
  */
 export class TDirection extends XmlComponent {
-    public constructor(value: TextDirection) {
+    public constructor(value: (typeof TextDirection)[keyof typeof TextDirection]) {
         super("w:textDirection");
 
         this.root.push(

src/file/table/table-cell/table-cell-properties.ts

@@ -17,9 +17,9 @@ import {
 export interface ITableCellPropertiesOptions {
     readonly shading?: IShadingAttributesProperties;
     readonly margins?: ITableCellMarginOptions;
-    readonly verticalAlign?: VerticalAlign;
+    readonly verticalAlign?: (typeof VerticalAlign)[keyof typeof VerticalAlign];
-    readonly textDirection?: TextDirection;
+    readonly textDirection?: (typeof TextDirection)[keyof typeof TextDirection];
-    readonly verticalMerge?: VerticalMergeType;
+    readonly verticalMerge?: (typeof VerticalMergeType)[keyof typeof VerticalMergeType];
     readonly width?: ITableWidthProperties;
     readonly columnSpan?: number;
     readonly rowSpan?: number;

src/file/table/table-properties/table-cell-margin.ts

@@ -1,8 +1,8 @@
 import { IgnoreIfEmptyXmlComponent } from "@file/xml-components";
-import { TableWidthElement, WidthType } from "../table-width";
+import { TableWidthElement, WidthType } from "@file/table";
 
 export interface ITableCellMarginOptions {
-    readonly marginUnitType?: WidthType;
+    readonly marginUnitType?: (typeof WidthType)[keyof typeof WidthType];
     readonly top?: number;
     readonly bottom?: number;
     readonly left?: number;
@@ -33,14 +33,15 @@ export interface ITableCellMarginOptions {
 //     </xsd:sequence>
 // </xsd:complexType>
 
-export enum TableCellMarginElementType {
+export const TableCellMarginElementType = {
-    TABLE = "w:tblCellMar",
+    TABLE: "w:tblCellMar",
-    TABLE_CELL = "w:tcMar",
+    // eslint-disable-next-line @typescript-eslint/naming-convention
-}
+    TABLE_CELL: "w:tcMar",
+} as const;
 
 export class TableCellMargin extends IgnoreIfEmptyXmlComponent {
     public constructor(
-        type: TableCellMarginElementType,
+        type: (typeof TableCellMarginElementType)[keyof typeof TableCellMarginElementType],
         { marginUnitType = WidthType.DXA, top, left, bottom, right }: ITableCellMarginOptions,
     ) {
         super(type);

src/file/table/table-properties/table-float-properties.ts

@@ -1,28 +1,28 @@
 import { NextAttributeComponent, StringEnumValueElement, XmlComponent } from "@file/xml-components";
 import { PositiveUniversalMeasure, signedTwipsMeasureValue, twipsMeasureValue, UniversalMeasure } from "@util/values";
 
-export enum TableAnchorType {
+export const TableAnchorType = {
-    MARGIN = "margin",
+    MARGIN: "margin",
-    PAGE = "page",
+    PAGE: "page",
-    TEXT = "text",
+    TEXT: "text",
-}
+} as const;
 
-export enum RelativeHorizontalPosition {
+export const RelativeHorizontalPosition = {
-    CENTER = "center",
+    CENTER: "center",
-    INSIDE = "inside",
+    INSIDE: "inside",
-    LEFT = "left",
+    LEFT: "left",
-    OUTSIDE = "outside",
+    OUTSIDE: "outside",
-    RIGHT = "right",
+    RIGHT: "right",
-}
+} as const;
 
-export enum RelativeVerticalPosition {
+export const RelativeVerticalPosition = {
-    CENTER = "center",
+    CENTER: "center",
-    INSIDE = "inside",
+    INSIDE: "inside",
-    BOTTOM = "bottom",
+    BOTTOM: "bottom",
-    OUTSIDE = "outside",
+    OUTSIDE: "outside",
-    INLINE = "inline",
+    INLINE: "inline",
-    TOP = "top",
+    TOP: "top",
-}
+} as const;
 
 // <xsd:simpleType name="ST_TblOverlap">
 //     <xsd:restriction base="xsd:string">
@@ -30,10 +30,10 @@ export enum RelativeVerticalPosition {
 //         <xsd:enumeration value="overlap"/>
 //     </xsd:restriction>
 // </xsd:simpleType>
-export enum OverlapType {
+export const OverlapType = {
-    NEVER = "never",
+    NEVER: "never",
-    OVERLAP = "overlap",
+    OVERLAP: "overlap",
-}
+} as const;
 
 export type ITableFloatOptions = {
     /* cSpell:disable */
@@ -46,7 +46,7 @@ export type ITableFloatOptions = {
      * If omitted, the value is assumed to be page.
      */
     /* cSpell:enable */
-    readonly horizontalAnchor?: TableAnchorType;
+    readonly horizontalAnchor?: (typeof TableAnchorType)[keyof typeof TableAnchorType];
 
     /**
      * Specifies an absolute horizontal position for the table, relative to the horizontalAnchor.
@@ -67,7 +67,7 @@ export type ITableFloatOptions = {
      * outside - the table should be outside of the anchor
      * right - the table should be right aligned with respect to the anchor
      */
-    readonly relativeHorizontalPosition?: RelativeHorizontalPosition;
+    readonly relativeHorizontalPosition?: (typeof RelativeHorizontalPosition)[keyof typeof RelativeHorizontalPosition];
 
     /**
      * Specifies the vertical anchor or the base object from which the vertical positioning
@@ -77,7 +77,7 @@ export type ITableFloatOptions = {
      * text - relative to the horizontal edge of the text margin for the column in which the anchor paragraph is located
      * If omitted, the value is assumed to be page.
      */
-    readonly verticalAnchor?: TableAnchorType;
+    readonly verticalAnchor?: (typeof TableAnchorType)[keyof typeof TableAnchorType];
 
     /**
      * Specifies an absolute vertical position for the table, relative to the verticalAnchor anchor.
@@ -98,7 +98,7 @@ export type ITableFloatOptions = {
      * inline - the table should be vertically aligned in line with the surrounding text (so as to not allow any text wrapping around it)
      * top - the table should be vertically aligned to the top edge of the anchor
      */
-    readonly relativeVerticalPosition?: RelativeVerticalPosition;
+    readonly relativeVerticalPosition?: (typeof RelativeVerticalPosition)[keyof typeof RelativeVerticalPosition];
 
     /**
      * Specifies the minimum distance to be maintained between the table and the top of text in the paragraph
@@ -123,7 +123,7 @@ export type ITableFloatOptions = {
      * to the right of the table. The value is in twentieths of a point. If omitted, the value is assumed to be zero.
      */
     readonly rightFromText?: number | PositiveUniversalMeasure;
-    readonly overlap?: OverlapType;
+    readonly overlap?: (typeof OverlapType)[keyof typeof OverlapType];
 };
 
 // <xsd:complexType name="CT_TblPPr">
@@ -156,12 +156,18 @@ export class TableFloatProperties extends XmlComponent {
         super("w:tblpPr");
         this.root.push(
             new NextAttributeComponent<Omit<ITableFloatOptions, "overlap">>({
-                leftFromText: { key: "w:leftFromText", value: leftFromText === undefined ? undefined : twipsMeasureValue(leftFromText) },
+                leftFromText: {
+                    key: "w:leftFromText",
+                    value: leftFromText === undefined ? undefined : twipsMeasureValue(leftFromText),
+                },
                 rightFromText: {
                     key: "w:rightFromText",
                     value: rightFromText === undefined ? undefined : twipsMeasureValue(rightFromText),
                 },
-                topFromText: { key: "w:topFromText", value: topFromText === undefined ? undefined : twipsMeasureValue(topFromText) },
+                topFromText: {
+                    key: "w:topFromText",
+                    value: topFromText === undefined ? undefined : twipsMeasureValue(topFromText),
+                },
                 bottomFromText: {
                     key: "w:bottomFromText",
                     value: bottomFromText === undefined ? undefined : twipsMeasureValue(bottomFromText),
@@ -197,7 +203,7 @@ export class TableFloatProperties extends XmlComponent {
             // <xsd:complexType name="CT_TblOverlap">
             //     <xsd:attribute name="val" type="ST_TblOverlap" use="required"/>
             // </xsd:complexType>
-            this.root.push(new StringEnumValueElement<OverlapType>("w:tblOverlap", overlap));
+            this.root.push(new StringEnumValueElement<(typeof OverlapType)[keyof typeof OverlapType]>("w:tblOverlap", overlap));
         }
     }
 }

src/file/table/table-properties/table-layout.ts

@@ -6,12 +6,14 @@ import { XmlAttributeComponent, XmlComponent } from "@file/xml-components";
 //         <xsd:enumeration value="autofit"/>
 //     </xsd:restriction>
 // </xsd:simpleType>
-export enum TableLayoutType {
+export const TableLayoutType = {
-    AUTOFIT = "autofit",
+    AUTOFIT: "autofit",
-    FIXED = "fixed",
+    FIXED: "fixed",
-}
+} as const;
 
-class TableLayoutAttributes extends XmlAttributeComponent<{ readonly type: TableLayoutType }> {
+class TableLayoutAttributes extends XmlAttributeComponent<{
+    readonly type: (typeof TableLayoutType)[keyof typeof TableLayoutType];
+}> {
     protected readonly xmlKeys = { type: "w:type" };
 }
 
@@ -19,7 +21,7 @@ class TableLayoutAttributes extends XmlAttributeComponent<{ readonly type: Table
 //     <xsd:attribute name="type" type="ST_TblLayoutType"/>
 // </xsd:complexType>
 export class TableLayout extends XmlComponent {
-    public constructor(type: TableLayoutType) {
+    public constructor(type: (typeof TableLayoutType)[keyof typeof TableLayoutType]) {
         super("w:tblLayout");
         this.root.push(new TableLayoutAttributes({ type }));
     }

src/file/table/table-properties/table-properties.ts

@@ -34,12 +34,12 @@ import { TableLayout, TableLayoutType } from "./table-layout";
 export interface ITablePropertiesOptions {
     readonly width?: ITableWidthProperties;
     readonly indent?: ITableWidthProperties;
-    readonly layout?: TableLayoutType;
+    readonly layout?: (typeof TableLayoutType)[keyof typeof TableLayoutType];
     readonly borders?: ITableBordersOptions;
     readonly float?: ITableFloatOptions;
     readonly shading?: IShadingAttributesProperties;
     readonly style?: string;
-    readonly alignment?: AlignmentType;
+    readonly alignment?: (typeof AlignmentType)[keyof typeof AlignmentType];
     readonly cellMargin?: ITableCellMarginOptions;
     readonly visuallyRightToLeft?: boolean;
 }

src/file/table/table-row/table-row-height.ts

@@ -13,24 +13,24 @@ import { PositiveUniversalMeasure, twipsMeasureValue } from "@util/values";
 //         <xsd:enumeration value="atLeast"/>
 //     </xsd:restriction>
 // </xsd:simpleType>
-export enum HeightRule {
+export const HeightRule = {
     /** Height is determined based on the content, so value is ignored. */
-    AUTO = "auto",
+    AUTO: "auto",
     /** At least the value specified */
-    ATLEAST = "atLeast",
+    ATLEAST: "atLeast",
     /** Exactly the value specified */
-    EXACT = "exact",
+    EXACT: "exact",
-}
+} as const;
 
 export class TableRowHeightAttributes extends XmlAttributeComponent<{
     readonly value: number | string;
-    readonly rule: HeightRule;
+    readonly rule: (typeof HeightRule)[keyof typeof HeightRule];
 }> {
     protected readonly xmlKeys = { value: "w:val", rule: "w:hRule" };
 }
 
 export class TableRowHeight extends XmlComponent {
-    public constructor(value: number | PositiveUniversalMeasure, rule: HeightRule) {
+    public constructor(value: number | PositiveUniversalMeasure, rule: (typeof HeightRule)[keyof typeof HeightRule]) {
         super("w:trHeight");
 
         this.root.push(

src/file/table/table-row/table-row-properties.ts

@@ -37,7 +37,7 @@ export interface ITableRowPropertiesOptions {
     readonly tableHeader?: boolean;
     readonly height?: {
         readonly value: number | PositiveUniversalMeasure;
-        readonly rule: HeightRule;
+        readonly rule: (typeof HeightRule)[keyof typeof HeightRule];
     };
 }
 

src/file/table/table-width.ts

@@ -10,16 +10,17 @@ import { measurementOrPercentValue, Percentage, UniversalMeasure } from "@util/v
 //     <xsd:enumeration value="auto"/>
 //   </xsd:restriction>
 // </xsd:simpleType>
-export enum WidthType {
+
+export const WidthType = {
     /** Auto. */
-    AUTO = "auto",
+    AUTO: "auto",
     /** Value is in twentieths of a point */
-    DXA = "dxa",
+    DXA: "dxa",
     /** No (empty) value. */
-    NIL = "nil",
+    NIL: "nil",
     /** Value is in percentage. */
-    PERCENTAGE = "pct",
+    PERCENTAGE: "pct",
-}
+} as const;
 
 // <xsd:complexType name="CT_TblWidth">
 //     <xsd:attribute name="w" type="ST_MeasurementOrPercent"/>
@@ -27,7 +28,7 @@ export enum WidthType {
 // </xsd:complexType>
 export type ITableWidthProperties = {
     readonly size: number | Percentage | UniversalMeasure;
-    readonly type?: WidthType;
+    readonly type?: (typeof WidthType)[keyof typeof WidthType];
 };
 
 export class TableWidthElement extends XmlComponent {

src/file/table/table.ts

@@ -27,10 +27,10 @@ export interface ITableOptions {
     readonly margins?: ITableCellMarginOptions;
     readonly indent?: ITableWidthProperties;
     readonly float?: ITableFloatOptions;
-    readonly layout?: TableLayoutType;
+    readonly layout?: (typeof TableLayoutType)[keyof typeof TableLayoutType];
     readonly style?: string;
     readonly borders?: ITableBordersOptions;
-    readonly alignment?: AlignmentType;
+    readonly alignment?: (typeof AlignmentType)[keyof typeof AlignmentType];
     readonly visuallyRightToLeft?: boolean;
 }
 

src/file/vertical-align/vertical-align.ts

@@ -11,13 +11,14 @@ import { XmlAttributeComponent, XmlComponent } from "@file/xml-components";
 //   <xsd:enumeration value="bottom"/>
 // </xsd:restriction>
 // </xsd:simpleType>
-export enum VerticalAlign {
+export const VerticalAlign = {
-    BOTTOM = "bottom",
+    BOTTOM: "bottom",
-    CENTER = "center",
+    CENTER: "center",
-    TOP = "top",
+    TOP: "top",
-}
+} as const;
+
 export class VerticalAlignAttributes extends XmlAttributeComponent<{
-    readonly verticalAlign?: VerticalAlign;
+    readonly verticalAlign?: (typeof VerticalAlign)[keyof typeof VerticalAlign];
 }> {
     protected readonly xmlKeys = {
         verticalAlign: "w:val",
@@ -25,7 +26,7 @@ export class VerticalAlignAttributes extends XmlAttributeComponent<{
 }
 
 export class VerticalAlignElement extends XmlComponent {
-    public constructor(value: VerticalAlign) {
+    public constructor(value: (typeof VerticalAlign)[keyof typeof VerticalAlign]) {
         super("w:vAlign");
         this.root.push(new VerticalAlignAttributes({ verticalAlign: value }));
     }

src/file/xml-components/imported-xml-component.spec.ts

@@ -55,6 +55,7 @@ describe("ImportedXmlComponent", () => {
             otherAttr: "2",
         };
         importedXmlComponent = new ImportedXmlComponent("w:test", attributes);
+        // eslint-disable-next-line functional/immutable-data
         importedXmlComponent.push(new ImportedXmlComponent("w:child"));
     });
 

src/file/xml-components/imported-xml-component.ts

@@ -21,6 +21,7 @@ export const convertToXmlComponent = (element: XmlElement): ImportedXmlComponent
             for (const childElm of childElements) {
                 const child = convertToXmlComponent(childElm);
                 if (child !== undefined) {
+                    // eslint-disable-next-line functional/immutable-data
                     xmlComponent.push(child);
                 }
             }
@@ -60,6 +61,7 @@ export class ImportedXmlComponent extends XmlComponent {
     public constructor(rootKey: string, _attr?: any) {
         super(rootKey);
         if (_attr) {
+            // eslint-disable-next-line functional/immutable-data
             this.root.push(new ImportedXmlComponentAttributes(_attr));
         }
     }

src/file/xml-components/xml-component.spec.ts

@@ -20,11 +20,13 @@ describe("XmlComponent", () => {
         });
         it("should handle children elements", () => {
             const xmlComponent = new TestComponent("w:test");
+            // eslint-disable-next-line functional/immutable-data
             xmlComponent.push(
                 new Attributes({
                     val: "test",
                 }),
             );
+            // eslint-disable-next-line functional/immutable-data
             xmlComponent.push(new TestComponent("innerTest"));
 
             const tree = new Formatter().format(xmlComponent);
@@ -43,6 +45,7 @@ describe("XmlComponent", () => {
         });
         it("should hoist attrs if only attrs are present", () => {
             const xmlComponent = new TestComponent("w:test");
+            // eslint-disable-next-line functional/immutable-data
             xmlComponent.push(
                 new Attributes({
                     val: "test",

src/file/xml-components/xmlable-object.ts

@@ -1,7 +1,7 @@
 export interface IXmlAttribute {
     readonly [key: string]: string | number | boolean;
 }
-export interface IXmlableObject extends Object {
+export interface IXmlableObject extends Record<string, unknown> {
     // readonly _attr?: IXmlAttribute;
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     readonly [key: string]: any;

src/patcher/from-docx.ts

@@ -20,18 +20,18 @@ import { appendContentType } from "./content-types-manager";
 // eslint-disable-next-line functional/prefer-readonly-type
 type InputDataType = Buffer | string | number[] | Uint8Array | ArrayBuffer | Blob | NodeJS.ReadableStream;
 
-export enum PatchType {
+export const PatchType = {
-    DOCUMENT = "file",
+    DOCUMENT: "file",
-    PARAGRAPH = "paragraph",
+    PARAGRAPH: "paragraph",
-}
+} as const;
 
 type ParagraphPatch = {
-    readonly type: PatchType.PARAGRAPH;
+    readonly type: typeof PatchType.PARAGRAPH;
     readonly children: readonly ParagraphChild[];
 };
 
 type FilePatch = {
-    readonly type: PatchType.DOCUMENT;
+    readonly type: typeof PatchType.DOCUMENT;
     readonly children: readonly FileChild[];
 };
 
@@ -49,6 +49,7 @@ export type IPatch = ParagraphPatch | FilePatch;
 
 export interface PatchDocumentOptions {
     readonly patches: { readonly [key: string]: IPatch };
+    readonly keepOriginalStyles?: boolean;
 }
 
 const imageReplacer = new ImageReplacer();
@@ -82,7 +83,12 @@ export const patchDocument = async (data: InputDataType, options: PatchDocumentO
                 file,
                 viewWrapper: {
                     Relationships: {
-                        createRelationship: (linkId: string, _: string, target: string, __: TargetModeType) => {
+                        createRelationship: (
+                            linkId: string,
+                            _: string,
+                            target: string,
+                            __: (typeof TargetModeType)[keyof typeof TargetModeType],
+                        ) => {
                             // eslint-disable-next-line functional/immutable-data
                             hyperlinkRelationshipAdditions.push({
                                 key,
@@ -128,6 +134,7 @@ export const patchDocument = async (data: InputDataType, options: PatchDocumentO
                     patchText,
                     renderedParagraphs,
                     context,
+                    options.keepOriginalStyles,
                 );
             }
 

src/patcher/paragraph-token-replacer.ts

@@ -3,11 +3,11 @@ import { Element } from "xml-js";
 import { createTextElementContents, patchSpaceAttribute } from "./util";
 import { IRenderedParagraphNode } from "./run-renderer";
 
-enum ReplaceMode {
+const ReplaceMode = {
-    START,
+    START: 0,
-    MIDDLE,
+    MIDDLE: 1,
-    END,
+    END: 2,
-}
+} as const;
 
 export const replaceTokenInParagraphElement = ({
     paragraphElement,
@@ -23,7 +23,7 @@ export const replaceTokenInParagraphElement = ({
     const startIndex = renderedParagraph.text.indexOf(originalText);
     const endIndex = startIndex + originalText.length - 1;
 
-    let replaceMode = ReplaceMode.START;
+    let replaceMode: (typeof ReplaceMode)[keyof typeof ReplaceMode] = ReplaceMode.START;
 
     for (const run of renderedParagraph.runs) {
         for (const { text, index, start, end } of run.parts) {
@@ -43,6 +43,7 @@ export const replaceTokenInParagraphElement = ({
                         patchTextElement(paragraphElement.elements![run.index].elements![index], firstPart);
                         replaceMode = ReplaceMode.MIDDLE;
                         continue;
+                        /* c8 ignore next 2 */
                     }
                     break;
                 case ReplaceMode.MIDDLE:
@@ -59,6 +60,7 @@ export const replaceTokenInParagraphElement = ({
                         patchTextElement(paragraphElement.elements![run.index].elements![index], "");
                     }
                     break;
+                /* c8 ignore next */
                 default:
             }
         }

src/patcher/relationship-manager.ts

@@ -23,7 +23,7 @@ export const appendRelationship = (
     id: number | string,
     type: RelationshipType,
     target: string,
-    targetMode?: TargetModeType,
+    targetMode?: (typeof TargetModeType)[keyof typeof TargetModeType],
 ): readonly Element[] => {
     const relationshipElements = getFirstLevelElements(relationships, "Relationships");
     // eslint-disable-next-line functional/immutable-data

src/patcher/replacer.spec.ts

@@ -44,6 +44,28 @@ const MOCK_JSON = {
                         },
                     ],
                 },
+                {
+                    type: "element",
+                    name: "w:p",
+                    elements: [
+                        {
+                            type: "element",
+                            name: "w:r",
+                            elements: [
+                                {
+                                    type: "element",
+                                    name: "w:rPr",
+                                    elements: [{ type: "element", name: "w:b", attributes: { "w:val": "1" } }],
+                                },
+                                {
+                                    type: "element",
+                                    name: "w:t",
+                                    elements: [{ type: "text", text: "What a {{bold}} text!" }],
+                                },
+                            ],
+                        },
+                    ],
+                },
             ],
         },
     ],
@@ -115,6 +137,93 @@ describe("replacer", () => {
             expect(JSON.stringify(output)).to.contain("Delightful Header");
         });
 
+        it("should replace paragraph type keeping original styling if keepOriginalStyles is true", () => {
+            const output = replacer(
+                MOCK_JSON,
+                {
+                    type: PatchType.PARAGRAPH,
+                    children: [new TextRun("sweet")],
+                },
+                "{{bold}}",
+                [
+                    {
+                        text: "What a {{bold}} text!",
+                        runs: [
+                            {
+                                text: "What a {{bold}} text!",
+                                parts: [{ text: "What a {{bold}} text!", index: 1, start: 0, end: 21 }],
+                                index: 0,
+                                start: 0,
+                                end: 21,
+                            },
+                        ],
+                        index: 0,
+                        path: [0, 0, 1],
+                    },
+                ],
+                {
+                    file: {} as unknown as File,
+                    viewWrapper: {
+                        Relationships: {},
+                    } as unknown as IViewWrapper,
+                    stack: [],
+                },
+                true,
+            );
+
+            expect(JSON.stringify(output)).to.contain("sweet");
+            expect(output.elements![0].elements![1].elements).toMatchObject([
+                {
+                    type: "element",
+                    name: "w:r",
+                    elements: [
+                        {
+                            type: "element",
+                            name: "w:rPr",
+                            elements: [{ type: "element", name: "w:b", attributes: { "w:val": "1" } }],
+                        },
+                        {
+                            type: "element",
+                            name: "w:t",
+                            elements: [{ type: "text", text: "What a " }],
+                        },
+                    ],
+                },
+                {
+                    type: "element",
+                    name: "w:r",
+                    elements: [
+                        {
+                            type: "element",
+                            name: "w:rPr",
+                            elements: [{ type: "element", name: "w:b", attributes: { "w:val": "1" } }],
+                        },
+                        {
+                            type: "element",
+                            name: "w:t",
+                            elements: [{ type: "text", text: "sweet" }],
+                        },
+                    ],
+                },
+                {
+                    type: "element",
+                    name: "w:r",
+                    elements: [
+                        {
+                            type: "element",
+                            name: "w:rPr",
+                            elements: [{ type: "element", name: "w:b", attributes: { "w:val": "1" } }],
+                        },
+                        {
+                            type: "element",
+                            name: "w:t",
+                            elements: [{ type: "text", text: " text!" }],
+                        },
+                    ],
+                },
+            ]);
+        });
+
         it("should replace document type", () => {
             const output = replacer(
                 MOCK_JSON,

src/patcher/replacer.ts

@@ -20,6 +20,7 @@ export const replacer = (
     patchText: string,
     renderedParagraphs: readonly IRenderedParagraphNode[],
     context: IContext,
+    keepOriginalStyles: boolean = false,
 ): Element => {
     for (const renderedParagraph of renderedParagraphs) {
         const textJson = patch.children
@@ -47,9 +48,30 @@ export const replacer = (
 
                 const index = findRunElementIndexWithToken(paragraphElement, SPLIT_TOKEN);
 
-                const { left, right } = splitRunElement(paragraphElement.elements![index], SPLIT_TOKEN);
+                const runElementToBeReplaced = paragraphElement.elements![index];
+                const { left, right } = splitRunElement(runElementToBeReplaced, SPLIT_TOKEN);
+
+                let newRunElements = textJson;
+                let patchedRightElement = right;
+
+                if (keepOriginalStyles) {
+                    const runElementNonTextualElements = runElementToBeReplaced.elements!.filter(
+                        (e) => e.type === "element" && e.name !== "w:t",
+                    );
+
+                    newRunElements = textJson.map((e) => ({
+                        ...e,
+                        elements: [...runElementNonTextualElements, ...e.elements!],
+                    }));
+
+                    patchedRightElement = {
+                        ...right,
+                        elements: [...runElementNonTextualElements, ...right.elements!],
+                    };
+                }
+
                 // eslint-disable-next-line functional/immutable-data
-                paragraphElement.elements!.splice(index, 1, left, ...textJson, right);
+                paragraphElement.elements!.splice(index, 1, left, ...newRunElements, patchedRightElement);
                 break;
             }
         }

tsconfig.json

@@ -1,9 +1,9 @@
 {
     "compilerOptions": {
-        "target": "ES2020",
+        "target": "ES2015",
         "useDefineForClassFields": true,
         "module": "ESNext",
-        "lib": ["ES2020", "DOM", "DOM.Iterable"],
+        "lib": ["ES2015", "DOM", "DOM.Iterable"],
         "skipLibCheck": true,
 
         /* Bundler mode */
@@ -35,14 +35,5 @@
             "@shared": ["./shared/index.ts"]
         }
     },
-    "ts-node": {
-        "esm": true,
-        "compilerOptions": {
-            "module": "ESNext",
-            "moduleResolution": "node",
-            "allowSyntheticDefaultImports": true,
-            "esModuleInterop": true
-        }
-    },
     "include": ["src"]
 }

vite.config.ts

@@ -39,7 +39,7 @@ export default defineConfig({
                 }
 
                 if (d === "es") {
-                    return "index.js";
+                    return "index.mjs";
                 }
 
                 if (d === "iife") {