add parallel processing flag to HTMLProcessor

Author: msadovyi

CHANGELOG.md

@@ -1,5 +1,11 @@
 # @code.store/arcxp-sdk-ts
 
+## 4.41.0
+
+### Minor Changes
+
+- add parallel processing flag to HTMLProcessor
+
 ## 4.40.6
 
 ### Patch Changes

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@code.store/arcxp-sdk-ts",
-  "version": "4.40.6",
+  "version": "4.41.0",
   "description": "A strongly typed set of ArcXP API's and utilities reduce the amount of work required to develop with ArcXP, starting with reducing the boilerplate code you have to write.",
   "type": "commonjs",
   "main": "./dist/index.js",

src/content-elements/html/html.processor.ts

@@ -39,6 +39,8 @@ export type WrapHandler = (node: Node, content: ContentElementType<'text'>) => C
  * using the `handle()` and `wrap()` methods.
  */
 export class HTMLProcessor {
+  protected parallelProcessing = true;
+
   protected handlers = {
     node: new Map<string, NodeHandler>(),
     wrap: new Map<string, WrapHandler>(),
@@ -61,6 +63,7 @@ export class HTMLProcessor {
         };
       }
     });
+
     this.wrap('i', (node, text) => {
       if (nodeTagIn(node, ['i'])) {
         return {
@@ -280,14 +283,26 @@ export class HTMLProcessor {
    * @param node - The HTML node to process
    **/
   protected async handleNested(node: Node) {
-    const children = await Promise.all(node.childNodes.map((child) => this.process(child)));
+    const children = await this.processChildNodes(node);
     const filtered = children.filter(Boolean).flat() as CElement[];
     const merged = this.mergeParagraphs(filtered);
     const wrapped = this.wrapChildrenTextNodes(node, merged);
 
     return wrapped;
   }
 
+  protected async processChildNodes(node: Node): Promise<(CElement[] | undefined)[]> {
+    if (this.parallelProcessing) {
+      return await Promise.all(node.childNodes.map((child) => this.process(child)));
+    }
+
+    const children: (CElement[] | undefined)[] = [];
+    for (const child of node.childNodes) {
+      children.push(await this.process(child));
+    }
+    return children;
+  }
+
   /**
    * Processes a single HTML node and converts it into content elements.
    * This method iterates through registered node handlers and attempts to process the node.
@@ -325,7 +340,7 @@ export class HTMLProcessor {
    *
    * @param items - The array of content elements to merge
    **/
-  private mergeParagraphs(items: CElement[]): CElement[] {
+  protected mergeParagraphs(items: CElement[]): CElement[] {
     const merged: CElement[] = [];
     let toMerge: ContentElementType<'text'>[] = [];