build(npm): bump @cparra/apexdocs from 2.25.0 to 3.0.0

[dependabot]

Bumps @cparra/apexdocs from 2.25.0 to 3.0.0.

Release notes

Sourced from @​cparra/apexdocs's releases.

3.0.0

ApexDocs 3.0.0

This is a new major release of ApexDocs, which means a lot of new features but also breaking changes.

New features

• The output markdown documentation now looks and contains the same content as the Salesforce documentation for Apex code
• New configuration hooks
• Enum values are now documented, and each specific value can receive its own documentation description.
• Code blocks are allowed through any tag (with a few documented exceptions) by wrapping your code in triple backticks (```).
• Objects referenced through @throws ,@exception , @return and, @param annotations now produce a link to the file (if they belong to the project)
• The Node package now exports a whole new set of functions and Typescript types, making it a lot pleasant to import it as a module and work with the functionality, instead of through the CLI.
• Besides using the CLI, the ApexDocs processing functionality can now be called imperatively from Javascript/Typescript by importing the process function.
• Tags can now be excluded from appearing in the documentation by using the excludeTags configuration property.

Improvements

• Improved examples folder in the repo
• Sanitizing HTML manually is no longer needed, it just works.
• General improvements to the way errors are presented when an exception happens when parsing the code or running a custom hook.

Deprecated

Specific Target Static Site Generators are no longer supported

In previous versions, it was possible to specify that the output should be in the format of Jekyll or Docsify, which are specific Static Site Generators (SSGs)

Since that was implemented, the industry has seen the rise of a huge number of other SSGs, with exciting new features and support for different component libraries.

This trend will probably continue, so we’ve made the decision that this tool should be as un-opinionated as possible on that matter.

The one thing that remains constant is that every single SSG continues to support Markdown as a first class citizen. So, the ability to target specific generators has been removed, and instead the ability to support plain markdown output has been vastly improved, including a way more powerful plugin engine that allows for consumers to easily integrate with the SSG of their choice.

Additionally, the examples folder now contains a lot of different examples on how to integrate with some popular SSGs (as of today), and the plan is to continue to grow this to continue to validate that the plugin framework is powerful enough to support anything thrown at it.

Breaking Changes

Changes to the CLI

• The apexdocs-generate command is now just apexdocs with subcommands for creating markdown files and OpenApi files
• Deprecated flags
  • recursive → With the SFDX format being now the de-facto standard, this is not necessary, as we can assume that this will always be true.
  • targetGenerator → See the Deprecated section as to why
  • indexOnly → This is a rare use case, so it was removed to clean up the API surface area. This can now be accomplished by using the provided hooks.
  • sanitizeHtml → This was added as patch-work to conditionally support special characters. 3.0 corrects any issues with special character rendering, so this is no longer needed
  • documentationRootDir → Can now be accomplished by using the hooks when integrating with a specific SSG.

Changes to how ApexDocs are parsed

... (truncated)

Commits

• See full diff in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

---

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

[dependabot]

Superseded by #268.