feat: ✨ add sub sections to section options

src/sections/section.test.ts

@@ -7,7 +7,7 @@ import {
 function createTestSection(options: DocumentSectionOptions) {
   class TestSection extends DocumentSection {
     protected synthesizeContent(): Array<string> {
-      return ['Test Section'];
+      return [options.title, ...this.subSections.map((s) => s.synthesize())];
     }
   }
 
@@ -87,4 +87,32 @@ describe('tryFindSection', () => {
       tryFindSection([testSection], ['Test Section', 'Sub Section']),
     ).toStrictEqual(subSection);
   });
+
+  it('should add single sub section passed in options', () => {
+    const testSection = createTestSection({
+      title: 'Test Section',
+      subSections: [createTestSection({ title: 'Sub Section' })],
+    });
+
+    expect(testSection.synthesize()).toMatchInlineSnapshot(`
+      "Test Section
+      Sub Section"
+    `);
+  });
+
+  it('should add multiple sub sections passed in options', () => {
+    const testSection = createTestSection({
+      title: 'Test Section',
+      subSections: [
+        createTestSection({ title: 'Sub Section 1' }),
+        createTestSection({ title: 'Sub Section 2' }),
+      ],
+    });
+
+    expect(testSection.synthesize()).toMatchInlineSnapshot(`
+      "Test Section
+      Sub Section 1
+      Sub Section 2"
+    `);
+  });
 });

src/sections/section.ts

@@ -3,6 +3,7 @@ import { HeadingLevel } from '../elements/heading.js';
 export interface DocumentSectionOptions {
   title: string;
   parent?: DocumentSection;
+  subSections?: Array<DocumentSection>;
 }
 
 /**
@@ -19,6 +20,7 @@ export abstract class DocumentSection {
     this.title = options.title;
     this.parent = options.parent;
     this.parent?._subSections.push(this);
+    options.subSections?.forEach((section) => this.addSubSection(section));
   }
 
   get subSections(): ReadonlyArray<DocumentSection> {