@cparra/apexdocs 2.25.0-alpha.1 → 2.25.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 (499) hide show
  1. package/README.md +37 -0
  2. package/dist/cli/generate.js +2963 -0
  3. package/dist/defaults-DUwru49Q.js +12 -0
  4. package/dist/defaults-SH0Rsi5E.js +11 -0
  5. package/dist/defaults-jLXD2y8-.js +13 -0
  6. package/dist/index.d.ts +101 -0
  7. package/dist/index.js +36 -0
  8. package/examples/markdown/docs/index.md +109 -0
  9. package/examples/{plain-markdown/docs/Miscellaneous/ns.BaseClass.md → markdown/docs/miscellaneous/BaseClass.md} +1 -1
  10. package/examples/markdown/docs/miscellaneous/MultiInheritanceClass.md +72 -0
  11. package/examples/{plain-markdown/docs/Miscellaneous/ns.ParentInterface.md → markdown/docs/miscellaneous/ParentInterface.md} +1 -1
  12. package/examples/{plain-markdown/docs/Miscellaneous/ns.ReferencedEnum.md → markdown/docs/miscellaneous/ReferencedEnum.md} +1 -1
  13. package/examples/markdown/docs/miscellaneous/SampleException.md +24 -0
  14. package/examples/{plain-markdown/docs/Miscellaneous/ns.SampleInterface.md → markdown/docs/miscellaneous/SampleInterface.md} +29 -32
  15. package/examples/markdown/docs/miscellaneous/Url.md +309 -0
  16. package/examples/markdown/docs/sample-enums/SampleEnum.md +36 -0
  17. package/examples/{plain-markdown/docs/SampleGroup/ns.SampleClass.md → markdown/docs/samplegroup/SampleClass.md} +11 -14
  18. package/examples/markdown/force-app/classes/MultiInheritanceClass.cls +1 -0
  19. package/examples/markdown/force-app/classes/SampleException.cls +17 -0
  20. package/examples/markdown/force-app/classes/Url.cls +194 -0
  21. package/examples/{plain-markdown → markdown}/package.json +2 -2
  22. package/examples/vitepress/.forceignore +12 -0
  23. package/examples/vitepress/apexdocs.config.ts +106 -0
  24. package/examples/vitepress/config/project-scratch-def.json +13 -0
  25. package/examples/vitepress/docs/.vitepress/cache/deps/@theme_index.js +259 -0
  26. package/examples/vitepress/docs/.vitepress/cache/deps/@theme_index.js.map +7 -0
  27. package/examples/vitepress/docs/.vitepress/cache/deps/_metadata.json +40 -0
  28. package/examples/vitepress/docs/.vitepress/cache/deps/chunk-574YRH25.js +11474 -0
  29. package/examples/vitepress/docs/.vitepress/cache/deps/chunk-574YRH25.js.map +7 -0
  30. package/examples/vitepress/docs/.vitepress/cache/deps/chunk-E5DZZB2I.js +9172 -0
  31. package/examples/vitepress/docs/.vitepress/cache/deps/chunk-E5DZZB2I.js.map +7 -0
  32. package/examples/vitepress/docs/.vitepress/cache/deps/package.json +3 -0
  33. package/examples/vitepress/docs/.vitepress/cache/deps/vitepress___@vue_devtools-api.js +4339 -0
  34. package/examples/vitepress/docs/.vitepress/cache/deps/vitepress___@vue_devtools-api.js.map +7 -0
  35. package/examples/vitepress/docs/.vitepress/cache/deps/vitepress___@vueuse_core.js +567 -0
  36. package/examples/vitepress/docs/.vitepress/cache/deps/vitepress___@vueuse_core.js.map +7 -0
  37. package/examples/vitepress/docs/.vitepress/cache/deps/vue.js +323 -0
  38. package/examples/vitepress/docs/.vitepress/cache/deps/vue.js.map +7 -0
  39. package/examples/vitepress/docs/.vitepress/config.mts +21 -0
  40. package/examples/vitepress/docs/.vitepress/sidebar.json +119 -0
  41. package/examples/vitepress/docs/api-examples.md +49 -0
  42. package/examples/vitepress/docs/index-frontmatter.md +16 -0
  43. package/examples/vitepress/docs/index.md +56 -0
  44. package/examples/vitepress/docs/markdown-examples.md +85 -0
  45. package/examples/vitepress/docs/miscellaneous/BaseClass.md +20 -0
  46. package/examples/vitepress/docs/miscellaneous/MultiInheritanceClass.md +76 -0
  47. package/examples/vitepress/docs/miscellaneous/ParentInterface.md +19 -0
  48. package/examples/vitepress/docs/miscellaneous/ReferencedEnum.md +15 -0
  49. package/examples/vitepress/docs/miscellaneous/SampleException.md +28 -0
  50. package/examples/vitepress/docs/miscellaneous/SampleInterface.md +116 -0
  51. package/examples/vitepress/docs/miscellaneous/Url.md +317 -0
  52. package/examples/vitepress/docs/sample-enums/SampleEnum.md +40 -0
  53. package/examples/vitepress/docs/samplegroup/SampleClass.md +174 -0
  54. package/examples/vitepress/force-app/main/default/classes/BaseClass.cls +3 -0
  55. package/examples/vitepress/force-app/main/default/classes/MultiInheritanceClass.cls +1 -0
  56. package/examples/vitepress/force-app/main/default/classes/ParentInterface.cls +3 -0
  57. package/examples/vitepress/force-app/main/default/classes/ReferencedEnum.cls +5 -0
  58. package/examples/vitepress/force-app/main/default/classes/SampleClass.cls +72 -0
  59. package/examples/vitepress/force-app/main/default/classes/SampleEnum.cls +30 -0
  60. package/examples/vitepress/force-app/main/default/classes/SampleException.cls +17 -0
  61. package/examples/vitepress/force-app/main/default/classes/SampleInterface.cls +46 -0
  62. package/examples/vitepress/force-app/main/default/classes/Url.cls +198 -0
  63. package/examples/vitepress/package-lock.json +2574 -0
  64. package/examples/vitepress/package.json +18 -0
  65. package/examples/vitepress/sfdx-project.json +12 -0
  66. package/jest.config.js +2 -1
  67. package/package.json +18 -19
  68. package/src/application/Apexdocs.ts +17 -70
  69. package/src/application/__tests__/apex-file-reader.spec.ts +104 -0
  70. package/src/application/apex-file-reader.ts +42 -0
  71. package/src/application/file-writer.ts +21 -0
  72. package/src/application/generators/markdown.ts +58 -0
  73. package/src/application/generators/openapi.ts +56 -0
  74. package/src/cli/args.ts +43 -0
  75. package/src/cli/commands/markdown.ts +52 -0
  76. package/src/cli/generate.ts +10 -134
  77. package/src/core/manifest.ts +90 -0
  78. package/src/{__spec__/core → core/markdown/__test__}/expect-extensions.ts +5 -5
  79. package/src/core/markdown/__test__/generating-class-docs.spec.ts +735 -0
  80. package/src/{__spec__/core → core/markdown/__test__}/generating-enum-docs.spec.ts +89 -59
  81. package/src/{__spec__/core → core/markdown/__test__}/generating-interface-docs.spec.ts +105 -75
  82. package/src/{__spec__/core → core/markdown/__test__}/generating-reference-guide.spec.ts +43 -26
  83. package/src/core/markdown/__test__/inheritance-chain.test.ts +54 -0
  84. package/src/core/markdown/__test__/test-helpers.ts +23 -0
  85. package/src/core/markdown/adapters/__tests__/documentables.spec.ts +109 -0
  86. package/src/core/markdown/adapters/__tests__/interface-adapter.spec.ts +148 -0
  87. package/src/{adapters → core/markdown/adapters}/__tests__/references.spec.ts +23 -2
  88. package/src/{adapters → core/markdown/adapters}/apex-types.ts +58 -44
  89. package/src/{adapters → core/markdown/adapters}/documentables.ts +58 -35
  90. package/src/{adapters → core/markdown/adapters}/fields-and-properties.ts +18 -11
  91. package/src/{adapters/references.ts → core/markdown/adapters/inline.ts} +43 -13
  92. package/src/{adapters → core/markdown/adapters}/methods-and-constructors.ts +36 -20
  93. package/src/core/markdown/adapters/reference-guide.ts +35 -0
  94. package/src/core/markdown/adapters/renderable-bundle.ts +78 -0
  95. package/src/core/markdown/adapters/renderable-to-page-data.ts +89 -0
  96. package/src/core/markdown/adapters/type-utils.ts +13 -0
  97. package/src/core/{renderable → markdown/adapters}/types.d.ts +57 -8
  98. package/src/core/markdown/generate-docs.ts +216 -0
  99. package/src/core/markdown/reflection/error-handling.ts +37 -0
  100. package/src/core/markdown/reflection/filter-scope.ts +13 -0
  101. package/src/core/markdown/reflection/inheritance-chain-expanion.ts +22 -0
  102. package/src/core/markdown/reflection/inheritance-chain.ts +23 -0
  103. package/src/core/markdown/reflection/inherited-member-expansion.ts +105 -0
  104. package/src/core/markdown/reflection/reflect-source.ts +45 -0
  105. package/src/core/markdown/reflection/sort-members.ts +59 -0
  106. package/src/{transpiler/markdown/plain-markdown → core/markdown/templates}/class-template.ts +5 -3
  107. package/src/{transpiler/markdown/plain-markdown → core/markdown/templates}/constructors-partial-template.ts +2 -2
  108. package/src/{transpiler/markdown/plain-markdown → core/markdown/templates}/documentable-partial-template.ts +6 -4
  109. package/src/{transpiler/markdown/plain-markdown → core/markdown/templates}/fieldsPartialTemplate.ts +1 -1
  110. package/src/core/markdown/templates/hookable.ts +7 -0
  111. package/src/{transpiler/markdown/plain-markdown → core/markdown/templates}/methods-partial-template.ts +2 -2
  112. package/src/core/{templates → markdown/templates}/reference-guide.ts +1 -1
  113. package/src/core/{template.ts → markdown/templates/template.ts} +25 -19
  114. package/src/core/markdown/utils.ts +3 -0
  115. package/src/{transpiler → core}/openapi/__tests__/open-api-docs-processor.spec.ts +1 -1
  116. package/src/{model → core/openapi}/apex-type-wrappers/__tests__/ClassMirrorWrapper.spec.ts +3 -3
  117. package/src/core/openapi/file-container.ts +13 -0
  118. package/src/{service → core/openapi}/manifest-factory.ts +3 -3
  119. package/src/{transpiler → core}/openapi/open-api-docs-processor.ts +9 -10
  120. package/src/core/openapi/openapi-type-file.ts +12 -0
  121. package/src/{service → core/openapi}/parser.ts +8 -8
  122. package/src/{transpiler → core}/openapi/parsers/Builder.ts +2 -2
  123. package/src/{transpiler → core}/openapi/parsers/MethodParser.ts +5 -5
  124. package/src/{transpiler → core}/openapi/parsers/ParameterObjectBuilder.ts +2 -2
  125. package/src/{transpiler → core}/openapi/parsers/ReferenceBuilder.ts +3 -3
  126. package/src/{transpiler → core}/openapi/parsers/RequestBodyBuilder.ts +2 -2
  127. package/src/{transpiler → core}/openapi/parsers/ResponsesBuilder.ts +2 -2
  128. package/src/{transpiler → core}/openapi/parsers/__tests__/MethodParser.spec.ts +1 -1
  129. package/src/{transpiler → core}/openapi/parsers/__tests__/ParameterObjectBuilder.spec.ts +2 -2
  130. package/src/{transpiler → core}/openapi/parsers/__tests__/ReferenceBuilder.spec.ts +2 -2
  131. package/src/{transpiler → core}/openapi/parsers/__tests__/RequestBodyBuilder.spec.ts +2 -2
  132. package/src/{transpiler → core}/openapi/parsers/__tests__/ResponsesBuilder.spec.ts +1 -1
  133. package/src/{transpiler → core/openapi}/transpiler.ts +2 -6
  134. package/src/{model → core/openapi}/types-repository.ts +0 -9
  135. package/src/core/parse-apex-metadata.ts +14 -0
  136. package/src/core/settings.ts +56 -0
  137. package/src/core/shared/types.d.ts +131 -0
  138. package/src/core/shared/utils.ts +5 -0
  139. package/src/defaults.ts +9 -0
  140. package/src/index.ts +40 -2
  141. package/src/test-helpers/ClassMirrorBuilder.ts +14 -1
  142. package/src/test-helpers/InterfaceMirrorBuilder.ts +0 -5
  143. package/src/test-helpers/SettingsBuilder.ts +1 -4
  144. package/src/util/fp.ts +3 -0
  145. package/src/util/logger.ts +3 -3
  146. package/src/util/string-utils.ts +0 -4
  147. package/tsconfig.json +6 -2
  148. package/apexdocs.config.ts +0 -13
  149. package/docs/.nojekyll +0 -0
  150. package/docs/__old/README.md +0 -1
  151. package/docs/__old/index.html +0 -22
  152. package/docs/__old/restapi.json +0 -589
  153. package/docs/__old/types/Classes/nspc.AnotherInterface.md +0 -22
  154. package/docs/__old/types/Classes/nspc.ChildClass.md +0 -97
  155. package/docs/__old/types/Main/nspc.GroupedClass.md +0 -10
  156. package/docs/__old/types/Main/nspc.SampleClass.md +0 -189
  157. package/docs/__old/types/Misc-Group/nspc.EscapedAnnotations.md +0 -4
  158. package/docs/__old/types/Misc-Group/nspc.GrandparentClass.md +0 -13
  159. package/docs/__old/types/Misc-Group/nspc.InterfaceWithInheritance.md +0 -29
  160. package/docs/__old/types/Misc-Group/nspc.MemberGrouping.md +0 -13
  161. package/docs/__old/types/Misc-Group/nspc.ParentClass.md +0 -37
  162. package/docs/__old/types/Misc-Group/nspc.Reference1.md +0 -18
  163. package/docs/__old/types/Misc-Group/nspc.Reference2.md +0 -12
  164. package/docs/__old/types/Misc-Group/nspc.Reference3.md +0 -7
  165. package/docs/__old/types/Misc-Group/nspc.Reference4.md +0 -7
  166. package/docs/__old/types/Misc-Group/nspc.Reference5.md +0 -7
  167. package/docs/__old/types/Misc-Group/nspc.Reference6.md +0 -9
  168. package/docs/__old/types/Misc-Group/nspc.Reference7.md +0 -7
  169. package/docs/__old/types/Misc-Group/nspc.SampleClassWithoutModifier.md +0 -11
  170. package/docs/__old/types/Misc-Group/nspc.SampleRestResource.md +0 -104
  171. package/docs/__old/types/Misc-Group/nspc.SampleRestResourceWithInnerClass.md +0 -33
  172. package/docs/__old/types/Misc-Group/nspc.SampleRestResourceWithoutApexDocs.md +0 -14
  173. package/docs/__old/types/README.md +0 -97
  174. package/docs/__old/types/Sample-Interfaces/nspc.SampleInterface.md +0 -23
  175. package/examples/includes/header.md +0 -3
  176. package/examples/plain-markdown/docs/Miscellaneous/ns.SampleException.md +0 -7
  177. package/examples/plain-markdown/docs/Sample-Enums/ns.SampleEnum.md +0 -36
  178. package/examples/plain-markdown/docs/index.md +0 -36
  179. package/examples/plain-markdown/force-app/classes/SampleException.cls +0 -1
  180. package/examples/plain-markdown/template.md +0 -3
  181. package/lib/__spec__/core/expect-extensions.d.ts +0 -3
  182. package/lib/__spec__/core/expect-extensions.js +0 -54
  183. package/lib/__spec__/core/expect-extensions.js.map +0 -1
  184. package/lib/__spec__/core/generating-class-docs.spec.d.ts +0 -1
  185. package/lib/__spec__/core/generating-class-docs.spec.js +0 -427
  186. package/lib/__spec__/core/generating-class-docs.spec.js.map +0 -1
  187. package/lib/__spec__/core/generating-enum-docs.spec.d.ts +0 -1
  188. package/lib/__spec__/core/generating-enum-docs.spec.js +0 -303
  189. package/lib/__spec__/core/generating-enum-docs.spec.js.map +0 -1
  190. package/lib/__spec__/core/generating-interface-docs.spec.d.ts +0 -1
  191. package/lib/__spec__/core/generating-interface-docs.spec.js +0 -361
  192. package/lib/__spec__/core/generating-interface-docs.spec.js.map +0 -1
  193. package/lib/__spec__/core/generating-reference-guide.spec.d.ts +0 -1
  194. package/lib/__spec__/core/generating-reference-guide.spec.js +0 -161
  195. package/lib/__spec__/core/generating-reference-guide.spec.js.map +0 -1
  196. package/lib/adapters/apex-types.d.ts +0 -7
  197. package/lib/adapters/apex-types.js +0 -112
  198. package/lib/adapters/apex-types.js.map +0 -1
  199. package/lib/adapters/documentables.d.ts +0 -7
  200. package/lib/adapters/documentables.js +0 -56
  201. package/lib/adapters/documentables.js.map +0 -1
  202. package/lib/adapters/fields-and-properties.d.ts +0 -4
  203. package/lib/adapters/fields-and-properties.js +0 -32
  204. package/lib/adapters/fields-and-properties.js.map +0 -1
  205. package/lib/adapters/methods-and-constructors.d.ts +0 -5
  206. package/lib/adapters/methods-and-constructors.js +0 -92
  207. package/lib/adapters/methods-and-constructors.js.map +0 -1
  208. package/lib/adapters/references.d.ts +0 -5
  209. package/lib/adapters/references.js +0 -82
  210. package/lib/adapters/references.js.map +0 -1
  211. package/lib/adapters/type-utils.d.ts +0 -2
  212. package/lib/adapters/type-utils.js +0 -7
  213. package/lib/adapters/type-utils.js.map +0 -1
  214. package/lib/application/Apexdocs.d.ts +0 -13
  215. package/lib/application/Apexdocs.js +0 -80
  216. package/lib/application/Apexdocs.js.map +0 -1
  217. package/lib/cli/generate.d.ts +0 -2
  218. package/lib/cli/generate.js +0 -157
  219. package/lib/cli/generate.js.map +0 -1
  220. package/lib/core/generate-docs.d.ts +0 -23
  221. package/lib/core/generate-docs.js +0 -241
  222. package/lib/core/generate-docs.js.map +0 -1
  223. package/lib/core/template.d.ts +0 -10
  224. package/lib/core/template.js +0 -92
  225. package/lib/core/template.js.map +0 -1
  226. package/lib/core/templates/reference-guide.d.ts +0 -1
  227. package/lib/core/templates/reference-guide.js +0 -18
  228. package/lib/core/templates/reference-guide.js.map +0 -1
  229. package/lib/index.d.ts +0 -2
  230. package/lib/index.js +0 -29
  231. package/lib/index.js.map +0 -1
  232. package/lib/model/apex-bundle.d.ts +0 -6
  233. package/lib/model/apex-bundle.js +0 -11
  234. package/lib/model/apex-bundle.js.map +0 -1
  235. package/lib/model/apex-type-wrappers/ClassMirrorWrapper.d.ts +0 -7
  236. package/lib/model/apex-type-wrappers/ClassMirrorWrapper.js +0 -14
  237. package/lib/model/apex-type-wrappers/ClassMirrorWrapper.js.map +0 -1
  238. package/lib/model/apex-type-wrappers/MethodMirrorWrapper.d.ts +0 -7
  239. package/lib/model/apex-type-wrappers/MethodMirrorWrapper.js +0 -12
  240. package/lib/model/apex-type-wrappers/MethodMirrorWrapper.js.map +0 -1
  241. package/lib/model/inheritance.d.ts +0 -8
  242. package/lib/model/inheritance.js +0 -3
  243. package/lib/model/inheritance.js.map +0 -1
  244. package/lib/model/manifest.d.ts +0 -22
  245. package/lib/model/manifest.js +0 -53
  246. package/lib/model/manifest.js.map +0 -1
  247. package/lib/model/markdown-file.d.ts +0 -16
  248. package/lib/model/markdown-file.js +0 -111
  249. package/lib/model/markdown-file.js.map +0 -1
  250. package/lib/model/markdown-generation-util/doc-comment-annotation-util.d.ts +0 -8
  251. package/lib/model/markdown-generation-util/doc-comment-annotation-util.js +0 -46
  252. package/lib/model/markdown-generation-util/doc-comment-annotation-util.js.map +0 -1
  253. package/lib/model/markdown-generation-util/field-declaration-util.d.ts +0 -3
  254. package/lib/model/markdown-generation-util/field-declaration-util.js +0 -54
  255. package/lib/model/markdown-generation-util/field-declaration-util.js.map +0 -1
  256. package/lib/model/markdown-generation-util/index.d.ts +0 -3
  257. package/lib/model/markdown-generation-util/index.js +0 -20
  258. package/lib/model/markdown-generation-util/index.js.map +0 -1
  259. package/lib/model/markdown-generation-util/method-declaration-util.d.ts +0 -4
  260. package/lib/model/markdown-generation-util/method-declaration-util.js +0 -114
  261. package/lib/model/markdown-generation-util/method-declaration-util.js.map +0 -1
  262. package/lib/model/markdown-generation-util/type-declaration-util.d.ts +0 -3
  263. package/lib/model/markdown-generation-util/type-declaration-util.js +0 -81
  264. package/lib/model/markdown-generation-util/type-declaration-util.js.map +0 -1
  265. package/lib/model/markdown-home-file.d.ts +0 -11
  266. package/lib/model/markdown-home-file.js +0 -57
  267. package/lib/model/markdown-home-file.js.map +0 -1
  268. package/lib/model/markdown-type-file.d.ts +0 -26
  269. package/lib/model/markdown-type-file.js +0 -137
  270. package/lib/model/markdown-type-file.js.map +0 -1
  271. package/lib/model/openapi/apex-doc-types.d.ts +0 -19
  272. package/lib/model/openapi/apex-doc-types.js +0 -5
  273. package/lib/model/openapi/apex-doc-types.js.map +0 -1
  274. package/lib/model/openapi/open-api-types.d.ts +0 -93
  275. package/lib/model/openapi/open-api-types.js +0 -3
  276. package/lib/model/openapi/open-api-types.js.map +0 -1
  277. package/lib/model/openapi/open-api.d.ts +0 -16
  278. package/lib/model/openapi/open-api.js +0 -34
  279. package/lib/model/openapi/open-api.js.map +0 -1
  280. package/lib/model/openapi/openapi-type-file.d.ts +0 -7
  281. package/lib/model/openapi/openapi-type-file.js +0 -17
  282. package/lib/model/openapi/openapi-type-file.js.map +0 -1
  283. package/lib/model/outputFile.d.ts +0 -10
  284. package/lib/model/outputFile.js +0 -22
  285. package/lib/model/outputFile.js.map +0 -1
  286. package/lib/model/types-repository.d.ts +0 -16
  287. package/lib/model/types-repository.js +0 -54
  288. package/lib/model/types-repository.js.map +0 -1
  289. package/lib/service/apex-file-reader.d.ts +0 -14
  290. package/lib/service/apex-file-reader.js +0 -49
  291. package/lib/service/apex-file-reader.js.map +0 -1
  292. package/lib/service/file-system.d.ts +0 -14
  293. package/lib/service/file-system.js +0 -48
  294. package/lib/service/file-system.js.map +0 -1
  295. package/lib/service/file-writer.d.ts +0 -6
  296. package/lib/service/file-writer.js +0 -57
  297. package/lib/service/file-writer.js.map +0 -1
  298. package/lib/service/manifest-factory.d.ts +0 -10
  299. package/lib/service/manifest-factory.js +0 -16
  300. package/lib/service/manifest-factory.js.map +0 -1
  301. package/lib/service/metadata-processor.d.ts +0 -3
  302. package/lib/service/metadata-processor.js +0 -17
  303. package/lib/service/metadata-processor.js.map +0 -1
  304. package/lib/service/parser.d.ts +0 -21
  305. package/lib/service/parser.js +0 -138
  306. package/lib/service/parser.js.map +0 -1
  307. package/lib/service/state.d.ts +0 -9
  308. package/lib/service/state.js +0 -20
  309. package/lib/service/state.js.map +0 -1
  310. package/lib/service/walkers/class-walker.d.ts +0 -4
  311. package/lib/service/walkers/class-walker.js +0 -33
  312. package/lib/service/walkers/class-walker.js.map +0 -1
  313. package/lib/service/walkers/enum-walker.d.ts +0 -4
  314. package/lib/service/walkers/enum-walker.js +0 -11
  315. package/lib/service/walkers/enum-walker.js.map +0 -1
  316. package/lib/service/walkers/interface-walker.d.ts +0 -4
  317. package/lib/service/walkers/interface-walker.js +0 -15
  318. package/lib/service/walkers/interface-walker.js.map +0 -1
  319. package/lib/service/walkers/walker-factory.d.ts +0 -5
  320. package/lib/service/walkers/walker-factory.js +0 -21
  321. package/lib/service/walkers/walker-factory.js.map +0 -1
  322. package/lib/service/walkers/walker.d.ts +0 -19
  323. package/lib/service/walkers/walker.js +0 -17
  324. package/lib/service/walkers/walker.js.map +0 -1
  325. package/lib/settings.d.ts +0 -64
  326. package/lib/settings.js +0 -89
  327. package/lib/settings.js.map +0 -1
  328. package/lib/test-helpers/AnnotationBuilder.d.ts +0 -12
  329. package/lib/test-helpers/AnnotationBuilder.js +0 -31
  330. package/lib/test-helpers/AnnotationBuilder.js.map +0 -1
  331. package/lib/test-helpers/ClassMirrorBuilder.d.ts +0 -18
  332. package/lib/test-helpers/ClassMirrorBuilder.js +0 -54
  333. package/lib/test-helpers/ClassMirrorBuilder.js.map +0 -1
  334. package/lib/test-helpers/DocCommentAnnotationBuilder.d.ts +0 -8
  335. package/lib/test-helpers/DocCommentAnnotationBuilder.js +0 -26
  336. package/lib/test-helpers/DocCommentAnnotationBuilder.js.map +0 -1
  337. package/lib/test-helpers/DocCommentBuilder.d.ts +0 -12
  338. package/lib/test-helpers/DocCommentBuilder.js +0 -38
  339. package/lib/test-helpers/DocCommentBuilder.js.map +0 -1
  340. package/lib/test-helpers/FieldMirrorBuilder.d.ts +0 -18
  341. package/lib/test-helpers/FieldMirrorBuilder.js +0 -54
  342. package/lib/test-helpers/FieldMirrorBuilder.js.map +0 -1
  343. package/lib/test-helpers/InterfaceMirrorBuilder.d.ts +0 -16
  344. package/lib/test-helpers/InterfaceMirrorBuilder.js +0 -43
  345. package/lib/test-helpers/InterfaceMirrorBuilder.js.map +0 -1
  346. package/lib/test-helpers/MethodMirrorBuilder.d.ts +0 -29
  347. package/lib/test-helpers/MethodMirrorBuilder.js +0 -72
  348. package/lib/test-helpers/MethodMirrorBuilder.js.map +0 -1
  349. package/lib/test-helpers/SettingsBuilder.d.ts +0 -8
  350. package/lib/test-helpers/SettingsBuilder.js +0 -27
  351. package/lib/test-helpers/SettingsBuilder.js.map +0 -1
  352. package/lib/transpiler/factory.d.ts +0 -6
  353. package/lib/transpiler/factory.js +0 -35
  354. package/lib/transpiler/factory.js.map +0 -1
  355. package/lib/transpiler/file-container.d.ts +0 -6
  356. package/lib/transpiler/file-container.js +0 -16
  357. package/lib/transpiler/file-container.js.map +0 -1
  358. package/lib/transpiler/generator-choices.d.ts +0 -1
  359. package/lib/transpiler/generator-choices.js +0 -3
  360. package/lib/transpiler/generator-choices.js.map +0 -1
  361. package/lib/transpiler/markdown/class-file-generatorHelper.d.ts +0 -11
  362. package/lib/transpiler/markdown/class-file-generatorHelper.js +0 -75
  363. package/lib/transpiler/markdown/class-file-generatorHelper.js.map +0 -1
  364. package/lib/transpiler/markdown/docsify/docsify-docs-processor.d.ts +0 -6
  365. package/lib/transpiler/markdown/docsify/docsify-docs-processor.js +0 -13
  366. package/lib/transpiler/markdown/docsify/docsify-docs-processor.js.map +0 -1
  367. package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.d.ts +0 -11
  368. package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.js +0 -51
  369. package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.js.map +0 -1
  370. package/lib/transpiler/markdown/markdown-transpiler-base.d.ts +0 -11
  371. package/lib/transpiler/markdown/markdown-transpiler-base.js +0 -27
  372. package/lib/transpiler/markdown/markdown-transpiler-base.js.map +0 -1
  373. package/lib/transpiler/markdown/plain-markdown/class-template.d.ts +0 -1
  374. package/lib/transpiler/markdown/plain-markdown/class-template.js +0 -77
  375. package/lib/transpiler/markdown/plain-markdown/class-template.js.map +0 -1
  376. package/lib/transpiler/markdown/plain-markdown/constructors-partial-template.d.ts +0 -1
  377. package/lib/transpiler/markdown/plain-markdown/constructors-partial-template.js +0 -36
  378. package/lib/transpiler/markdown/plain-markdown/constructors-partial-template.js.map +0 -1
  379. package/lib/transpiler/markdown/plain-markdown/documentable-partial-template.d.ts +0 -1
  380. package/lib/transpiler/markdown/plain-markdown/documentable-partial-template.js +0 -28
  381. package/lib/transpiler/markdown/plain-markdown/documentable-partial-template.js.map +0 -1
  382. package/lib/transpiler/markdown/plain-markdown/enum-template.d.ts +0 -1
  383. package/lib/transpiler/markdown/plain-markdown/enum-template.js +0 -16
  384. package/lib/transpiler/markdown/plain-markdown/enum-template.js.map +0 -1
  385. package/lib/transpiler/markdown/plain-markdown/fieldsPartialTemplate.d.ts +0 -1
  386. package/lib/transpiler/markdown/plain-markdown/fieldsPartialTemplate.js +0 -27
  387. package/lib/transpiler/markdown/plain-markdown/fieldsPartialTemplate.js.map +0 -1
  388. package/lib/transpiler/markdown/plain-markdown/grouped-members-partial-template.d.ts +0 -1
  389. package/lib/transpiler/markdown/plain-markdown/grouped-members-partial-template.js +0 -10
  390. package/lib/transpiler/markdown/plain-markdown/grouped-members-partial-template.js.map +0 -1
  391. package/lib/transpiler/markdown/plain-markdown/interface-template.d.ts +0 -1
  392. package/lib/transpiler/markdown/plain-markdown/interface-template.js +0 -20
  393. package/lib/transpiler/markdown/plain-markdown/interface-template.js.map +0 -1
  394. package/lib/transpiler/markdown/plain-markdown/methods-partial-template.d.ts +0 -1
  395. package/lib/transpiler/markdown/plain-markdown/methods-partial-template.js +0 -47
  396. package/lib/transpiler/markdown/plain-markdown/methods-partial-template.js.map +0 -1
  397. package/lib/transpiler/markdown/plain-markdown/plain-docsProcessor.d.ts +0 -9
  398. package/lib/transpiler/markdown/plain-markdown/plain-docsProcessor.js +0 -42
  399. package/lib/transpiler/markdown/plain-markdown/plain-docsProcessor.js.map +0 -1
  400. package/lib/transpiler/markdown/plain-markdown/type-doc-partial.d.ts +0 -1
  401. package/lib/transpiler/markdown/plain-markdown/type-doc-partial.js +0 -31
  402. package/lib/transpiler/markdown/plain-markdown/type-doc-partial.js.map +0 -1
  403. package/lib/transpiler/openapi/open-api-docs-processor.d.ts +0 -13
  404. package/lib/transpiler/openapi/open-api-docs-processor.js +0 -78
  405. package/lib/transpiler/openapi/open-api-docs-processor.js.map +0 -1
  406. package/lib/transpiler/openapi/parsers/Builder.d.ts +0 -16
  407. package/lib/transpiler/openapi/parsers/Builder.js +0 -30
  408. package/lib/transpiler/openapi/parsers/Builder.js.map +0 -1
  409. package/lib/transpiler/openapi/parsers/MethodParser.d.ts +0 -20
  410. package/lib/transpiler/openapi/parsers/MethodParser.js +0 -190
  411. package/lib/transpiler/openapi/parsers/MethodParser.js.map +0 -1
  412. package/lib/transpiler/openapi/parsers/ParameterObjectBuilder.d.ts +0 -7
  413. package/lib/transpiler/openapi/parsers/ParameterObjectBuilder.js +0 -11
  414. package/lib/transpiler/openapi/parsers/ParameterObjectBuilder.js.map +0 -1
  415. package/lib/transpiler/openapi/parsers/ReferenceBuilder.d.ts +0 -39
  416. package/lib/transpiler/openapi/parsers/ReferenceBuilder.js +0 -250
  417. package/lib/transpiler/openapi/parsers/ReferenceBuilder.js.map +0 -1
  418. package/lib/transpiler/openapi/parsers/RequestBodyBuilder.d.ts +0 -10
  419. package/lib/transpiler/openapi/parsers/RequestBodyBuilder.js +0 -20
  420. package/lib/transpiler/openapi/parsers/RequestBodyBuilder.js.map +0 -1
  421. package/lib/transpiler/openapi/parsers/ResponsesBuilder.d.ts +0 -7
  422. package/lib/transpiler/openapi/parsers/ResponsesBuilder.js +0 -22
  423. package/lib/transpiler/openapi/parsers/ResponsesBuilder.js.map +0 -1
  424. package/lib/transpiler/processor-type-transpiler.d.ts +0 -10
  425. package/lib/transpiler/processor-type-transpiler.js +0 -9
  426. package/lib/transpiler/processor-type-transpiler.js.map +0 -1
  427. package/lib/transpiler/transpiler.d.ts +0 -5
  428. package/lib/transpiler/transpiler.js +0 -30
  429. package/lib/transpiler/transpiler.js.map +0 -1
  430. package/lib/util/error-logger.d.ts +0 -8
  431. package/lib/util/error-logger.js +0 -90
  432. package/lib/util/error-logger.js.map +0 -1
  433. package/lib/util/logger.d.ts +0 -21
  434. package/lib/util/logger.js +0 -61
  435. package/lib/util/logger.js.map +0 -1
  436. package/lib/util/string-utils.d.ts +0 -2
  437. package/lib/util/string-utils.js +0 -15
  438. package/lib/util/string-utils.js.map +0 -1
  439. package/src/__spec__/core/generating-class-docs.spec.ts +0 -511
  440. package/src/adapters/__tests__/interface-adapter.spec.ts +0 -80
  441. package/src/adapters/type-utils.ts +0 -5
  442. package/src/adapters/types.d.ts +0 -8
  443. package/src/core/generate-docs.ts +0 -357
  444. package/src/model/apex-bundle.ts +0 -3
  445. package/src/model/inheritance.ts +0 -7
  446. package/src/model/manifest.ts +0 -84
  447. package/src/model/markdown-file.ts +0 -122
  448. package/src/model/markdown-generation-util/doc-comment-annotation-util.ts +0 -50
  449. package/src/model/markdown-generation-util/field-declaration-util.ts +0 -71
  450. package/src/model/markdown-generation-util/index.ts +0 -3
  451. package/src/model/markdown-generation-util/method-declaration-util.ts +0 -166
  452. package/src/model/markdown-generation-util/type-declaration-util.ts +0 -91
  453. package/src/model/markdown-home-file.ts +0 -58
  454. package/src/model/markdown-type-file.ts +0 -165
  455. package/src/model/openapi/openapi-type-file.ts +0 -14
  456. package/src/model/outputFile.ts +0 -20
  457. package/src/service/__tests__/apex-file-reader.spec.ts +0 -92
  458. package/src/service/apex-file-reader.ts +0 -51
  459. package/src/service/file-writer.ts +0 -34
  460. package/src/service/metadata-processor.ts +0 -16
  461. package/src/service/state.ts +0 -24
  462. package/src/service/walkers/class-walker.ts +0 -30
  463. package/src/service/walkers/enum-walker.ts +0 -7
  464. package/src/service/walkers/interface-walker.ts +0 -12
  465. package/src/service/walkers/walker-factory.ts +0 -19
  466. package/src/service/walkers/walker.ts +0 -42
  467. package/src/settings.ts +0 -147
  468. package/src/transpiler/factory.ts +0 -33
  469. package/src/transpiler/file-container.ts +0 -13
  470. package/src/transpiler/generator-choices.ts +0 -1
  471. package/src/transpiler/markdown/class-file-generatorHelper.ts +0 -78
  472. package/src/transpiler/markdown/docsify/docsify-docs-processor.ts +0 -12
  473. package/src/transpiler/markdown/jekyll/jekyll-docsProcessor.ts +0 -50
  474. package/src/transpiler/markdown/markdown-transpiler-base.ts +0 -28
  475. package/src/transpiler/markdown/plain-markdown/plain-docsProcessor.ts +0 -42
  476. package/src/transpiler/processor-type-transpiler.ts +0 -18
  477. /package/examples/{plain-markdown → markdown}/.forceignore +0 -0
  478. /package/examples/{plain-markdown → markdown}/config/project-scratch-def.json +0 -0
  479. /package/examples/{plain-markdown → markdown}/force-app/classes/BaseClass.cls +0 -0
  480. /package/examples/{plain-markdown → markdown}/force-app/classes/ParentInterface.cls +0 -0
  481. /package/examples/{plain-markdown → markdown}/force-app/classes/ReferencedEnum.cls +0 -0
  482. /package/examples/{plain-markdown → markdown}/force-app/classes/SampleClass.cls +0 -0
  483. /package/examples/{plain-markdown → markdown}/force-app/classes/SampleEnum.cls +0 -0
  484. /package/examples/{plain-markdown → markdown}/force-app/classes/SampleInterface.cls +0 -0
  485. /package/examples/{plain-markdown → markdown}/package-lock.json +0 -0
  486. /package/examples/{plain-markdown → markdown}/sfdx-project.json +0 -0
  487. /package/src/{service → application}/file-system.ts +0 -0
  488. /package/src/{model/__tests__ → core/__test__}/manifest.spec.ts +0 -0
  489. /package/src/{transpiler/markdown/plain-markdown → core/markdown/templates}/enum-template.ts +0 -0
  490. /package/src/{transpiler/markdown/plain-markdown → core/markdown/templates}/grouped-members-partial-template.ts +0 -0
  491. /package/src/{transpiler/markdown/plain-markdown → core/markdown/templates}/interface-template.ts +0 -0
  492. /package/src/{transpiler/markdown/plain-markdown → core/markdown/templates}/type-doc-partial.ts +0 -0
  493. /package/src/{service → core/openapi}/__tests__/manifest-factory.spec.ts +0 -0
  494. /package/src/{model → core}/openapi/__tests__/open-api.spec.ts +0 -0
  495. /package/src/{model → core}/openapi/apex-doc-types.ts +0 -0
  496. /package/src/{model → core/openapi}/apex-type-wrappers/ClassMirrorWrapper.ts +0 -0
  497. /package/src/{model → core/openapi}/apex-type-wrappers/MethodMirrorWrapper.ts +0 -0
  498. /package/src/{model → core}/openapi/open-api-types.ts +0 -0
  499. /package/src/{model → core}/openapi/open-api.ts +0 -0
@@ -1,357 +0,0 @@
1
- import { ClassMirror, InterfaceMirror, reflect as mirrorReflection, Type } from '@cparra/apex-reflection';
2
- import { typeToRenderableType } from '../adapters/apex-types';
3
- import { Renderable, RenderableContent, RenderableEnum, StringOrLink } from './renderable/types';
4
- import { classMarkdownTemplate } from '../transpiler/markdown/plain-markdown/class-template';
5
- import { enumMarkdownTemplate } from '../transpiler/markdown/plain-markdown/enum-template';
6
- import { interfaceMarkdownTemplate } from '../transpiler/markdown/plain-markdown/interface-template';
7
- import * as E from 'fp-ts/Either';
8
- import { flow, pipe } from 'fp-ts/function';
9
- import { CompilationRequest, Template } from './template';
10
- import Manifest from '../model/manifest';
11
- import { referenceGuideTemplate } from './templates/reference-guide';
12
- import { adaptDescribable } from '../adapters/documentables';
13
-
14
- export const documentType = flow(typeToRenderableType, resolveApexTypeTemplate, compile);
15
-
16
- export type DocumentationBundle = {
17
- format: 'markdown';
18
- referenceGuide: string; // Output file with links to all other files (e.g. index/table of contents)
19
- docs: DocOutput[];
20
- };
21
-
22
- type DocumentationConfig = {
23
- scope: string[];
24
- outputDir: string;
25
- namespace?: string;
26
- sortMembersAlphabetically?: boolean;
27
- defaultGroupName: string;
28
- referenceGuideTemplate: string;
29
- };
30
-
31
- type DocOutput = {
32
- docContents: string;
33
- typeName: string;
34
- type: 'class' | 'interface' | 'enum';
35
- };
36
-
37
- const configDefaults: DocumentationConfig = {
38
- scope: ['public'],
39
- outputDir: 'docs',
40
- defaultGroupName: 'Miscellaneous',
41
- referenceGuideTemplate: referenceGuideTemplate,
42
- };
43
-
44
- export function generateDocs(
45
- input: string[],
46
- config?: Partial<DocumentationConfig>,
47
- ): E.Either<string[], DocumentationBundle> {
48
- const configWithDefaults = { ...configDefaults, ...config };
49
- return pipe(
50
- input,
51
- (input) => input.map(reflectSourceBody),
52
- checkForReflectionErrors,
53
- E.map((types) => types.map((type) => addInheritedMembers(type, types))),
54
- E.map((types) => filterTypesOutOfScope(types, configWithDefaults.scope)),
55
- E.map((types) => typesToRenderableBundle(types, configWithDefaults)),
56
- E.map(({ references, renderables }) => ({
57
- referenceGuide: pipe(referencesToReferenceGuide(references, configWithDefaults.referenceGuideTemplate)),
58
- docs: renderables.map(renderableToOutputDoc),
59
- })),
60
- E.map(({ referenceGuide, docs }) => ({ format: 'markdown', referenceGuide: referenceGuide, docs })),
61
- );
62
- }
63
-
64
- type ReferenceGuideReference = {
65
- title: StringOrLink;
66
- description: RenderableContent[] | undefined;
67
- };
68
-
69
- type RenderableBundle = {
70
- // References are grouped by their defined @group annotation
71
- references: {
72
- [key: string]: ReferenceGuideReference[];
73
- };
74
- renderables: Renderable[];
75
- };
76
-
77
- function typesToRenderableBundle(types: Type[], config: DocumentationConfig) {
78
- return types.reduce<RenderableBundle>(
79
- (acc, type) => {
80
- const renderable = typeToRenderableType(
81
- type,
82
- (referenceName) => {
83
- return linkFromTypeNameGenerator(type, types, referenceName, config);
84
- },
85
- config.namespace,
86
- );
87
- acc.renderables.push(renderable);
88
-
89
- const descriptionLines = type.docComment?.descriptionLines;
90
- const reference = {
91
- title: getLinkFromRoot(config, type),
92
- description: adaptDescribable(descriptionLines, (referenceName) => {
93
- const type = findType(types, referenceName);
94
- return type ? getLinkFromRoot(config, type) : referenceName;
95
- }).description,
96
- };
97
-
98
- const group = getTypeGroup(type, config);
99
- if (!acc.references[group]) {
100
- acc.references[group] = [];
101
- }
102
- acc.references[group].push(reference);
103
-
104
- return acc;
105
- },
106
- {
107
- references: {},
108
- renderables: [],
109
- },
110
- );
111
- }
112
-
113
- function renderableToOutputDoc(renderable: Renderable): DocOutput {
114
- function buildDocOutput(renderable: Renderable, docContents: string): DocOutput {
115
- return {
116
- docContents,
117
- typeName: renderable.name,
118
- type: renderable.type,
119
- };
120
- }
121
-
122
- return pipe(renderable, resolveApexTypeTemplate, compile, (docContents) => buildDocOutput(renderable, docContents));
123
- }
124
-
125
- function referencesToReferenceGuide(
126
- references: { [key: string]: ReferenceGuideReference[] },
127
- template: string,
128
- ): string {
129
- function alphabetizeReferences(references: { [key: string]: ReferenceGuideReference[] }): {
130
- [key: string]: ReferenceGuideReference[];
131
- } {
132
- return Object.keys(references)
133
- .sort((a, b) => a.localeCompare(b))
134
- .reduce<{ [key: string]: ReferenceGuideReference[] }>((acc, key) => {
135
- acc[key] = references[key].sort((a, b) => a.title.toString().localeCompare(b.title.toString()));
136
- return acc;
137
- }, {});
138
- }
139
-
140
- return pipe(references, alphabetizeReferences, (references) =>
141
- compile({
142
- template: template,
143
- source: references,
144
- }),
145
- );
146
- }
147
-
148
- function filterTypesOutOfScope(types: Type[], scope: string[]): Type[] {
149
- return new Manifest(types).filteredByAccessModifierAndAnnotations(scope);
150
- }
151
-
152
- function checkForReflectionErrors(reflectionResult: E.Either<string, Type>[]) {
153
- function reduceReflectionResultIntoSingleEither(results: E.Either<string, Type>[]): {
154
- errors: string[];
155
- types: Type[];
156
- } {
157
- return results.reduce<{ errors: string[]; types: Type[] }>(
158
- (acc, result) => {
159
- E.isLeft(result) ? acc.errors.push(result.left) : acc.types.push(result.right);
160
- return acc;
161
- },
162
- {
163
- errors: [],
164
- types: [],
165
- },
166
- );
167
- }
168
-
169
- return pipe(reflectionResult, reduceReflectionResultIntoSingleEither, ({ errors, types }) =>
170
- errors.length ? E.left(errors) : E.right(types),
171
- );
172
- }
173
-
174
- function reflectSourceBody(input: string): E.Either<string, Type> {
175
- const result = mirrorReflection(input);
176
- // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
177
- return result.error ? E.left(result.error.message) : E.right(result.typeMirror!);
178
- }
179
-
180
- function resolveApexTypeTemplate(renderable: Renderable): CompilationRequest {
181
- function getTemplate(renderable: Renderable): string {
182
- switch (renderable.type) {
183
- case 'enum':
184
- return enumMarkdownTemplate;
185
- case 'interface':
186
- return interfaceMarkdownTemplate;
187
- case 'class':
188
- return classMarkdownTemplate;
189
- }
190
- }
191
-
192
- return {
193
- template: getTemplate(renderable),
194
- source: renderable as RenderableEnum,
195
- };
196
- }
197
-
198
- function compile(request: CompilationRequest): string {
199
- return Template.getInstance().compile(request);
200
- }
201
-
202
- function findType(repository: Type[], referenceName: string) {
203
- return repository.find((currentType: Type) => currentType.name.toLowerCase() === referenceName.toLowerCase());
204
- }
205
-
206
- function addInheritedMembers<T extends Type>(current: T, repository: Type[]): T {
207
- if (current.type_name === 'enum') {
208
- return current;
209
- } else if (current.type_name === 'interface') {
210
- return addInheritedInterfaceMethods(current as InterfaceMirror, repository) as T;
211
- } else {
212
- return addInheritedClassMembers(current as ClassMirror, repository) as T;
213
- }
214
- }
215
-
216
- function getParents<T extends Type>(
217
- extendedNamesExtractor: (current: T) => string[],
218
- current: T,
219
- repository: Type[],
220
- ): T[] {
221
- return pipe(
222
- extendedNamesExtractor(current),
223
- (interfaces: string[]) => interfaces.map((interfaceName) => repository.find((type) => type.name === interfaceName)),
224
- (interfaces = []) => interfaces.filter((type) => type !== undefined) as T[],
225
- (interfaces) =>
226
- interfaces.reduce<T[]>(
227
- (acc, current) => [...acc, ...getParents(extendedNamesExtractor, current, repository)],
228
- interfaces,
229
- ),
230
- );
231
- }
232
-
233
- function addInheritedInterfaceMethods(interfaceMirror: InterfaceMirror, repository: Type[]): InterfaceMirror {
234
- function methodAlreadyExists(memberName: string, members: { name: string }[]) {
235
- return members.some((member) => member.name.toLowerCase() === memberName.toLowerCase());
236
- }
237
-
238
- function parentExtractor(interfaceMirror: InterfaceMirror): string[] {
239
- return interfaceMirror.extended_interfaces;
240
- }
241
-
242
- const parents = getParents(parentExtractor, interfaceMirror, repository);
243
- return {
244
- ...interfaceMirror,
245
- methods: parents.reduce(
246
- (acc, currentValue) => [
247
- ...acc,
248
- ...currentValue.methods
249
- .filter((method) => !methodAlreadyExists(method.name, acc))
250
- .map((method) => ({
251
- ...method,
252
- inherited: true,
253
- })),
254
- ],
255
- interfaceMirror.methods,
256
- ),
257
- };
258
- }
259
-
260
- function addInheritedClassMembers(classMirror: ClassMirror, repository: Type[]): ClassMirror {
261
- function memberAlreadyExists(memberName: string, members: { name: string }[]) {
262
- return members.some((member) => member.name.toLowerCase() === memberName.toLowerCase());
263
- }
264
-
265
- function parentExtractor(classMirror: ClassMirror): string[] {
266
- return classMirror.extended_class ? [classMirror.extended_class] : [];
267
- }
268
-
269
- function filterMember<T extends { name: string; access_modifier: string }>(members: T[], existing: T[]): T[] {
270
- return members
271
- .filter((member) => member.access_modifier.toLowerCase() !== 'private')
272
- .filter((member) => !memberAlreadyExists(member.name, existing))
273
- .map((member) => ({
274
- ...member,
275
- inherited: true,
276
- }));
277
- }
278
-
279
- const parents = getParents(parentExtractor, classMirror, repository);
280
- return {
281
- ...classMirror,
282
- fields: parents.reduce(
283
- (acc, currentValue) => [...acc, ...filterMember(currentValue.fields, acc)],
284
- classMirror.fields,
285
- ),
286
- properties: parents.reduce(
287
- (acc, currentValue) => [...acc, ...filterMember(currentValue.properties, acc)],
288
- classMirror.properties,
289
- ),
290
- methods: parents.reduce(
291
- (acc, currentValue) => [...acc, ...filterMember(currentValue.methods, acc)],
292
- classMirror.methods,
293
- ),
294
- };
295
- }
296
-
297
- function linkFromTypeNameGenerator(
298
- typeBeingDocumented: Type,
299
- repository: Type[],
300
- referenceName: string,
301
- config: DocumentationConfig,
302
- ): StringOrLink {
303
- const type = findType(repository, referenceName);
304
- if (!type) {
305
- // If the type is not found, we return the type name as a string.
306
- return referenceName;
307
- }
308
-
309
- const [fullClassName, fileLink] = getFileLinkTuple(typeBeingDocumented, type, config);
310
- return {
311
- title: fullClassName,
312
- url: fileLink,
313
- };
314
- }
315
-
316
- function getFileLinkTuple(
317
- typeBeingDocumented: Type,
318
- referencedType: Type,
319
- config: DocumentationConfig,
320
- ): [string, string] {
321
- const namespacePrefix = config.namespace ? `${config.namespace}.` : '';
322
- const directoryRoot = `${getDirectoryRoot(typeBeingDocumented, referencedType, config)}`;
323
- // TODO: Instead of adding a "." to the name when there is a namespace, maybe we want to create a folder for everything
324
- // within that namespace and put the files in there.
325
- const fullClassName = `${namespacePrefix}${referencedType.name}`;
326
- return [fullClassName, `${directoryRoot}${fullClassName}.md`];
327
- }
328
-
329
- function getLinkFromRoot(config: DocumentationConfig, type?: Type): StringOrLink {
330
- if (!type) {
331
- return '';
332
- }
333
- const namespacePrefix = config.namespace ? `${config.namespace}./` : '';
334
- return {
335
- title: `${namespacePrefix}${type.name}`,
336
- url: `./${namespacePrefix}${getSanitizedGroup(type, config)}/${type.name}.md`,
337
- };
338
- }
339
-
340
- function getDirectoryRoot(typeBeingDocumented: Type, referencedType: Type, config: DocumentationConfig) {
341
- if (getTypeGroup(typeBeingDocumented, config) === getTypeGroup(referencedType, config)) {
342
- // If the types the same groups then we simply link directly to that file
343
- return './';
344
- } else {
345
- // If the types have different groups, then we have to go up a directory
346
- return `../${getSanitizedGroup(referencedType, config)}/`;
347
- }
348
- }
349
-
350
- function getTypeGroup(type: Type, config: DocumentationConfig): string {
351
- const groupAnnotation = type.docComment?.annotations.find((annotation) => annotation.name.toLowerCase() === 'group');
352
- return groupAnnotation?.body ?? config.defaultGroupName;
353
- }
354
-
355
- function getSanitizedGroup(classModel: Type, config: DocumentationConfig) {
356
- return getTypeGroup(classModel, config).replace(/ /g, '-').replace('.', '');
357
- }
@@ -1,3 +0,0 @@
1
- export default class ApexBundle {
2
- constructor(public filePath: string, public rawTypeContent: string, public rawMetadataContent: string | null) {}
3
- }
@@ -1,7 +0,0 @@
1
- import { FieldMirror, MethodMirror, PropertyMirror } from '@cparra/apex-reflection';
2
-
3
- export type InheritanceSupport = { inherited: boolean };
4
- export type FieldMirrorWithInheritance = FieldMirror & InheritanceSupport;
5
- export type PropertyMirrorWithInheritance = PropertyMirror & InheritanceSupport;
6
- export type MethodMirrorWithInheritance = MethodMirror & InheritanceSupport;
7
- export type FieldOrProperty = FieldMirrorWithInheritance | PropertyMirrorWithInheritance;
@@ -1,84 +0,0 @@
1
- import {
2
- ClassMirror,
3
- EnumMirror,
4
- InterfaceMirror,
5
- Type,
6
- Annotation,
7
- DocComment,
8
- DocCommentAnnotation,
9
- } from '@cparra/apex-reflection';
10
-
11
- type AccessAndDocAware = { access_modifier: string; annotations: Annotation[]; docComment?: DocComment };
12
-
13
- /**
14
- * Represents the full library of Apex top-level types (classes, enums, and interface) for a Salesforce project.
15
- */
16
- export default class Manifest {
17
- /**
18
- * Constructs a new Manifest object.
19
- * @param types List of types to be wrapped by this object.
20
- * @param isForInnerTypes Whether this manifest represent an inner type or not.
21
- */
22
- constructor(public types: Type[], public isForInnerTypes: boolean = false) {}
23
-
24
- filteredByAccessModifierAndAnnotations(modifiers: string[]): Type[] {
25
- const filteredTypes = this.filterAccessibleModifier(this.types, modifiers);
26
- const typesToReturn: Type[] = [];
27
- for (const filteredType of filteredTypes) {
28
- const currentType = filteredType as Type;
29
- if (currentType.type_name === 'enum') {
30
- // Ignoring enum values is not supported.
31
- typesToReturn.push(currentType);
32
- continue;
33
- }
34
-
35
- if (currentType.type_name === 'interface') {
36
- const currentInterface = currentType as InterfaceMirror;
37
- typesToReturn.push({
38
- ...currentType,
39
- methods: this.filterAccessibleModifier(currentInterface.methods, modifiers),
40
- } as InterfaceMirror);
41
- continue;
42
- }
43
-
44
- const currentClass = currentType as ClassMirror;
45
- let filteredClass = {
46
- ...currentType,
47
- methods: this.filterAccessibleModifier(currentClass.methods, modifiers),
48
- properties: this.filterAccessibleModifier(currentClass.properties, modifiers),
49
- fields: this.filterAccessibleModifier(currentClass.fields, modifiers),
50
- constructors: this.filterAccessibleModifier(currentClass.constructors, modifiers),
51
- } as ClassMirror;
52
-
53
- if (!this.isForInnerTypes) {
54
- filteredClass = {
55
- ...filteredClass,
56
- enums: this.filterAccessibleModifier(currentClass.enums, modifiers) as EnumMirror[],
57
- interfaces: this.filterAccessibleModifier(currentClass.interfaces, modifiers) as InterfaceMirror[],
58
- classes: new Manifest(currentClass.classes, true).filteredByAccessModifierAndAnnotations(
59
- modifiers,
60
- ) as ClassMirror[],
61
- };
62
- }
63
-
64
- typesToReturn.push(filteredClass);
65
- }
66
-
67
- return typesToReturn;
68
- }
69
-
70
- filterAccessibleModifier(accessAndDocAware: AccessAndDocAware[], modifiers: string[]) {
71
- return accessAndDocAware.filter((currentType) => {
72
- const hasIgnoreDocAnnotation = currentType.docComment?.annotations.some(
73
- (annotation: DocCommentAnnotation) => annotation.name.toLowerCase() === 'ignore',
74
- );
75
- if (hasIgnoreDocAnnotation) {
76
- return false;
77
- }
78
- return (
79
- modifiers.includes(currentType.access_modifier) ||
80
- currentType.annotations.some((annotation: Annotation) => modifiers.includes(annotation.type.toLowerCase()))
81
- );
82
- });
83
- }
84
- }
@@ -1,122 +0,0 @@
1
- import { OutputFile } from './outputFile';
2
- import ClassFileGeneratorHelper from '../transpiler/markdown/class-file-generatorHelper';
3
-
4
- export class MarkdownFile extends OutputFile {
5
- fileExtension(): string {
6
- return '.md';
7
- }
8
-
9
- addTitle(text: string, level = 1) {
10
- let title = '';
11
- for (let i = 0; i < level; i++) {
12
- title += '#';
13
- }
14
-
15
- title += ' ';
16
- title += text;
17
- this._contents += title;
18
- this.addBlankLine();
19
- }
20
-
21
- public addText(text: string) {
22
- //super.addText(this._replaceInlineReferences(text), encodeHtml);
23
- super.addText(text);
24
- }
25
-
26
- public addLink(text: string) {
27
- this.addText(`{@link ${text}}`);
28
- }
29
-
30
- startCodeBlock(language = 'apex') {
31
- this.addText(`\`\`\`${language}`);
32
- }
33
-
34
- endCodeBlock() {
35
- this.addText('```');
36
- this.addBlankLine();
37
- }
38
-
39
- addHorizontalRule() {
40
- this._contents += '---';
41
- this.addBlankLine();
42
- }
43
-
44
- initializeTable(...headers: string[]) {
45
- this.addBlankLine();
46
- this._contents += '|';
47
- headers.forEach((header) => {
48
- this._contents += header + '|';
49
- });
50
- this.addBlankLine();
51
- this._contents += '|';
52
- headers.forEach(() => {
53
- this._contents += '---' + '|';
54
- });
55
- this.addBlankLine();
56
- }
57
-
58
- addTableRow(...columns: string[]) {
59
- this._contents += '|';
60
- columns.forEach((column) => {
61
- this._contents += this._replaceInlineReferences(column) + '|';
62
- });
63
- this.addBlankLine();
64
- }
65
-
66
- addListItem(text: string) {
67
- this._contents += `* ${text}`;
68
- }
69
-
70
- protected static replaceInlineLinks(text: string) {
71
- // Parsing text to extract possible linking classes.
72
- const possibleLinks = text.match(/<<.*?>>/g);
73
- possibleLinks?.forEach((currentMatch) => {
74
- const classNameForMatch = currentMatch.replace('<<', '').replace('>>', '');
75
- text = text.replace(currentMatch, ClassFileGeneratorHelper.getFileLinkByTypeName(classNameForMatch));
76
- });
77
-
78
- // Parsing links using {@link ClassName} format
79
- const linkFormatRegEx = '{@link (.*?)}';
80
- const expression = new RegExp(linkFormatRegEx, 'gi');
81
- let match;
82
- const matches = [];
83
-
84
- do {
85
- match = expression.exec(text);
86
- if (match) {
87
- matches.push(match);
88
- }
89
- } while (match);
90
-
91
- for (const currentMatch of matches) {
92
- text = text.replace(currentMatch[0], ClassFileGeneratorHelper.getFileLinkByTypeName(currentMatch[1]));
93
- }
94
- return text;
95
- }
96
-
97
- protected static replaceInlineEmails(text: string) {
98
- // Parsing links using {@link ClassName} format
99
- const linkFormatRegEx = '{@email (.*?)}';
100
- const expression = new RegExp(linkFormatRegEx, 'gi');
101
- let match;
102
- const matches = [];
103
-
104
- do {
105
- match = expression.exec(text);
106
- if (match) {
107
- matches.push(match);
108
- }
109
- } while (match);
110
-
111
- for (const currentMatch of matches) {
112
- text = text.replace(currentMatch[0], `[${currentMatch[1]}](mailto:${currentMatch[1]})`);
113
- }
114
- return text;
115
- }
116
-
117
- private _replaceInlineReferences(text: string): string {
118
- text = MarkdownFile.replaceInlineLinks(text);
119
- text = MarkdownFile.replaceInlineEmails(text);
120
- return text;
121
- }
122
- }
@@ -1,50 +0,0 @@
1
- import { DocComment, DocCommentAnnotation } from '@cparra/apex-reflection';
2
- import ClassFileGeneratorHelper from '../../transpiler/markdown/class-file-generatorHelper';
3
- import { MarkdownFile } from '../markdown-file';
4
-
5
- interface DocCommentAware {
6
- docComment?: DocComment;
7
- }
8
-
9
- export function addMermaid(markdownFile: MarkdownFile, docCommentAware: DocCommentAware) {
10
- const mermaid = docCommentAware.docComment?.annotations.find((annotation) => annotation.name === 'mermaid');
11
- if (!mermaid) {
12
- return;
13
- }
14
-
15
- markdownFile.addBlankLine();
16
- markdownFile.startCodeBlock('mermaid');
17
- mermaid.bodyLines.forEach((line) => {
18
- markdownFile.addText(line);
19
- });
20
- markdownFile.endCodeBlock();
21
- markdownFile.addBlankLine();
22
- }
23
-
24
- export function addCustomDocCommentAnnotations(markdownFile: MarkdownFile, docCommentAware: DocCommentAware) {
25
- docCommentAware.docComment?.annotations
26
- .filter((currentAnnotation: DocCommentAnnotation) => currentAnnotation.name !== 'description')
27
- .filter((currentAnnotation: DocCommentAnnotation) => currentAnnotation.name !== 'mermaid')
28
- .forEach((currentAnnotation: DocCommentAnnotation) => {
29
- markdownFile.addBlankLine();
30
- markdownFile.addText(buildDocAnnotationText(currentAnnotation));
31
- markdownFile.addBlankLine();
32
- });
33
-
34
- function splitAndCapitalize(text: string) {
35
- const words = text.split(/[-_]+/);
36
- const capitalizedWords = [];
37
- for (const word of words) {
38
- capitalizedWords.push(word.charAt(0).toUpperCase() + word.slice(1));
39
- }
40
- return capitalizedWords.join(' ');
41
- }
42
-
43
- function buildDocAnnotationText(annotation: DocCommentAnnotation) {
44
- let annotationBodyText = annotation.body;
45
- if (annotation.name.toLowerCase() === 'see') {
46
- annotationBodyText = ClassFileGeneratorHelper.getFileLinkByTypeName(annotation.body);
47
- }
48
- return `**${splitAndCapitalize(annotation.name)}** ${annotationBodyText}`;
49
- }
50
- }
@@ -1,71 +0,0 @@
1
- import { MarkdownFile } from '../markdown-file';
2
- import { FieldMirrorWithInheritance, FieldOrProperty, PropertyMirrorWithInheritance } from '../inheritance';
3
-
4
- export function declareField(
5
- markdownFile: MarkdownFile,
6
- fields: FieldMirrorWithInheritance[] | PropertyMirrorWithInheritance[],
7
- startingHeadingLevel: number,
8
- grouped = false,
9
- ) {
10
- markdownFile.addBlankLine();
11
- fields.forEach((propertyModel) => {
12
- addFieldSection(markdownFile, propertyModel, startingHeadingLevel, grouped);
13
- });
14
-
15
- markdownFile.addHorizontalRule();
16
- }
17
-
18
- function addFieldSection(
19
- markdownFile: MarkdownFile,
20
- mirrorModel: FieldOrProperty,
21
- startingHeadingLevel: number,
22
- grouped: boolean,
23
- ) {
24
- if (!grouped) {
25
- markdownFile.addTitle(
26
- `\`${mirrorModel.access_modifier} ${mirrorModel.name}\` → \`${mirrorModel.typeReference.rawDeclaration}\``,
27
- startingHeadingLevel + 2,
28
- );
29
- markdownFile.addBlankLine();
30
- if (mirrorModel.inherited) {
31
- markdownFile.addText('*Inherited*');
32
- }
33
-
34
- mirrorModel.annotations.forEach((annotation) => {
35
- markdownFile.addText(`\`${annotation.type.toUpperCase()}\` `);
36
- });
37
-
38
- if (mirrorModel.docComment?.description) {
39
- markdownFile.addBlankLine();
40
- markdownFile.addText(mirrorModel.docComment.description);
41
- }
42
- markdownFile.addBlankLine();
43
- } else {
44
- let annotations = '';
45
- const hasAnnotations = !!mirrorModel.annotations.length;
46
- if (hasAnnotations) {
47
- annotations += ' [';
48
- }
49
- mirrorModel.annotations.forEach((annotation) => {
50
- annotations += `\`${annotation.type.toUpperCase()}\` `;
51
- });
52
- if (hasAnnotations) {
53
- annotations += ']';
54
- }
55
-
56
- // If grouped we want to display these as a list
57
- let description = '';
58
- if (mirrorModel.docComment?.description) {
59
- description = ` - ${mirrorModel.docComment?.description}`;
60
- }
61
-
62
- let listItemText = `\`${mirrorModel.access_modifier} ${mirrorModel.name}\` → \`${mirrorModel.typeReference.rawDeclaration}\``;
63
- if (mirrorModel.inherited) {
64
- listItemText += '(*Inherited*)';
65
- }
66
- listItemText += `${annotations} ${description}`;
67
-
68
- markdownFile.addListItem(listItemText);
69
- markdownFile.addBlankLine();
70
- }
71
- }
@@ -1,3 +0,0 @@
1
- export * from './type-declaration-util';
2
- export * from './method-declaration-util';
3
- export * from './field-declaration-util';