@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
|
@@ -3,10 +3,12 @@ export const documentablePartialTemplate = `
|
|
|
3
3
|
\`{{this}}\`
|
|
4
4
|
{{/each}}
|
|
5
5
|
|
|
6
|
-
{{
|
|
6
|
+
{{{renderContent doc.description}}}
|
|
7
7
|
|
|
8
8
|
{{#each doc.customTags}}
|
|
9
|
-
**{{splitAndCapitalize name}}**
|
|
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
|
|
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
|
-
{{
|
|
24
|
+
{{{renderContent doc.example.value}}}
|
|
23
25
|
{{/if}}
|
|
24
26
|
`.trim();
|
package/src/{transpiler/markdown/plain-markdown → core/markdown/templates}/fieldsPartialTemplate.ts
RENAMED
|
@@ -10,7 +10,7 @@ export const fieldsPartialTemplate = `
|
|
|
10
10
|
{{#> documentablePartialTemplate }}
|
|
11
11
|
|
|
12
12
|
{{ heading signature.headingLevel signature.heading }}
|
|
13
|
-
{{ code
|
|
13
|
+
{{ code signature.value }}
|
|
14
14
|
|
|
15
15
|
{{ heading type.headingLevel type.heading }}
|
|
16
16
|
{{link type.value}}
|
|
@@ -10,14 +10,14 @@ export const methodsPartialTemplate = `
|
|
|
10
10
|
{{#> documentablePartialTemplate}}
|
|
11
11
|
|
|
12
12
|
{{ heading signature.headingLevel signature.heading }}
|
|
13
|
-
{{ code
|
|
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}} | {{
|
|
20
|
+
| {{name}} | {{link type}} | {{{renderContent description}}} |
|
|
21
21
|
{{/each}}
|
|
22
22
|
{{/if}}
|
|
23
23
|
|
|
@@ -1,15 +1,15 @@
|
|
|
1
1
|
import Handlebars from 'handlebars';
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
4
|
-
import {
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
7
|
-
import {
|
|
8
|
-
import {
|
|
9
|
-
import {
|
|
10
|
-
import {
|
|
11
|
-
import {
|
|
12
|
-
import {
|
|
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('
|
|
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 = (
|
|
76
|
+
const convertCodeBlock = (codeBlock: CodeBlock): Handlebars.SafeString => {
|
|
77
77
|
return new Handlebars.SafeString(
|
|
78
78
|
`
|
|
79
|
-
\`\`\`${language}
|
|
80
|
-
${
|
|
79
|
+
\`\`\`${codeBlock.language}
|
|
80
|
+
${codeBlock.content.join('\n')}
|
|
81
81
|
\`\`\`
|
|
82
82
|
`.trim(),
|
|
83
83
|
);
|
|
84
84
|
};
|
|
85
85
|
|
|
86
|
-
const
|
|
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
|
|
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();
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { OpenApiDocsProcessor } from '../open-api-docs-processor';
|
|
2
|
-
import { Settings } from '
|
|
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 {
|
|
4
|
-
import { MethodMirrorBuilder } from '
|
|
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()
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import Manifest from '../
|
|
1
|
+
import Manifest from '../manifest';
|
|
2
2
|
import { TypeParser } from './parser';
|
|
3
3
|
import { ReflectionResult } from '@cparra/apex-reflection';
|
|
4
|
-
import
|
|
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:
|
|
13
|
+
reflect: (apexBundle: UnparsedSourceFile) => ReflectionResult,
|
|
14
14
|
): Manifest {
|
|
15
15
|
return new Manifest(typeParser.parse(reflect));
|
|
16
16
|
}
|
|
@@ -1,19 +1,17 @@
|
|
|
1
|
-
import
|
|
2
|
-
import { FileContainer } from '../file-container';
|
|
1
|
+
import { FileContainer } from './file-container';
|
|
3
2
|
import { ClassMirror, Type } from '@cparra/apex-reflection';
|
|
4
|
-
import {
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
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 '
|
|
7
|
+
import { camel2title } from '#utils/string-utils';
|
|
8
|
+
import { createOpenApiFile } from './openapi-type-file';
|
|
10
9
|
|
|
11
|
-
export class OpenApiDocsProcessor
|
|
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
|
-
|
|
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
|
|
3
|
-
import
|
|
4
|
-
import {
|
|
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:
|
|
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:
|
|
13
|
+
constructor(public typeBundles: UnparsedSourceFile[]) {}
|
|
14
14
|
|
|
15
|
-
parse(reflect: (apexBundle:
|
|
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.
|
|
20
|
+
if (!!result.typeMirror && !!currentBundle.metadataContent) {
|
|
21
21
|
// If successful and there is a metadata file
|
|
22
|
-
const metadataParams =
|
|
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 '../../../
|
|
3
|
-
import { SchemaObject } from '../../../
|
|
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 '../../../
|
|
2
|
+
import { OpenApi } from '../../../core/openapi/open-api';
|
|
3
3
|
import * as yaml from 'js-yaml';
|
|
4
|
-
import { ClassMirrorWrapper } from '../../../
|
|
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 '../../../
|
|
12
|
+
} from '../../../core/openapi/apex-doc-types';
|
|
13
13
|
import { RequestBodyBuilder } from './RequestBodyBuilder';
|
|
14
14
|
import { ApexDocSchemaAware } from './Builder';
|
|
15
|
-
import { PropertiesObject, ReferenceObject } from '../../../
|
|
16
|
-
import { MethodMirrorWrapper } from '../../../
|
|
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 '../../../
|
|
1
|
+
import { ParameterObject } from '../../../core/openapi/open-api-types';
|
|
2
2
|
import { Reference } from './ReferenceBuilder';
|
|
3
|
-
import { ApexDocParameterObject } from '../../../
|
|
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 '../../../
|
|
9
|
-
import { TypeBundle, TypesRepository } from '../../../
|
|
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 '../../../
|
|
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 '../../../
|
|
1
|
+
import { RequestBody } from '../../../core/openapi/open-api-types';
|
|
2
2
|
import { Reference } from './ReferenceBuilder';
|
|
3
|
-
import { ApexDocHttpRequestBody } from '../../../
|
|
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 '../../../
|
|
1
|
+
import { ResponseObject } from '../../../core/openapi/open-api-types';
|
|
2
2
|
import { Reference } from './ReferenceBuilder';
|
|
3
|
-
import { ApexDocHttpResponse } from '../../../
|
|
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 '../../../../
|
|
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 '../../../../
|
|
4
|
-
import { ApexDocParameterObject } from '../../../../
|
|
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 '../../../../
|
|
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 '../../../../
|
|
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 '../../../../
|
|
4
|
-
import { ApexDocHttpRequestBody } from '../../../../
|
|
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 '../../../../
|
|
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
|
|
3
|
+
import { OpenApiDocsProcessor } from './open-api-docs-processor';
|
|
5
4
|
|
|
6
5
|
export default class Transpiler {
|
|
7
|
-
static generate(types: Type[], processor:
|
|
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
|
+
}
|