@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,166 +0,0 @@
1
- import { ConstructorMirror, DocComment } from '@cparra/apex-reflection';
2
- import { MarkdownFile } from '../markdown-file';
3
- import { ParameterMirror } from '@cparra/apex-reflection';
4
- import { addCustomDocCommentAnnotations, addMermaid } from './doc-comment-annotation-util';
5
- import { MethodMirrorWithInheritance } from '../inheritance';
6
-
7
- export function declareMethod(
8
- markdownFile: MarkdownFile,
9
- methods: ConstructorMirror[] | MethodMirrorWithInheritance[],
10
- startingHeadingLevel: number,
11
- className = '',
12
- ): void {
13
- methods.forEach((currentMethod) => {
14
- const signatureName = isMethod(currentMethod)
15
- ? `${(currentMethod as MethodMirrorWithInheritance).typeReference.rawDeclaration} ${
16
- (currentMethod as MethodMirrorWithInheritance).name
17
- }`
18
- : className;
19
-
20
- markdownFile.addTitle(
21
- `\`${buildSignature(currentMethod.access_modifier, signatureName, currentMethod)}\``,
22
- startingHeadingLevel + 2,
23
- );
24
-
25
- // Inheritance tag
26
- if (isMethod(currentMethod)) {
27
- const asMethodMirror = currentMethod as MethodMirrorWithInheritance;
28
- if (asMethodMirror.inherited) {
29
- markdownFile.addBlankLine();
30
- markdownFile.addText('*Inherited*');
31
- markdownFile.addBlankLine();
32
- }
33
- }
34
-
35
- currentMethod.annotations.forEach((annotation) => {
36
- markdownFile.addBlankLine();
37
- markdownFile.addText(`\`${annotation.type.toUpperCase()}\``);
38
- });
39
-
40
- if (currentMethod.docComment?.description) {
41
- markdownFile.addBlankLine();
42
- markdownFile.addText(currentMethod.docComment.description);
43
- markdownFile.addBlankLine();
44
- }
45
-
46
- if (currentMethod.parameters.length) {
47
- addParameters(markdownFile, currentMethod, startingHeadingLevel);
48
- }
49
-
50
- if (isMethod(currentMethod)) {
51
- addReturns(markdownFile, currentMethod as MethodMirrorWithInheritance, startingHeadingLevel);
52
- }
53
-
54
- addThrowsBlock(markdownFile, currentMethod, startingHeadingLevel);
55
-
56
- addCustomDocCommentAnnotations(markdownFile, currentMethod);
57
-
58
- addMermaid(markdownFile, currentMethod);
59
-
60
- if (currentMethod.docComment?.exampleAnnotation) {
61
- addExample(markdownFile, currentMethod, startingHeadingLevel);
62
- }
63
- });
64
-
65
- markdownFile.addHorizontalRule();
66
- }
67
-
68
- type ParameterAware = {
69
- parameters: ParameterMirror[];
70
- };
71
-
72
- type DocCommentAware = {
73
- docComment?: DocComment;
74
- };
75
-
76
- function buildSignature(accessModifier: string, name: string, parameterAware: ParameterAware): string {
77
- let signature = `${name}(`;
78
- if (isMethod(parameterAware) && (parameterAware as MethodMirrorWithInheritance).memberModifiers.length) {
79
- signature =
80
- accessModifier +
81
- ' ' +
82
- (parameterAware as MethodMirrorWithInheritance).memberModifiers.join(' ') +
83
- ' ' +
84
- signature;
85
- } else {
86
- signature = accessModifier + ' ' + signature;
87
- }
88
- const signatureParameters = parameterAware.parameters.map(
89
- (param) => `${param.typeReference.rawDeclaration} ${param.name}`,
90
- );
91
- signature += signatureParameters.join(', ');
92
- return `${signature})`;
93
- }
94
-
95
- function addParameters(
96
- markdownFile: MarkdownFile,
97
- methodModel: MethodMirrorWithInheritance | ConstructorMirror,
98
- startingHeadingLevel: number,
99
- ) {
100
- if (!methodModel.docComment?.paramAnnotations.length) {
101
- // If there are no parameters defined in the docs then we don't want to display this section
102
- return;
103
- }
104
-
105
- markdownFile.addTitle('Parameters', startingHeadingLevel + 3);
106
- markdownFile.initializeTable('Param', 'Description');
107
-
108
- methodModel.docComment?.paramAnnotations.forEach((paramAnnotation) => {
109
- const paramName = paramAnnotation.paramName;
110
- const paramDescription = paramAnnotation.bodyLines.join(' ');
111
- markdownFile.addTableRow(`\`${paramName}\``, paramDescription);
112
- });
113
-
114
- markdownFile.addBlankLine();
115
- }
116
-
117
- function addReturns(
118
- markdownFile: MarkdownFile,
119
- methodModel: MethodMirrorWithInheritance,
120
- startingHeadingLevel: number,
121
- ) {
122
- if (!methodModel.docComment?.returnAnnotation) {
123
- return;
124
- }
125
-
126
- markdownFile.addTitle('Returns', startingHeadingLevel + 3);
127
- markdownFile.initializeTable('Type', 'Description');
128
- markdownFile.addTableRow(
129
- `\`${methodModel.typeReference.rawDeclaration}\``,
130
- methodModel.docComment?.returnAnnotation.bodyLines.join(' '),
131
- );
132
- markdownFile.addBlankLine();
133
- }
134
-
135
- function addThrowsBlock(markdownFile: MarkdownFile, docCommentAware: DocCommentAware, startingHeadingLevel: number) {
136
- if (!docCommentAware.docComment?.throwsAnnotations.length) {
137
- return;
138
- }
139
- markdownFile.addTitle('Throws', startingHeadingLevel + 3);
140
- markdownFile.initializeTable('Exception', 'Description');
141
-
142
- docCommentAware.docComment?.throwsAnnotations.forEach((annotation) => {
143
- const exceptionName = annotation.exceptionName;
144
- const exceptionDescription = annotation.bodyLines.join(' ');
145
-
146
- markdownFile.addTableRow(`\`${exceptionName}\``, exceptionDescription);
147
- });
148
-
149
- markdownFile.addBlankLine();
150
- }
151
-
152
- function addExample(markdownFile: MarkdownFile, docCommentAware: DocCommentAware, startingHeadingLevel: number) {
153
- markdownFile.addTitle('Example', startingHeadingLevel + 3);
154
- markdownFile.startCodeBlock();
155
- docCommentAware.docComment?.exampleAnnotation.bodyLines.forEach((line) => {
156
- markdownFile.addText(line);
157
- });
158
- markdownFile.endCodeBlock();
159
- markdownFile.addBlankLine();
160
- }
161
-
162
- function isMethod(
163
- method: MethodMirrorWithInheritance | ConstructorMirror | ParameterAware,
164
- ): method is MethodMirrorWithInheritance {
165
- return (method as MethodMirrorWithInheritance).typeReference !== undefined;
166
- }
@@ -1,91 +0,0 @@
1
- import { MarkdownFile } from '../markdown-file';
2
- import { addCustomDocCommentAnnotations, addMermaid } from './doc-comment-annotation-util';
3
- import { Annotation, ClassMirror, InterfaceMirror, Type } from '@cparra/apex-reflection';
4
- import { TypesRepository } from '../types-repository';
5
-
6
- export function declareType(markdownFile: MarkdownFile, typeMirror: Type): void {
7
- typeMirror.annotations.forEach((currentAnnotation: Annotation) => {
8
- markdownFile.addBlankLine();
9
- markdownFile.addText(`\`${currentAnnotation.type.toUpperCase()}\``);
10
- });
11
-
12
- if (typeMirror.docComment?.descriptionLines) {
13
- markdownFile.addBlankLine();
14
- for (const currentLine of typeMirror.docComment.descriptionLines) {
15
- markdownFile.addText(currentLine);
16
- }
17
- markdownFile.addBlankLine();
18
- }
19
-
20
- if (typeMirror.type_name === 'class') {
21
- addInheritanceSectionForClass(typeMirror, markdownFile);
22
- }
23
-
24
- if (typeMirror.type_name === 'interface') {
25
- addInheritanceSectionForInterface(typeMirror, markdownFile);
26
- }
27
-
28
- addCustomDocCommentAnnotations(markdownFile, typeMirror);
29
-
30
- addMermaid(markdownFile, typeMirror);
31
- }
32
-
33
- function addInheritanceSectionForClass(typeMirror: Type, markdownFile: MarkdownFile) {
34
- const typeAsClass = typeMirror as ClassMirror;
35
- if (typeAsClass.extended_class) {
36
- markdownFile.addBlankLine();
37
- markdownFile.addText('**Inheritance**');
38
- markdownFile.addBlankLine();
39
- addParent(markdownFile, typeAsClass);
40
- markdownFile.addText(typeMirror.name);
41
- markdownFile.addBlankLine();
42
- }
43
-
44
- if (typeAsClass.implemented_interfaces.length) {
45
- markdownFile.addBlankLine();
46
- markdownFile.addText('**Implemented types**');
47
- markdownFile.addBlankLine();
48
- for (let i = 0; i < typeAsClass.implemented_interfaces.length; i++) {
49
- const currentName = typeAsClass.implemented_interfaces[i];
50
- markdownFile.addLink(currentName);
51
- if (i < typeAsClass.implemented_interfaces.length - 1) {
52
- markdownFile.addText(', ');
53
- }
54
- }
55
- markdownFile.addBlankLine();
56
- }
57
- }
58
-
59
- function addInheritanceSectionForInterface(typeMirror: Type, markdownFile: MarkdownFile) {
60
- const typeAsInterface = typeMirror as InterfaceMirror;
61
- if (typeAsInterface.extended_interfaces.length) {
62
- markdownFile.addBlankLine();
63
- markdownFile.addText('**Extended types**');
64
- markdownFile.addBlankLine();
65
- for (let i = 0; i < typeAsInterface.extended_interfaces.length; i++) {
66
- const currentName = typeAsInterface.extended_interfaces[i];
67
- markdownFile.addLink(currentName);
68
- if (i < typeAsInterface.extended_interfaces.length - 1) {
69
- markdownFile.addText(', ');
70
- }
71
- }
72
- }
73
- }
74
-
75
- function addParent(markdownFile: MarkdownFile, classMirror: ClassMirror) {
76
- if (!classMirror.extended_class) {
77
- return;
78
- }
79
-
80
- const parentType = TypesRepository.getInstance().getFromScopedByName(classMirror.extended_class);
81
- if (!parentType) {
82
- return;
83
- }
84
-
85
- if (parentType.type_name === 'class') {
86
- addParent(markdownFile, parentType as ClassMirror);
87
- }
88
-
89
- markdownFile.addLink(parentType.name);
90
- markdownFile.addText(' > ');
91
- }
@@ -1,58 +0,0 @@
1
- import { Type } from '@cparra/apex-reflection';
2
- import ClassFileGeneratorHelper from '../transpiler/markdown/class-file-generatorHelper';
3
- import { MarkdownFile } from './markdown-file';
4
- import { truncate } from '../util/string-utils';
5
- import { Settings } from '../settings';
6
-
7
- export class MarkdownHomeFile extends MarkdownFile {
8
- constructor(public fileName: string, public types: Type[], headerContent?: string) {
9
- super(fileName, '');
10
- if (headerContent) {
11
- this.addText(headerContent);
12
- }
13
- this.addTitle(Settings.getInstance().getTitle());
14
- this.addTypeEntries(types);
15
- }
16
-
17
- private addTypeEntries(types: Type[]) {
18
- const groupedClasses: Map<string, Type[]> = this.group(types);
19
- groupedClasses.forEach((value: Type[], key: string) => {
20
- this.addTitle(key, 2);
21
- value.forEach((typeMirror) => {
22
- this.addTypeEntry(typeMirror);
23
- });
24
- });
25
- }
26
-
27
- private addTypeEntry(typeMirror: Type) {
28
- this.addBlankLine();
29
- this.addTitle(ClassFileGeneratorHelper.getFileLink(typeMirror), 3);
30
- this.addBlankLine();
31
-
32
- if (typeMirror.docComment?.descriptionLines) {
33
- const description = typeMirror.docComment.descriptionLines.reduce(
34
- (previous, current) => previous + current + '\n',
35
- '',
36
- );
37
- this.addText(truncate(description, 300));
38
- this.addBlankLine();
39
- }
40
- }
41
-
42
- private group(classes: Type[]): Map<string, Type[]> {
43
- return classes.reduce((groups, currentClass) => {
44
- const key = this.getClassGroup(currentClass);
45
- const group: Type[] = groups.get(key) || [];
46
- group.push(currentClass);
47
- groups.set(key, group);
48
- return groups;
49
- }, new Map());
50
- }
51
-
52
- private getClassGroup(classModel: Type): string {
53
- return (
54
- classModel.docComment?.annotations.find((annotation) => annotation.name === 'group')?.body ??
55
- Settings.getInstance().getDefaultGroupName()
56
- );
57
- }
58
- }
@@ -1,165 +0,0 @@
1
- import {
2
- ClassMirror,
3
- ConstructorMirror,
4
- EnumMirror,
5
- InterfaceMirror,
6
- MethodMirror,
7
- Type,
8
- } from '@cparra/apex-reflection';
9
- import { WalkerFactory } from '../service/walkers/walker-factory';
10
- import { WalkerListener } from '../service/walkers/walker';
11
- import { MarkdownFile } from './markdown-file';
12
- import { declareType, declareMethod, declareField } from './markdown-generation-util';
13
- import ClassFileGeneratorHelper from '../transpiler/markdown/class-file-generatorHelper';
14
- import { FieldMirrorWithInheritance, MethodMirrorWithInheritance, PropertyMirrorWithInheritance } from './inheritance';
15
- import { Settings } from '../settings';
16
-
17
- interface GroupAware {
18
- group?: string;
19
- groupDescription?: string;
20
- }
21
-
22
- interface GroupMap {
23
- [key: string]: GroupAware[];
24
- }
25
-
26
- export class MarkdownTypeFile extends MarkdownFile implements WalkerListener {
27
- constructor(private type: Type, private headingLevel: number = 1, headerContent?: string, private isInner = false) {
28
- super(
29
- `${Settings.getInstance().getNamespacePrefix()}${type.name}`,
30
- ClassFileGeneratorHelper.getSanitizedGroup(type),
31
- );
32
- if (headerContent) {
33
- this.addText(headerContent);
34
- }
35
- const walker = WalkerFactory.get(type);
36
- walker.walk(this);
37
- }
38
-
39
- public onTypeDeclaration(typeMirror: Type): void {
40
- let fullTypeName;
41
- if (this.isInner) {
42
- fullTypeName = typeMirror.name;
43
- } else {
44
- // If we are dealing with a class, we want to check if it has a class
45
- // modifier and add it to the name.
46
- if (this.isClass(typeMirror) && typeMirror.classModifier) {
47
- fullTypeName = `${typeMirror.classModifier} ${Settings.getInstance().getNamespacePrefix()}${typeMirror.name}`;
48
- } else {
49
- fullTypeName = `${Settings.getInstance().getNamespacePrefix()}${typeMirror.name}`;
50
- }
51
- }
52
- this.addTitle(fullTypeName, this.headingLevel);
53
- declareType(this, typeMirror);
54
- }
55
-
56
- private isClass(typeMirror: Type): typeMirror is ClassMirror {
57
- return typeMirror.type_name === 'class';
58
- }
59
-
60
- public onConstructorDeclaration(className: string, constructors: ConstructorMirror[]): void {
61
- this.addTitle('Constructors', this.headingLevel + 1);
62
- this.declareMethodWithGroupings(constructors, className);
63
- }
64
-
65
- public onFieldsDeclaration(fields: FieldMirrorWithInheritance[]): void {
66
- this.addTitle('Fields', this.headingLevel + 1);
67
- this.declareFieldOrProperty(fields);
68
- }
69
-
70
- public onPropertiesDeclaration(properties: PropertyMirrorWithInheritance[]): void {
71
- this.addTitle('Properties', this.headingLevel + 1);
72
- this.declareFieldOrProperty(properties);
73
- }
74
-
75
- public onMethodsDeclaration(methods: MethodMirror[]): void {
76
- this.addTitle('Methods', this.headingLevel + 1);
77
- this.declareMethodWithGroupings(methods);
78
- }
79
-
80
- public onInnerEnumsDeclaration(enums: EnumMirror[]): void {
81
- this.addInnerTypes('Enums', enums);
82
- }
83
-
84
- public onInnerClassesDeclaration(classes: ClassMirror[]): void {
85
- this.addInnerTypes('Classes', classes);
86
- }
87
-
88
- public onInnerInterfacesDeclaration(interfaces: InterfaceMirror[]): void {
89
- this.addInnerTypes('Interfaces', interfaces, false);
90
- }
91
-
92
- private addInnerTypes(title: string, types: Type[], addSeparator = true) {
93
- this.addTitle(title, this.headingLevel + 1);
94
- types.forEach((currentType) => {
95
- const innerFile = new MarkdownTypeFile(currentType, this.headingLevel + 2, undefined, true);
96
- this.addText(innerFile._contents);
97
- });
98
- if (addSeparator) {
99
- this.addHorizontalRule();
100
- }
101
- }
102
-
103
- private hasGroupings(groupAware: GroupAware[]): boolean {
104
- return !!groupAware.find((current) => !!current.group);
105
- }
106
-
107
- private declareMethodWithGroupings(
108
- methods: ConstructorMirror[] | MethodMirrorWithInheritance[],
109
- className = '',
110
- ): void {
111
- const hasGroupings = this.hasGroupings(methods);
112
- if (!hasGroupings) {
113
- declareMethod(this, methods, this.headingLevel, className);
114
- } else {
115
- const groupedConstructors = this.group(methods);
116
- for (const key in groupedConstructors) {
117
- // For the group description, we can take the first one, since they all have the same description.
118
- this.startGroup(key, groupedConstructors[key][0].groupDescription);
119
- const constructorsForGroup = groupedConstructors[key] as (ConstructorMirror | MethodMirrorWithInheritance)[];
120
- declareMethod(this, constructorsForGroup, this.headingLevel, className);
121
- this.endGroup();
122
- }
123
- }
124
- }
125
-
126
- private declareFieldOrProperty(
127
- fieldsOrProperties: FieldMirrorWithInheritance[] | PropertyMirrorWithInheritance[],
128
- ): void {
129
- const hasGroupings = this.hasGroupings(fieldsOrProperties);
130
- if (!hasGroupings) {
131
- declareField(this, fieldsOrProperties, this.headingLevel, false);
132
- } else {
133
- const groupedFields = this.group(fieldsOrProperties);
134
- for (const key in groupedFields) {
135
- // For the group description, we can take the first one, since they all have the same description.
136
- this.startGroup(key, groupedFields[key][0].groupDescription);
137
- const fieldsForGroup = groupedFields[key] as (FieldMirrorWithInheritance | PropertyMirrorWithInheritance)[];
138
- declareField(this, fieldsForGroup, this.headingLevel, true);
139
- this.endGroup();
140
- }
141
- }
142
- }
143
-
144
- private startGroup(groupName: string, groupDescription?: string) {
145
- this.headingLevel = this.headingLevel + 2;
146
- this.addTitle(groupName, this.headingLevel);
147
- if (groupDescription) {
148
- this.addText(groupDescription);
149
- }
150
- }
151
-
152
- private endGroup() {
153
- this.headingLevel = this.headingLevel - 2;
154
- }
155
-
156
- private group(list: GroupAware[]) {
157
- return list.reduce((groups: GroupMap, item) => {
158
- const groupName: string = item.group ?? 'Other';
159
- const group: GroupAware[] = groups[groupName] || [];
160
- group.push(item);
161
- groups[groupName] = group;
162
- return groups;
163
- }, {});
164
- }
165
- }
@@ -1,14 +0,0 @@
1
- import { OutputFile } from '../outputFile';
2
- import { OpenApi } from './open-api';
3
- import { Settings } from '../../settings';
4
-
5
- export class OpenapiTypeFile extends OutputFile {
6
- constructor(public openApiModel: OpenApi) {
7
- super(Settings.getInstance().openApiFileName(), '');
8
- this.addText(JSON.stringify({ ...openApiModel, namespace: undefined }, null, 2));
9
- }
10
-
11
- fileExtension(): string {
12
- return '.json';
13
- }
14
- }
@@ -1,20 +0,0 @@
1
- export abstract class OutputFile {
2
- _contents = '';
3
-
4
- constructor(public fileName: string, public dir: string) {}
5
-
6
- abstract fileExtension(): string;
7
-
8
- get body() {
9
- return this._contents;
10
- }
11
-
12
- addText(text: string) {
13
- this._contents += text;
14
- this.addBlankLine();
15
- }
16
-
17
- addBlankLine() {
18
- this._contents += '\n';
19
- }
20
- }
@@ -1,92 +0,0 @@
1
- import { Settings, SettingsConfig } from '../../settings';
2
- import { ApexFileReader } from '../apex-file-reader';
3
-
4
- describe('File Reader', () => {
5
- beforeEach(() => {
6
- Settings.build({
7
- sourceDirectory: '',
8
- recursive: true,
9
- scope: [],
10
- outputDir: '',
11
- targetGenerator: 'jekyll',
12
- indexOnly: false,
13
- defaultGroupName: 'Misc',
14
- sanitizeHtml: true,
15
- openApiFileName: 'openapi',
16
- title: 'Classes',
17
- includeMetadata: false,
18
- } as SettingsConfig);
19
- });
20
-
21
- it('returns an empty list when there are no files in the directory', () => {
22
- const result = ApexFileReader.processFiles({
23
- // eslint-disable-next-line @typescript-eslint/no-unused-vars
24
- isDirectory(_: string): boolean {
25
- return false;
26
- },
27
- // eslint-disable-next-line @typescript-eslint/no-unused-vars
28
- joinPath(_: string): string {
29
- return '';
30
- },
31
- // eslint-disable-next-line @typescript-eslint/no-unused-vars
32
- readDirectory(_: string): string[] {
33
- return [];
34
- },
35
- // eslint-disable-next-line @typescript-eslint/no-unused-vars
36
- readFile(_: string): string {
37
- return '';
38
- },
39
- exists(): boolean {
40
- return true;
41
- },
42
- });
43
- expect(result.length).toBe(0);
44
- });
45
-
46
- it('returns an empty list when there are no Apex files in the directory', () => {
47
- const result = ApexFileReader.processFiles({
48
- isDirectory(): boolean {
49
- return false;
50
- },
51
- joinPath(): string {
52
- return '';
53
- },
54
- readDirectory(): string[] {
55
- return ['SomeFile.md'];
56
- },
57
- readFile(): string {
58
- return '';
59
- },
60
- exists(): boolean {
61
- return true;
62
- },
63
- });
64
- expect(result.length).toBe(0);
65
- });
66
-
67
- it('returns the file contents for an Apex file', () => {
68
- const result = ApexFileReader.processFiles({
69
- // eslint-disable-next-line @typescript-eslint/no-unused-vars
70
- isDirectory(_: string): boolean {
71
- return false;
72
- },
73
- // eslint-disable-next-line @typescript-eslint/no-unused-vars
74
- joinPath(_: string): string {
75
- return '';
76
- },
77
- // eslint-disable-next-line @typescript-eslint/no-unused-vars
78
- readDirectory(_: string): string[] {
79
- return ['SomeApexFile.cls'];
80
- },
81
- // eslint-disable-next-line @typescript-eslint/no-unused-vars
82
- readFile(_: string): string {
83
- return 'public class MyClass{}';
84
- },
85
- exists(): boolean {
86
- return true;
87
- },
88
- });
89
- expect(result.length).toBe(1);
90
- expect(result[0].rawTypeContent).toBe('public class MyClass{}');
91
- });
92
- });
@@ -1,51 +0,0 @@
1
- import { Settings } from '../settings';
2
- import { FileSystem } from './file-system';
3
- import ApexBundle from '../model/apex-bundle';
4
-
5
- const APEX_FILE_EXTENSION = '.cls';
6
-
7
- /**
8
- * Reads from .cls files and returns their raw body.
9
- */
10
- export class ApexFileReader {
11
- /**
12
- * Reads from .cls files and returns their raw body.
13
- */
14
- static processFiles(fileSystem: FileSystem, rootPath: string = this.sourceDirectory): ApexBundle[] {
15
- let bundles: ApexBundle[] = [];
16
-
17
- const directoryContents = fileSystem.readDirectory(rootPath);
18
- directoryContents.forEach((currentFilePath) => {
19
- const currentPath = fileSystem.joinPath(rootPath, currentFilePath);
20
- if (this.readRecursively && fileSystem.isDirectory(currentPath)) {
21
- bundles = bundles.concat(this.processFiles(fileSystem, currentPath));
22
- }
23
-
24
- if (!this.isApexFile(currentFilePath)) {
25
- return;
26
- }
27
-
28
- const rawApexFile = fileSystem.readFile(currentPath);
29
- const metadataPath = fileSystem.joinPath(rootPath, `${currentFilePath}-meta.xml`);
30
- let rawMetadataFile = null;
31
- if (Settings.getInstance().includeMetadata()) {
32
- rawMetadataFile = fileSystem.exists(metadataPath) ? fileSystem.readFile(metadataPath) : null;
33
- }
34
-
35
- bundles.push(new ApexBundle(currentFilePath, rawApexFile, rawMetadataFile));
36
- });
37
- return bundles;
38
- }
39
-
40
- private static isApexFile(currentFile: string): boolean {
41
- return currentFile.endsWith(APEX_FILE_EXTENSION);
42
- }
43
-
44
- private static get sourceDirectory() {
45
- return Settings.getInstance().sourceDirectory;
46
- }
47
-
48
- private static get readRecursively() {
49
- return Settings.getInstance().recursive;
50
- }
51
- }
@@ -1,34 +0,0 @@
1
- import * as fs from 'fs';
2
- import * as path from 'path';
3
- import { OutputFile } from '../model/outputFile';
4
- import { OnBeforeFileWrite, Settings, TargetFile } from '../settings';
5
-
6
- export class FileWriter {
7
- static write(files: OutputFile[], onWriteCallback: (file: TargetFile) => void) {
8
- const onBeforeFileWrite: OnBeforeFileWrite = (file: TargetFile) => Settings.getInstance().onBeforeFileWrite(file);
9
- files.forEach((file) => {
10
- const resolvedFile = this.getTargetLocation(file, onBeforeFileWrite);
11
- const fullDir = path.join(resolvedFile.dir.baseDir, resolvedFile.dir.fileDir);
12
- if (!fs.existsSync(fullDir)) {
13
- fs.mkdirSync(fullDir, { recursive: true });
14
- }
15
-
16
- const filePath = path.join(fullDir, `${resolvedFile.name}${resolvedFile.extension}`);
17
- fs.writeFileSync(filePath, file.body, 'utf8');
18
- onWriteCallback(resolvedFile);
19
- });
20
- }
21
-
22
- private static getTargetLocation(file: OutputFile, onBeforeFileWrite: OnBeforeFileWrite): TargetFile {
23
- const targetFile: TargetFile = {
24
- name: file.fileName,
25
- extension: file.fileExtension(),
26
- dir: {
27
- baseDir: Settings.getInstance().outputDir,
28
- fileDir: file.dir,
29
- },
30
- };
31
-
32
- return onBeforeFileWrite(targetFile);
33
- }
34
- }