Added api annotations to enumerations and updated merge.js

Author: BasicPrimitives

merge.js

@@ -111,7 +111,10 @@ function read_enumerations(files, enums) {
 
 function getEnumValues(fileName) {
   const fileContent = fs.readFileSync(fileName, "utf8");
-  let fileText = fileContent.substring(fileContent.indexOf("*/") + 2);
+  let fileText = fileContent.replace(/\/\*[\s\S]*?\*\/|([^\\:]|^)\/\/.*$/gi, () => {
+    return '';
+  });
+
   const chars = ['\uFEFF', "\n", "\r", "\t", " "];
   chars.forEach(item => {
     fileText = fileText.replaceAll(item, '');

src.primitives/enums/AdviserPlacementType.js

@@ -1,15 +1,28 @@
-/*
-	Enum: primitives.common.AdviserPlacementType
-		Defines item placement in tree relative to parent.
-	
-	Auto - Layout manager defined.
-	Left - Item placed on the left side of parent.
-	Right - Item placed on the right side of parent.
-*/
+/**
+ * @typedef {number} AdviserPlacementType
+ **/
+
+
+/**
+ * Defines leftward or rightward item placement relative to the referenced item.
+ * In case of assitants and advisers the referenced item is their imediate parent.
+ * In case of family diagram the referenced item is spouse or sibling in the row. 
+ *  
+ * @enum {AdviserPlacementType}
+ */
 primitives.common.AdviserPlacementType =
 {
+	/**
+	 * Auto select by layout manager
+	 */
 	Auto: 0,
+	/**
+	 * Left side
+	 */
 	Left: 2,
+	/**
+	 * Right side
+	 */
 	Right: 3
 };
 

src.primitives/enums/AnnotationType.js

@@ -1,16 +1,42 @@
-/*
-	Enum: primitives.common.AnnotationType
-		Defines type of annotation object.
-	
-	Connector - Connector lines between two rectangular areas.
-	Shape - Shape around rectanglur area.
-	HighlightPath - Use highlight properties for connector lines between items.
-*/
+/**
+ * @typedef {number} AnnotationType
+ **/
+
+
+/**
+	Defines type of on-screen and in-layout annotation object. Annotations are geometrical 
+	figures drawn around or bound to existing nodes of the diagram.
+*  
+ * @enum {AnnotationType}
+ */
 primitives.common.AnnotationType =
 {
+	/**
+	 * Connector lines between two nodes of the diagram. They are drawn on top of existing
+	 * diagram layout and they don't affect nodes placement. So it is users responsibility to
+	 * prserve space between nodes for them.
+	 */
 	Connector: 0,
+	/**
+	 * Shape annotation is a possibility to draw some geometrical
+	 * shapes over several nodes of the diagram. 
+	 */
 	Shape: 1,
+	/**
+	 * Highlight path annotation traces path between given sequence of nodes 
+	 * over existing connector lines in the diagram.
+	 */
 	HighlightPath: 2,
+	/**
+	 * In-layout label annotation. Label anntations are placed in layout between nodes,
+	 * they preserve space between nodes, so they don't overlap neighbouring nodes.
+	 * Label annotations are designed for autoplacement and bundling of connection lines between 
+	 * nodes when needed.
+	 */
 	Label: 3,
+	/**
+	 * Background annotation highlights nodes via drawing rectangular shape in background.
+	 * If shapes overlap the same style neighbouring shapes they are merged into one continuous shape. 
+	 */
 	Background: 4
 };