@cparra/apexdocs 2.22.0 → 2.23.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 (184) hide show
  1. package/.eslintrc.js +12 -12
  2. package/.github/workflows/close_stale.yml +22 -22
  3. package/.prettierrc.js +7 -7
  4. package/LICENSE +21 -21
  5. package/README.md +718 -682
  6. package/apexdocs.config.ts +13 -11
  7. package/docs/README.md +1 -1
  8. package/docs/restapi.json +589 -589
  9. package/docs/types/Classes/nspc.ChildClass.md +21 -18
  10. package/docs/types/Main/nspc.SampleClass.md +13 -13
  11. package/examples/force-app/main/default/classes/AnotherInterface.cls +16 -16
  12. package/examples/force-app/main/default/classes/ChildClass.cls +42 -41
  13. package/examples/force-app/main/default/classes/EscapedAnnotations.cls +5 -5
  14. package/examples/force-app/main/default/classes/GrandparentClass.cls +4 -4
  15. package/examples/force-app/main/default/classes/GroupedClass.cls +8 -8
  16. package/examples/force-app/main/default/classes/MemberGrouping.cls +17 -17
  17. package/examples/force-app/main/default/classes/ParentClass.cls +16 -16
  18. package/examples/force-app/main/default/classes/SampleClass.cls +166 -166
  19. package/examples/force-app/main/default/classes/SampleClass.cls-meta.xml +5 -5
  20. package/examples/force-app/main/default/classes/SampleClassWithoutModifier.cls +9 -9
  21. package/examples/force-app/main/default/classes/SampleInterface.cls +16 -16
  22. package/examples/force-app/main/default/restapi/SampleRestResource.cls +195 -195
  23. package/examples/force-app/main/default/restapi/SampleRestResourceToSkip.cls +35 -35
  24. package/examples/force-app/main/default/restapi/SampleRestResourceWithInnerClass.cls +24 -24
  25. package/examples/force-app/main/default/restapi/SampleRestResourceWithoutApexDocs.cls +15 -15
  26. package/examples/force-app/main/default/restapi/references/Reference1.cls +9 -9
  27. package/examples/force-app/main/default/restapi/references/Reference2.cls +9 -9
  28. package/examples/force-app/main/default/restapi/references/Reference3.cls +3 -3
  29. package/examples/force-app/main/default/restapi/references/Reference4.cls +3 -3
  30. package/examples/force-app/main/default/restapi/references/Reference5.cls +3 -3
  31. package/examples/force-app/main/default/restapi/references/Reference6.cls +6 -6
  32. package/examples/force-app/main/default/restapi/references/Reference7.cls +3 -3
  33. package/examples/includes/header.md +3 -3
  34. package/jest.config.js +5 -5
  35. package/lib/application/Apexdocs.d.ts +13 -13
  36. package/lib/application/Apexdocs.js +76 -76
  37. package/lib/cli/generate.d.ts +2 -2
  38. package/lib/cli/generate.js +130 -122
  39. package/lib/cli/generate.js.map +1 -1
  40. package/lib/index.d.ts +1 -1
  41. package/lib/index.js +17 -17
  42. package/lib/model/apex-bundle.d.ts +6 -6
  43. package/lib/model/apex-bundle.js +10 -10
  44. package/lib/model/apex-type-wrappers/ClassMirrorWrapper.d.ts +7 -7
  45. package/lib/model/apex-type-wrappers/ClassMirrorWrapper.js +13 -13
  46. package/lib/model/apex-type-wrappers/MethodMirrorWrapper.d.ts +7 -7
  47. package/lib/model/apex-type-wrappers/MethodMirrorWrapper.js +11 -11
  48. package/lib/model/inheritance.d.ts +8 -8
  49. package/lib/model/inheritance.js +2 -2
  50. package/lib/model/manifest-diff.d.ts +27 -27
  51. package/lib/model/manifest-diff.js +68 -68
  52. package/lib/model/manifest.d.ts +22 -22
  53. package/lib/model/manifest.js +46 -46
  54. package/lib/model/markdown-file.d.ts +16 -16
  55. package/lib/model/markdown-file.js +106 -106
  56. package/lib/model/markdown-generation-util/doc-comment-annotation-util.d.ts +8 -8
  57. package/lib/model/markdown-generation-util/doc-comment-annotation-util.js +43 -43
  58. package/lib/model/markdown-generation-util/field-declaration-util.d.ts +3 -3
  59. package/lib/model/markdown-generation-util/field-declaration-util.js +54 -62
  60. package/lib/model/markdown-generation-util/field-declaration-util.js.map +1 -1
  61. package/lib/model/markdown-generation-util/index.d.ts +3 -3
  62. package/lib/model/markdown-generation-util/index.js +19 -19
  63. package/lib/model/markdown-generation-util/method-declaration-util.d.ts +4 -4
  64. package/lib/model/markdown-generation-util/method-declaration-util.js +114 -114
  65. package/lib/model/markdown-generation-util/type-declaration-util.d.ts +3 -3
  66. package/lib/model/markdown-generation-util/type-declaration-util.js +81 -81
  67. package/lib/model/markdown-home-file.d.ts +11 -11
  68. package/lib/model/markdown-home-file.js +53 -53
  69. package/lib/model/markdown-type-file.d.ts +26 -26
  70. package/lib/model/markdown-type-file.js +133 -141
  71. package/lib/model/markdown-type-file.js.map +1 -1
  72. package/lib/model/openapi/apex-doc-types.d.ts +19 -19
  73. package/lib/model/openapi/apex-doc-types.js +4 -4
  74. package/lib/model/openapi/open-api-types.d.ts +93 -93
  75. package/lib/model/openapi/open-api-types.js +2 -2
  76. package/lib/model/openapi/open-api.d.ts +16 -16
  77. package/lib/model/openapi/open-api.js +33 -33
  78. package/lib/model/openapi/openapi-type-file.d.ts +7 -7
  79. package/lib/model/openapi/openapi-type-file.js +16 -16
  80. package/lib/model/outputFile.d.ts +10 -10
  81. package/lib/model/outputFile.js +28 -28
  82. package/lib/model/types-repository.d.ts +16 -16
  83. package/lib/model/types-repository.js +53 -53
  84. package/lib/service/apex-file-reader.d.ts +14 -14
  85. package/lib/service/apex-file-reader.js +45 -45
  86. package/lib/service/file-system.d.ts +14 -14
  87. package/lib/service/file-system.js +24 -24
  88. package/lib/service/file-writer.d.ts +6 -6
  89. package/lib/service/file-writer.js +33 -33
  90. package/lib/service/manifest-factory.d.ts +10 -10
  91. package/lib/service/manifest-factory.js +13 -13
  92. package/lib/service/metadata-processor.d.ts +3 -3
  93. package/lib/service/metadata-processor.js +16 -16
  94. package/lib/service/parser.d.ts +21 -21
  95. package/lib/service/parser.js +134 -134
  96. package/lib/service/state.d.ts +9 -9
  97. package/lib/service/state.js +19 -19
  98. package/lib/service/walkers/class-walker.d.ts +4 -4
  99. package/lib/service/walkers/class-walker.js +32 -32
  100. package/lib/service/walkers/class-walker.js.map +1 -1
  101. package/lib/service/walkers/enum-walker.d.ts +4 -4
  102. package/lib/service/walkers/enum-walker.js +10 -10
  103. package/lib/service/walkers/enum-walker.js.map +1 -1
  104. package/lib/service/walkers/interface-walker.d.ts +4 -4
  105. package/lib/service/walkers/interface-walker.js +14 -14
  106. package/lib/service/walkers/interface-walker.js.map +1 -1
  107. package/lib/service/walkers/walker-factory.d.ts +5 -5
  108. package/lib/service/walkers/walker-factory.js +20 -20
  109. package/lib/service/walkers/walker.d.ts +19 -16
  110. package/lib/service/walkers/walker.js +16 -9
  111. package/lib/service/walkers/walker.js.map +1 -1
  112. package/lib/settings.d.ts +64 -53
  113. package/lib/settings.js +88 -78
  114. package/lib/settings.js.map +1 -1
  115. package/lib/test-helpers/AnnotationBuilder.d.ts +12 -12
  116. package/lib/test-helpers/AnnotationBuilder.js +30 -30
  117. package/lib/test-helpers/ClassMirrorBuilder.d.ts +18 -18
  118. package/lib/test-helpers/ClassMirrorBuilder.js +53 -53
  119. package/lib/test-helpers/DocCommentAnnotationBuilder.d.ts +8 -8
  120. package/lib/test-helpers/DocCommentAnnotationBuilder.js +25 -25
  121. package/lib/test-helpers/DocCommentBuilder.d.ts +12 -12
  122. package/lib/test-helpers/DocCommentBuilder.js +37 -37
  123. package/lib/test-helpers/FieldMirrorBuilder.d.ts +18 -18
  124. package/lib/test-helpers/FieldMirrorBuilder.js +53 -53
  125. package/lib/test-helpers/MethodMirrorBuilder.d.ts +10 -10
  126. package/lib/test-helpers/MethodMirrorBuilder.js +36 -36
  127. package/lib/test-helpers/SettingsBuilder.d.ts +8 -8
  128. package/lib/test-helpers/SettingsBuilder.js +26 -26
  129. package/lib/transpiler/factory.d.ts +6 -6
  130. package/lib/transpiler/factory.js +31 -31
  131. package/lib/transpiler/file-container.d.ts +6 -6
  132. package/lib/transpiler/file-container.js +15 -15
  133. package/lib/transpiler/generator-choices.d.ts +1 -1
  134. package/lib/transpiler/generator-choices.js +2 -2
  135. package/lib/transpiler/markdown/class-file-generatorHelper.d.ts +8 -8
  136. package/lib/transpiler/markdown/class-file-generatorHelper.js +55 -55
  137. package/lib/transpiler/markdown/class-file-generatorHelper.js.map +1 -1
  138. package/lib/transpiler/markdown/docsify/docsify-docs-processor.d.ts +6 -6
  139. package/lib/transpiler/markdown/docsify/docsify-docs-processor.js +12 -12
  140. package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.d.ts +11 -10
  141. package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.js +50 -27
  142. package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.js.map +1 -1
  143. package/lib/transpiler/markdown/markdown-transpiler-base.d.ts +11 -11
  144. package/lib/transpiler/markdown/markdown-transpiler-base.js +23 -23
  145. package/lib/transpiler/markdown/plain-markdown/plain-docsProcessor.d.ts +6 -6
  146. package/lib/transpiler/markdown/plain-markdown/plain-docsProcessor.js +13 -13
  147. package/lib/transpiler/openapi/open-api-docs-processor.d.ts +13 -13
  148. package/lib/transpiler/openapi/open-api-docs-processor.js +74 -74
  149. package/lib/transpiler/openapi/parsers/Builder.d.ts +16 -16
  150. package/lib/transpiler/openapi/parsers/Builder.js +29 -29
  151. package/lib/transpiler/openapi/parsers/MethodParser.d.ts +20 -20
  152. package/lib/transpiler/openapi/parsers/MethodParser.js +166 -166
  153. package/lib/transpiler/openapi/parsers/ParameterObjectBuilder.d.ts +7 -7
  154. package/lib/transpiler/openapi/parsers/ParameterObjectBuilder.js +10 -10
  155. package/lib/transpiler/openapi/parsers/ReferenceBuilder.d.ts +39 -39
  156. package/lib/transpiler/openapi/parsers/ReferenceBuilder.js +225 -225
  157. package/lib/transpiler/openapi/parsers/RequestBodyBuilder.d.ts +10 -10
  158. package/lib/transpiler/openapi/parsers/RequestBodyBuilder.js +19 -19
  159. package/lib/transpiler/openapi/parsers/ResponsesBuilder.d.ts +7 -7
  160. package/lib/transpiler/openapi/parsers/ResponsesBuilder.js +21 -21
  161. package/lib/transpiler/processor-type-transpiler.d.ts +10 -10
  162. package/lib/transpiler/processor-type-transpiler.js +8 -8
  163. package/lib/transpiler/transpiler.d.ts +5 -5
  164. package/lib/transpiler/transpiler.js +26 -26
  165. package/lib/util/error-logger.d.ts +8 -8
  166. package/lib/util/error-logger.js +89 -89
  167. package/lib/util/logger.d.ts +21 -21
  168. package/lib/util/logger.js +57 -57
  169. package/lib/util/string-utils.d.ts +2 -2
  170. package/lib/util/string-utils.js +14 -14
  171. package/package.json +78 -78
  172. package/src/cli/generate.ts +8 -0
  173. package/src/model/markdown-generation-util/field-declaration-util.ts +3 -9
  174. package/src/model/markdown-type-file.ts +4 -10
  175. package/src/service/walkers/class-walker.ts +6 -7
  176. package/src/service/walkers/enum-walker.ts +0 -1
  177. package/src/service/walkers/interface-walker.ts +1 -1
  178. package/src/service/walkers/walker.ts +8 -1
  179. package/src/settings.ts +21 -0
  180. package/src/transpiler/markdown/class-file-generatorHelper.ts +2 -2
  181. package/src/transpiler/markdown/jekyll/jekyll-docsProcessor.ts +26 -3
  182. package/tsconfig.json +20 -20
  183. package/tslint.json +5 -5
  184. package/ROADMAP.md +0 -16
@@ -21,6 +21,9 @@ ChildClass
21
21
 
22
22
  ## Fields
23
23
 
24
+ ### `private aPrivateString` → `String`
25
+
26
+
24
27
  ### `private privateStringFromChild` → `String`
25
28
 
26
29
 
@@ -48,6 +51,24 @@ This is a protected string, use carefully.
48
51
  ---
49
52
  ## Methods
50
53
  ### `public void doSomething()`
54
+ ### `public void execute()`
55
+
56
+ Executes the command.
57
+
58
+ ### `public String getValue()`
59
+
60
+ Returns a value based on the executed command.
61
+
62
+ #### Returns
63
+
64
+ |Type|Description|
65
+ |---|---|
66
+ |`String`|The value|
67
+
68
+ ### `public virtual String overridableMethod()`
69
+
70
+ *Inherited*
71
+
51
72
  ### `public override String overridableMethodOverridden()`
52
73
 
53
74
  This method was overridden.
@@ -73,22 +94,4 @@ sequenceDiagram
73
94
  ```
74
95
 
75
96
 
76
- ### `public void execute()`
77
-
78
- Executes the command.
79
-
80
- ### `public String getValue()`
81
-
82
- Returns a value based on the executed command.
83
-
84
- #### Returns
85
-
86
- |Type|Description|
87
- |---|---|
88
- |`String`|The value|
89
-
90
- ### `public virtual String overridableMethod()`
91
-
92
- *Inherited*
93
-
94
97
  ---
@@ -62,23 +62,23 @@ Constructs a SampleClass with an argument.
62
62
  ## Fields
63
63
  ### Common Constants
64
64
 
65
- * `public ANOTHER_CONSTANT` → `String`
66
65
  * `public A_CONSTANT` → `String` [`NAMESPACEACCESSIBLE` ] - This is a constant.
66
+ * `public ANOTHER_CONSTANT` → `String`
67
67
  * `public listOfStrings` → `List<String>`
68
68
  ---
69
69
  ### 'General' Constants
70
70
 
71
- * `public GENERAL_ANOTHER_CONSTANT` → `String`
72
71
  * `public GENERAL_A_CONSTANT` → `String` [`NAMESPACEACCESSIBLE` ] - This is a constant.
73
- ---
74
- ### Other variables
75
-
76
- * `public someVariable` → `String`
72
+ * `public GENERAL_ANOTHER_CONSTANT` → `String`
77
73
  ---
78
74
  ### Other
79
75
 
80
76
  * `private somePrivateStuff` → `String`
81
77
  ---
78
+ ### Other variables
79
+
80
+ * `public someVariable` → `String`
81
+ ---
82
82
  ## Properties
83
83
 
84
84
  ### `public AnotherProp` → `Decimal`
@@ -97,6 +97,13 @@ This is a String property.
97
97
  ---
98
98
  ## Methods
99
99
  ### A method group
100
+ ##### `public static String anotherSampleMethod(String arg1)`
101
+
102
+ Something here
103
+
104
+
105
+ **Arg1** The arg1 description
106
+
100
107
  ##### `public static String sampleMethod(String argument1, String argument2)`
101
108
 
102
109
  `NAMESPACEACCESSIBLE`
@@ -123,13 +130,6 @@ System.debug(result);
123
130
  ```
124
131
 
125
132
 
126
- ##### `public static String anotherSampleMethod(String arg1)`
127
-
128
- Something here
129
-
130
-
131
- **Arg1** The arg1 description
132
-
133
133
  ##### `public static Map<Id,List<String>> yetAnotherSampleMethod(String arg1)`
134
134
  ---
135
135
  ### Other
@@ -1,16 +1,16 @@
1
- /**
2
- * @description Some desc
3
- * @group Classes
4
- * @mermaid
5
- * sequenceDiagram
6
- * participant dotcom
7
- * participant iframe
8
- * participant viewscreen
9
- * dotcom->>iframe: loads html w/ iframe url
10
- * iframe->>viewscreen: request template
11
- * viewscreen->>iframe: html & javascript
12
- * iframe->>dotcom: iframe ready
13
- * dotcom->>iframe: set mermaid data on iframe
14
- * iframe->>iframe: render mermaid
15
- */
16
- public interface AnotherInterface{}
1
+ /**
2
+ * @description Some desc
3
+ * @group Classes
4
+ * @mermaid
5
+ * sequenceDiagram
6
+ * participant dotcom
7
+ * participant iframe
8
+ * participant viewscreen
9
+ * dotcom->>iframe: loads html w/ iframe url
10
+ * iframe->>viewscreen: request template
11
+ * viewscreen->>iframe: html & javascript
12
+ * iframe->>dotcom: iframe ready
13
+ * dotcom->>iframe: set mermaid data on iframe
14
+ * iframe->>iframe: render mermaid
15
+ */
16
+ public interface AnotherInterface{}
@@ -1,41 +1,42 @@
1
- /**
2
- * @description Some desc
3
- * @group Classes
4
- */
5
- public class ChildClass extends ParentClass implements SampleInterface {
6
- private String privateStringFromChild;
7
-
8
- public void doSomething() {
9
- System.debug('Do something');
10
- }
11
-
12
- /**
13
- * @description This method was overridden.
14
- * @return A String.
15
- * @mermaid
16
- * sequenceDiagram
17
- * participant dotcom
18
- * participant iframe
19
- * participant viewscreen
20
- * dotcom->>iframe: loads html w/ iframe url
21
- * iframe->>viewscreen: request template
22
- * viewscreen->>iframe: html & javascript
23
- * iframe->>dotcom: iframe ready
24
- * dotcom->>iframe: set mermaid data on iframe
25
- * iframe->>iframe: render mermaid
26
- */
27
- public override String overridableMethodOverridden() {
28
- return null ?? '';
29
- }
30
-
31
- /**
32
- * @description Executes the command.
33
- */
34
- public void execute();
35
-
36
- /**
37
- * @description Returns a value based on the executed command.
38
- * @return The value
39
- */
40
- public String getValue();
41
- }
1
+ /**
2
+ * @description Some desc
3
+ * @group Classes
4
+ */
5
+ public class ChildClass extends ParentClass implements SampleInterface {
6
+ private String privateStringFromChild;
7
+ private String aPrivateString;
8
+
9
+ public void doSomething() {
10
+ System.debug('Do something');
11
+ }
12
+
13
+ /**
14
+ * @description This method was overridden.
15
+ * @return A String.
16
+ * @mermaid
17
+ * sequenceDiagram
18
+ * participant dotcom
19
+ * participant iframe
20
+ * participant viewscreen
21
+ * dotcom->>iframe: loads html w/ iframe url
22
+ * iframe->>viewscreen: request template
23
+ * viewscreen->>iframe: html & javascript
24
+ * iframe->>dotcom: iframe ready
25
+ * dotcom->>iframe: set mermaid data on iframe
26
+ * iframe->>iframe: render mermaid
27
+ */
28
+ public override String overridableMethodOverridden() {
29
+ return null ?? '';
30
+ }
31
+
32
+ /**
33
+ * @description Executes the command.
34
+ */
35
+ public void execute();
36
+
37
+ /**
38
+ * @description Returns a value based on the executed command.
39
+ * @return The value
40
+ */
41
+ public String getValue();
42
+ }
@@ -1,5 +1,5 @@
1
- /**
2
- * @description This sentence has an `@embedded` annotation.
3
- */
4
- public with sharing class EscapedAnnotations {
5
- }
1
+ /**
2
+ * @description This sentence has an `@embedded` annotation.
3
+ */
4
+ public with sharing class EscapedAnnotations {
5
+ }
@@ -1,5 +1,5 @@
1
- public virtual class GrandparentClass {
2
- protected String protectedGrandParentField;
3
-
4
- protected String AProp { get; set; }
1
+ public virtual class GrandparentClass {
2
+ protected String protectedGrandParentField;
3
+
4
+ protected String AProp { get; set; }
5
5
  }
@@ -1,8 +1,8 @@
1
- /**********************************************************
2
- Uses a block style apex doc
3
- @group Main
4
- @test-class {@link SampleClass}
5
- ***********************************************************/
6
- public class GroupedClass {
7
-
8
- }
1
+ /**********************************************************
2
+ Uses a block style apex doc
3
+ @group Main
4
+ @test-class {@link SampleClass}
5
+ ***********************************************************/
6
+ public class GroupedClass {
7
+
8
+ }
@@ -1,17 +1,17 @@
1
- public class MemberGrouping {
2
- // @start-group Group old syntax
3
- public static final String inGroup1;
4
- public static final String anotherInGroup1;
5
- // @end-group
6
-
7
- /**
8
- * @start-group Group new syntax
9
- * @description Group's description
10
- */
11
-
12
- /** @description Description for constant in group 2 */
13
- public static final String inGroup2;
14
- /** @description Description for another constant in group 2 @future annotation */
15
- public static final String anotherInGroup2;
16
- /** @end-group */
17
- }
1
+ public class MemberGrouping {
2
+ // @start-group Group old syntax
3
+ public static final String inGroup1;
4
+ public static final String anotherInGroup1;
5
+ // @end-group
6
+
7
+ /**
8
+ * @start-group Group new syntax
9
+ * @description Group's description
10
+ */
11
+
12
+ /** @description Description for constant in group 2 */
13
+ public static final String inGroup2;
14
+ /** @description Description for another constant in group 2 @future annotation */
15
+ public static final String anotherInGroup2;
16
+ /** @end-group */
17
+ }
@@ -1,16 +1,16 @@
1
- public abstract class ParentClass extends GrandparentClass{
2
- private String privateStringFromParent;
3
- /**
4
- * @description This is a protected string, use carefully.
5
- */
6
- protected String protectedStringFromParent;
7
- public String publicStringFromParent;
8
-
9
- public virtual String overridableMethod() {
10
- return '';
11
- }
12
-
13
- public virtual String overridableMethodOverridden() {
14
- return '';
15
- }
16
- }
1
+ public abstract class ParentClass extends GrandparentClass{
2
+ private String privateStringFromParent;
3
+ /**
4
+ * @description This is a protected string, use carefully.
5
+ */
6
+ protected String protectedStringFromParent;
7
+ public String publicStringFromParent;
8
+
9
+ public virtual String overridableMethod() {
10
+ return '';
11
+ }
12
+
13
+ public virtual String overridableMethodOverridden() {
14
+ return '';
15
+ }
16
+ }
@@ -1,166 +1,166 @@
1
- /**
2
- * @description This is a class description. This class relates to {@link SampleInterface}
3
- * But this {@link ClassThatDoesNotExist} does not exist.
4
- * You can also link using this syntax <<SampleInterface>>
5
- * @group Main
6
- * @CustomAnnotation A Custom annotation
7
- * @author Cesar Parra
8
- * @see SampleInterface
9
- */
10
- @NamespaceAccessible
11
- public virtual with sharing class SampleClass {
12
- /**
13
- * @description This is a namespace accessible enum
14
- */
15
- @NamespaceAccessible
16
- public enum InnerEnum {
17
- A,
18
- B,
19
- C
20
- }
21
-
22
- // @start-group Common Constants
23
-
24
- public List<String> listOfStrings;
25
-
26
- /**
27
- * @description This is a constant.
28
- */
29
- @NamespaceAccessible
30
- public static final String A_CONSTANT = 'My Constant Value';
31
- public static final String ANOTHER_CONSTANT = 'My Constant Value';
32
- // @end-group
33
-
34
- // @start-group 'General' Constants
35
- /**
36
- * @description This is a constant.
37
- */
38
- @NamespaceAccessible
39
- public static final String GENERAL_A_CONSTANT = 'My Constant Value';
40
- public static final String GENERAL_ANOTHER_CONSTANT = 'My Constant Value';
41
- // @end-group
42
-
43
- // @start-group Other variables
44
- public String someVariable = 'test';
45
- // @end-group
46
-
47
- // @start-group My Super Group
48
- /**
49
- * @description Constructs a SampleClass without any arguments. This relates to {@link SampleInterface}
50
- * @throws ExcName some exception
51
- * @CustomAnnotation A Custom method annotation
52
- * @see SampleInterface
53
- * @example
54
- * // Example
55
- * SampleClass sampleInstance = new SampleClass();
56
- */
57
- @NamespaceAccessible
58
- public SampleClass() {
59
- System.debug('Constructor');
60
- }
61
- // @end-group
62
-
63
- /**
64
- * @description Constructs a SampleClass with an argument.
65
- * @param argument1 Argument1 definition
66
- * @param argument2 Argument2 definition
67
- */
68
- public SampleClass(String argument1, String argument2) {
69
- System.debug('Constructor');
70
- }
71
-
72
-
73
- // @start-group A method group
74
- /**
75
- * @description Executes commands based on the passed in argument.
76
- * @example
77
- * String result = SampleClass.testMethod();
78
- * System.debug(result);
79
- * @param argument1 Argument1 to debug
80
- * @param argument2 Argument2 to debug
81
- * @return Empty string
82
- */
83
- @NamespaceAccessible
84
- public static String sampleMethod(String argument1, String argument2) {
85
- System.debug('Execute');
86
- return '';
87
- }
88
-
89
- /**
90
- * @description Something here
91
- * @arg1 The arg1 description
92
- */
93
- public static String anotherSampleMethod(String arg1) {
94
- System.debug('something');
95
- return '';
96
- }
97
-
98
- public static Map<Id, List<String>> yetAnotherSampleMethod(String arg1) {
99
- System.debug('something');
100
- return new Map<Id, List<String>>();
101
- }
102
- // @end-group
103
-
104
-
105
- /**
106
- * @description Calls the method.
107
- * This methods allows you to call it.
108
- */
109
- public static void call() {
110
- }
111
-
112
- /**
113
- * @description This is a String property.
114
- */
115
- @AuraEnabled
116
- @Deprecated
117
- public String MyProp { get; set; }
118
-
119
- /**
120
- * @description This is a Decimal property.
121
- */
122
- @AuraEnabled
123
- public Decimal AnotherProp { get; private set; }
124
-
125
- private String somePrivateStuff;
126
-
127
- /**
128
- * @description Inner class belonging to SampleClass.
129
- */
130
- public class InnerClass {
131
- /**
132
- * @description Description of the inner property.
133
- */
134
- public String InnerProp {
135
- get;
136
- set;
137
- }
138
-
139
- /**
140
- * @description Executes from the inner class.
141
- */
142
- public void innerMethod() {
143
- System.debug('Executing inner method.');
144
- }
145
- }
146
-
147
- /**
148
- * @description Inner class belonging to SampleClass.
149
- */
150
- public class AnotherInnerClass {
151
- /**
152
- * @description Description of the inner property.
153
- */
154
- public String InnerProp {
155
- get;
156
- set;
157
- }
158
-
159
- /**
160
- * @description Executes from the inner class.
161
- */
162
- public void innerMethod() {
163
- System.debug('Executing inner method.');
164
- }
165
- }
166
- }
1
+ /**
2
+ * @description This is a class description. This class relates to {@link SampleInterface}
3
+ * But this {@link ClassThatDoesNotExist} does not exist.
4
+ * You can also link using this syntax <<SampleInterface>>
5
+ * @group Main
6
+ * @CustomAnnotation A Custom annotation
7
+ * @author Cesar Parra
8
+ * @see SampleInterface
9
+ */
10
+ @NamespaceAccessible
11
+ public virtual with sharing class SampleClass {
12
+ /**
13
+ * @description This is a namespace accessible enum
14
+ */
15
+ @NamespaceAccessible
16
+ public enum InnerEnum {
17
+ A,
18
+ B,
19
+ C
20
+ }
21
+
22
+ // @start-group Common Constants
23
+
24
+ public List<String> listOfStrings;
25
+
26
+ /**
27
+ * @description This is a constant.
28
+ */
29
+ @NamespaceAccessible
30
+ public static final String A_CONSTANT = 'My Constant Value';
31
+ public static final String ANOTHER_CONSTANT = 'My Constant Value';
32
+ // @end-group
33
+
34
+ // @start-group 'General' Constants
35
+ /**
36
+ * @description This is a constant.
37
+ */
38
+ @NamespaceAccessible
39
+ public static final String GENERAL_A_CONSTANT = 'My Constant Value';
40
+ public static final String GENERAL_ANOTHER_CONSTANT = 'My Constant Value';
41
+ // @end-group
42
+
43
+ // @start-group Other variables
44
+ public String someVariable = 'test';
45
+ // @end-group
46
+
47
+ // @start-group My Super Group
48
+ /**
49
+ * @description Constructs a SampleClass without any arguments. This relates to {@link SampleInterface}
50
+ * @throws ExcName some exception
51
+ * @CustomAnnotation A Custom method annotation
52
+ * @see SampleInterface
53
+ * @example
54
+ * // Example
55
+ * SampleClass sampleInstance = new SampleClass();
56
+ */
57
+ @NamespaceAccessible
58
+ public SampleClass() {
59
+ System.debug('Constructor');
60
+ }
61
+ // @end-group
62
+
63
+ /**
64
+ * @description Constructs a SampleClass with an argument.
65
+ * @param argument1 Argument1 definition
66
+ * @param argument2 Argument2 definition
67
+ */
68
+ public SampleClass(String argument1, String argument2) {
69
+ System.debug('Constructor');
70
+ }
71
+
72
+
73
+ // @start-group A method group
74
+ /**
75
+ * @description Executes commands based on the passed in argument.
76
+ * @example
77
+ * String result = SampleClass.testMethod();
78
+ * System.debug(result);
79
+ * @param argument1 Argument1 to debug
80
+ * @param argument2 Argument2 to debug
81
+ * @return Empty string
82
+ */
83
+ @NamespaceAccessible
84
+ public static String sampleMethod(String argument1, String argument2) {
85
+ System.debug('Execute');
86
+ return '';
87
+ }
88
+
89
+ /**
90
+ * @description Something here
91
+ * @arg1 The arg1 description
92
+ */
93
+ public static String anotherSampleMethod(String arg1) {
94
+ System.debug('something');
95
+ return '';
96
+ }
97
+
98
+ public static Map<Id, List<String>> yetAnotherSampleMethod(String arg1) {
99
+ System.debug('something');
100
+ return new Map<Id, List<String>>();
101
+ }
102
+ // @end-group
103
+
104
+
105
+ /**
106
+ * @description Calls the method.
107
+ * This methods allows you to call it.
108
+ */
109
+ public static void call() {
110
+ }
111
+
112
+ /**
113
+ * @description This is a String property.
114
+ */
115
+ @AuraEnabled
116
+ @Deprecated
117
+ public String MyProp { get; set; }
118
+
119
+ /**
120
+ * @description This is a Decimal property.
121
+ */
122
+ @AuraEnabled
123
+ public Decimal AnotherProp { get; private set; }
124
+
125
+ private String somePrivateStuff;
126
+
127
+ /**
128
+ * @description Inner class belonging to SampleClass.
129
+ */
130
+ public class InnerClass {
131
+ /**
132
+ * @description Description of the inner property.
133
+ */
134
+ public String InnerProp {
135
+ get;
136
+ set;
137
+ }
138
+
139
+ /**
140
+ * @description Executes from the inner class.
141
+ */
142
+ public void innerMethod() {
143
+ System.debug('Executing inner method.');
144
+ }
145
+ }
146
+
147
+ /**
148
+ * @description Inner class belonging to SampleClass.
149
+ */
150
+ public class AnotherInnerClass {
151
+ /**
152
+ * @description Description of the inner property.
153
+ */
154
+ public String InnerProp {
155
+ get;
156
+ set;
157
+ }
158
+
159
+ /**
160
+ * @description Executes from the inner class.
161
+ */
162
+ public void innerMethod() {
163
+ System.debug('Executing inner method.');
164
+ }
165
+ }
166
+ }