@cparra/apexdocs 2.25.0-alpha.4 → 2.25.0-alpha.5

package/src/{__spec__/core → core/markdown/__test__}/generating-enum-docs.spec.ts

@@ -1,6 +1,5 @@
-import { generateDocs } from '../../core/generate-docs';
 import { assertEither, extendExpect } from './expect-extensions';
-import { apexBundleFromRawString } from './test-helpers';
+import { apexBundleFromRawString, generateDocs } from './test-helpers';
 
 describe('Generates enum documentation', () => {
   beforeAll(() => {
@@ -8,7 +7,7 @@ describe('Generates enum documentation', () => {
   });
 
   describe('documentation output', () => {
-    it('always returns markdown as the format', () => {
+    it('returns the name of the enum', async () => {
       const input = `
      public enum MyEnum {
         VALUE1,
@@ -16,24 +15,12 @@ describe('Generates enum documentation', () => {
       }
     `;
 
-      const result = generateDocs([apexBundleFromRawString(input)]);
-      assertEither(result, (data) => expect(data.format).toBe('markdown'));
-    });
-
-    it('returns the name of the enum', () => {
-      const input = `
-     public enum MyEnum {
-        VALUE1,
-        VALUE2
-      }
-    `;
-
-      const result = generateDocs([apexBundleFromRawString(input)]);
+      const result = await generateDocs([apexBundleFromRawString(input)])();
       expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data.docs[0].typeName).toBe('MyEnum'));
+      assertEither(result, (data) => expect(data.docs[0].fileName).toBe('MyEnum'));
     });
 
-    it('returns the type as enum', () => {
+    it('returns the type as enum', async () => {
       const input = `
      public enum MyEnum {
         VALUE1,
@@ -41,12 +28,12 @@ describe('Generates enum documentation', () => {
       }
     `;
 
-      const result = generateDocs([apexBundleFromRawString(input)]);
+      const result = await generateDocs([apexBundleFromRawString(input)])();
       expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data.docs[0].type).toBe('enum'));
+      assertEither(result, (data) => expect(data.docs[0].source.type).toBe('enum'));
     });
 
-    it('does not return enums out of scope', () => {
+    it('does not return enums out of scope', async () => {
       const input1 = `
      global enum MyEnum {
         VALUE1,
@@ -61,13 +48,13 @@ describe('Generates enum documentation', () => {
         }
       `;
 
-      const result = generateDocs([apexBundleFromRawString(input1), apexBundleFromRawString(input2)], {
+      const result = await generateDocs([apexBundleFromRawString(input1), apexBundleFromRawString(input2)], {
         scope: ['global'],
-      });
+      })();
       expect(result).documentationBundleHasLength(1);
     });
 
-    it('does not return enums that have an @ignore in the docs', () => {
+    it('does not return enums that have an @ignore in the docs', async () => {
       const input = `
       /**
         * @ignore
@@ -78,13 +65,13 @@ describe('Generates enum documentation', () => {
       }
       `;
 
-      const result = generateDocs([apexBundleFromRawString(input)]);
+      const result = await generateDocs([apexBundleFromRawString(input)])();
       expect(result).documentationBundleHasLength(0);
     });
   });
 
   describe('documentation content', () => {
-    it('generates a heading with the enum name', () => {
+    it('generates a heading with the enum name', async () => {
       const input = `
      public enum MyEnum {
         VALUE1,
@@ -94,12 +81,12 @@ describe('Generates enum documentation', () => {
 
       const output = `# MyEnum Enum`;
 
-      const result = generateDocs([apexBundleFromRawString(input)]);
+      const result = await generateDocs([apexBundleFromRawString(input)])();
       expect(result).documentationBundleHasLength(1);
       assertEither(result, (data) => expect(data).firstDocContains(output));
     });
 
-    it('displays type level annotations', () => {
+    it('displays type level annotations', async () => {
       const input = `
         @NamespaceAccessible
         public enum MyEnum {
@@ -108,12 +95,12 @@ describe('Generates enum documentation', () => {
          }
        `;
 
-      const result = generateDocs([apexBundleFromRawString(input)]);
+      const result = await generateDocs([apexBundleFromRawString(input)])();
       expect(result).documentationBundleHasLength(1);
       assertEither(result, (data) => expect(data).firstDocContains('NAMESPACEACCESSIBLE'));
     });
 
-    it('displays the description', () => {
+    it('displays the description', async () => {
       const input = `
      /**
       * This is a description
@@ -124,12 +111,12 @@ describe('Generates enum documentation', () => {
       }
     `;
 
-      const result = generateDocs([apexBundleFromRawString(input)]);
+      const result = await generateDocs([apexBundleFromRawString(input)])();
       expect(result).documentationBundleHasLength(1);
       assertEither(result, (data) => expect(data).firstDocContains('This is a description'));
     });
 
-    it('display custom documentation tags', () => {
+    it('display custom documentation tags', async () => {
       const input = `
      /**
       * @custom-tag My Value
@@ -140,13 +127,13 @@ describe('Generates enum documentation', () => {
       }
     `;
 
-      const result = generateDocs([apexBundleFromRawString(input)]);
+      const result = await generateDocs([apexBundleFromRawString(input)])();
       expect(result).documentationBundleHasLength(1);
       assertEither(result, (data) => expect(data).firstDocContains('Custom Tag'));
       assertEither(result, (data) => expect(data).firstDocContains('My Value'));
     });
 
-    it('displays the group', () => {
+    it('displays the group', async () => {
       const input = `
      /**
       * @group MyGroup
@@ -157,13 +144,13 @@ describe('Generates enum documentation', () => {
       }
     `;
 
-      const result = generateDocs([apexBundleFromRawString(input)]);
+      const result = await generateDocs([apexBundleFromRawString(input)])();
       expect(result).documentationBundleHasLength(1);
       assertEither(result, (data) => expect(data).firstDocContains('Group'));
       assertEither(result, (data) => expect(data).firstDocContains('MyGroup'));
     });
 
-    it('displays the author', () => {
+    it('displays the author', async () => {
       const input = `
      /**
       * @author John Doe
@@ -174,13 +161,13 @@ describe('Generates enum documentation', () => {
       }
     `;
 
-      const result = generateDocs([apexBundleFromRawString(input)]);
+      const result = await generateDocs([apexBundleFromRawString(input)])();
       expect(result).documentationBundleHasLength(1);
       assertEither(result, (data) => expect(data).firstDocContains('Author'));
       assertEither(result, (data) => expect(data).firstDocContains('John Doe'));
     });
 
-    it('displays the date', () => {
+    it('displays the date', async () => {
       const input = `
      /**
       * @date 2021-01-01
@@ -191,13 +178,13 @@ describe('Generates enum documentation', () => {
       }
     `;
 
-      const result = generateDocs([apexBundleFromRawString(input)]);
+      const result = await generateDocs([apexBundleFromRawString(input)])();
       expect(result).documentationBundleHasLength(1);
       assertEither(result, (data) => expect(data).firstDocContains('Date'));
       assertEither(result, (data) => expect(data).firstDocContains('2021-01-01'));
     });
 
-    it('displays descriptions', () => {
+    it('displays descriptions', async () => {
       const input = `
       /**
         * @description This is a description
@@ -205,12 +192,12 @@ describe('Generates enum documentation', () => {
       public enum MyEnum {}
       `;
 
-      const result = generateDocs([apexBundleFromRawString(input)]);
+      const result = await generateDocs([apexBundleFromRawString(input)])();
       expect(result).documentationBundleHasLength(1);
       assertEither(result, (data) => expect(data).firstDocContains('This is a description'));
     });
 
-    it('displays descriptions with links', () => {
+    it('displays descriptions with links', async () => {
       const input1 = `
       /**
         * @description This is a description with a {@link EnumRef} reference
@@ -220,7 +207,7 @@ describe('Generates enum documentation', () => {
 
       const input2 = 'public enum EnumRef {}';
 
-      const result = generateDocs([apexBundleFromRawString(input1), apexBundleFromRawString(input2)]);
+      const result = await generateDocs([apexBundleFromRawString(input1), apexBundleFromRawString(input2)])();
       expect(result).documentationBundleHasLength(2);
       assertEither(result, (data) => expect(data).firstDocContains('Description'));
       assertEither(result, (data) =>
@@ -228,7 +215,7 @@ describe('Generates enum documentation', () => {
       );
     });
 
-    it('displays descriptions with emails', () => {
+    it('displays descriptions with emails', async () => {
       const input = `
       /**
         * @description This is a description with an {@email test@testerson.com} email
@@ -236,7 +223,7 @@ describe('Generates enum documentation', () => {
       public enum MyEnum {}
       `;
 
-      const result = generateDocs([apexBundleFromRawString(input)]);
+      const result = await generateDocs([apexBundleFromRawString(input)])();
       expect(result).documentationBundleHasLength(1);
       assertEither(result, (data) =>
         expect(data).firstDocContains(
@@ -245,7 +232,7 @@ describe('Generates enum documentation', () => {
       );
     });
 
-    it('displays sees with accurately resolved links', () => {
+    it('displays sees with accurately resolved links', async () => {
       const input1 = `
       /**
         * @see EnumRef
@@ -255,13 +242,13 @@ describe('Generates enum documentation', () => {
 
       const input2 = 'public enum EnumRef {}';
 
-      const result = generateDocs([apexBundleFromRawString(input1), apexBundleFromRawString(input2)]);
+      const result = await generateDocs([apexBundleFromRawString(input1), apexBundleFromRawString(input2)])();
       expect(result).documentationBundleHasLength(2);
       assertEither(result, (data) => expect(data).firstDocContains('See'));
       assertEither(result, (data) => expect(data).firstDocContains('[EnumRef](./EnumRef.md)'));
     });
 
-    it('displays sees without links when the reference is not found', () => {
+    it('displays sees without links when the reference is not found', async () => {
       const input = `
       /**
         * @see EnumRef
@@ -269,34 +256,34 @@ describe('Generates enum documentation', () => {
       public enum MyEnum {}
       `;
 
-      const result = generateDocs([apexBundleFromRawString(input)]);
+      const result = await generateDocs([apexBundleFromRawString(input)])();
       expect(result).documentationBundleHasLength(1);
       assertEither(result, (data) => expect(data).firstDocContains('See'));
       assertEither(result, (data) => expect(data).firstDocContains('EnumRef'));
     });
 
-    it('displays the namespace if present in the config', () => {
+    it('displays the namespace if present in the config', async () => {
       const input = `
       public enum MyEnum {}
       `;
 
-      const result = generateDocs([apexBundleFromRawString(input)], { namespace: 'MyNamespace' });
+      const result = await generateDocs([apexBundleFromRawString(input)], { namespace: 'MyNamespace' })();
       expect(result).documentationBundleHasLength(1);
       assertEither(result, (data) => expect(data).firstDocContains('## Namespace'));
       assertEither(result, (data) => expect(data).firstDocContains('MyNamespace'));
     });
 
-    it('does not display the namespace if not present in the config', () => {
+    it('does not display the namespace if not present in the config', async () => {
       const input = `
       public enum MyEnum {}
       `;
 
-      const result = generateDocs([apexBundleFromRawString(input)]);
+      const result = await generateDocs([apexBundleFromRawString(input)])();
       expect(result).documentationBundleHasLength(1);
       assertEither(result, (data) => expect(data).firstDocContainsNot('## Namespace'));
     });
 
-    it('displays a mermaid diagram', () => {
+    it('displays a mermaid diagram', async () => {
       const input = `
       /**
         * @mermaid
@@ -312,13 +299,13 @@ describe('Generates enum documentation', () => {
       }
       `;
 
-      const result = generateDocs([apexBundleFromRawString(input)]);
+      const result = await generateDocs([apexBundleFromRawString(input)])();
       expect(result).documentationBundleHasLength(1);
       assertEither(result, (data) => expect(data).firstDocContains('```mermaid'));
       assertEither(result, (data) => expect(data).firstDocContains('graph TD'));
     });
 
-    it('displays an example code block', () => {
+    it('displays an example code block', async () => {
       const input = `
       /**
         * @example
@@ -334,13 +321,13 @@ describe('Generates enum documentation', () => {
       }
       `;
 
-      const result = generateDocs([apexBundleFromRawString(input)]);
+      const result = await generateDocs([apexBundleFromRawString(input)])();
       expect(result).documentationBundleHasLength(1);
       assertEither(result, (data) => expect(data).firstDocContains('```apex'));
       assertEither(result, (data) => expect(data).firstDocContains('public class MyClass'));
     });
 
-    it('displays values', () => {
+    it('displays values', async () => {
       const input = `
       public enum MyEnum {
         VALUE1,
@@ -348,11 +335,47 @@ describe('Generates enum documentation', () => {
       }
       `;
 
-      const result = generateDocs([apexBundleFromRawString(input)]);
+      const result = await generateDocs([apexBundleFromRawString(input)])();
       expect(result).documentationBundleHasLength(1);
       assertEither(result, (data) => expect(data).firstDocContains('## Values'));
       assertEither(result, (data) => expect(data).firstDocContains('VALUE1'));
       assertEither(result, (data) => expect(data).firstDocContains('VALUE2'));
     });
+
+    it('displays values sorted when sortMembersAlphabetically is true', async () => {
+      const input = `
+      public enum MyEnum {
+        VALUE2,
+        VALUE1
+      }
+      `;
+
+      const result = await generateDocs([apexBundleFromRawString(input)], { sortMembersAlphabetically: true })();
+      expect(result).documentationBundleHasLength(1);
+      assertEither(result, (data) => expect(data).firstDocContains('## Values'));
+      assertEither(result, (data) => {
+        const value1Index = data.docs[0].content.indexOf('VALUE1');
+        const value2Index = data.docs[0].content.indexOf('VALUE2');
+        expect(value1Index).toBeLessThan(value2Index);
+      });
+    });
+
+    it('does not sort values when sortMembersAlphabetically is false', async () => {
+      const input = `
+      public enum MyEnum {
+        VALUE2,
+        VALUE1
+      }
+      `;
+
+      const result = await generateDocs([apexBundleFromRawString(input)], { sortMembersAlphabetically: false })();
+      expect(result).documentationBundleHasLength(1);
+      assertEither(result, (data) => expect(data).firstDocContains('## Values'));
+      assertEither(result, (data) => {
+        const value1Index = data.docs[0].content.indexOf('VALUE1');
+        const value2Index = data.docs[0].content.indexOf('VALUE2');
+        expect(value1Index).toBeGreaterThan(value2Index);
+      });
+    });
   });
 });