Releases: reactjs/react-docgen
@react-docgen/[email protected]
[email protected]
@react-docgen/[email protected]
Patch Changes
- Updated dependencies
[8ba9ac7]:
[email protected]
@react-docgen/[email protected]
Patch Changes
- Updated dependencies
[c3c16e3]:
[email protected]
@react-docgen/[email protected]
[email protected]
@react-docgen/[email protected]
Patch Changes
- Updated dependencies
[c7e2bd5]:
[email protected]
Migration Guide: https://react-docgen.dev/docs/migrate/v6
Major Changes
-
96d6e9e
Thanks @danez! - RenameflowTypeHandlerto
codeTypeHandlerbecause it handles Flow and TypeScript -
#719
d7a39af
Thanks @danez! - Refactored
resolveComponentDefinitionutility.- Renamed to
findComponentDefinition - Removed named export
isComponentDefinition - The utility now does a lot more than previously, check out the commit to see
the changes in detail.
- Renamed to
-
#761
dfc2f85
Thanks @danez! - RenamedpropDocBlockHandlerto
propDocblockHandlerfor consistency -
96d6e9e
Thanks @danez! - Simplify
resolveObjectValuesToArrayand remove type handling. None of the code that
was handling types was used. -
caae6bf
Thanks @danez! - The return values of
resolveObjectValuesToArrayare now in the order they are defined in the
source code. -
#744
e956802
Thanks @danez! - Removed match utility.The utility can be replaced by babel helpers and is not needed anymore. Also
using explicit checks likepath.isMemberExpression()is better for type
safety and catching potential bugs. -
96d6e9e
Thanks @danez! - Migrate react-docgen to ES
modules. Please read
this -
#693
3b28f6e
Thanks @danez! - The CLI was removed from
react-docgeninto its own package@react-docgen/cli.Check out https://react-docgen.dev/docs/getting-started/cli for the
documentation. -
96d6e9e
Thanks @danez! - The mainparseAPI had some
breaking changes.-
The arguments were changed from previously 5 to just 2. The following diff
illustrates how to migrate:-parse(src, resolver, handlers, importer, options: { filename, ...babelOptions}) +parse(src, { resolver, handlers, importer, filename, babelOptions: {} })
-
The return type is now always an array, independent of the resolver, even if
only one component was found in the file.
-
-
#786
0a2481d
Thanks @danez! - Renamed the methodtoObjectto
buildin the DocumentationBuilder.This method might be used by integrations.
-
96d6e9e
Thanks @danez! - Renamed some of the main exports
for clarity.Renamed
handlerstobuiltinHandlersRenamedresolverto
builtinResolversRenamedimporterstobuiltinImporters -
#743
5215bab
Thanks @danez! - Removed support for the
@extends React.Componentannotation on react class components.Instead, you can use the new
@componentannotation or define your own
annotation by creating a customFindAnnotatedDefinitionsResolverinstance -
#714
80e4c74
Thanks @danez! - Renamed and migrated built-in
resolvers to classes.-
findAllComponentDefinitionswas renamed toFindAllDefinitionsResolver
and is now a class.-const resolver = builtinResolvers.findAllComponentDefinitions +const resolver = new builtinResolvers.FindAllDefinitionsResolver()
-
findAllExportedComponentDefinitionswas renamed to
FindExportedDefinitionsResolverand is now a class.-const resolver = builtinResolvers.findAllExportedComponentDefinitions +const resolver = new builtinResolvers.FindExportedDefinitionsResolver()
-
findExportedComponentDefinitionwas removed. Use
FindExportedDefinitionsResolverwith thelimitoption instead.This is still the default resolver.
-const resolver = builtinResolvers.findExportedComponentDefinition +const resolver = new builtinResolvers.FindExportedDefinitionsResolver({ limit: 1 })
-
-
96d6e9e
Thanks @danez! - Migrated to babel toolchainThis is one of the big changes in this new version of react-docgen. It made
the code a lot more robust because there are now finally working TypeScript
types for the ASTs.Another benefit from this change is that react-docgen is now a lot faster. 🚀
In some tests an improvement of nearly 50% was seen in comparison to
version 5. -
#707
d4c27d4
Thanks @danez! - Improve performance of file
system importer.The file system importer now also caches the resolving of files in addition to
parsing files. If the importer is used in an environment where files do change
at runtime (like a watch command) then the caches will need to be cleared on
every file change. -
96d6e9e
Thanks @danez! - Changed the minimum Node.js
version to 14.18.0
Minor Changes
-
96d6e9e
Thanks @danez! - Add support for.ctsand.mts
extension when using typescript -
96d6e9e
Thanks @danez! - Treat functions returning
React.Children.mapas components -
96d6e9e
Thanks @danez! - Improve performance by creating
all visitors only once -
96d6e9e
Thanks @danez! - Support all possible kinds of
functions in thedisplayNameHandler -
#786
0a2481d
Thanks @danez! - Export the type for the
DocumentationBuilder. -
#786
0a2481d
Thanks @danez! - The typesNodePathand
babelTypesare now exported.These types are useful when building integrations in TypeScript.
babelTypesincludes all types from@babel/types. -
#714
80e4c74
Thanks @danez! - Add the new ChainResolver which
allows multiple resolvers to be chained.import { builtinResolvers } from 'react-docgen'; const { ChainResolver } = builtinResolvers; const resolver = new ChainResolver([resolver1, resolver2], { chainingLogic: ChainResolver.Logic.ALL, // or ChainResolver.Logic.FIRST_FOUND, });
-
96d6e9e
Thanks @danez! - Support all literal types in
typescript