@cparra/apexdocs 2.25.0 → 3.0.0-alpha.10

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 (431) hide show
  1. package/.github/workflows/ci.yaml +22 -0
  2. package/README.md +73 -12
  3. package/__mocks__/chalk.js +12 -0
  4. package/__mocks__/log-update.js +6 -0
  5. package/dist/cli/generate.js +3181 -0
  6. package/dist/defaults-DGKfeZq-.js +13 -0
  7. package/dist/index.d.ts +117 -0
  8. package/dist/index.js +36 -0
  9. package/eslint.config.mjs +10 -0
  10. package/examples/markdown/.forceignore +12 -0
  11. package/examples/markdown/config/project-scratch-def.json +5 -0
  12. package/examples/markdown/docs/index.md +109 -0
  13. package/examples/markdown/docs/miscellaneous/BaseClass.md +16 -0
  14. package/examples/markdown/docs/miscellaneous/MultiInheritanceClass.md +72 -0
  15. package/examples/markdown/docs/miscellaneous/ParentInterface.md +15 -0
  16. package/examples/markdown/docs/miscellaneous/ReferencedEnum.md +8 -0
  17. package/examples/markdown/docs/miscellaneous/SampleException.md +24 -0
  18. package/examples/markdown/docs/miscellaneous/SampleInterface.md +116 -0
  19. package/examples/markdown/docs/miscellaneous/Url.md +309 -0
  20. package/examples/markdown/docs/sample-enums/SampleEnum.md +36 -0
  21. package/examples/markdown/docs/samplegroup/SampleClass.md +170 -0
  22. package/examples/markdown/force-app/classes/BaseClass.cls +3 -0
  23. package/examples/markdown/force-app/classes/MultiInheritanceClass.cls +1 -0
  24. package/examples/markdown/force-app/classes/ParentInterface.cls +3 -0
  25. package/examples/markdown/force-app/classes/ReferencedEnum.cls +3 -0
  26. package/examples/markdown/force-app/classes/SampleClass.cls +72 -0
  27. package/examples/markdown/force-app/classes/SampleEnum.cls +30 -0
  28. package/examples/markdown/force-app/classes/SampleException.cls +17 -0
  29. package/examples/markdown/force-app/classes/SampleInterface.cls +50 -0
  30. package/examples/markdown/force-app/classes/Url.cls +194 -0
  31. package/examples/markdown/package-lock.json +665 -0
  32. package/examples/markdown/package.json +20 -0
  33. package/examples/markdown/sfdx-project.json +12 -0
  34. package/examples/vitepress/.forceignore +12 -0
  35. package/examples/vitepress/apexdocs.config.ts +106 -0
  36. package/examples/vitepress/config/project-scratch-def.json +13 -0
  37. package/examples/vitepress/docs/.vitepress/cache/deps/@theme_index.js +259 -0
  38. package/examples/vitepress/docs/.vitepress/cache/deps/@theme_index.js.map +7 -0
  39. package/examples/vitepress/docs/.vitepress/cache/deps/_metadata.json +40 -0
  40. package/examples/vitepress/docs/.vitepress/cache/deps/chunk-574YRH25.js +11474 -0
  41. package/examples/vitepress/docs/.vitepress/cache/deps/chunk-574YRH25.js.map +7 -0
  42. package/examples/vitepress/docs/.vitepress/cache/deps/chunk-E5DZZB2I.js +9172 -0
  43. package/examples/vitepress/docs/.vitepress/cache/deps/chunk-E5DZZB2I.js.map +7 -0
  44. package/examples/vitepress/docs/.vitepress/cache/deps/package.json +3 -0
  45. package/examples/vitepress/docs/.vitepress/cache/deps/vitepress___@vue_devtools-api.js +4339 -0
  46. package/examples/vitepress/docs/.vitepress/cache/deps/vitepress___@vue_devtools-api.js.map +7 -0
  47. package/examples/vitepress/docs/.vitepress/cache/deps/vitepress___@vueuse_core.js +567 -0
  48. package/examples/vitepress/docs/.vitepress/cache/deps/vitepress___@vueuse_core.js.map +7 -0
  49. package/examples/vitepress/docs/.vitepress/cache/deps/vue.js +323 -0
  50. package/examples/vitepress/docs/.vitepress/cache/deps/vue.js.map +7 -0
  51. package/examples/vitepress/docs/.vitepress/config.mts +21 -0
  52. package/examples/vitepress/docs/.vitepress/sidebar.json +119 -0
  53. package/examples/vitepress/docs/api-examples.md +49 -0
  54. package/examples/vitepress/docs/index-frontmatter.md +16 -0
  55. package/examples/vitepress/docs/index.md +56 -0
  56. package/examples/vitepress/docs/markdown-examples.md +85 -0
  57. package/examples/vitepress/docs/miscellaneous/BaseClass.md +20 -0
  58. package/examples/vitepress/docs/miscellaneous/MultiInheritanceClass.md +76 -0
  59. package/examples/vitepress/docs/miscellaneous/ParentInterface.md +19 -0
  60. package/examples/vitepress/docs/miscellaneous/ReferencedEnum.md +15 -0
  61. package/examples/vitepress/docs/miscellaneous/SampleException.md +28 -0
  62. package/examples/vitepress/docs/miscellaneous/SampleInterface.md +116 -0
  63. package/examples/vitepress/docs/miscellaneous/Url.md +317 -0
  64. package/examples/vitepress/docs/sample-enums/SampleEnum.md +40 -0
  65. package/examples/vitepress/docs/samplegroup/SampleClass.md +174 -0
  66. package/examples/vitepress/force-app/main/default/classes/BaseClass.cls +3 -0
  67. package/examples/vitepress/force-app/main/default/classes/MultiInheritanceClass.cls +1 -0
  68. package/examples/vitepress/force-app/main/default/classes/ParentInterface.cls +3 -0
  69. package/examples/vitepress/force-app/main/default/classes/ReferencedEnum.cls +5 -0
  70. package/examples/vitepress/force-app/main/default/classes/SampleClass.cls +72 -0
  71. package/examples/vitepress/force-app/main/default/classes/SampleEnum.cls +30 -0
  72. package/examples/vitepress/force-app/main/default/classes/SampleException.cls +17 -0
  73. package/examples/vitepress/force-app/main/default/classes/SampleInterface.cls +46 -0
  74. package/examples/vitepress/force-app/main/default/classes/Url.cls +198 -0
  75. package/examples/vitepress/package-lock.json +2574 -0
  76. package/examples/vitepress/package.json +18 -0
  77. package/examples/vitepress/sfdx-project.json +12 -0
  78. package/jest.config.js +6 -1
  79. package/jest.d.ts +7 -0
  80. package/package.json +34 -36
  81. package/src/application/Apexdocs.ts +58 -68
  82. package/src/application/__tests__/apex-file-reader.spec.ts +104 -0
  83. package/src/application/apex-file-reader.ts +55 -0
  84. package/src/application/file-system.ts +69 -0
  85. package/src/application/file-writer.ts +43 -0
  86. package/src/application/generators/markdown.ts +45 -0
  87. package/src/application/generators/openapi.ts +60 -0
  88. package/src/cli/args.ts +43 -0
  89. package/src/cli/commands/markdown.ts +53 -0
  90. package/src/cli/generate.ts +10 -131
  91. package/src/core/manifest.ts +90 -0
  92. package/src/core/markdown/__test__/expect-extensions.ts +32 -0
  93. package/src/core/markdown/__test__/generating-class-docs.spec.ts +733 -0
  94. package/src/core/markdown/__test__/generating-enum-docs.spec.ts +385 -0
  95. package/src/core/markdown/__test__/generating-interface-docs.spec.ts +461 -0
  96. package/src/core/markdown/__test__/generating-reference-guide.spec.ts +180 -0
  97. package/src/core/markdown/__test__/inheritance-chain.test.ts +54 -0
  98. package/src/core/markdown/__test__/test-helpers.ts +23 -0
  99. package/src/core/markdown/adapters/__tests__/documentables.spec.ts +109 -0
  100. package/src/core/markdown/adapters/__tests__/interface-adapter.spec.ts +148 -0
  101. package/src/core/markdown/adapters/__tests__/link-generator.spec.ts +130 -0
  102. package/src/core/markdown/adapters/__tests__/references.spec.ts +136 -0
  103. package/src/core/markdown/adapters/apex-types.ts +238 -0
  104. package/src/core/markdown/adapters/documentables.ts +115 -0
  105. package/src/core/markdown/adapters/fields-and-properties.ts +45 -0
  106. package/src/core/markdown/adapters/generate-link.ts +82 -0
  107. package/src/core/markdown/adapters/inline.ts +143 -0
  108. package/src/core/markdown/adapters/methods-and-constructors.ts +133 -0
  109. package/src/core/markdown/adapters/reference-guide.ts +37 -0
  110. package/src/core/markdown/adapters/renderable-bundle.ts +61 -0
  111. package/src/core/markdown/adapters/renderable-to-page-data.ts +89 -0
  112. package/src/core/markdown/adapters/type-utils.ts +13 -0
  113. package/src/core/markdown/adapters/types.d.ts +180 -0
  114. package/src/core/markdown/generate-docs.ts +212 -0
  115. package/src/core/markdown/reflection/filter-scope.ts +13 -0
  116. package/src/core/markdown/reflection/inheritance-chain-expanion.ts +22 -0
  117. package/src/core/markdown/reflection/inheritance-chain.ts +23 -0
  118. package/src/core/markdown/reflection/inherited-member-expansion.ts +105 -0
  119. package/src/core/markdown/reflection/reflect-source.ts +123 -0
  120. package/src/core/markdown/reflection/sort-members.ts +59 -0
  121. package/src/core/markdown/templates/class-template.ts +75 -0
  122. package/src/core/markdown/templates/constructors-partial-template.ts +32 -0
  123. package/src/core/markdown/templates/documentable-partial-template.ts +26 -0
  124. package/src/core/markdown/templates/enum-template.ts +12 -0
  125. package/src/core/markdown/templates/fieldsPartialTemplate.ts +23 -0
  126. package/src/core/markdown/templates/grouped-members-partial-template.ts +6 -0
  127. package/src/core/markdown/templates/hookable.ts +7 -0
  128. package/src/core/markdown/templates/interface-template.ts +16 -0
  129. package/src/core/markdown/templates/methods-partial-template.ts +43 -0
  130. package/src/core/markdown/templates/reference-guide.ts +14 -0
  131. package/src/core/markdown/templates/template.ts +114 -0
  132. package/src/core/markdown/templates/type-doc-partial.ts +27 -0
  133. package/src/core/markdown/utils.ts +3 -0
  134. package/src/{service → core/openapi}/__tests__/manifest-factory.spec.ts +1 -2
  135. package/src/{transpiler → core}/openapi/__tests__/open-api-docs-processor.spec.ts +1 -1
  136. package/src/{model → core/openapi}/apex-type-wrappers/__tests__/ClassMirrorWrapper.spec.ts +3 -3
  137. package/src/core/openapi/file-container.ts +13 -0
  138. package/src/{service → core/openapi}/manifest-factory.ts +3 -3
  139. package/src/{transpiler → core}/openapi/open-api-docs-processor.ts +10 -11
  140. package/src/{model → core}/openapi/open-api-types.ts +2 -2
  141. package/src/core/openapi/openapi-type-file.ts +12 -0
  142. package/src/{service → core/openapi}/parser.ts +7 -21
  143. package/src/{transpiler → core}/openapi/parsers/Builder.ts +3 -3
  144. package/src/{transpiler → core}/openapi/parsers/MethodParser.ts +6 -6
  145. package/src/{transpiler → core}/openapi/parsers/ParameterObjectBuilder.ts +2 -2
  146. package/src/{transpiler → core}/openapi/parsers/ReferenceBuilder.ts +7 -6
  147. package/src/{transpiler → core}/openapi/parsers/RequestBodyBuilder.ts +2 -2
  148. package/src/{transpiler → core}/openapi/parsers/ResponsesBuilder.ts +2 -2
  149. package/src/{transpiler → core}/openapi/parsers/__tests__/MethodParser.spec.ts +1 -1
  150. package/src/{transpiler → core}/openapi/parsers/__tests__/ParameterObjectBuilder.spec.ts +2 -2
  151. package/src/{transpiler → core}/openapi/parsers/__tests__/ReferenceBuilder.spec.ts +2 -2
  152. package/src/{transpiler → core}/openapi/parsers/__tests__/RequestBodyBuilder.spec.ts +2 -2
  153. package/src/{transpiler → core}/openapi/parsers/__tests__/ResponsesBuilder.spec.ts +1 -1
  154. package/src/{transpiler → core/openapi}/transpiler.ts +2 -6
  155. package/src/{model → core/openapi}/types-repository.ts +0 -9
  156. package/src/core/parse-apex-metadata.ts +30 -0
  157. package/src/core/settings.ts +56 -0
  158. package/src/core/shared/types.d.ts +147 -0
  159. package/src/core/shared/utils.ts +5 -0
  160. package/src/defaults.ts +9 -0
  161. package/src/index.ts +36 -1
  162. package/src/test-helpers/ClassMirrorBuilder.ts +14 -1
  163. package/src/test-helpers/FieldMirrorBuilder.ts +1 -1
  164. package/src/test-helpers/InterfaceMirrorBuilder.ts +39 -0
  165. package/src/test-helpers/MethodMirrorBuilder.ts +46 -6
  166. package/src/test-helpers/SettingsBuilder.ts +1 -4
  167. package/src/util/error-logger.ts +4 -4
  168. package/src/util/fp.ts +3 -0
  169. package/src/util/logger.ts +12 -25
  170. package/src/util/string-utils.ts +0 -4
  171. package/tsconfig.json +8 -3
  172. package/.eslintrc.js +0 -12
  173. package/apexdocs.config.ts +0 -13
  174. package/docs/.nojekyll +0 -0
  175. package/docs/README.md +0 -1
  176. package/docs/index.html +0 -22
  177. package/docs/restapi.json +0 -589
  178. package/docs/types/Classes/nspc.AnotherInterface.md +0 -22
  179. package/docs/types/Classes/nspc.ChildClass.md +0 -97
  180. package/docs/types/Main/nspc.GroupedClass.md +0 -10
  181. package/docs/types/Main/nspc.SampleClass.md +0 -190
  182. package/docs/types/Misc-Group/nspc.EscapedAnnotations.md +0 -4
  183. package/docs/types/Misc-Group/nspc.GrandparentClass.md +0 -13
  184. package/docs/types/Misc-Group/nspc.InterfaceWithInheritance.md +0 -29
  185. package/docs/types/Misc-Group/nspc.MemberGrouping.md +0 -13
  186. package/docs/types/Misc-Group/nspc.ParentClass.md +0 -37
  187. package/docs/types/Misc-Group/nspc.Reference1.md +0 -18
  188. package/docs/types/Misc-Group/nspc.Reference2.md +0 -12
  189. package/docs/types/Misc-Group/nspc.Reference3.md +0 -7
  190. package/docs/types/Misc-Group/nspc.Reference4.md +0 -7
  191. package/docs/types/Misc-Group/nspc.Reference5.md +0 -7
  192. package/docs/types/Misc-Group/nspc.Reference6.md +0 -9
  193. package/docs/types/Misc-Group/nspc.Reference7.md +0 -7
  194. package/docs/types/Misc-Group/nspc.SampleClassWithoutModifier.md +0 -11
  195. package/docs/types/Misc-Group/nspc.SampleRestResource.md +0 -211
  196. package/docs/types/Misc-Group/nspc.SampleRestResourceWithInnerClass.md +0 -34
  197. package/docs/types/Misc-Group/nspc.SampleRestResourceWithoutApexDocs.md +0 -14
  198. package/docs/types/README.md +0 -97
  199. package/docs/types/Sample-Interfaces/nspc.SampleInterface.md +0 -23
  200. package/examples/includes/header.md +0 -3
  201. package/lib/application/Apexdocs.d.ts +0 -13
  202. package/lib/application/Apexdocs.js +0 -77
  203. package/lib/application/Apexdocs.js.map +0 -1
  204. package/lib/cli/generate.d.ts +0 -2
  205. package/lib/cli/generate.js +0 -131
  206. package/lib/cli/generate.js.map +0 -1
  207. package/lib/index.d.ts +0 -1
  208. package/lib/index.js +0 -18
  209. package/lib/index.js.map +0 -1
  210. package/lib/model/apex-bundle.d.ts +0 -6
  211. package/lib/model/apex-bundle.js +0 -11
  212. package/lib/model/apex-bundle.js.map +0 -1
  213. package/lib/model/apex-type-wrappers/ClassMirrorWrapper.d.ts +0 -7
  214. package/lib/model/apex-type-wrappers/ClassMirrorWrapper.js +0 -14
  215. package/lib/model/apex-type-wrappers/ClassMirrorWrapper.js.map +0 -1
  216. package/lib/model/apex-type-wrappers/MethodMirrorWrapper.d.ts +0 -7
  217. package/lib/model/apex-type-wrappers/MethodMirrorWrapper.js +0 -12
  218. package/lib/model/apex-type-wrappers/MethodMirrorWrapper.js.map +0 -1
  219. package/lib/model/inheritance.d.ts +0 -8
  220. package/lib/model/inheritance.js +0 -3
  221. package/lib/model/inheritance.js.map +0 -1
  222. package/lib/model/manifest-diff.d.ts +0 -27
  223. package/lib/model/manifest-diff.js +0 -69
  224. package/lib/model/manifest-diff.js.map +0 -1
  225. package/lib/model/manifest.d.ts +0 -22
  226. package/lib/model/manifest.js +0 -47
  227. package/lib/model/manifest.js.map +0 -1
  228. package/lib/model/markdown-file.d.ts +0 -16
  229. package/lib/model/markdown-file.js +0 -107
  230. package/lib/model/markdown-file.js.map +0 -1
  231. package/lib/model/markdown-generation-util/doc-comment-annotation-util.d.ts +0 -8
  232. package/lib/model/markdown-generation-util/doc-comment-annotation-util.js +0 -44
  233. package/lib/model/markdown-generation-util/doc-comment-annotation-util.js.map +0 -1
  234. package/lib/model/markdown-generation-util/field-declaration-util.d.ts +0 -3
  235. package/lib/model/markdown-generation-util/field-declaration-util.js +0 -55
  236. package/lib/model/markdown-generation-util/field-declaration-util.js.map +0 -1
  237. package/lib/model/markdown-generation-util/index.d.ts +0 -3
  238. package/lib/model/markdown-generation-util/index.js +0 -20
  239. package/lib/model/markdown-generation-util/index.js.map +0 -1
  240. package/lib/model/markdown-generation-util/method-declaration-util.d.ts +0 -4
  241. package/lib/model/markdown-generation-util/method-declaration-util.js +0 -115
  242. package/lib/model/markdown-generation-util/method-declaration-util.js.map +0 -1
  243. package/lib/model/markdown-generation-util/type-declaration-util.d.ts +0 -3
  244. package/lib/model/markdown-generation-util/type-declaration-util.js +0 -82
  245. package/lib/model/markdown-generation-util/type-declaration-util.js.map +0 -1
  246. package/lib/model/markdown-home-file.d.ts +0 -11
  247. package/lib/model/markdown-home-file.js +0 -54
  248. package/lib/model/markdown-home-file.js.map +0 -1
  249. package/lib/model/markdown-type-file.d.ts +0 -26
  250. package/lib/model/markdown-type-file.js +0 -134
  251. package/lib/model/markdown-type-file.js.map +0 -1
  252. package/lib/model/openapi/apex-doc-types.d.ts +0 -19
  253. package/lib/model/openapi/apex-doc-types.js +0 -5
  254. package/lib/model/openapi/apex-doc-types.js.map +0 -1
  255. package/lib/model/openapi/open-api-types.d.ts +0 -93
  256. package/lib/model/openapi/open-api-types.js +0 -3
  257. package/lib/model/openapi/open-api-types.js.map +0 -1
  258. package/lib/model/openapi/open-api.d.ts +0 -16
  259. package/lib/model/openapi/open-api.js +0 -34
  260. package/lib/model/openapi/open-api.js.map +0 -1
  261. package/lib/model/openapi/openapi-type-file.d.ts +0 -7
  262. package/lib/model/openapi/openapi-type-file.js +0 -17
  263. package/lib/model/openapi/openapi-type-file.js.map +0 -1
  264. package/lib/model/outputFile.d.ts +0 -10
  265. package/lib/model/outputFile.js +0 -29
  266. package/lib/model/outputFile.js.map +0 -1
  267. package/lib/model/types-repository.d.ts +0 -16
  268. package/lib/model/types-repository.js +0 -54
  269. package/lib/model/types-repository.js.map +0 -1
  270. package/lib/service/apex-file-reader.d.ts +0 -14
  271. package/lib/service/apex-file-reader.js +0 -46
  272. package/lib/service/apex-file-reader.js.map +0 -1
  273. package/lib/service/file-system.d.ts +0 -14
  274. package/lib/service/file-system.js +0 -25
  275. package/lib/service/file-system.js.map +0 -1
  276. package/lib/service/file-writer.d.ts +0 -6
  277. package/lib/service/file-writer.js +0 -34
  278. package/lib/service/file-writer.js.map +0 -1
  279. package/lib/service/manifest-factory.d.ts +0 -10
  280. package/lib/service/manifest-factory.js +0 -14
  281. package/lib/service/manifest-factory.js.map +0 -1
  282. package/lib/service/metadata-processor.d.ts +0 -3
  283. package/lib/service/metadata-processor.js +0 -17
  284. package/lib/service/metadata-processor.js.map +0 -1
  285. package/lib/service/parser.d.ts +0 -21
  286. package/lib/service/parser.js +0 -135
  287. package/lib/service/parser.js.map +0 -1
  288. package/lib/service/state.d.ts +0 -9
  289. package/lib/service/state.js +0 -20
  290. package/lib/service/state.js.map +0 -1
  291. package/lib/service/walkers/class-walker.d.ts +0 -4
  292. package/lib/service/walkers/class-walker.js +0 -33
  293. package/lib/service/walkers/class-walker.js.map +0 -1
  294. package/lib/service/walkers/enum-walker.d.ts +0 -4
  295. package/lib/service/walkers/enum-walker.js +0 -11
  296. package/lib/service/walkers/enum-walker.js.map +0 -1
  297. package/lib/service/walkers/interface-walker.d.ts +0 -4
  298. package/lib/service/walkers/interface-walker.js +0 -15
  299. package/lib/service/walkers/interface-walker.js.map +0 -1
  300. package/lib/service/walkers/walker-factory.d.ts +0 -5
  301. package/lib/service/walkers/walker-factory.js +0 -21
  302. package/lib/service/walkers/walker-factory.js.map +0 -1
  303. package/lib/service/walkers/walker.d.ts +0 -19
  304. package/lib/service/walkers/walker.js +0 -17
  305. package/lib/service/walkers/walker.js.map +0 -1
  306. package/lib/settings.d.ts +0 -64
  307. package/lib/settings.js +0 -89
  308. package/lib/settings.js.map +0 -1
  309. package/lib/test-helpers/AnnotationBuilder.d.ts +0 -12
  310. package/lib/test-helpers/AnnotationBuilder.js +0 -31
  311. package/lib/test-helpers/AnnotationBuilder.js.map +0 -1
  312. package/lib/test-helpers/ClassMirrorBuilder.d.ts +0 -18
  313. package/lib/test-helpers/ClassMirrorBuilder.js +0 -54
  314. package/lib/test-helpers/ClassMirrorBuilder.js.map +0 -1
  315. package/lib/test-helpers/DocCommentAnnotationBuilder.d.ts +0 -8
  316. package/lib/test-helpers/DocCommentAnnotationBuilder.js +0 -26
  317. package/lib/test-helpers/DocCommentAnnotationBuilder.js.map +0 -1
  318. package/lib/test-helpers/DocCommentBuilder.d.ts +0 -12
  319. package/lib/test-helpers/DocCommentBuilder.js +0 -38
  320. package/lib/test-helpers/DocCommentBuilder.js.map +0 -1
  321. package/lib/test-helpers/FieldMirrorBuilder.d.ts +0 -18
  322. package/lib/test-helpers/FieldMirrorBuilder.js +0 -54
  323. package/lib/test-helpers/FieldMirrorBuilder.js.map +0 -1
  324. package/lib/test-helpers/MethodMirrorBuilder.d.ts +0 -10
  325. package/lib/test-helpers/MethodMirrorBuilder.js +0 -37
  326. package/lib/test-helpers/MethodMirrorBuilder.js.map +0 -1
  327. package/lib/test-helpers/SettingsBuilder.d.ts +0 -8
  328. package/lib/test-helpers/SettingsBuilder.js +0 -27
  329. package/lib/test-helpers/SettingsBuilder.js.map +0 -1
  330. package/lib/transpiler/factory.d.ts +0 -6
  331. package/lib/transpiler/factory.js +0 -32
  332. package/lib/transpiler/factory.js.map +0 -1
  333. package/lib/transpiler/file-container.d.ts +0 -6
  334. package/lib/transpiler/file-container.js +0 -16
  335. package/lib/transpiler/file-container.js.map +0 -1
  336. package/lib/transpiler/generator-choices.d.ts +0 -1
  337. package/lib/transpiler/generator-choices.js +0 -3
  338. package/lib/transpiler/generator-choices.js.map +0 -1
  339. package/lib/transpiler/markdown/class-file-generatorHelper.d.ts +0 -8
  340. package/lib/transpiler/markdown/class-file-generatorHelper.js +0 -56
  341. package/lib/transpiler/markdown/class-file-generatorHelper.js.map +0 -1
  342. package/lib/transpiler/markdown/docsify/docsify-docs-processor.d.ts +0 -6
  343. package/lib/transpiler/markdown/docsify/docsify-docs-processor.js +0 -13
  344. package/lib/transpiler/markdown/docsify/docsify-docs-processor.js.map +0 -1
  345. package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.d.ts +0 -11
  346. package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.js +0 -51
  347. package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.js.map +0 -1
  348. package/lib/transpiler/markdown/markdown-transpiler-base.d.ts +0 -11
  349. package/lib/transpiler/markdown/markdown-transpiler-base.js +0 -24
  350. package/lib/transpiler/markdown/markdown-transpiler-base.js.map +0 -1
  351. package/lib/transpiler/markdown/plain-markdown/plain-docsProcessor.d.ts +0 -6
  352. package/lib/transpiler/markdown/plain-markdown/plain-docsProcessor.js +0 -14
  353. package/lib/transpiler/markdown/plain-markdown/plain-docsProcessor.js.map +0 -1
  354. package/lib/transpiler/openapi/open-api-docs-processor.d.ts +0 -13
  355. package/lib/transpiler/openapi/open-api-docs-processor.js +0 -75
  356. package/lib/transpiler/openapi/open-api-docs-processor.js.map +0 -1
  357. package/lib/transpiler/openapi/parsers/Builder.d.ts +0 -16
  358. package/lib/transpiler/openapi/parsers/Builder.js +0 -30
  359. package/lib/transpiler/openapi/parsers/Builder.js.map +0 -1
  360. package/lib/transpiler/openapi/parsers/MethodParser.d.ts +0 -20
  361. package/lib/transpiler/openapi/parsers/MethodParser.js +0 -167
  362. package/lib/transpiler/openapi/parsers/MethodParser.js.map +0 -1
  363. package/lib/transpiler/openapi/parsers/ParameterObjectBuilder.d.ts +0 -7
  364. package/lib/transpiler/openapi/parsers/ParameterObjectBuilder.js +0 -11
  365. package/lib/transpiler/openapi/parsers/ParameterObjectBuilder.js.map +0 -1
  366. package/lib/transpiler/openapi/parsers/ReferenceBuilder.d.ts +0 -39
  367. package/lib/transpiler/openapi/parsers/ReferenceBuilder.js +0 -226
  368. package/lib/transpiler/openapi/parsers/ReferenceBuilder.js.map +0 -1
  369. package/lib/transpiler/openapi/parsers/RequestBodyBuilder.d.ts +0 -10
  370. package/lib/transpiler/openapi/parsers/RequestBodyBuilder.js +0 -20
  371. package/lib/transpiler/openapi/parsers/RequestBodyBuilder.js.map +0 -1
  372. package/lib/transpiler/openapi/parsers/ResponsesBuilder.d.ts +0 -7
  373. package/lib/transpiler/openapi/parsers/ResponsesBuilder.js +0 -22
  374. package/lib/transpiler/openapi/parsers/ResponsesBuilder.js.map +0 -1
  375. package/lib/transpiler/processor-type-transpiler.d.ts +0 -10
  376. package/lib/transpiler/processor-type-transpiler.js +0 -9
  377. package/lib/transpiler/processor-type-transpiler.js.map +0 -1
  378. package/lib/transpiler/transpiler.d.ts +0 -5
  379. package/lib/transpiler/transpiler.js +0 -27
  380. package/lib/transpiler/transpiler.js.map +0 -1
  381. package/lib/util/error-logger.d.ts +0 -8
  382. package/lib/util/error-logger.js +0 -90
  383. package/lib/util/error-logger.js.map +0 -1
  384. package/lib/util/logger.d.ts +0 -21
  385. package/lib/util/logger.js +0 -58
  386. package/lib/util/logger.js.map +0 -1
  387. package/lib/util/string-utils.d.ts +0 -2
  388. package/lib/util/string-utils.js +0 -15
  389. package/lib/util/string-utils.js.map +0 -1
  390. package/src/model/__tests__/manifest-diff.spec.ts +0 -147
  391. package/src/model/apex-bundle.ts +0 -3
  392. package/src/model/inheritance.ts +0 -7
  393. package/src/model/manifest-diff.ts +0 -94
  394. package/src/model/manifest.ts +0 -74
  395. package/src/model/markdown-file.ts +0 -121
  396. package/src/model/markdown-generation-util/doc-comment-annotation-util.ts +0 -50
  397. package/src/model/markdown-generation-util/field-declaration-util.ts +0 -71
  398. package/src/model/markdown-generation-util/index.ts +0 -3
  399. package/src/model/markdown-generation-util/method-declaration-util.ts +0 -166
  400. package/src/model/markdown-generation-util/type-declaration-util.ts +0 -91
  401. package/src/model/markdown-home-file.ts +0 -58
  402. package/src/model/markdown-type-file.ts +0 -165
  403. package/src/model/openapi/openapi-type-file.ts +0 -14
  404. package/src/model/outputFile.ts +0 -29
  405. package/src/service/__tests__/apex-file-reader.spec.ts +0 -92
  406. package/src/service/apex-file-reader.ts +0 -51
  407. package/src/service/file-system.ts +0 -33
  408. package/src/service/file-writer.ts +0 -34
  409. package/src/service/metadata-processor.ts +0 -16
  410. package/src/service/state.ts +0 -24
  411. package/src/service/walkers/class-walker.ts +0 -30
  412. package/src/service/walkers/enum-walker.ts +0 -7
  413. package/src/service/walkers/interface-walker.ts +0 -12
  414. package/src/service/walkers/walker-factory.ts +0 -19
  415. package/src/service/walkers/walker.ts +0 -42
  416. package/src/settings.ts +0 -147
  417. package/src/transpiler/factory.ts +0 -33
  418. package/src/transpiler/file-container.ts +0 -13
  419. package/src/transpiler/generator-choices.ts +0 -1
  420. package/src/transpiler/markdown/class-file-generatorHelper.ts +0 -58
  421. package/src/transpiler/markdown/docsify/docsify-docs-processor.ts +0 -12
  422. package/src/transpiler/markdown/jekyll/jekyll-docsProcessor.ts +0 -50
  423. package/src/transpiler/markdown/markdown-transpiler-base.ts +0 -28
  424. package/src/transpiler/markdown/plain-markdown/plain-docsProcessor.ts +0 -12
  425. package/src/transpiler/processor-type-transpiler.ts +0 -18
  426. /package/src/{model/__tests__ → core/__test__}/manifest.spec.ts +0 -0
  427. /package/src/{model → core}/openapi/__tests__/open-api.spec.ts +0 -0
  428. /package/src/{model → core}/openapi/apex-doc-types.ts +0 -0
  429. /package/src/{model → core/openapi}/apex-type-wrappers/ClassMirrorWrapper.ts +0 -0
  430. /package/src/{model → core/openapi}/apex-type-wrappers/MethodMirrorWrapper.ts +0 -0
  431. /package/src/{model → core}/openapi/open-api.ts +0 -0
@@ -1,97 +0,0 @@
1
- # nspc.ChildClass
2
-
3
- Some desc
4
-
5
-
6
- **Inheritance**
7
-
8
- [nspc.GrandparentClass](types/Misc-Group/nspc.GrandparentClass.md)
9
- >
10
- [nspc.ParentClass](types/Misc-Group/nspc.ParentClass.md)
11
- >
12
- ChildClass
13
-
14
-
15
- **Implemented types**
16
-
17
- [nspc.SampleInterface](types/Sample-Interfaces/nspc.SampleInterface.md)
18
-
19
-
20
- **Group** Classes
21
-
22
- ## Fields
23
-
24
- ### `private aPrivateString` → `String`
25
-
26
-
27
- ### `private privateStringFromChild` → `String`
28
-
29
-
30
- ### `protected protectedGrandParentField` → `String`
31
-
32
- *Inherited*
33
-
34
- ### `protected protectedStringFromParent` → `String`
35
-
36
- *Inherited*
37
-
38
- This is a protected string, use carefully.
39
-
40
- ### `public publicStringFromParent` → `String`
41
-
42
- *Inherited*
43
-
44
- ---
45
- ## Properties
46
-
47
- ### `protected AProp` → `String`
48
-
49
- *Inherited*
50
-
51
- ---
52
- ## Methods
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
-
72
- ### `public override String overridableMethodOverridden()`
73
-
74
- This method was overridden.
75
-
76
- #### Returns
77
-
78
- |Type|Description|
79
- |---|---|
80
- |`String`|A String.|
81
-
82
-
83
- ```mermaid
84
- sequenceDiagram
85
- participant dotcom
86
- participant iframe
87
- participant viewscreen
88
- dotcom->>iframe: loads html w/ iframe url
89
- iframe->>viewscreen: request template
90
- viewscreen->>iframe: html & javascript
91
- iframe->>dotcom: iframe ready
92
- dotcom->>iframe: set mermaid data on iframe
93
- iframe->>iframe: render mermaid
94
- ```
95
-
96
-
97
- ---
@@ -1,10 +0,0 @@
1
- # nspc.GroupedClass
2
-
3
- Uses a block style apex doc
4
-
5
-
6
- **Group** Main
7
-
8
-
9
- **Test Class** [nspc.SampleClass](types/Main/nspc.SampleClass.md)
10
-
@@ -1,190 +0,0 @@
1
- # virtual nspc.SampleClass
2
-
3
- `NAMESPACEACCESSIBLE`
4
-
5
- This is a class description. This class relates to [nspc.SampleInterface](types/Sample-Interfaces/nspc.SampleInterface.md)
6
- But this [ClassThatDoesNotExist](ClassThatDoesNotExist) does not exist.
7
- You can also link using this syntax [nspc.SampleInterface](types/Sample-Interfaces/nspc.SampleInterface.md)
8
-
9
-
10
- **Group** Main
11
-
12
-
13
- **CustomAnnotation** A Custom annotation
14
-
15
-
16
- **Author** Cesar Parra
17
-
18
-
19
- **See** [nspc.SampleInterface](types/Sample-Interfaces/nspc.SampleInterface.md)
20
-
21
- ## Constructors
22
- ### My Super Group
23
- ##### `public SampleClass()`
24
-
25
- `NAMESPACEACCESSIBLE`
26
-
27
- Constructs a SampleClass without any arguments. This relates to [nspc.SampleInterface](types/Sample-Interfaces/nspc.SampleInterface.md)
28
-
29
- ###### Throws
30
-
31
- |Exception|Description|
32
- |---|---|
33
- |`ExcName`|some exception|
34
-
35
-
36
- **CustomAnnotation** A Custom method annotation
37
-
38
-
39
- **See** [nspc.SampleInterface](types/Sample-Interfaces/nspc.SampleInterface.md)
40
-
41
- ###### Example
42
- ```apex
43
- // Example
44
- SampleClass sampleInstance = new SampleClass();
45
- ```
46
-
47
-
48
- ---
49
- ### Other
50
- ##### `public SampleClass(String argument1, String argument2)`
51
-
52
- Constructs a SampleClass with an argument.
53
-
54
- ###### Parameters
55
-
56
- |Param|Description|
57
- |---|---|
58
- |`argument1`|Argument1 definition|
59
- |`argument2`|Argument2 definition|
60
-
61
- ---
62
- ## Fields
63
- ### Common Constants
64
-
65
- * `public A_CONSTANT` → `String` [`NAMESPACEACCESSIBLE` ] - This is a constant.
66
- * `public ANOTHER_CONSTANT` → `String`
67
- * `public listOfStrings` → `List<String>`
68
- ---
69
- ### 'General' Constants
70
-
71
- * `public GENERAL_A_CONSTANT` → `String` [`NAMESPACEACCESSIBLE` ] - This is a constant.
72
- * `public GENERAL_ANOTHER_CONSTANT` → `String`
73
- ---
74
- ### Other
75
-
76
- * `private somePrivateStuff` → `String`
77
- ---
78
- ### Other variables
79
-
80
- * `public someVariable` → `String`
81
- ---
82
- ## Properties
83
-
84
- ### `public AnotherProp` → `Decimal`
85
-
86
- `AURAENABLED`
87
-
88
- This is a Decimal property.
89
-
90
- ### `public MyProp` → `String`
91
-
92
- `AURAENABLED`
93
- `DEPRECATED`
94
-
95
- This is a String property.
96
-
97
- ---
98
- ## Methods
99
- ### A method group
100
- ##### `public static String anotherSampleMethod(String arg1)`
101
-
102
- Something here
103
-
104
-
105
- **Arg1** The arg1 description
106
-
107
- ##### `public static String sampleMethod(String argument1, String argument2)`
108
-
109
- `NAMESPACEACCESSIBLE`
110
-
111
- Executes commands based on the passed in argument.
112
-
113
- ###### Parameters
114
-
115
- |Param|Description|
116
- |---|---|
117
- |`argument1`|Argument1 to debug|
118
- |`argument2`|Argument2 to debug|
119
-
120
- ###### Returns
121
-
122
- |Type|Description|
123
- |---|---|
124
- |`String`|Empty string|
125
-
126
- ###### Example
127
- ```apex
128
- String result = SampleClass.testMethod();
129
- System.debug(result);
130
- ```
131
-
132
-
133
- ##### `public static Map<Id,List<String>> yetAnotherSampleMethod(String arg1)`
134
- ---
135
- ### Other
136
- ##### `public static void call()`
137
-
138
- Calls the method.
139
- This methods allows you to call it.
140
-
141
- ---
142
- ## Enums
143
- ### InnerEnum
144
-
145
- `NAMESPACEACCESSIBLE`
146
-
147
- This is a namespace accessible enum
148
-
149
-
150
- ---
151
- ## Classes
152
- ### AnotherInnerClass
153
-
154
- Inner class belonging to SampleClass.
155
-
156
- #### Properties
157
-
158
- ##### `public InnerProp` → `String`
159
-
160
-
161
- Description of the inner property.
162
-
163
- ---
164
- #### Methods
165
- ##### `public void innerMethod()`
166
-
167
- Executes from the inner class.
168
-
169
- ---
170
-
171
- ### InnerClass
172
-
173
- Inner class belonging to SampleClass.
174
-
175
- #### Properties
176
-
177
- ##### `public InnerProp` → `String`
178
-
179
-
180
- Description of the inner property.
181
-
182
- ---
183
- #### Methods
184
- ##### `public void innerMethod()`
185
-
186
- Executes from the inner class.
187
-
188
- ---
189
-
190
- ---
@@ -1,4 +0,0 @@
1
- # nspc.EscapedAnnotations
2
-
3
- This sentence has an `@embedded` annotation.
4
-
@@ -1,13 +0,0 @@
1
- # virtual nspc.GrandparentClass
2
- ## Fields
3
-
4
- ### `protected protectedGrandParentField` → `String`
5
-
6
-
7
- ---
8
- ## Properties
9
-
10
- ### `protected AProp` → `String`
11
-
12
-
13
- ---
@@ -1,29 +0,0 @@
1
- # nspc.InterfaceWithInheritance
2
-
3
- **Extended types**
4
-
5
- [nspc.SampleInterface](types/Sample-Interfaces/nspc.SampleInterface.md)
6
- ,
7
- [nspc.AnotherInterface](types/Classes/nspc.AnotherInterface.md)
8
- ## Methods
9
- ### `global void execute()`
10
-
11
- *Inherited*
12
-
13
-
14
- Executes the command.
15
-
16
- ### `global String getValue()`
17
-
18
- *Inherited*
19
-
20
-
21
- Returns a value based on the executed command.
22
-
23
- #### Returns
24
-
25
- |Type|Description|
26
- |---|---|
27
- |`String`|The value|
28
-
29
- ---
@@ -1,13 +0,0 @@
1
- # nspc.MemberGrouping
2
- ## Fields
3
- ### Group old syntax
4
-
5
- * `public anotherInGroup1` → `String`
6
- * `public inGroup1` → `String`
7
- ---
8
- ### Group new syntax
9
- Group's description
10
-
11
- * `public anotherInGroup2` → `String` - Description for another constant in group 2
12
- * `public inGroup2` → `String` - Description for constant in group 2
13
- ---
@@ -1,37 +0,0 @@
1
- # abstract nspc.ParentClass
2
-
3
- **Inheritance**
4
-
5
- [nspc.GrandparentClass](types/Misc-Group/nspc.GrandparentClass.md)
6
- &gt;
7
- ParentClass
8
-
9
- ## Fields
10
-
11
- ### `private privateStringFromParent` → `String`
12
-
13
-
14
- ### `protected protectedGrandParentField` → `String`
15
-
16
- *Inherited*
17
-
18
- ### `protected protectedStringFromParent` → `String`
19
-
20
-
21
- This is a protected string, use carefully.
22
-
23
- ### `public publicStringFromParent` → `String`
24
-
25
-
26
- ---
27
- ## Properties
28
-
29
- ### `protected AProp` → `String`
30
-
31
- *Inherited*
32
-
33
- ---
34
- ## Methods
35
- ### `public virtual String overridableMethod()`
36
- ### `public virtual String overridableMethodOverridden()`
37
- ---
@@ -1,18 +0,0 @@
1
- # nspc.Reference1
2
- ## Fields
3
-
4
- ### `public reference2Member` → `Reference2`
5
-
6
-
7
- This is a reference 2 member. Lorem.
8
-
9
- ### `public reference3Member` → `Reference3`
10
-
11
-
12
- ### `public reference4Collection` → `List<Reference4>`
13
-
14
-
15
- ### `public reference5Member` → `Reference5`
16
-
17
-
18
- ---
@@ -1,12 +0,0 @@
1
- # nspc.Reference2
2
- ## Fields
3
-
4
- ### `public objectReference` → `Object`
5
-
6
-
7
- This is an object reference.
8
-
9
- ### `public stringMember` → `String`
10
-
11
-
12
- ---
@@ -1,7 +0,0 @@
1
- # nspc.Reference3
2
- ## Fields
3
-
4
- ### `public someBoolean` → `Boolean`
5
-
6
-
7
- ---
@@ -1,7 +0,0 @@
1
- # nspc.Reference4
2
- ## Fields
3
-
4
- ### `public someString` → `String`
5
-
6
-
7
- ---
@@ -1,7 +0,0 @@
1
- # nspc.Reference5
2
- ## Fields
3
-
4
- ### `public reference6Member` → `Reference6`
5
-
6
-
7
- ---
@@ -1,9 +0,0 @@
1
- # nspc.Reference6
2
- ## Fields
3
-
4
- ### `public grandChildString` → `String`
5
-
6
-
7
- This is the grandchild description.
8
-
9
- ---
@@ -1,7 +0,0 @@
1
- # nspc.Reference7
2
- ## Fields
3
-
4
- ### `public untypedObject` → `Object`
5
-
6
-
7
- ---
@@ -1,11 +0,0 @@
1
- # nspc.SampleClassWithoutModifier
2
-
3
- `ISTEST`
4
- ## Methods
5
- ### `private static void thisIsAClassWithoutAModifier()`
6
-
7
- `ISTEST`
8
-
9
- This is a test method
10
-
11
- ---
@@ -1,211 +0,0 @@
1
- # nspc.SampleRestResource
2
-
3
- `RESTRESOURCE`
4
-
5
- Account related operations
6
-
7
- ## Methods
8
- ### `global static void doDelete()`
9
-
10
- `HTTPDELETE`
11
-
12
- Sample HTTP Delete method with references to other types.
13
-
14
-
15
- **Http Parameter** name: limit
16
- in: header
17
- required: true
18
- description: My sample description.
19
- schema: SampleClass
20
-
21
-
22
- **Http Response** statusCode: 200
23
- schema: SampleClass
24
-
25
-
26
- **Http Response** statusCode: 500
27
- schema: SampleClass
28
-
29
-
30
- **Http Response** statusCode: 304
31
- schema: ChildClass
32
-
33
-
34
- **Http Response** statusCode: 305
35
- schema: Reference1
36
-
37
-
38
- **Http Response** statusCode: 306
39
- schema: List&lt;Reference1&gt;
40
-
41
-
42
- **Http Response** statusCode: 307
43
- schema: Reference7[untypedObject:Reference2]
44
-
45
- ### `global static Account doGet()`
46
-
47
- `HTTPGET`
48
-
49
- This is a sample HTTP Get method
50
-
51
- #### Returns
52
-
53
- |Type|Description|
54
- |---|---|
55
- |`Account`|An Account SObject.|
56
-
57
-
58
- **Http Parameter** name: limit
59
- in: query
60
- required: true
61
- description: Limits the number of items on a page
62
- schema:
63
- type: integer
64
-
65
-
66
- **Http Parameter** name: complex
67
- in: cookie
68
- description: A more complex schema
69
- schema:
70
- type: array
71
- items:
72
- type: object
73
- properties:
74
- name:
75
- type: string
76
-
77
-
78
- **Http Response** statusCode: 200
79
- schema:
80
- type: object
81
- properties:
82
- id:
83
- type: string
84
- description: The super Id.
85
- name:
86
- type: string
87
- phone:
88
- type: string
89
- format: byte
90
-
91
-
92
- **Http Response** statusCode: 500
93
- schema:
94
- type: string
95
-
96
-
97
- **Http Response** statusCode: 304
98
- schema:
99
- type: object
100
- properties:
101
- error:
102
- type: string
103
-
104
-
105
- **Http Response** statusCode: 400
106
- schema:
107
- type: array
108
- items:
109
- type: object
110
- properties:
111
- name:
112
- type: string
113
-
114
-
115
- **Http Response** statusCode: 100
116
- schema:
117
- type: object
118
- properties:
119
- anotherObject:
120
- description: An object inside of an object
121
- type: object
122
- properties:
123
- message:
124
- type: string
125
- somethingElse:
126
- type: number
127
-
128
- ### `global static String doPost(String name, String phone, String website)`
129
-
130
- `HTTPPOST`
131
-
132
- This is a sample HTTP Post method
133
-
134
- #### Returns
135
-
136
- |Type|Description|
137
- |---|---|
138
- |`String`|A String SObject.|
139
-
140
-
141
- **Summary** Posts an Account 2
142
-
143
-
144
- **Http Parameter** name: limit
145
- in: query
146
- required: true
147
- description: Limits the number of items on a page
148
- schema:
149
- type: integer
150
-
151
-
152
- **Http Parameter** name: complex
153
- in: cookie
154
- description: A more complex schema
155
- schema:
156
- type: array
157
- items:
158
- type: object
159
- properties:
160
- name:
161
- type: string
162
-
163
-
164
- **Http Request Body** description: This is an example of a request body
165
- required: true
166
- schema:
167
- type: array
168
- items:
169
- type: object
170
- properties:
171
- name:
172
- type: string
173
-
174
-
175
- **Http Response** statusCode: 200
176
- schema:
177
- type: object
178
- properties:
179
- id:
180
- type: string
181
- description: The super Id.
182
- name:
183
- type: string
184
- phone:
185
- type: string
186
- format: byte
187
-
188
-
189
- **Http Response** statusCode: 500
190
- schema:
191
- type: string
192
-
193
-
194
- **Http Response** statusCode: 304
195
- schema:
196
- type: object
197
- properties:
198
- error:
199
- type: string
200
-
201
-
202
- **Http Response** statusCode: 400
203
- schema:
204
- type: array
205
- items:
206
- type: object
207
- properties:
208
- name:
209
- type: string
210
-
211
- ---