@cparra/apexdocs 2.15.1 → 2.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/README.md +10 -0
  2. package/docs/types/Misc-Group/nspc.AtFutureRecipes.md +4 -0
  3. package/docs/types/Misc-Group/nspc.EscapedAnnotations.md +4 -0
  4. package/docs/types/Misc-Group/nspc.MemberGrouping.md +1 -1
  5. package/docs/types/README.md +6 -0
  6. package/examples/force-app/main/default/classes/EscapedAnnotations.cls +5 -0
  7. package/examples/force-app/main/default/classes/MemberGrouping.cls +1 -0
  8. package/package.json +4 -4
package/README.md CHANGED
@@ -69,6 +69,16 @@ public class MyClass {
69
69
  ```
70
70
 
71
71
  * Apex docs blocks can now all be in a single line
72
+
73
+ 📒 Note: If you wish to have multiple `@` tags in a single line but don't want them to be treated as ApexDoc annotations, you can
74
+ escape them by adding wrapping the annotation in ticks, for example
75
+
76
+ ```apex
77
+ /**
78
+ * @MyCustomAnnotation This is a custom annotation with an `@embedded` annotation
79
+ */
80
+ ```
81
+
72
82
  * Support for grouping blocks of related code within a class
73
83
  * Support for HTML tags
74
84
  * OpenApi REST specification generation
package/docs/types/Misc-Group/nspc.AtFutureRecipes.md ADDED
@@ -0,0 +1,4 @@
1
+ # nspc.AtFutureRecipes
2
+
3
+ Demonstrates the @future syntax and usage
4
+
package/docs/types/Misc-Group/nspc.EscapedAnnotations.md ADDED
@@ -0,0 +1,4 @@
1
+ # nspc.EscapedAnnotations
2
+
3
+ This sentence has an `@embedded` annotation.
4
+
package/docs/types/Misc-Group/nspc.MemberGrouping.md CHANGED
@@ -8,6 +8,6 @@
8
8
  ### Group new syntax
9
9
  Group's description
10
10
 
11
- * `public anotherInGroup2` → `String`
11
+ * `public anotherInGroup2` → `String` - Description for another constant in group 2
12
12
  * `public inGroup2` → `String` - Description for constant in group 2
13
13
  ---
package/docs/types/README.md CHANGED
@@ -14,6 +14,12 @@ Some desc
14
14
 
15
15
  ## Misc Group
16
16
 
17
+ ### [nspc.EscapedAnnotations](types/Misc-Group/nspc.EscapedAnnotations.md)
18
+
19
+ This sentence has an `@embedded` annotation.
20
+
21
+
22
+
17
23
  ### [nspc.GrandparentClass](types/Misc-Group/nspc.GrandparentClass.md)
18
24
 
19
25
 
package/examples/force-app/main/default/classes/EscapedAnnotations.cls ADDED
@@ -0,0 +1,5 @@
1
+ /**
2
+ * @description This sentence has an `@embedded` annotation.
3
+ */
4
+ public with sharing class EscapedAnnotations {
5
+ }
package/examples/force-app/main/default/classes/MemberGrouping.cls CHANGED
@@ -11,6 +11,7 @@ public class MemberGrouping {
11
11
 
12
12
  /** @description Description for constant in group 2 */
13
13
  public static final String inGroup2;
14
+ /** @description Description for another constant in group 2 @future annotation */
14
15
  public static final String anotherInGroup2;
15
16
  /** @end-group */
16
17
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cparra/apexdocs",
3
- "version": "2.15.1",
3
+ "version": "2.16.0",
4
4
  "description": "Library with CLI capabilities to generate documentation for Salesforce Apex classes.",
5
5
  "keywords": [
6
6
  "apex",
@@ -47,9 +47,9 @@
47
47
  "eslint": "^8.0.1",
48
48
  "eslint-config-prettier": "^8.3.0",
49
49
  "eslint-plugin-prettier": "^4.0.0",
50
- "husky": "^4.2.3",
50
+ "husky": "^8.0.3",
51
51
  "jest": "^27.5.1",
52
- "lint-staged": "^12.3.7",
52
+ "lint-staged": "^13.2.1",
53
53
  "prettier": "^2.4.1",
54
54
  "rimraf": "^3.0.2",
55
55
  "ts-jest": "^27.1.3",
@@ -66,7 +66,7 @@
66
66
  ]
67
67
  },
68
68
  "dependencies": {
69
- "@cparra/apex-reflection": "2.3.1",
69
+ "@cparra/apex-reflection": "2.4.0",
70
70
  "chalk": "^4.1.2",
71
71
  "fast-xml-parser": "^4.0.1",
72
72
  "js-yaml": "^4.1.0",