Sort LWC metadata targets and configurations

Author: cesarParra

examples/markdown/docs/index.md

@@ -12,20 +12,20 @@ Represents an event that people can register for.
 
 ### [Price_Component__c](custom-objects/Price_Component__c.md)
 
-### [Product_Price_Component__c](custom-objects/Product_Price_Component__c.md)
-
 ### [Product__c](custom-objects/Product__c.md)
 
 Product that is sold or available for sale.
 
-### [Sales_Order_Line__c](custom-objects/Sales_Order_Line__c.md)
-
-Represents a line item on a sales order.
+### [Product_Price_Component__c](custom-objects/Product_Price_Component__c.md)
 
 ### [Sales_Order__c](custom-objects/Sales_Order__c.md)
 
 Custom object for tracking sales orders.
 
+### [Sales_Order_Line__c](custom-objects/Sales_Order_Line__c.md)
+
+Represents a line item on a sales order.
+
 ### [Speaker__c](custom-objects/Speaker__c.md)
 
 Represents a speaker at an event.

examples/markdown/package.json

@@ -15,6 +15,7 @@
   "apexdocs": {
     "sourceDir": "force-app",
     "scope": ["global", "public", "protected", "private", "namespaceaccessible"],
-    "namespace": "ns"
+    "namespace": "ns",
+    "sortAlphabetically": true
   }
 }

src/core/reflection/sort-types-and-members.ts

@@ -1,7 +1,8 @@
 import { ClassMirror, EnumMirror, InterfaceMirror, Type } from '@cparra/apex-reflection';
 import { ParsedFile, TopLevelType } from '../shared/types';
-import { isApexType, isObjectType } from '../shared/utils';
+import { isApexType, isLwcType, isObjectType } from '../shared/utils';
 import { CustomObjectMetadata } from './sobject/reflect-custom-object-sources';
+import { LwcMetadata } from './lwc/reflect-lwc-source';
 
 type Named = { name: string };
 
@@ -23,10 +24,15 @@ export function sortTypesAndMembers(
           type: sortCustomObjectFields(parsedFile.type, shouldSort),
         };
       }
+      if (isLwcType(parsedFile.type)) {
+        return {
+          ...parsedFile,
+          type: sortLwcMetadata(parsedFile.type, shouldSort),
+        };
+      }
+
       // For TriggerMetadata or any other types, return the original parsedFile unchanged
       return parsedFile;
-
-      // TODO: Parsed LWC members (properties and methods)
     })
     .sort((a, b) => sortByNames(shouldSort, a.type, b.type));
 }
@@ -85,3 +91,37 @@ function sortClassMembers(shouldSort: boolean, classType: ClassMirror): ClassMir
     properties: sortNamed(shouldSort, classType.properties),
   };
 }
+
+function sortLwcMetadata(type: LwcMetadata, shouldSort: boolean): LwcMetadata {
+  if (!shouldSort) {
+    return type;
+  }
+
+  const sortedType = { ...type };
+
+  // Sort targets.
+  if (sortedType.targets?.target) {
+    sortedType.targets = {
+      ...sortedType.targets,
+      target: [...sortedType.targets.target].sort(),
+    };
+  }
+
+  // Sort targetConfigs.
+  if (sortedType.targetConfigs?.targetConfig) {
+    sortedType.targetConfigs = {
+      ...sortedType.targetConfigs,
+      targetConfig: sortedType.targetConfigs.targetConfig.map((config) => {
+        if (config.property) {
+          return {
+            ...config,
+            property: [...config.property].sort((a, b) => a['@_name'].localeCompare(b['@_name'])),
+          };
+        }
+        return config;
+      }),
+    };
+  }
+
+  return sortedType;
+}