@cparra/apexdocs 2.25.0-alpha.8 → 2.25.0
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/.eslintrc.js +12 -0
- package/README.md +12 -73
- package/apexdocs.config.ts +13 -0
- package/docs/.nojekyll +0 -0
- package/docs/README.md +1 -0
- package/docs/index.html +22 -0
- package/docs/restapi.json +589 -0
- package/docs/types/Classes/nspc.AnotherInterface.md +22 -0
- package/docs/types/Classes/nspc.ChildClass.md +97 -0
- package/docs/types/Main/nspc.GroupedClass.md +10 -0
- package/docs/types/Main/nspc.SampleClass.md +190 -0
- package/docs/types/Misc-Group/nspc.EscapedAnnotations.md +4 -0
- package/docs/types/Misc-Group/nspc.GrandparentClass.md +13 -0
- package/docs/types/Misc-Group/nspc.InterfaceWithInheritance.md +29 -0
- package/docs/types/Misc-Group/nspc.MemberGrouping.md +13 -0
- package/docs/types/Misc-Group/nspc.ParentClass.md +37 -0
- package/docs/types/Misc-Group/nspc.Reference1.md +18 -0
- package/docs/types/Misc-Group/nspc.Reference2.md +12 -0
- package/docs/types/Misc-Group/nspc.Reference3.md +7 -0
- package/docs/types/Misc-Group/nspc.Reference4.md +7 -0
- package/docs/types/Misc-Group/nspc.Reference5.md +7 -0
- package/docs/types/Misc-Group/nspc.Reference6.md +9 -0
- package/docs/types/Misc-Group/nspc.Reference7.md +7 -0
- package/docs/types/Misc-Group/nspc.SampleClassWithoutModifier.md +11 -0
- package/docs/types/Misc-Group/nspc.SampleRestResource.md +211 -0
- package/docs/types/Misc-Group/nspc.SampleRestResourceWithInnerClass.md +34 -0
- package/docs/types/Misc-Group/nspc.SampleRestResourceWithoutApexDocs.md +14 -0
- package/docs/types/README.md +97 -0
- package/docs/types/Sample-Interfaces/nspc.SampleInterface.md +23 -0
- package/examples/includes/header.md +3 -0
- package/jest.config.js +1 -6
- package/lib/application/Apexdocs.d.ts +13 -0
- package/lib/application/Apexdocs.js +77 -0
- package/lib/application/Apexdocs.js.map +1 -0
- package/lib/cli/generate.d.ts +2 -0
- package/lib/cli/generate.js +131 -0
- package/lib/cli/generate.js.map +1 -0
- package/lib/index.d.ts +1 -0
- package/lib/index.js +18 -0
- package/lib/index.js.map +1 -0
- package/lib/model/apex-bundle.d.ts +6 -0
- package/lib/model/apex-bundle.js +11 -0
- package/lib/model/apex-bundle.js.map +1 -0
- package/lib/model/apex-type-wrappers/ClassMirrorWrapper.d.ts +7 -0
- package/lib/model/apex-type-wrappers/ClassMirrorWrapper.js +14 -0
- package/lib/model/apex-type-wrappers/ClassMirrorWrapper.js.map +1 -0
- package/lib/model/apex-type-wrappers/MethodMirrorWrapper.d.ts +7 -0
- package/lib/model/apex-type-wrappers/MethodMirrorWrapper.js +12 -0
- package/lib/model/apex-type-wrappers/MethodMirrorWrapper.js.map +1 -0
- package/lib/model/inheritance.d.ts +8 -0
- package/lib/model/inheritance.js +3 -0
- package/lib/model/inheritance.js.map +1 -0
- package/lib/model/manifest-diff.d.ts +27 -0
- package/lib/model/manifest-diff.js +69 -0
- package/lib/model/manifest-diff.js.map +1 -0
- package/lib/model/manifest.d.ts +22 -0
- package/lib/model/manifest.js +47 -0
- package/lib/model/manifest.js.map +1 -0
- package/lib/model/markdown-file.d.ts +16 -0
- package/lib/model/markdown-file.js +107 -0
- package/lib/model/markdown-file.js.map +1 -0
- package/lib/model/markdown-generation-util/doc-comment-annotation-util.d.ts +8 -0
- package/lib/model/markdown-generation-util/doc-comment-annotation-util.js +44 -0
- package/lib/model/markdown-generation-util/doc-comment-annotation-util.js.map +1 -0
- package/lib/model/markdown-generation-util/field-declaration-util.d.ts +3 -0
- package/lib/model/markdown-generation-util/field-declaration-util.js +55 -0
- package/lib/model/markdown-generation-util/field-declaration-util.js.map +1 -0
- package/lib/model/markdown-generation-util/index.d.ts +3 -0
- package/lib/model/markdown-generation-util/index.js +20 -0
- package/lib/model/markdown-generation-util/index.js.map +1 -0
- package/lib/model/markdown-generation-util/method-declaration-util.d.ts +4 -0
- package/lib/model/markdown-generation-util/method-declaration-util.js +115 -0
- package/lib/model/markdown-generation-util/method-declaration-util.js.map +1 -0
- package/lib/model/markdown-generation-util/type-declaration-util.d.ts +3 -0
- package/lib/model/markdown-generation-util/type-declaration-util.js +82 -0
- package/lib/model/markdown-generation-util/type-declaration-util.js.map +1 -0
- package/lib/model/markdown-home-file.d.ts +11 -0
- package/lib/model/markdown-home-file.js +54 -0
- package/lib/model/markdown-home-file.js.map +1 -0
- package/lib/model/markdown-type-file.d.ts +26 -0
- package/lib/model/markdown-type-file.js +134 -0
- package/lib/model/markdown-type-file.js.map +1 -0
- package/lib/model/openapi/apex-doc-types.d.ts +19 -0
- package/lib/model/openapi/apex-doc-types.js +5 -0
- package/lib/model/openapi/apex-doc-types.js.map +1 -0
- package/lib/model/openapi/open-api-types.d.ts +93 -0
- package/lib/model/openapi/open-api-types.js +3 -0
- package/lib/model/openapi/open-api-types.js.map +1 -0
- package/lib/model/openapi/open-api.d.ts +16 -0
- package/lib/model/openapi/open-api.js +34 -0
- package/lib/model/openapi/open-api.js.map +1 -0
- package/lib/model/openapi/openapi-type-file.d.ts +7 -0
- package/lib/model/openapi/openapi-type-file.js +17 -0
- package/lib/model/openapi/openapi-type-file.js.map +1 -0
- package/lib/model/outputFile.d.ts +10 -0
- package/lib/model/outputFile.js +29 -0
- package/lib/model/outputFile.js.map +1 -0
- package/lib/model/types-repository.d.ts +16 -0
- package/lib/model/types-repository.js +54 -0
- package/lib/model/types-repository.js.map +1 -0
- package/lib/service/apex-file-reader.d.ts +14 -0
- package/lib/service/apex-file-reader.js +46 -0
- package/lib/service/apex-file-reader.js.map +1 -0
- package/lib/service/file-system.d.ts +14 -0
- package/lib/service/file-system.js +25 -0
- package/lib/service/file-system.js.map +1 -0
- package/lib/service/file-writer.d.ts +6 -0
- package/lib/service/file-writer.js +34 -0
- package/lib/service/file-writer.js.map +1 -0
- package/lib/service/manifest-factory.d.ts +10 -0
- package/lib/service/manifest-factory.js +14 -0
- package/lib/service/manifest-factory.js.map +1 -0
- package/lib/service/metadata-processor.d.ts +3 -0
- package/lib/service/metadata-processor.js +17 -0
- package/lib/service/metadata-processor.js.map +1 -0
- package/lib/service/parser.d.ts +21 -0
- package/lib/service/parser.js +135 -0
- package/lib/service/parser.js.map +1 -0
- package/lib/service/state.d.ts +9 -0
- package/lib/service/state.js +20 -0
- package/lib/service/state.js.map +1 -0
- package/lib/service/walkers/class-walker.d.ts +4 -0
- package/lib/service/walkers/class-walker.js +33 -0
- package/lib/service/walkers/class-walker.js.map +1 -0
- package/lib/service/walkers/enum-walker.d.ts +4 -0
- package/lib/service/walkers/enum-walker.js +11 -0
- package/lib/service/walkers/enum-walker.js.map +1 -0
- package/lib/service/walkers/interface-walker.d.ts +4 -0
- package/lib/service/walkers/interface-walker.js +15 -0
- package/lib/service/walkers/interface-walker.js.map +1 -0
- package/lib/service/walkers/walker-factory.d.ts +5 -0
- package/lib/service/walkers/walker-factory.js +21 -0
- package/lib/service/walkers/walker-factory.js.map +1 -0
- package/lib/service/walkers/walker.d.ts +19 -0
- package/lib/service/walkers/walker.js +17 -0
- package/lib/service/walkers/walker.js.map +1 -0
- package/lib/settings.d.ts +64 -0
- package/lib/settings.js +89 -0
- package/lib/settings.js.map +1 -0
- package/lib/test-helpers/AnnotationBuilder.d.ts +12 -0
- package/lib/test-helpers/AnnotationBuilder.js +31 -0
- package/lib/test-helpers/AnnotationBuilder.js.map +1 -0
- package/lib/test-helpers/ClassMirrorBuilder.d.ts +18 -0
- package/lib/test-helpers/ClassMirrorBuilder.js +54 -0
- package/lib/test-helpers/ClassMirrorBuilder.js.map +1 -0
- package/lib/test-helpers/DocCommentAnnotationBuilder.d.ts +8 -0
- package/lib/test-helpers/DocCommentAnnotationBuilder.js +26 -0
- package/lib/test-helpers/DocCommentAnnotationBuilder.js.map +1 -0
- package/lib/test-helpers/DocCommentBuilder.d.ts +12 -0
- package/lib/test-helpers/DocCommentBuilder.js +38 -0
- package/lib/test-helpers/DocCommentBuilder.js.map +1 -0
- package/lib/test-helpers/FieldMirrorBuilder.d.ts +18 -0
- package/lib/test-helpers/FieldMirrorBuilder.js +54 -0
- package/lib/test-helpers/FieldMirrorBuilder.js.map +1 -0
- package/lib/test-helpers/MethodMirrorBuilder.d.ts +10 -0
- package/lib/test-helpers/MethodMirrorBuilder.js +37 -0
- package/lib/test-helpers/MethodMirrorBuilder.js.map +1 -0
- package/lib/test-helpers/SettingsBuilder.d.ts +8 -0
- package/lib/test-helpers/SettingsBuilder.js +27 -0
- package/lib/test-helpers/SettingsBuilder.js.map +1 -0
- package/lib/transpiler/factory.d.ts +6 -0
- package/lib/transpiler/factory.js +32 -0
- package/lib/transpiler/factory.js.map +1 -0
- package/lib/transpiler/file-container.d.ts +6 -0
- package/lib/transpiler/file-container.js +16 -0
- package/lib/transpiler/file-container.js.map +1 -0
- package/lib/transpiler/generator-choices.d.ts +1 -0
- package/lib/transpiler/generator-choices.js +3 -0
- package/lib/transpiler/generator-choices.js.map +1 -0
- package/lib/transpiler/markdown/class-file-generatorHelper.d.ts +8 -0
- package/lib/transpiler/markdown/class-file-generatorHelper.js +56 -0
- package/lib/transpiler/markdown/class-file-generatorHelper.js.map +1 -0
- package/lib/transpiler/markdown/docsify/docsify-docs-processor.d.ts +6 -0
- package/lib/transpiler/markdown/docsify/docsify-docs-processor.js +13 -0
- package/lib/transpiler/markdown/docsify/docsify-docs-processor.js.map +1 -0
- package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.d.ts +11 -0
- package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.js +51 -0
- package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.js.map +1 -0
- package/lib/transpiler/markdown/markdown-transpiler-base.d.ts +11 -0
- package/lib/transpiler/markdown/markdown-transpiler-base.js +24 -0
- package/lib/transpiler/markdown/markdown-transpiler-base.js.map +1 -0
- package/lib/transpiler/markdown/plain-markdown/plain-docsProcessor.d.ts +6 -0
- package/lib/transpiler/markdown/plain-markdown/plain-docsProcessor.js +14 -0
- package/lib/transpiler/markdown/plain-markdown/plain-docsProcessor.js.map +1 -0
- package/lib/transpiler/openapi/open-api-docs-processor.d.ts +13 -0
- package/lib/transpiler/openapi/open-api-docs-processor.js +75 -0
- package/lib/transpiler/openapi/open-api-docs-processor.js.map +1 -0
- package/lib/transpiler/openapi/parsers/Builder.d.ts +16 -0
- package/lib/transpiler/openapi/parsers/Builder.js +30 -0
- package/lib/transpiler/openapi/parsers/Builder.js.map +1 -0
- package/lib/transpiler/openapi/parsers/MethodParser.d.ts +20 -0
- package/lib/transpiler/openapi/parsers/MethodParser.js +167 -0
- package/lib/transpiler/openapi/parsers/MethodParser.js.map +1 -0
- package/lib/transpiler/openapi/parsers/ParameterObjectBuilder.d.ts +7 -0
- package/lib/transpiler/openapi/parsers/ParameterObjectBuilder.js +11 -0
- package/lib/transpiler/openapi/parsers/ParameterObjectBuilder.js.map +1 -0
- package/lib/transpiler/openapi/parsers/ReferenceBuilder.d.ts +39 -0
- package/lib/transpiler/openapi/parsers/ReferenceBuilder.js +226 -0
- package/lib/transpiler/openapi/parsers/ReferenceBuilder.js.map +1 -0
- package/lib/transpiler/openapi/parsers/RequestBodyBuilder.d.ts +10 -0
- package/lib/transpiler/openapi/parsers/RequestBodyBuilder.js +20 -0
- package/lib/transpiler/openapi/parsers/RequestBodyBuilder.js.map +1 -0
- package/lib/transpiler/openapi/parsers/ResponsesBuilder.d.ts +7 -0
- package/lib/transpiler/openapi/parsers/ResponsesBuilder.js +22 -0
- package/lib/transpiler/openapi/parsers/ResponsesBuilder.js.map +1 -0
- package/lib/transpiler/processor-type-transpiler.d.ts +10 -0
- package/lib/transpiler/processor-type-transpiler.js +9 -0
- package/lib/transpiler/processor-type-transpiler.js.map +1 -0
- package/lib/transpiler/transpiler.d.ts +5 -0
- package/lib/transpiler/transpiler.js +27 -0
- package/lib/transpiler/transpiler.js.map +1 -0
- package/lib/util/error-logger.d.ts +8 -0
- package/lib/util/error-logger.js +90 -0
- package/lib/util/error-logger.js.map +1 -0
- package/lib/util/logger.d.ts +21 -0
- package/lib/util/logger.js +58 -0
- package/lib/util/logger.js.map +1 -0
- package/lib/util/string-utils.d.ts +2 -0
- package/lib/util/string-utils.js +15 -0
- package/lib/util/string-utils.js.map +1 -0
- package/package.json +36 -35
- package/src/application/Apexdocs.ts +70 -17
- package/src/cli/generate.ts +131 -10
- package/src/index.ts +1 -35
- package/src/model/__tests__/manifest-diff.spec.ts +147 -0
- package/src/model/apex-bundle.ts +3 -0
- package/src/{core/openapi → model}/apex-type-wrappers/__tests__/ClassMirrorWrapper.spec.ts +3 -3
- package/src/model/inheritance.ts +7 -0
- package/src/model/manifest-diff.ts +94 -0
- package/src/model/manifest.ts +74 -0
- package/src/model/markdown-file.ts +121 -0
- package/src/model/markdown-generation-util/doc-comment-annotation-util.ts +50 -0
- package/src/model/markdown-generation-util/field-declaration-util.ts +71 -0
- package/src/model/markdown-generation-util/index.ts +3 -0
- package/src/model/markdown-generation-util/method-declaration-util.ts +166 -0
- package/src/model/markdown-generation-util/type-declaration-util.ts +91 -0
- package/src/model/markdown-home-file.ts +58 -0
- package/src/model/markdown-type-file.ts +165 -0
- package/src/{core → model}/openapi/open-api-types.ts +2 -2
- package/src/model/openapi/openapi-type-file.ts +14 -0
- package/src/model/outputFile.ts +29 -0
- package/src/{core/openapi → model}/types-repository.ts +9 -0
- package/src/service/__tests__/apex-file-reader.spec.ts +92 -0
- package/src/{core/openapi → service}/__tests__/manifest-factory.spec.ts +2 -1
- package/src/service/apex-file-reader.ts +51 -0
- package/src/service/file-writer.ts +34 -0
- package/src/{core/openapi → service}/manifest-factory.ts +3 -3
- package/src/service/metadata-processor.ts +16 -0
- package/src/{core/openapi → service}/parser.ts +9 -9
- package/src/service/state.ts +24 -0
- package/src/service/walkers/class-walker.ts +30 -0
- package/src/service/walkers/enum-walker.ts +7 -0
- package/src/service/walkers/interface-walker.ts +12 -0
- package/src/service/walkers/walker-factory.ts +19 -0
- package/src/service/walkers/walker.ts +42 -0
- package/src/settings.ts +147 -0
- package/src/test-helpers/ClassMirrorBuilder.ts +1 -14
- package/src/test-helpers/FieldMirrorBuilder.ts +1 -1
- package/src/test-helpers/MethodMirrorBuilder.ts +6 -46
- package/src/test-helpers/SettingsBuilder.ts +4 -1
- package/src/transpiler/factory.ts +33 -0
- package/src/transpiler/file-container.ts +13 -0
- package/src/transpiler/generator-choices.ts +1 -0
- package/src/transpiler/markdown/class-file-generatorHelper.ts +58 -0
- package/src/transpiler/markdown/docsify/docsify-docs-processor.ts +12 -0
- package/src/transpiler/markdown/jekyll/jekyll-docsProcessor.ts +50 -0
- package/src/transpiler/markdown/markdown-transpiler-base.ts +28 -0
- package/src/transpiler/markdown/plain-markdown/plain-docsProcessor.ts +12 -0
- package/src/{core → transpiler}/openapi/__tests__/open-api-docs-processor.spec.ts +1 -1
- package/src/{core → transpiler}/openapi/open-api-docs-processor.ts +10 -9
- package/src/{core → transpiler}/openapi/parsers/Builder.ts +3 -3
- package/src/{core → transpiler}/openapi/parsers/MethodParser.ts +6 -6
- package/src/{core → transpiler}/openapi/parsers/ParameterObjectBuilder.ts +2 -2
- package/src/{core → transpiler}/openapi/parsers/ReferenceBuilder.ts +6 -7
- package/src/{core → transpiler}/openapi/parsers/RequestBodyBuilder.ts +2 -2
- package/src/{core → transpiler}/openapi/parsers/ResponsesBuilder.ts +2 -2
- package/src/{core → transpiler}/openapi/parsers/__tests__/MethodParser.spec.ts +1 -1
- package/src/{core → transpiler}/openapi/parsers/__tests__/ParameterObjectBuilder.spec.ts +2 -2
- package/src/{core → transpiler}/openapi/parsers/__tests__/ReferenceBuilder.spec.ts +2 -2
- package/src/{core → transpiler}/openapi/parsers/__tests__/RequestBodyBuilder.spec.ts +2 -2
- package/src/{core → transpiler}/openapi/parsers/__tests__/ResponsesBuilder.spec.ts +1 -1
- package/src/transpiler/processor-type-transpiler.ts +18 -0
- package/src/{core/openapi → transpiler}/transpiler.ts +6 -2
- package/src/util/error-logger.ts +4 -4
- package/src/util/logger.ts +6 -6
- package/src/util/string-utils.ts +4 -0
- package/tsconfig.json +3 -8
- package/.github/workflows/ci.yaml +0 -22
- package/__mocks__/chalk.js +0 -12
- package/__mocks__/log-update.js +0 -6
- package/dist/cli/generate.js +0 -2976
- package/dist/defaults-DUwru49Q.js +0 -12
- package/dist/defaults-SH0Rsi5E.js +0 -11
- package/dist/index.d.ts +0 -62
- package/dist/index.js +0 -36
- package/eslint.config.mjs +0 -10
- package/examples/plain-markdown/.forceignore +0 -12
- package/examples/plain-markdown/config/project-scratch-def.json +0 -5
- package/examples/plain-markdown/docs/Miscellaneous/ns.BaseClass.md +0 -16
- package/examples/plain-markdown/docs/Miscellaneous/ns.MultiInheritanceClass.md +0 -73
- package/examples/plain-markdown/docs/Miscellaneous/ns.ParentInterface.md +0 -15
- package/examples/plain-markdown/docs/Miscellaneous/ns.ReferencedEnum.md +0 -8
- package/examples/plain-markdown/docs/Miscellaneous/ns.SampleException.md +0 -25
- package/examples/plain-markdown/docs/Miscellaneous/ns.SampleInterface.md +0 -119
- package/examples/plain-markdown/docs/Miscellaneous/ns.Url.md +0 -320
- package/examples/plain-markdown/docs/Sample-Enums/ns.SampleEnum.md +0 -38
- package/examples/plain-markdown/docs/SampleGroup/ns.SampleClass.md +0 -173
- package/examples/plain-markdown/docs/index.md +0 -117
- package/examples/plain-markdown/force-app/classes/BaseClass.cls +0 -3
- package/examples/plain-markdown/force-app/classes/MultiInheritanceClass.cls +0 -1
- package/examples/plain-markdown/force-app/classes/ParentInterface.cls +0 -3
- package/examples/plain-markdown/force-app/classes/ReferencedEnum.cls +0 -3
- package/examples/plain-markdown/force-app/classes/SampleClass.cls +0 -72
- package/examples/plain-markdown/force-app/classes/SampleEnum.cls +0 -30
- package/examples/plain-markdown/force-app/classes/SampleException.cls +0 -17
- package/examples/plain-markdown/force-app/classes/SampleInterface.cls +0 -46
- package/examples/plain-markdown/force-app/classes/Url.cls +0 -194
- package/examples/plain-markdown/package-lock.json +0 -665
- package/examples/plain-markdown/package.json +0 -20
- package/examples/plain-markdown/sfdx-project.json +0 -12
- package/examples/vitepress/.forceignore +0 -12
- package/examples/vitepress/apexdocs.config.ts +0 -108
- package/examples/vitepress/config/project-scratch-def.json +0 -13
- package/examples/vitepress/docs/.vitepress/cache/deps/@theme_index.js +0 -259
- package/examples/vitepress/docs/.vitepress/cache/deps/@theme_index.js.map +0 -7
- package/examples/vitepress/docs/.vitepress/cache/deps/_metadata.json +0 -40
- package/examples/vitepress/docs/.vitepress/cache/deps/chunk-574YRH25.js +0 -11474
- package/examples/vitepress/docs/.vitepress/cache/deps/chunk-574YRH25.js.map +0 -7
- package/examples/vitepress/docs/.vitepress/cache/deps/chunk-E5DZZB2I.js +0 -9172
- package/examples/vitepress/docs/.vitepress/cache/deps/chunk-E5DZZB2I.js.map +0 -7
- package/examples/vitepress/docs/.vitepress/cache/deps/package.json +0 -3
- package/examples/vitepress/docs/.vitepress/cache/deps/vitepress___@vue_devtools-api.js +0 -4339
- package/examples/vitepress/docs/.vitepress/cache/deps/vitepress___@vue_devtools-api.js.map +0 -7
- package/examples/vitepress/docs/.vitepress/cache/deps/vitepress___@vueuse_core.js +0 -567
- package/examples/vitepress/docs/.vitepress/cache/deps/vitepress___@vueuse_core.js.map +0 -7
- package/examples/vitepress/docs/.vitepress/cache/deps/vue.js +0 -323
- package/examples/vitepress/docs/.vitepress/cache/deps/vue.js.map +0 -7
- package/examples/vitepress/docs/.vitepress/config.mts +0 -21
- package/examples/vitepress/docs/.vitepress/sidebar.json +0 -119
- package/examples/vitepress/docs/Miscellaneous/apexdocs.BaseClass.md +0 -20
- package/examples/vitepress/docs/Miscellaneous/apexdocs.MultiInheritanceClass.md +0 -76
- package/examples/vitepress/docs/Miscellaneous/apexdocs.ParentInterface.md +0 -19
- package/examples/vitepress/docs/Miscellaneous/apexdocs.ReferencedEnum.md +0 -15
- package/examples/vitepress/docs/Miscellaneous/apexdocs.SampleException.md +0 -28
- package/examples/vitepress/docs/Miscellaneous/apexdocs.SampleInterface.md +0 -116
- package/examples/vitepress/docs/Miscellaneous/apexdocs.Url.md +0 -317
- package/examples/vitepress/docs/Sample-Enums/apexdocs.SampleEnum.md +0 -40
- package/examples/vitepress/docs/SampleGroup/apexdocs.SampleClass.md +0 -174
- package/examples/vitepress/docs/api-examples.md +0 -49
- package/examples/vitepress/docs/index-frontmatter.md +0 -16
- package/examples/vitepress/docs/index.md +0 -56
- package/examples/vitepress/docs/markdown-examples.md +0 -85
- package/examples/vitepress/force-app/main/default/classes/BaseClass.cls +0 -3
- package/examples/vitepress/force-app/main/default/classes/MultiInheritanceClass.cls +0 -1
- package/examples/vitepress/force-app/main/default/classes/ParentInterface.cls +0 -3
- package/examples/vitepress/force-app/main/default/classes/ReferencedEnum.cls +0 -5
- package/examples/vitepress/force-app/main/default/classes/SampleClass.cls +0 -72
- package/examples/vitepress/force-app/main/default/classes/SampleEnum.cls +0 -30
- package/examples/vitepress/force-app/main/default/classes/SampleException.cls +0 -17
- package/examples/vitepress/force-app/main/default/classes/SampleInterface.cls +0 -46
- package/examples/vitepress/force-app/main/default/classes/Url.cls +0 -198
- package/examples/vitepress/package-lock.json +0 -2574
- package/examples/vitepress/package.json +0 -18
- package/examples/vitepress/sfdx-project.json +0 -12
- package/jest.d.ts +0 -7
- package/src/application/__tests__/apex-file-reader.spec.ts +0 -104
- package/src/application/apex-file-reader.ts +0 -42
- package/src/application/file-writer.ts +0 -25
- package/src/application/generators/markdown.ts +0 -53
- package/src/application/generators/openapi.ts +0 -56
- package/src/cli/args.ts +0 -43
- package/src/cli/commands/markdown.ts +0 -58
- package/src/core/manifest.ts +0 -90
- package/src/core/markdown/__test__/expect-extensions.ts +0 -32
- package/src/core/markdown/__test__/generating-class-docs.spec.ts +0 -733
- package/src/core/markdown/__test__/generating-enum-docs.spec.ts +0 -385
- package/src/core/markdown/__test__/generating-interface-docs.spec.ts +0 -459
- package/src/core/markdown/__test__/generating-reference-guide.spec.ts +0 -184
- package/src/core/markdown/__test__/inheritance-chain.test.ts +0 -54
- package/src/core/markdown/__test__/test-helpers.ts +0 -22
- package/src/core/markdown/adapters/__tests__/documentables.spec.ts +0 -109
- package/src/core/markdown/adapters/__tests__/interface-adapter.spec.ts +0 -112
- package/src/core/markdown/adapters/__tests__/references.spec.ts +0 -136
- package/src/core/markdown/adapters/apex-types.ts +0 -237
- package/src/core/markdown/adapters/documentables.ts +0 -116
- package/src/core/markdown/adapters/fields-and-properties.ts +0 -45
- package/src/core/markdown/adapters/inline.ts +0 -143
- package/src/core/markdown/adapters/methods-and-constructors.ts +0 -133
- package/src/core/markdown/adapters/renderable-bundle.ts +0 -144
- package/src/core/markdown/adapters/renderable-to-page-data.ts +0 -92
- package/src/core/markdown/adapters/type-utils.ts +0 -13
- package/src/core/markdown/adapters/types.d.ts +0 -182
- package/src/core/markdown/generate-docs.ts +0 -158
- package/src/core/markdown/reflection/error-handling.ts +0 -37
- package/src/core/markdown/reflection/filter-scope.ts +0 -13
- package/src/core/markdown/reflection/inheritance-chain-expanion.ts +0 -22
- package/src/core/markdown/reflection/inheritance-chain.ts +0 -23
- package/src/core/markdown/reflection/inherited-member-expansion.ts +0 -105
- package/src/core/markdown/reflection/reflect-source.ts +0 -41
- package/src/core/markdown/reflection/sort-members.ts +0 -59
- package/src/core/markdown/templates/class-template.ts +0 -75
- package/src/core/markdown/templates/constructors-partial-template.ts +0 -32
- package/src/core/markdown/templates/documentable-partial-template.ts +0 -26
- package/src/core/markdown/templates/enum-template.ts +0 -12
- package/src/core/markdown/templates/fieldsPartialTemplate.ts +0 -23
- package/src/core/markdown/templates/grouped-members-partial-template.ts +0 -6
- package/src/core/markdown/templates/hookable.ts +0 -7
- package/src/core/markdown/templates/interface-template.ts +0 -16
- package/src/core/markdown/templates/methods-partial-template.ts +0 -43
- package/src/core/markdown/templates/reference-guide.ts +0 -14
- package/src/core/markdown/templates/template.ts +0 -114
- package/src/core/markdown/templates/type-doc-partial.ts +0 -27
- package/src/core/markdown/utils.ts +0 -3
- package/src/core/openapi/file-container.ts +0 -13
- package/src/core/openapi/openapi-type-file.ts +0 -14
- package/src/core/parse-apex-metadata.ts +0 -14
- package/src/core/settings.ts +0 -56
- package/src/core/shared/types.d.ts +0 -92
- package/src/core/shared/utils.ts +0 -5
- package/src/defaults.ts +0 -8
- package/src/test-helpers/InterfaceMirrorBuilder.ts +0 -39
- package/src/util/fp.ts +0 -3
- /package/src/{core/__test__ → model/__tests__}/manifest.spec.ts +0 -0
- /package/src/{core/openapi → model}/apex-type-wrappers/ClassMirrorWrapper.ts +0 -0
- /package/src/{core/openapi → model}/apex-type-wrappers/MethodMirrorWrapper.ts +0 -0
- /package/src/{core → model}/openapi/__tests__/open-api.spec.ts +0 -0
- /package/src/{core → model}/openapi/apex-doc-types.ts +0 -0
- /package/src/{core → model}/openapi/open-api.ts +0 -0
- /package/src/{application → service}/file-system.ts +0 -0
package/dist/index.d.ts
DELETED
|
@@ -1,62 +0,0 @@
|
|
|
1
|
-
import { SetOptional } from 'type-fest';
|
|
2
|
-
|
|
3
|
-
type ConfigurableHooks = {
|
|
4
|
-
transformReferenceGuide: TransformReferenceGuide;
|
|
5
|
-
transformDocs: TransformDocs;
|
|
6
|
-
transformDocPage: TransformDocPage;
|
|
7
|
-
};
|
|
8
|
-
|
|
9
|
-
type UserDefinedMarkdownConfig = {
|
|
10
|
-
targetGenerator: 'markdown';
|
|
11
|
-
sourceDir: string;
|
|
12
|
-
targetDir: string;
|
|
13
|
-
scope: string[];
|
|
14
|
-
defaultGroupName: string;
|
|
15
|
-
namespace?: string;
|
|
16
|
-
sortMembersAlphabetically: boolean;
|
|
17
|
-
includeMetadata: boolean;
|
|
18
|
-
} & Partial<ConfigurableHooks>;
|
|
19
|
-
|
|
20
|
-
type Frontmatter = string | Record<string, unknown> | null;
|
|
21
|
-
|
|
22
|
-
type ReferenceGuidePageData = {
|
|
23
|
-
directory: string;
|
|
24
|
-
frontmatter: Frontmatter;
|
|
25
|
-
content: string;
|
|
26
|
-
fileExtension: string;
|
|
27
|
-
fileName: string;
|
|
28
|
-
};
|
|
29
|
-
|
|
30
|
-
type DocPageData = {
|
|
31
|
-
source: {
|
|
32
|
-
filePath: string;
|
|
33
|
-
name: string;
|
|
34
|
-
type: 'interface' | 'class' | 'enum';
|
|
35
|
-
};
|
|
36
|
-
group: string | null;
|
|
37
|
-
fileName: string;
|
|
38
|
-
fileExtension: string;
|
|
39
|
-
directory: string;
|
|
40
|
-
frontmatter: Frontmatter;
|
|
41
|
-
content: string;
|
|
42
|
-
};
|
|
43
|
-
|
|
44
|
-
type Skip = {
|
|
45
|
-
readonly _tag: 'Skip';
|
|
46
|
-
};
|
|
47
|
-
|
|
48
|
-
// Configurable Hooks
|
|
49
|
-
|
|
50
|
-
type TransformReferenceGuide = (
|
|
51
|
-
referenceGuide: ReferenceGuidePageData,
|
|
52
|
-
) => Partial<ReferenceGuidePageData> | Skip | Promise<Partial<ReferenceGuidePageData> | Skip>;
|
|
53
|
-
|
|
54
|
-
type TransformDocs = (docs: DocPageData[]) => DocPageData[] | Promise<DocPageData[]>;
|
|
55
|
-
|
|
56
|
-
type TransformDocPage = (doc: DocPageData) => Partial<DocPageData> | Promise<Partial<DocPageData>>;
|
|
57
|
-
|
|
58
|
-
type ConfigurableMarkdownConfig = Omit<SetOptional<UserDefinedMarkdownConfig, 'targetDir' | 'scope' | 'defaultGroupName' | 'includeMetadata' | 'sortMembersAlphabetically'>, 'targetGenerator'>;
|
|
59
|
-
declare function defineMarkdownConfig(config: ConfigurableMarkdownConfig): UserDefinedMarkdownConfig;
|
|
60
|
-
declare function skip(): Skip;
|
|
61
|
-
|
|
62
|
-
export { type ConfigurableHooks, type DocPageData, type ReferenceGuidePageData, defineMarkdownConfig, skip };
|
package/dist/index.js
DELETED
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
'use strict';
|
|
2
|
-
|
|
3
|
-
var defaults = require('./defaults-DUwru49Q.js');
|
|
4
|
-
|
|
5
|
-
var __defProp = Object.defineProperty;
|
|
6
|
-
var __defProps = Object.defineProperties;
|
|
7
|
-
var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
|
|
8
|
-
var __getOwnPropSymbols = Object.getOwnPropertySymbols;
|
|
9
|
-
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
10
|
-
var __propIsEnum = Object.prototype.propertyIsEnumerable;
|
|
11
|
-
var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
|
|
12
|
-
var __spreadValues = (a, b) => {
|
|
13
|
-
for (var prop in b || (b = {}))
|
|
14
|
-
if (__hasOwnProp.call(b, prop))
|
|
15
|
-
__defNormalProp(a, prop, b[prop]);
|
|
16
|
-
if (__getOwnPropSymbols)
|
|
17
|
-
for (var prop of __getOwnPropSymbols(b)) {
|
|
18
|
-
if (__propIsEnum.call(b, prop))
|
|
19
|
-
__defNormalProp(a, prop, b[prop]);
|
|
20
|
-
}
|
|
21
|
-
return a;
|
|
22
|
-
};
|
|
23
|
-
var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
|
|
24
|
-
function defineMarkdownConfig(config) {
|
|
25
|
-
return __spreadProps(__spreadValues(__spreadValues({}, defaults.defaults), config), {
|
|
26
|
-
targetGenerator: "markdown"
|
|
27
|
-
});
|
|
28
|
-
}
|
|
29
|
-
function skip() {
|
|
30
|
-
return {
|
|
31
|
-
_tag: "Skip"
|
|
32
|
-
};
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
exports.defineMarkdownConfig = defineMarkdownConfig;
|
|
36
|
-
exports.skip = skip;
|
package/eslint.config.mjs
DELETED
|
@@ -1,10 +0,0 @@
|
|
|
1
|
-
// @ts-check
|
|
2
|
-
|
|
3
|
-
import eslint from '@eslint/js';
|
|
4
|
-
import tseslint from 'typescript-eslint';
|
|
5
|
-
import eslintConfigPrettier from "eslint-config-prettier";
|
|
6
|
-
|
|
7
|
-
export default tseslint.config(
|
|
8
|
-
eslint.configs.recommended,
|
|
9
|
-
...tseslint.configs.recommended,
|
|
10
|
-
eslintConfigPrettier);
|
|
@@ -1,12 +0,0 @@
|
|
|
1
|
-
# List files or directories below to ignore them when running force:source:push, force:source:pull, and force:source:status
|
|
2
|
-
# More information: https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_exclude_source.htm
|
|
3
|
-
#
|
|
4
|
-
|
|
5
|
-
package.xml
|
|
6
|
-
|
|
7
|
-
# LWC configuration files
|
|
8
|
-
**/jsconfig.json
|
|
9
|
-
**/.eslintrc.json
|
|
10
|
-
|
|
11
|
-
# LWC Jest
|
|
12
|
-
**/__tests__/**
|
|
@@ -1,73 +0,0 @@
|
|
|
1
|
-
# MultiInheritanceClass Class
|
|
2
|
-
|
|
3
|
-
## Namespace
|
|
4
|
-
ns
|
|
5
|
-
|
|
6
|
-
**Inheritance**
|
|
7
|
-
[ns.SampleClass](../SampleGroup/ns.SampleClass.md) < [ns.BaseClass](./ns.BaseClass.md)
|
|
8
|
-
|
|
9
|
-
## Fields
|
|
10
|
-
### `sampleEnumFromBase`
|
|
11
|
-
|
|
12
|
-
*Inherited*
|
|
13
|
-
|
|
14
|
-
#### Signature
|
|
15
|
-
```apex
|
|
16
|
-
public sampleEnumFromBase
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
#### Type
|
|
20
|
-
[ns.SampleEnum](../Sample-Enums/ns.SampleEnum.md)
|
|
21
|
-
|
|
22
|
-
## Properties
|
|
23
|
-
### Group Name
|
|
24
|
-
#### `someProperty`
|
|
25
|
-
|
|
26
|
-
*Inherited*
|
|
27
|
-
|
|
28
|
-
##### Signature
|
|
29
|
-
```apex
|
|
30
|
-
public someProperty
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
##### Type
|
|
34
|
-
String
|
|
35
|
-
|
|
36
|
-
## Methods
|
|
37
|
-
### Available Methods
|
|
38
|
-
#### `doSomething()`
|
|
39
|
-
|
|
40
|
-
*Inherited*
|
|
41
|
-
|
|
42
|
-
##### Signature
|
|
43
|
-
```apex
|
|
44
|
-
public void doSomething()
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
##### Return Type
|
|
48
|
-
**void**
|
|
49
|
-
|
|
50
|
-
### Deprecated Methods
|
|
51
|
-
#### `sayHello()`
|
|
52
|
-
|
|
53
|
-
*Inherited*
|
|
54
|
-
|
|
55
|
-
`DEPRECATED`
|
|
56
|
-
|
|
57
|
-
This is a sample method.
|
|
58
|
-
|
|
59
|
-
##### Signature
|
|
60
|
-
```apex
|
|
61
|
-
public virtual String sayHello()
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
##### Return Type
|
|
65
|
-
**String**
|
|
66
|
-
|
|
67
|
-
A string value.
|
|
68
|
-
|
|
69
|
-
##### Example
|
|
70
|
-
```apex
|
|
71
|
-
SampleClass sample = new SampleClass();
|
|
72
|
-
sample.doSomething();
|
|
73
|
-
```
|
|
@@ -1,25 +0,0 @@
|
|
|
1
|
-
# SampleException Class
|
|
2
|
-
|
|
3
|
-
This is a sample exception.
|
|
4
|
-
|
|
5
|
-
**Usage**
|
|
6
|
-
|
|
7
|
-
You can use the exception the following way.
|
|
8
|
-
|
|
9
|
-
You can also take a look at [ns.SampleClass](../SampleGroup/ns.SampleClass.md) to see how it is used.
|
|
10
|
-
|
|
11
|
-
This is a dangerous HTML tag: <script>alert('Hello');</script>
|
|
12
|
-
|
|
13
|
-
```apex
|
|
14
|
-
try {
|
|
15
|
-
throw new SampleException();
|
|
16
|
-
} catch (SampleException e) {
|
|
17
|
-
System.debug('Caught exception');
|
|
18
|
-
}
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
## Namespace
|
|
22
|
-
ns
|
|
23
|
-
|
|
24
|
-
**Inheritance**
|
|
25
|
-
Exception
|
|
@@ -1,119 +0,0 @@
|
|
|
1
|
-
# SampleInterface Interface
|
|
2
|
-
|
|
3
|
-
`NAMESPACEACCESSIBLE`
|
|
4
|
-
|
|
5
|
-
This is a sample interface
|
|
6
|
-
|
|
7
|
-
**Author** John Doe
|
|
8
|
-
|
|
9
|
-
**Date** 2020-01-01
|
|
10
|
-
|
|
11
|
-
**See** [ns.SampleEnum](../Sample-Enums/ns.SampleEnum.md)
|
|
12
|
-
|
|
13
|
-
**See** [ns.ReferencedEnum](./ns.ReferencedEnum.md)
|
|
14
|
-
|
|
15
|
-
## Namespace
|
|
16
|
-
ns
|
|
17
|
-
|
|
18
|
-
## Diagram
|
|
19
|
-
```mermaid
|
|
20
|
-
graph TD
|
|
21
|
-
A[SampleInterface] -->|extends| B[ParentInterface]
|
|
22
|
-
B -->|extends| C[GrandParentInterface]
|
|
23
|
-
C -->|extends| D[GreatGrandParentInterface]
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## Example
|
|
27
|
-
```apex
|
|
28
|
-
SampleInterface sampleInterface = new SampleInterface();
|
|
29
|
-
sampleInterface.sampleMethod();
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
**Extends**
|
|
33
|
-
[ns.ParentInterface](./ns.ParentInterface.md)
|
|
34
|
-
|
|
35
|
-
## Methods
|
|
36
|
-
### `sampleMethod()`
|
|
37
|
-
|
|
38
|
-
`NAMESPACEACCESSIBLE`
|
|
39
|
-
|
|
40
|
-
This is a sample method
|
|
41
|
-
|
|
42
|
-
**Custom Tag**
|
|
43
|
-
|
|
44
|
-
This is a custom tag
|
|
45
|
-
|
|
46
|
-
**Another Custom Tag**
|
|
47
|
-
|
|
48
|
-
This is another custom tag
|
|
49
|
-
|
|
50
|
-
#### Signature
|
|
51
|
-
```apex
|
|
52
|
-
public String sampleMethod()
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
#### Return Type
|
|
56
|
-
**String**
|
|
57
|
-
|
|
58
|
-
Some return value
|
|
59
|
-
|
|
60
|
-
#### Throws
|
|
61
|
-
[ns.SampleException](./ns.SampleException.md): This is a sample exception
|
|
62
|
-
|
|
63
|
-
AnotherSampleException: This is another sample exception
|
|
64
|
-
|
|
65
|
-
#### Diagram
|
|
66
|
-
```mermaid
|
|
67
|
-
graph TD
|
|
68
|
-
A[SampleInterface] -->|extends| B[ParentInterface]
|
|
69
|
-
B -->|extends| C[GrandParentInterface]
|
|
70
|
-
C -->|extends| D[GreatGrandParentInterface]
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
#### Example
|
|
74
|
-
```apex
|
|
75
|
-
SampleInterface sampleInterface = new SampleInterface();
|
|
76
|
-
sampleInterface.sampleMethod();
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
---
|
|
80
|
-
|
|
81
|
-
### `sampleMethodWithParams(param1, param2, theEnum)`
|
|
82
|
-
|
|
83
|
-
`NAMESPACEACCESSIBLE`
|
|
84
|
-
`DEPRECATED`
|
|
85
|
-
|
|
86
|
-
This is a sample method with parameters
|
|
87
|
-
|
|
88
|
-
Sometimes it won't be possible to find a NonExistent link.
|
|
89
|
-
|
|
90
|
-
#### Signature
|
|
91
|
-
```apex
|
|
92
|
-
public SampleEnum sampleMethodWithParams(String param1, Integer param2, SampleEnum theEnum)
|
|
93
|
-
```
|
|
94
|
-
|
|
95
|
-
#### Parameters
|
|
96
|
-
| Name | Type | Description |
|
|
97
|
-
|------|------|-------------|
|
|
98
|
-
| param1 | String | This is the first parameter |
|
|
99
|
-
| param2 | Integer | This is the second parameter |
|
|
100
|
-
| theEnum | [ns.SampleEnum](../Sample-Enums/ns.SampleEnum.md) | This is an enum parameter |
|
|
101
|
-
|
|
102
|
-
#### Return Type
|
|
103
|
-
**[ns.SampleEnum](../Sample-Enums/ns.SampleEnum.md)**
|
|
104
|
-
|
|
105
|
-
Some return value
|
|
106
|
-
|
|
107
|
-
---
|
|
108
|
-
|
|
109
|
-
### `sampleParentMethod()`
|
|
110
|
-
|
|
111
|
-
*Inherited*
|
|
112
|
-
|
|
113
|
-
#### Signature
|
|
114
|
-
```apex
|
|
115
|
-
public void sampleParentMethod()
|
|
116
|
-
```
|
|
117
|
-
|
|
118
|
-
#### Return Type
|
|
119
|
-
**void**
|