@cparra/apexdocs 1.15.0 → 1.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 (97) hide show
  1. package/.gitattributes +2 -0
  2. package/.github/workflows/ci.yml +29 -0
  3. package/README.md +2 -0
  4. package/docs/404.html +24 -24
  5. package/docs/README.md +46 -46
  6. package/docs/Sample-Classes/SampleClass.md +112 -112
  7. package/docs/Sample-Classes/SampleClass2.md +112 -112
  8. package/docs/Sample-Classes/SampleClassMultipleAuthorsAndDates.md +120 -120
  9. package/docs/Sample-Interfaces/SampleInterface.md +29 -29
  10. package/docs/_config.yml +40 -40
  11. package/docs/assets/css/style.css +319 -319
  12. package/docs/index.md +48 -48
  13. package/examples/apex/SampleClassMultipleAuthorsAndDates.cls +100 -100
  14. package/lib/Command/Generate.d.ts +1 -1
  15. package/lib/Command/Generate.js +13 -1
  16. package/lib/MarkdownDocsProcessor.js +3 -0
  17. package/lib/MetadataProcessor.d.ts +3 -0
  18. package/lib/MetadataProcessor.js +15 -0
  19. package/lib/Parser/ClassParser.js +28 -17
  20. package/lib/application/Apexdocs.js +6 -3
  21. package/lib/application/Apexdocs.js.map +1 -1
  22. package/lib/cli/generate.js +6 -1
  23. package/lib/index.js.map +1 -1
  24. package/lib/model/ApexModel.d.ts +3 -0
  25. package/lib/model/ApexModel.js +8 -0
  26. package/lib/model/file.js +1 -0
  27. package/lib/model/file.js.map +1 -1
  28. package/lib/model/manifest-diff.js +1 -0
  29. package/lib/model/manifest-diff.js.map +1 -1
  30. package/lib/model/markdown-file.d.ts +2 -0
  31. package/lib/model/markdown-file.js +29 -0
  32. package/lib/model/markdown-file.js.map +1 -1
  33. package/lib/model/markdown-generation-util/doc-comment-annotation-util.d.ts +7 -0
  34. package/lib/model/markdown-generation-util/doc-comment-annotation-util.js +24 -0
  35. package/lib/model/markdown-generation-util/doc-comment-annotation-util.js.map +1 -0
  36. package/lib/model/markdown-generation-util/field-declaration-util.d.ts +1 -1
  37. package/lib/model/markdown-generation-util/field-declaration-util.js +34 -12
  38. package/lib/model/markdown-generation-util/field-declaration-util.js.map +1 -1
  39. package/lib/model/markdown-generation-util/index.js +13 -6
  40. package/lib/model/markdown-generation-util/index.js.map +1 -1
  41. package/lib/model/markdown-generation-util/method-declaration-util.d.ts +1 -1
  42. package/lib/model/markdown-generation-util/method-declaration-util.js +5 -5
  43. package/lib/model/markdown-generation-util/method-declaration-util.js.map +1 -1
  44. package/lib/model/markdown-generation-util/type-declaration-util.d.ts +1 -1
  45. package/lib/model/markdown-generation-util/type-declaration-util.js +5 -11
  46. package/lib/model/markdown-generation-util/type-declaration-util.js.map +1 -1
  47. package/lib/model/markdown-home-file.d.ts +1 -0
  48. package/lib/model/markdown-home-file.js +7 -5
  49. package/lib/model/markdown-home-file.js.map +1 -1
  50. package/lib/model/markdown-type-file.d.ts +10 -3
  51. package/lib/model/markdown-type-file.js +70 -10
  52. package/lib/model/markdown-type-file.js.map +1 -1
  53. package/lib/model/types-repository.d.ts +8 -0
  54. package/lib/model/types-repository.js +22 -0
  55. package/lib/model/types-repository.js.map +1 -0
  56. package/lib/service/apex-file-reader.js +1 -0
  57. package/lib/service/apex-file-reader.js.map +1 -1
  58. package/lib/service/file-system.js +1 -0
  59. package/lib/service/file-system.js.map +1 -1
  60. package/lib/service/file-writer.js +1 -0
  61. package/lib/service/file-writer.js.map +1 -1
  62. package/lib/service/manifest-factory.js +1 -0
  63. package/lib/service/manifest-factory.js.map +1 -1
  64. package/lib/service/parser.js +1 -0
  65. package/lib/service/parser.js.map +1 -1
  66. package/lib/service/walkers/class-walker.js +1 -0
  67. package/lib/service/walkers/class-walker.js.map +1 -1
  68. package/lib/service/walkers/enum-walker.js +1 -0
  69. package/lib/service/walkers/enum-walker.js.map +1 -1
  70. package/lib/service/walkers/interface-walker.js +1 -0
  71. package/lib/service/walkers/interface-walker.js.map +1 -1
  72. package/lib/service/walkers/walker-factory.js +1 -0
  73. package/lib/service/walkers/walker-factory.js.map +1 -1
  74. package/lib/service/walkers/walker.js +1 -0
  75. package/lib/service/walkers/walker.js.map +1 -1
  76. package/lib/settings.d.ts +3 -0
  77. package/lib/settings.js +7 -0
  78. package/lib/settings.js.map +1 -1
  79. package/lib/transpiler/file-container.js +1 -0
  80. package/lib/transpiler/file-container.js.map +1 -1
  81. package/lib/transpiler/markdown/class-file-generatorHelper.d.ts +1 -0
  82. package/lib/transpiler/markdown/class-file-generatorHelper.js +9 -0
  83. package/lib/transpiler/markdown/class-file-generatorHelper.js.map +1 -1
  84. package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.js +1 -0
  85. package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.js.map +1 -1
  86. package/lib/transpiler/markdown/markdown-transpiler-base.js +1 -0
  87. package/lib/transpiler/markdown/markdown-transpiler-base.js.map +1 -1
  88. package/lib/util/logger.js +1 -0
  89. package/lib/util/logger.js.map +1 -1
  90. package/package.json +2 -1
  91. package/src/Command/Generate.ts +17 -0
  92. package/src/MarkdownDocsProcessor.ts +5 -0
  93. package/src/MetadataProcessor.ts +16 -0
  94. package/src/Model/ApexModel.ts +11 -0
  95. package/src/Parser/ClassParser.ts +35 -17
  96. package/src/Settings.ts +10 -0
  97. package/src/cli/generate.ts +7 -0
package/.gitattributes ADDED
@@ -0,0 +1,2 @@
1
+ # Set the default line return behavior, in case people don't have core.autocrlf set.
2
+ * text=auto
@@ -0,0 +1,29 @@
1
+ name: Tests
2
+
3
+ on: push
4
+
5
+ jobs:
6
+ build:
7
+ runs-on: ubuntu-latest
8
+
9
+ steps:
10
+ - uses: actions/checkout@v2
11
+
12
+ - name: Cache node modules
13
+ uses: actions/cache@v2
14
+ env:
15
+ cache-name: cache-node-modules
16
+ with:
17
+ # npm cache files are stored in `~/.npm` on Linux/macOS
18
+ path: ~/.npm
19
+ key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}
20
+ restore-keys: |
21
+ ${{ runner.os }}-build-${{ env.cache-name }}-
22
+ ${{ runner.os }}-build-
23
+ ${{ runner.os }}-
24
+
25
+ - name: Install Dependencies
26
+ run: npm install
27
+
28
+ - name: Test
29
+ run: npm test
package/README.md CHANGED
@@ -75,6 +75,8 @@ The CLI supports the following parameters:
75
75
  | --targetGenerator | -g | Define the static file generator for which the documents will be created. Currently supports jekyll and docsify. | `jekyll` | No |
76
76
  | --configPath | -c | The path to the JSON configuration file that defines the structure of the documents to generate. | N/A | No |
77
77
  | --group | -o | Define whether the generated files should be grouped by the @group tag on the top level classes. | `true` | No |
78
+ | --indexOnly | N/A | Defines whether only the index file should be generated. | `false` | No |
79
+
78
80
 
79
81
  #### Configuration File
80
82
 
package/docs/404.html CHANGED
@@ -1,24 +1,24 @@
1
- ---
2
- layout: default
3
- ---
4
-
5
- <style type="text/css" media="screen">
6
- .container {
7
- margin: 10px auto;
8
- max-width: 600px;
9
- text-align: center;
10
- }
11
- h1 {
12
- margin: 30px 0;
13
- font-size: 4em;
14
- line-height: 1;
15
- letter-spacing: -1px;
16
- }
17
- </style>
18
-
19
- <div class="container">
20
- <h1>404</h1>
21
-
22
- <p><strong>Page not found :(</strong></p>
23
- <p>The requested page could not be found.</p>
24
- </div>
1
+ ---
2
+ layout: default
3
+ ---
4
+
5
+ <style type="text/css" media="screen">
6
+ .container {
7
+ margin: 10px auto;
8
+ max-width: 600px;
9
+ text-align: center;
10
+ }
11
+ h1 {
12
+ margin: 30px 0;
13
+ font-size: 4em;
14
+ line-height: 1;
15
+ letter-spacing: -1px;
16
+ }
17
+ </style>
18
+
19
+ <div class="container">
20
+ <h1>404</h1>
21
+
22
+ <p><strong>Page not found :(</strong></p>
23
+ <p>The requested page could not be found.</p>
24
+ </div>
package/docs/README.md CHANGED
@@ -1,49 +1,49 @@
1
1
  # Welcome to the Apex Docs documentation example.
2
2
 
3
3
  This content will be added to the top of the home page.
4
-
5
- # Classes
6
- ## Sample Classes
7
-
8
- ### [SampleClass](/Sample-Classes/SampleClass.md)
9
-
10
-
11
- This is a class description.
12
-
13
-
14
-
15
- ### [SampleClass](/Sample-Classes/SampleClass.md)
16
-
17
-
18
- This is a class description.
19
-
20
-
21
-
22
- ### [SampleClass2](/Sample-Classes/SampleClass2.md)
23
-
24
-
25
- This is a class description.
26
-
27
-
28
-
29
- ### [SampleClassMultipleAuthorsAndDates](/Sample-Classes/SampleClassMultipleAuthorsAndDates.md)
30
-
31
-
32
- This is a class description.
33
-
34
-
35
- ## Sample Interfaces
36
-
37
- ### [SampleInterface](/Sample-Interfaces/SampleInterface.md)
38
-
39
-
40
- This is an interface description.
41
-
42
-
43
-
44
- ### [SampleInterface](/Sample-Interfaces/SampleInterface.md)
45
-
46
-
47
- This is an interface description.
48
-
49
-
4
+
5
+ # Classes
6
+ ## Sample Classes
7
+
8
+ ### [SampleClass](/Sample-Classes/SampleClass.md)
9
+
10
+
11
+ This is a class description.
12
+
13
+
14
+
15
+ ### [SampleClass](/Sample-Classes/SampleClass.md)
16
+
17
+
18
+ This is a class description.
19
+
20
+
21
+
22
+ ### [SampleClass2](/Sample-Classes/SampleClass2.md)
23
+
24
+
25
+ This is a class description.
26
+
27
+
28
+
29
+ ### [SampleClassMultipleAuthorsAndDates](/Sample-Classes/SampleClassMultipleAuthorsAndDates.md)
30
+
31
+
32
+ This is a class description.
33
+
34
+
35
+ ## Sample Interfaces
36
+
37
+ ### [SampleInterface](/Sample-Interfaces/SampleInterface.md)
38
+
39
+
40
+ This is an interface description.
41
+
42
+
43
+
44
+ ### [SampleInterface](/Sample-Interfaces/SampleInterface.md)
45
+
46
+
47
+ This is an interface description.
48
+
49
+
@@ -1,112 +1,112 @@
1
- # SampleClass class
2
-
3
- `NamespaceAccessible`
4
-
5
- This is a class description.
6
-
7
- ## Related
8
-
9
- [SampleInterface](/Sample-Interfaces/SampleInterface.md)
10
-
11
-
12
- [SampleClass2](/Sample-Classes/SampleClass2.md)
13
-
14
- ---
15
- ## Constructors
16
- ### `SampleClass()`
17
-
18
- `NamespaceAccessible`
19
-
20
- Constructs a SampleClass without any arguments.
21
- #### Example
22
- ```
23
- <pre>
24
- SampleClass sampleInstance = new SampleClass();
25
- ```
26
-
27
- ### `SampleClass(String argument)`
28
-
29
- `NamespaceAccessible`
30
-
31
- Constructs a SampleClass with an argument.
32
- #### Parameters
33
-
34
- | Param | Description |
35
- | ----- | ----------- |
36
- |`argument` | Some argument |
37
-
38
- ---
39
- ## Properties
40
-
41
- ### `AnotherProp` → `Decimal`
42
-
43
- `NamespaceAccessible`
44
-
45
- This is a Decimal property.
46
-
47
- ### `MyProp` → `String`
48
-
49
- `NamespaceAccessible`
50
-
51
- This is a String property.
52
-
53
- ---
54
- ## Methods
55
- ### `call()` → `void`
56
-
57
- `NamespaceAccessible`
58
-
59
- Calls the method. This methods allows you to call it.
60
-
61
- ### `testMethod(String argument)` → `String`
62
-
63
- `NamespaceAccessible`
64
-
65
- Executes commands based on the passed in argument.
66
-
67
- #### Example
68
- ```
69
- <pre>
70
- String result = SampleClass.testMethod();
71
- System.debug(result);
72
- ```
73
-
74
- ---
75
- ## Inner Classes
76
-
77
- ### SampleClass.AnotherInnerClass class
78
-
79
- Inner class belonging to SampleClass.
80
-
81
- ---
82
- #### Properties
83
-
84
- ##### `InnerProp` → `public`
85
-
86
- Description of the inner property.
87
-
88
- ---
89
- #### Methods
90
- ##### `innerMethod()` → `void`
91
-
92
- Executes from the inner class.
93
-
94
- ---
95
- ### SampleClass.InnerClass class
96
-
97
- Inner class belonging to SampleClass.
98
-
99
- ---
100
- #### Properties
101
-
102
- ##### `InnerProp` → `public`
103
-
104
- Description of the inner property.
105
-
106
- ---
107
- #### Methods
108
- ##### `innerMethod()` → `void`
109
-
110
- Executes from the inner class.
111
-
112
- ---
1
+ # SampleClass class
2
+
3
+ `NamespaceAccessible`
4
+
5
+ This is a class description.
6
+
7
+ ## Related
8
+
9
+ [SampleInterface](/Sample-Interfaces/SampleInterface.md)
10
+
11
+
12
+ [SampleClass2](/Sample-Classes/SampleClass2.md)
13
+
14
+ ---
15
+ ## Constructors
16
+ ### `SampleClass()`
17
+
18
+ `NamespaceAccessible`
19
+
20
+ Constructs a SampleClass without any arguments.
21
+ #### Example
22
+ ```
23
+ <pre>
24
+ SampleClass sampleInstance = new SampleClass();
25
+ ```
26
+
27
+ ### `SampleClass(String argument)`
28
+
29
+ `NamespaceAccessible`
30
+
31
+ Constructs a SampleClass with an argument.
32
+ #### Parameters
33
+
34
+ | Param | Description |
35
+ | ----- | ----------- |
36
+ |`argument` | Some argument |
37
+
38
+ ---
39
+ ## Properties
40
+
41
+ ### `AnotherProp` → `Decimal`
42
+
43
+ `NamespaceAccessible`
44
+
45
+ This is a Decimal property.
46
+
47
+ ### `MyProp` → `String`
48
+
49
+ `NamespaceAccessible`
50
+
51
+ This is a String property.
52
+
53
+ ---
54
+ ## Methods
55
+ ### `call()` → `void`
56
+
57
+ `NamespaceAccessible`
58
+
59
+ Calls the method. This methods allows you to call it.
60
+
61
+ ### `testMethod(String argument)` → `String`
62
+
63
+ `NamespaceAccessible`
64
+
65
+ Executes commands based on the passed in argument.
66
+
67
+ #### Example
68
+ ```
69
+ <pre>
70
+ String result = SampleClass.testMethod();
71
+ System.debug(result);
72
+ ```
73
+
74
+ ---
75
+ ## Inner Classes
76
+
77
+ ### SampleClass.AnotherInnerClass class
78
+
79
+ Inner class belonging to SampleClass.
80
+
81
+ ---
82
+ #### Properties
83
+
84
+ ##### `InnerProp` → `public`
85
+
86
+ Description of the inner property.
87
+
88
+ ---
89
+ #### Methods
90
+ ##### `innerMethod()` → `void`
91
+
92
+ Executes from the inner class.
93
+
94
+ ---
95
+ ### SampleClass.InnerClass class
96
+
97
+ Inner class belonging to SampleClass.
98
+
99
+ ---
100
+ #### Properties
101
+
102
+ ##### `InnerProp` → `public`
103
+
104
+ Description of the inner property.
105
+
106
+ ---
107
+ #### Methods
108
+ ##### `innerMethod()` → `void`
109
+
110
+ Executes from the inner class.
111
+
112
+ ---
@@ -1,112 +1,112 @@
1
- # SampleClass2 class
2
-
3
- `NamespaceAccessible`
4
-
5
- This is a class description.
6
-
7
- ## Related
8
-
9
- [SampleInterface](/Sample-Interfaces/SampleInterface.md)
10
-
11
-
12
- [SampleClass](/Sample-Classes/SampleClass.md)
13
-
14
- ---
15
- ## Constructors
16
- ### `SampleClass2()`
17
-
18
- `NamespaceAccessible`
19
-
20
- Constructs a SampleClass2 without any arguments.
21
- #### Example
22
- ```
23
- <pre>
24
- SampleClass2 sampleInstance = new SampleClass2();
25
- ```
26
-
27
- ### `SampleClass2(String argument)`
28
-
29
- `NamespaceAccessible`
30
-
31
- Constructs a SampleClass2 with an argument.
32
- #### Parameters
33
-
34
- | Param | Description |
35
- | ----- | ----------- |
36
- |`argument` | Some argument |
37
-
38
- ---
39
- ## Properties
40
-
41
- ### `AnotherProp` → `Decimal`
42
-
43
- `NamespaceAccessible`
44
-
45
- This is a Decimal property.
46
-
47
- ### `MyProp` → `String`
48
-
49
- `NamespaceAccessible`
50
-
51
- This is a String property.
52
-
53
- ---
54
- ## Methods
55
- ### `call()` → `void`
56
-
57
- `NamespaceAccessible`
58
-
59
- Calls the method. This methods allows you to call it.
60
-
61
- ### `testMethod(String argument)` → `String`
62
-
63
- `NamespaceAccessible`
64
-
65
- Executes commands based on the passed in argument.
66
-
67
- #### Example
68
- ```
69
- <pre>
70
- String result = SampleClass2.testMethod();
71
- System.debug(result);
72
- ```
73
-
74
- ---
75
- ## Inner Classes
76
-
77
- ### SampleClass2.AnotherInnerClass class
78
-
79
- Inner class belonging to SampleClass2.
80
-
81
- ---
82
- #### Properties
83
-
84
- ##### `InnerProp` → `public`
85
-
86
- Description of the inner property.
87
-
88
- ---
89
- #### Methods
90
- ##### `innerMethod()` → `void`
91
-
92
- Executes from the inner class.
93
-
94
- ---
95
- ### SampleClass2.InnerClass class
96
-
97
- Inner class belonging to SampleClass2.
98
-
99
- ---
100
- #### Properties
101
-
102
- ##### `InnerProp` → `public`
103
-
104
- Description of the inner property.
105
-
106
- ---
107
- #### Methods
108
- ##### `innerMethod()` → `void`
109
-
110
- Executes from the inner class.
111
-
112
- ---
1
+ # SampleClass2 class
2
+
3
+ `NamespaceAccessible`
4
+
5
+ This is a class description.
6
+
7
+ ## Related
8
+
9
+ [SampleInterface](/Sample-Interfaces/SampleInterface.md)
10
+
11
+
12
+ [SampleClass](/Sample-Classes/SampleClass.md)
13
+
14
+ ---
15
+ ## Constructors
16
+ ### `SampleClass2()`
17
+
18
+ `NamespaceAccessible`
19
+
20
+ Constructs a SampleClass2 without any arguments.
21
+ #### Example
22
+ ```
23
+ <pre>
24
+ SampleClass2 sampleInstance = new SampleClass2();
25
+ ```
26
+
27
+ ### `SampleClass2(String argument)`
28
+
29
+ `NamespaceAccessible`
30
+
31
+ Constructs a SampleClass2 with an argument.
32
+ #### Parameters
33
+
34
+ | Param | Description |
35
+ | ----- | ----------- |
36
+ |`argument` | Some argument |
37
+
38
+ ---
39
+ ## Properties
40
+
41
+ ### `AnotherProp` → `Decimal`
42
+
43
+ `NamespaceAccessible`
44
+
45
+ This is a Decimal property.
46
+
47
+ ### `MyProp` → `String`
48
+
49
+ `NamespaceAccessible`
50
+
51
+ This is a String property.
52
+
53
+ ---
54
+ ## Methods
55
+ ### `call()` → `void`
56
+
57
+ `NamespaceAccessible`
58
+
59
+ Calls the method. This methods allows you to call it.
60
+
61
+ ### `testMethod(String argument)` → `String`
62
+
63
+ `NamespaceAccessible`
64
+
65
+ Executes commands based on the passed in argument.
66
+
67
+ #### Example
68
+ ```
69
+ <pre>
70
+ String result = SampleClass2.testMethod();
71
+ System.debug(result);
72
+ ```
73
+
74
+ ---
75
+ ## Inner Classes
76
+
77
+ ### SampleClass2.AnotherInnerClass class
78
+
79
+ Inner class belonging to SampleClass2.
80
+
81
+ ---
82
+ #### Properties
83
+
84
+ ##### `InnerProp` → `public`
85
+
86
+ Description of the inner property.
87
+
88
+ ---
89
+ #### Methods
90
+ ##### `innerMethod()` → `void`
91
+
92
+ Executes from the inner class.
93
+
94
+ ---
95
+ ### SampleClass2.InnerClass class
96
+
97
+ Inner class belonging to SampleClass2.
98
+
99
+ ---
100
+ #### Properties
101
+
102
+ ##### `InnerProp` → `public`
103
+
104
+ Description of the inner property.
105
+
106
+ ---
107
+ #### Methods
108
+ ##### `innerMethod()` → `void`
109
+
110
+ Executes from the inner class.
111
+
112
+ ---