@elisra-devops/docgen-skins 0.24.0 → 0.26.0

package/src/test/JSONTestSuiteHeaderParagraph.test.ts

@@ -37,4 +37,28 @@ describe('JSONTestSuiteHeaderParagraph', () => {
     expect(json.headingLevel).toBe(2);
     expect(json.runs.length).toBeGreaterThan(0);
   });
+
+  test('emits bookmarkName when wiId is truthy', () => {
+    const fields: any[] = [{ name: 'Custom', value: 'Value' }];
+    const paragraph = new JSONTestSuiteHeaderParagraph(fields, { ...baseStyles }, 42, 2);
+    const json = paragraph.getJSONParagraph();
+
+    expect(json.bookmarkName).toBe('_WI42');
+  });
+
+  test('does not emit bookmarkName when wiId is 0 or falsy', () => {
+    const fields: any[] = [{ name: 'Custom', value: 'Value' }];
+    const paragraph = new JSONTestSuiteHeaderParagraph(fields, { ...baseStyles }, 0, 2);
+    const json = paragraph.getJSONParagraph();
+
+    expect(json.bookmarkName).toBeUndefined();
+  });
+
+  test('does not emit bookmarkName when wiId is undefined', () => {
+    const fields: any[] = [{ name: 'Custom', value: 'Value' }];
+    const paragraph = new JSONTestSuiteHeaderParagraph(fields, { ...baseStyles }, undefined as any, 2);
+    const json = paragraph.getJSONParagraph();
+
+    expect(json.bookmarkName).toBeUndefined();
+  });
 });

package/src/test/SkinsEdgeCases.test.ts

@@ -202,6 +202,57 @@ describe('Skins – edge cases and public API', () => {
     expect(groupedRow.Cells[0].gridSpan).toBeGreaterThan(0);
   });
 
+  test('generateTraceTable defaults to vertical merge enabled when the flag is omitted (SRS back-compat)', () => {
+    const skins = new Skins('json', 'c://template.dotx');
+
+    const buildRow = (nameValue: string) => ({
+      url: '',
+      level: 0,
+      Source: 1,
+      fields: [
+        { name: 'ID', value: 1 },
+        { name: 'Name', value: nameValue },
+      ],
+    });
+
+    const traceData = {
+      title: undefined,
+      adoptedData: [buildRow('Repeated'), buildRow('')],
+      errorMessage: null,
+    };
+
+    const result = skins.generateTraceTable(traceData as any, baseHeaderStyles as any, baseStyles as any, 0);
+    const table: any = result[0];
+
+    expect(table.Rows[2].Cells[1].vMerge).toBe('continue');
+  });
+
+  test('generateTraceTable does not merge when enableVerticalMerge is explicitly false', () => {
+    const skins = new Skins('json', 'c://template.dotx');
+
+    const buildRow = (nameValue: string) => ({
+      url: '',
+      level: 0,
+      Source: 1,
+      fields: [
+        { name: 'ID', value: 1 },
+        { name: 'Name', value: nameValue },
+      ],
+    });
+
+    const traceData = {
+      title: undefined,
+      adoptedData: [buildRow('Repeated'), buildRow('')],
+      errorMessage: null,
+      enableVerticalMerge: false,
+    };
+
+    const result = skins.generateTraceTable(traceData as any, baseHeaderStyles as any, baseStyles as any, 0);
+    const table: any = result[0];
+
+    expect(table.Rows[2].Cells[1].vMerge).toBeUndefined();
+  });
+
   test('generateTraceTable falls back to error paragraph when no adoptedData but errorMessage exists', () => {
     const skins = new Skins('json', 'c://template.dotx');
 

package/src/test/integration/skins.integration.test.ts

@@ -606,3 +606,55 @@ describe('Common functions - tests', () => {
     expect(hasHtml).toBe(true);
   });
 });
+
+describe('Time machine report skin - tests', () => {
+  test('generate time-machine-report skin with compare summary and differences', async () => {
+    const skins = new Skins('json', 'c\\test\\test.dotx');
+    const result = await skins.addNewContentToDocumentSkin(
+      'historical-compare-report-content-control',
+      skins.SKIN_TYPE_TIME_MACHINE,
+      {
+        teamProjectName: 'MEWP',
+        queryName: 'Shared Query',
+        compareResult: {
+          baseline: { asOf: '2025-12-22T17:08:00.000Z', total: 4 },
+          compareTo: { asOf: '2025-12-28T08:57:00.000Z', total: 4 },
+          summary: { updatedCount: 1 },
+          rows: [
+            {
+              id: 11,
+              workItemType: 'Requirement',
+              title: 'Req-11',
+              workItemUrl: 'https://dev.azure.com/org/project/_workitems/edit/11',
+              baselineRevisionId: 2,
+              compareToRevisionId: 20,
+              compareStatus: 'Changed',
+              differences: [{ field: 'Test Phase', baseline: 'FAT', compareTo: 'FAT; ATP' }],
+            },
+          ],
+        },
+      },
+      headerStyles,
+      styles,
+      1,
+    );
+
+    expect(Array.isArray(result)).toBe(true);
+    expect(result.length).toBeGreaterThan(0);
+    expect(result.some((item: any) => item.type === 'table')).toBe(true);
+    expect(
+      result.some((item: any) => {
+        if (item?.type !== 'paragraph') return false;
+        const text = (item?.runs || []).map((run: any) => run?.text || '').join('');
+        return text.includes('Difference');
+      }),
+    ).toBe(true);
+    expect(
+      result.some((item: any) => {
+        if (item?.type !== 'paragraph') return false;
+        const text = (item?.runs || []).map((run: any) => run?.text || '').join('');
+        return text.includes('Work Item Differences');
+      }),
+    ).toBe(true);
+  });
+});