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