@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
@@ -3,10 +3,12 @@ export const documentablePartialTemplate = `
3
3
  \`{{this}}\`
4
4
  {{/each}}
5
5
 
6
- {{withLinks doc.description}}
6
+ {{{renderContent doc.description}}}
7
7
 
8
8
  {{#each doc.customTags}}
9
- **{{splitAndCapitalize name}}** {{withLinks description}}
9
+ **{{splitAndCapitalize name}}**
10
+
11
+ {{{renderContent description}}}
10
12
 
11
13
  {{/each}}
12
14
 
@@ -14,11 +16,11 @@ export const documentablePartialTemplate = `
14
16
 
15
17
  {{#if doc.mermaid.value}}
16
18
  {{ heading doc.mermaid.headingLevel doc.mermaid.heading }}
17
- {{code "mermaid" doc.mermaid.value}}
19
+ {{code doc.mermaid.value}}
18
20
  {{/if}}
19
21
 
20
22
  {{#if doc.example.value}}
21
23
  {{ heading doc.example.headingLevel doc.example.heading }}
22
- {{code "apex" doc.example.value}}
24
+ {{{renderContent doc.example.value}}}
23
25
  {{/if}}
24
26
  `.trim();
@@ -10,7 +10,7 @@ export const fieldsPartialTemplate = `
10
10
  {{#> documentablePartialTemplate }}
11
11
 
12
12
  {{ heading signature.headingLevel signature.heading }}
13
- {{ code "apex" signature.value }}
13
+ {{ code signature.value }}
14
14
 
15
15
  {{ heading type.headingLevel type.heading }}
16
16
  {{link type.value}}
@@ -0,0 +1,7 @@
1
+ export const hookableTemplate = `
2
+ {{#if frontmatter}}
3
+ {{{frontmatter}}}
4
+ {{/if}}
5
+
6
+ {{{content}}}
7
+ `.trim();
@@ -10,14 +10,14 @@ export const methodsPartialTemplate = `
10
10
  {{#> documentablePartialTemplate}}
11
11
 
12
12
  {{ heading signature.headingLevel signature.heading }}
13
- {{ code "apex" signature.value }}
13
+ {{ code signature.value }}
14
14
 
15
15
  {{#if parameters.value}}
16
16
  {{ heading parameters.headingLevel parameters.heading }}
17
17
  | Name | Type | Description |
18
18
  |------|------|-------------|
19
19
  {{#each parameters.value}}
20
- | {{name}} | {{link type}} | {{withLinks description}} |
20
+ | {{name}} | {{link type}} | {{{renderContent description}}} |
21
21
  {{/each}}
22
22
  {{/if}}
23
23
 
@@ -7,7 +7,7 @@ export const referenceGuideTemplate = `
7
7
  {{#each this}}
8
8
  ### {{link title}}
9
9
 
10
- {{withLinks description}}
10
+ {{{renderContent description}}}
11
11
 
12
12
  {{/each}}
13
13
  {{/each}}
@@ -1,15 +1,15 @@
1
1
  import Handlebars from 'handlebars';
2
- import { typeDocPartial } from '../transpiler/markdown/plain-markdown/type-doc-partial';
3
- import { documentablePartialTemplate } from '../transpiler/markdown/plain-markdown/documentable-partial-template';
4
- import { methodsPartialTemplate } from '../transpiler/markdown/plain-markdown/methods-partial-template';
5
- import { constructorsPartialTemplate } from '../transpiler/markdown/plain-markdown/constructors-partial-template';
6
- import { fieldsPartialTemplate } from '../transpiler/markdown/plain-markdown/fieldsPartialTemplate';
7
- import { classMarkdownTemplate } from '../transpiler/markdown/plain-markdown/class-template';
8
- import { enumMarkdownTemplate } from '../transpiler/markdown/plain-markdown/enum-template';
9
- import { interfaceMarkdownTemplate } from '../transpiler/markdown/plain-markdown/interface-template';
10
- import { RenderableContent, StringOrLink } from './renderable/types';
11
- import { isEmptyLine } from '../adapters/type-utils';
12
- import { groupedMembersPartialTemplate } from '../transpiler/markdown/plain-markdown/grouped-members-partial-template';
2
+ import { CodeBlock, RenderableContent, StringOrLink } from '../adapters/types';
3
+ import { isCodeBlock, isEmptyLine, isInlineCode } from '../adapters/type-utils';
4
+ import { typeDocPartial } from './type-doc-partial';
5
+ import { documentablePartialTemplate } from './documentable-partial-template';
6
+ import { methodsPartialTemplate } from './methods-partial-template';
7
+ import { groupedMembersPartialTemplate } from './grouped-members-partial-template';
8
+ import { constructorsPartialTemplate } from './constructors-partial-template';
9
+ import { fieldsPartialTemplate } from './fieldsPartialTemplate';
10
+ import { classMarkdownTemplate } from './class-template';
11
+ import { enumMarkdownTemplate } from './enum-template';
12
+ import { interfaceMarkdownTemplate } from './interface-template';
13
13
 
14
14
  export type CompilationRequest = {
15
15
  template: string;
@@ -32,7 +32,7 @@ export class Template {
32
32
 
33
33
  Handlebars.registerHelper('link', link);
34
34
  Handlebars.registerHelper('code', convertCodeBlock);
35
- Handlebars.registerHelper('withLinks', resolveLinksInContent);
35
+ Handlebars.registerHelper('renderContent', resolveRenderableContent);
36
36
  Handlebars.registerHelper('heading', heading);
37
37
  Handlebars.registerHelper('inlineCode', inlineCode);
38
38
  Handlebars.registerHelper('splitAndCapitalize', splitAndCapitalize);
@@ -73,27 +73,33 @@ const inlineCode = (text: string) => {
73
73
  return new Handlebars.SafeString(`\`${text}\``);
74
74
  };
75
75
 
76
- const convertCodeBlock = (language: string, lines: string[]): Handlebars.SafeString => {
76
+ const convertCodeBlock = (codeBlock: CodeBlock): Handlebars.SafeString => {
77
77
  return new Handlebars.SafeString(
78
78
  `
79
- \`\`\`${language}
80
- ${lines.join('\n')}
79
+ \`\`\`${codeBlock.language}
80
+ ${codeBlock.content.join('\n')}
81
81
  \`\`\`
82
82
  `.trim(),
83
83
  );
84
84
  };
85
85
 
86
- const resolveLinksInContent = (description?: RenderableContent[]): string => {
86
+ const resolveRenderableContent = (description?: RenderableContent[]): string => {
87
87
  if (!description) {
88
88
  return '';
89
89
  }
90
90
 
91
91
  function reduceDescription(acc: string, curr: RenderableContent) {
92
92
  if (isEmptyLine(curr)) {
93
- return acc + '\n\n';
93
+ return acc + '\n';
94
+ }
95
+ if (isCodeBlock(curr)) {
96
+ return acc + convertCodeBlock(curr) + '\n';
97
+ }
98
+ if (isInlineCode(curr)) {
99
+ return acc + inlineCode(curr.content).toString() + ' ';
100
+ } else {
101
+ return acc + Handlebars.escapeExpression(link(curr)).trim() + ' ';
94
102
  }
95
-
96
- return acc + link(curr).trim() + ' ';
97
103
  }
98
104
 
99
105
  return description.reduce(reduceDescription, '').trim();
@@ -0,0 +1,3 @@
1
+ import { ParsedFile } from '../shared/types';
2
+
3
+ export const parsedFilesToTypes = (parsedFiles: ParsedFile[]) => parsedFiles.map((parsedFile) => parsedFile.type);
@@ -1,5 +1,5 @@
1
1
  import { OpenApiDocsProcessor } from '../open-api-docs-processor';
2
- import { Settings } from '../../../settings';
2
+ import { Settings } from '../../settings';
3
3
  import { SettingsBuilder } from '../../../test-helpers/SettingsBuilder';
4
4
  import { DocCommentBuilder } from '../../../test-helpers/DocCommentBuilder';
5
5
  import { AnnotationBuilder } from '../../../test-helpers/AnnotationBuilder';
@@ -1,7 +1,7 @@
1
- import { ClassMirrorBuilder } from '../../../test-helpers/ClassMirrorBuilder';
2
1
  import { ClassMirrorWrapper } from '../ClassMirrorWrapper';
3
- import { AnnotationBuilder } from '../../../test-helpers/AnnotationBuilder';
4
- import { MethodMirrorBuilder } from '../../../test-helpers/MethodMirrorBuilder';
2
+ import { ClassMirrorBuilder } from '../../../../test-helpers/ClassMirrorBuilder';
3
+ import { MethodMirrorBuilder } from '../../../../test-helpers/MethodMirrorBuilder';
4
+ import { AnnotationBuilder } from '../../../../test-helpers/AnnotationBuilder';
5
5
 
6
6
  it('should return methods by annotation when they exist', function () {
7
7
  const classMirror = new ClassMirrorBuilder()
@@ -0,0 +1,13 @@
1
+ import { PageData } from '../shared/types';
2
+
3
+ export class FileContainer {
4
+ _files: PageData[] = [];
5
+
6
+ files(): PageData[] {
7
+ return this._files;
8
+ }
9
+
10
+ pushFile(file: PageData): void {
11
+ this._files.push(file);
12
+ }
13
+ }
@@ -1,7 +1,7 @@
1
- import Manifest from '../model/manifest';
1
+ import Manifest from '../manifest';
2
2
  import { TypeParser } from './parser';
3
3
  import { ReflectionResult } from '@cparra/apex-reflection';
4
- import ApexBundle from '../model/apex-bundle';
4
+ import { UnparsedSourceFile } from '../shared/types';
5
5
 
6
6
  /**
7
7
  * Builds a new Manifest object, sourcing its types from the received TypeParser.
@@ -10,7 +10,7 @@ import ApexBundle from '../model/apex-bundle';
10
10
  */
11
11
  export function createManifest(
12
12
  typeParser: TypeParser,
13
- reflect: (apexBundle: ApexBundle) => ReflectionResult,
13
+ reflect: (apexBundle: UnparsedSourceFile) => ReflectionResult,
14
14
  ): Manifest {
15
15
  return new Manifest(typeParser.parse(reflect));
16
16
  }
@@ -1,19 +1,17 @@
1
- import ProcessorTypeTranspiler from '../processor-type-transpiler';
2
- import { FileContainer } from '../file-container';
1
+ import { FileContainer } from './file-container';
3
2
  import { ClassMirror, Type } from '@cparra/apex-reflection';
4
- import { OpenapiTypeFile } from '../../model/openapi/openapi-type-file';
5
- import { Logger } from '../../util/logger';
6
- import { OpenApi } from '../../model/openapi/open-api';
7
- import { Settings } from '../../settings';
3
+ import { Logger } from '#utils/logger';
4
+ import { OpenApi } from './open-api';
5
+ import { Settings } from '../settings';
8
6
  import { MethodParser } from './parsers/MethodParser';
9
- import { camel2title } from '../../util/string-utils';
7
+ import { camel2title } from '#utils/string-utils';
8
+ import { createOpenApiFile } from './openapi-type-file';
10
9
 
11
- export class OpenApiDocsProcessor extends ProcessorTypeTranspiler {
10
+ export class OpenApiDocsProcessor {
12
11
  protected readonly _fileContainer: FileContainer;
13
12
  openApiModel: OpenApi;
14
13
 
15
14
  constructor() {
16
- super();
17
15
  this._fileContainer = new FileContainer();
18
16
  const title = Settings.getInstance().getOpenApiTitle();
19
17
  if (!title) {
@@ -68,7 +66,8 @@ export class OpenApiDocsProcessor extends ProcessorTypeTranspiler {
68
66
  }
69
67
 
70
68
  onAfterProcess: ((types: Type[]) => void) | undefined = () => {
71
- this._fileContainer.pushFile(new OpenapiTypeFile(this.openApiModel));
69
+ const page = createOpenApiFile(Settings.getInstance().openApiFileName(), this.openApiModel);
70
+ this._fileContainer.pushFile(page);
72
71
  };
73
72
 
74
73
  private getEndpointPath(type: Type): string | null {
@@ -0,0 +1,12 @@
1
+ import { OpenApi } from './open-api';
2
+ import { OpenApiPageData } from '../shared/types';
3
+
4
+ export function createOpenApiFile(fileName: string, openApiModel: OpenApi): OpenApiPageData {
5
+ const content = JSON.stringify({ ...openApiModel, namespace: undefined }, null, 2);
6
+ return {
7
+ filePath: '',
8
+ content,
9
+ frontmatter: null,
10
+ group: null,
11
+ };
12
+ }
@@ -1,25 +1,25 @@
1
1
  import { ClassMirror, InterfaceMirror, ReflectionResult, Type } from '@cparra/apex-reflection';
2
- import ApexBundle from '../model/apex-bundle';
3
- import MetadataProcessor from './metadata-processor';
4
- import { Logger } from '../util/logger';
2
+ import { parseApexMetadata } from '../parse-apex-metadata';
3
+ import { Logger } from '#utils/logger';
4
+ import { UnparsedSourceFile } from '../shared/types';
5
5
 
6
6
  export interface TypeParser {
7
- parse(reflect: (apexBundle: ApexBundle) => ReflectionResult): Type[];
7
+ parse(reflect: (apexBundle: UnparsedSourceFile) => ReflectionResult): Type[];
8
8
  }
9
9
 
10
10
  type NameAware = { name: string };
11
11
 
12
12
  export class RawBodyParser implements TypeParser {
13
- constructor(public typeBundles: ApexBundle[]) {}
13
+ constructor(public typeBundles: UnparsedSourceFile[]) {}
14
14
 
15
- parse(reflect: (apexBundle: ApexBundle) => ReflectionResult): Type[] {
15
+ parse(reflect: (apexBundle: UnparsedSourceFile) => ReflectionResult): Type[] {
16
16
  const types = this.typeBundles
17
17
  .map((currentBundle) => {
18
18
  Logger.log(`Parsing file: ${currentBundle.filePath}`);
19
19
  const result = reflect(currentBundle);
20
- if (!!result.typeMirror && !!currentBundle.rawMetadataContent) {
20
+ if (!!result.typeMirror && !!currentBundle.metadataContent) {
21
21
  // If successful and there is a metadata file
22
- const metadataParams = MetadataProcessor.process(currentBundle.rawMetadataContent);
22
+ const metadataParams = parseApexMetadata(currentBundle.metadataContent);
23
23
  metadataParams.forEach((value, key) => {
24
24
  const declaration = `${key}: ${value}`;
25
25
  result.typeMirror?.annotations.push({
@@ -1,6 +1,6 @@
1
1
  import { Reference, ReferenceBuilder } from './ReferenceBuilder';
2
- import { ApexDocSchemaObject } from '../../../model/openapi/apex-doc-types';
3
- import { SchemaObject } from '../../../model/openapi/open-api-types';
2
+ import { ApexDocSchemaObject } from '../../../core/openapi/apex-doc-types';
3
+ import { SchemaObject } from '../../../core/openapi/open-api-types';
4
4
 
5
5
  export type ApexDocSchemaAware = {
6
6
  schema: ApexDocSchemaObject;
@@ -1,7 +1,7 @@
1
1
  import { ClassMirror, MethodMirror } from '@cparra/apex-reflection';
2
- import { OpenApi } from '../../../model/openapi/open-api';
2
+ import { OpenApi } from '../../../core/openapi/open-api';
3
3
  import * as yaml from 'js-yaml';
4
- import { ClassMirrorWrapper } from '../../../model/apex-type-wrappers/ClassMirrorWrapper';
4
+ import { ClassMirrorWrapper } from '../../../core/openapi/apex-type-wrappers/ClassMirrorWrapper';
5
5
  import { Reference, ReferenceBuilder } from './ReferenceBuilder';
6
6
  import { ParameterObjectBuilder } from './ParameterObjectBuilder';
7
7
  import { ResponsesBuilder } from './ResponsesBuilder';
@@ -9,11 +9,11 @@ import {
9
9
  ApexDocHttpRequestBody,
10
10
  ApexDocHttpResponse,
11
11
  ApexDocParameterObject,
12
- } from '../../../model/openapi/apex-doc-types';
12
+ } from '../../../core/openapi/apex-doc-types';
13
13
  import { RequestBodyBuilder } from './RequestBodyBuilder';
14
14
  import { ApexDocSchemaAware } from './Builder';
15
- import { PropertiesObject, ReferenceObject } from '../../../model/openapi/open-api-types';
16
- import { MethodMirrorWrapper } from '../../../model/apex-type-wrappers/MethodMirrorWrapper';
15
+ import { PropertiesObject, ReferenceObject } from '../../../core/openapi/open-api-types';
16
+ import { MethodMirrorWrapper } from '../../../core/openapi/apex-type-wrappers/MethodMirrorWrapper';
17
17
 
18
18
  type FallbackMethodParser = (methodMirror: MethodMirror) => void;
19
19
  type AddToOpenApi<T extends ApexDocSchemaAware> = (input: T, urlValue: string, httpMethodKey: HttpOperations) => void;
@@ -1,6 +1,6 @@
1
- import { ParameterObject } from '../../../model/openapi/open-api-types';
1
+ import { ParameterObject } from '../../../core/openapi/open-api-types';
2
2
  import { Reference } from './ReferenceBuilder';
3
- import { ApexDocParameterObject } from '../../../model/openapi/apex-doc-types';
3
+ import { ApexDocParameterObject } from '../../../core/openapi/apex-doc-types';
4
4
  import { Builder } from './Builder';
5
5
 
6
6
  export class ParameterObjectBuilder extends Builder<ParameterObject, ApexDocParameterObject> {
@@ -5,11 +5,11 @@ import {
5
5
  SchemaObject,
6
6
  SchemaObjectArray,
7
7
  SchemaObjectObject,
8
- } from '../../../model/openapi/open-api-types';
9
- import { TypeBundle, TypesRepository } from '../../../model/types-repository';
8
+ } from '../../../core/openapi/open-api-types';
9
+ import { TypeBundle, TypesRepository } from '../../../core/openapi/types-repository';
10
10
  import { ClassMirror, DocCommentAnnotation, FieldMirror, PropertyMirror } from '@cparra/apex-reflection';
11
11
  import { ListObjectType, ReferencedType } from '@cparra/apex-reflection';
12
- import { ApexDocSchemaObject } from '../../../model/openapi/apex-doc-types';
12
+ import { ApexDocSchemaObject } from '../../../core/openapi/apex-doc-types';
13
13
 
14
14
  type TypeBundleWithIsCollectionAndReferenceOverrides = TypeBundle & {
15
15
  originalTypeName: string;
@@ -1,6 +1,6 @@
1
- import { RequestBody } from '../../../model/openapi/open-api-types';
1
+ import { RequestBody } from '../../../core/openapi/open-api-types';
2
2
  import { Reference } from './ReferenceBuilder';
3
- import { ApexDocHttpRequestBody } from '../../../model/openapi/apex-doc-types';
3
+ import { ApexDocHttpRequestBody } from '../../../core/openapi/apex-doc-types';
4
4
  import { Builder } from './Builder';
5
5
 
6
6
  /**
@@ -1,6 +1,6 @@
1
- import { ResponseObject } from '../../../model/openapi/open-api-types';
1
+ import { ResponseObject } from '../../../core/openapi/open-api-types';
2
2
  import { Reference } from './ReferenceBuilder';
3
- import { ApexDocHttpResponse } from '../../../model/openapi/apex-doc-types';
3
+ import { ApexDocHttpResponse } from '../../../core/openapi/apex-doc-types';
4
4
  import { Builder } from './Builder';
5
5
 
6
6
  export class ResponsesBuilder extends Builder<ResponseObject, ApexDocHttpResponse> {
@@ -1,7 +1,7 @@
1
1
  import { ClassMirrorBuilder } from '../../../../test-helpers/ClassMirrorBuilder';
2
2
  import { MethodMirrorBuilder } from '../../../../test-helpers/MethodMirrorBuilder';
3
3
  import { AnnotationBuilder } from '../../../../test-helpers/AnnotationBuilder';
4
- import { OpenApi } from '../../../../model/openapi/open-api';
4
+ import { OpenApi } from '../../../../core/openapi/open-api';
5
5
  import { MethodParser } from '../MethodParser';
6
6
  import { DocCommentBuilder } from '../../../../test-helpers/DocCommentBuilder';
7
7
 
@@ -1,7 +1,7 @@
1
1
  import { ParameterObjectBuilder } from '../ParameterObjectBuilder';
2
2
  import { Reference } from '../ReferenceBuilder';
3
- import { ReferenceObject } from '../../../../model/openapi/open-api-types';
4
- import { ApexDocParameterObject } from '../../../../model/openapi/apex-doc-types';
3
+ import { ReferenceObject } from '../../../../core/openapi/open-api-types';
4
+ import { ApexDocParameterObject } from '../../../../core/openapi/apex-doc-types';
5
5
 
6
6
  jest.mock('../ReferenceBuilder', () => {
7
7
  return {
@@ -1,8 +1,8 @@
1
- import { TypesRepository } from '../../../../model/types-repository';
1
+ import { TypesRepository } from '../../../../core/openapi/types-repository';
2
2
  import { ReferenceBuilder } from '../ReferenceBuilder';
3
3
  import { ClassMirrorBuilder } from '../../../../test-helpers/ClassMirrorBuilder';
4
4
  import { FieldMirrorBuilder } from '../../../../test-helpers/FieldMirrorBuilder';
5
- import { SchemaObjectArray, SchemaObjectObject } from '../../../../model/openapi/open-api-types';
5
+ import { SchemaObjectArray, SchemaObjectObject } from '../../../../core/openapi/open-api-types';
6
6
  import { DocCommentBuilder } from '../../../../test-helpers/DocCommentBuilder';
7
7
  import { DocCommentAnnotationBuilder } from '../../../../test-helpers/DocCommentAnnotationBuilder';
8
8
 
@@ -1,7 +1,7 @@
1
1
  import { RequestBodyBuilder } from '../RequestBodyBuilder';
2
2
  import { Reference } from '../ReferenceBuilder';
3
- import { ReferenceObject } from '../../../../model/openapi/open-api-types';
4
- import { ApexDocHttpRequestBody } from '../../../../model/openapi/apex-doc-types';
3
+ import { ReferenceObject } from '../../../../core/openapi/open-api-types';
4
+ import { ApexDocHttpRequestBody } from '../../../../core/openapi/apex-doc-types';
5
5
 
6
6
  jest.mock('../ReferenceBuilder', () => {
7
7
  return {
@@ -1,6 +1,6 @@
1
1
  import { ResponsesBuilder } from '../ResponsesBuilder';
2
2
  import { Reference } from '../ReferenceBuilder';
3
- import { ApexDocHttpResponse } from '../../../../model/openapi/apex-doc-types';
3
+ import { ApexDocHttpResponse } from '../../../../core/openapi/apex-doc-types';
4
4
 
5
5
  jest.mock('../ReferenceBuilder', () => {
6
6
  return {
@@ -1,24 +1,20 @@
1
1
  import { Type } from '@cparra/apex-reflection';
2
- import ProcessorTypeTranspiler from './processor-type-transpiler';
3
2
  import { Settings } from '../settings';
4
- import State from '../service/state';
3
+ import { OpenApiDocsProcessor } from './open-api-docs-processor';
5
4
 
6
5
  export default class Transpiler {
7
- static generate(types: Type[], processor: ProcessorTypeTranspiler): void {
6
+ static generate(types: Type[], processor: OpenApiDocsProcessor): void {
8
7
  const sortedTypes = types.sort((apexTypeA, apexTypeB) => {
9
8
  if (apexTypeA.name < apexTypeB.name) return -1;
10
9
  if (apexTypeA.name > apexTypeB.name) return 1;
11
10
  return 0;
12
11
  });
13
12
 
14
- processor.onBeforeProcess?.(sortedTypes);
15
-
16
13
  if (Settings.getInstance().indexOnly) {
17
14
  return;
18
15
  }
19
16
 
20
17
  sortedTypes.forEach((currentType) => {
21
- State.getInstance().setTypeBeingProcessed(currentType);
22
18
  processor.onProcess(currentType);
23
19
  });
24
20
  processor.onAfterProcess?.(sortedTypes);
@@ -4,7 +4,6 @@ export type TypeBundle = { type: Type; isChild: boolean; parentType?: Type };
4
4
 
5
5
  export class TypesRepository {
6
6
  private static instance: TypesRepository;
7
- private scopedTypes: Type[] = [];
8
7
  private allTypes: Type[] = [];
9
8
 
10
9
  public static getInstance(): TypesRepository {
@@ -52,12 +51,4 @@ export class TypesRepository {
52
51
  }
53
52
  return { type: foundType, isChild: false };
54
53
  }
55
-
56
- public populateScoped(types: Type[]) {
57
- this.scopedTypes = types;
58
- }
59
-
60
- public getFromScopedByName(typeName: string): Type | undefined {
61
- return this.scopedTypes.find((currentType: Type) => currentType.name === typeName);
62
- }
63
54
  }
@@ -0,0 +1,14 @@
1
+ import { XMLParser } from 'fast-xml-parser';
2
+
3
+ export function parseApexMetadata(input: string) {
4
+ const map = new Map<string, string>();
5
+ const xml = new XMLParser().parse(input);
6
+
7
+ map.set('apiVersion', xml.ApexClass.apiVersion ?? '');
8
+
9
+ if (xml.ApexClass.status) {
10
+ map.set('status', xml.ApexClass.status);
11
+ }
12
+
13
+ return map;
14
+ }
@@ -0,0 +1,56 @@
1
+ import { Generator } from './shared/types';
2
+
3
+ export interface SettingsConfig {
4
+ sourceDirectory: string;
5
+ scope: string[];
6
+ outputDir: string;
7
+ targetGenerator: Generator;
8
+ indexOnly: boolean;
9
+ defaultGroupName: string;
10
+ openApiTitle?: string;
11
+ namespace?: string;
12
+ openApiFileName: string;
13
+ includeMetadata: boolean;
14
+ sortMembersAlphabetically?: boolean;
15
+ }
16
+
17
+ export class Settings {
18
+ private static instance: Settings;
19
+
20
+ private constructor(public config: SettingsConfig) {}
21
+
22
+ public static build(config: SettingsConfig) {
23
+ Settings.instance = new Settings(config);
24
+ }
25
+
26
+ public static getInstance(): Settings {
27
+ if (!Settings.instance) {
28
+ throw new Error('Settings has not been initialized');
29
+ }
30
+ return Settings.instance;
31
+ }
32
+
33
+ get scope(): string[] {
34
+ return this.config.scope;
35
+ }
36
+
37
+ get targetGenerator(): Generator {
38
+ return this.config.targetGenerator;
39
+ }
40
+
41
+ get indexOnly(): boolean {
42
+ return this.config.indexOnly;
43
+ }
44
+
45
+ public getOpenApiTitle(): string | undefined {
46
+ return this.config.openApiTitle;
47
+ }
48
+
49
+ public getNamespace(): string | undefined {
50
+ return this.config.namespace;
51
+ }
52
+
53
+ public openApiFileName(): string {
54
+ return this.config.openApiFileName;
55
+ }
56
+ }