Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

chore(deps): update dependency react-docgen to v7 #6787

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

chore(deps): update dependency react-docgen to v7 #6787

wants to merge 1 commit into from

Conversation

renovate[bot]
Copy link
Contributor

@renovate renovate bot commented Mar 27, 2024

Mend Renovate

This PR contains the following updates:

Package Change Age Adoption Passing Confidence
react-docgen (source) ^5.4.3 -> ^7.0.3 age adoption passing confidence

Release Notes

reactjs/react-docgen (react-docgen)

v7.0.3

Compare Source

Patch Changes

v7.0.2

Compare Source

Patch Changes

v7.0.1

Compare Source

Patch Changes

v7.0.0

Compare Source

Major Changes

  • #​846
    82154c3
    Thanks @​danez! - getTypeFromReactComponent now
    returns an array of paths to types instead of just one. This can appear when
    multiple type definitions are found for a component, for example:

    const Component: React.FC<Props> = (props: { some: string }) => {};

    In this example both the Props definition as well as { some: string } are
    now found and used.

    Here is a simple diff to illustrate the change when using
    getTypeFromReactComponent:

    const type = getTypeFromReactComponent(path)

-if (type) {
+if (type.length > 0) {
    // do smth
}

  • #​848
    dda8915
    Thanks @​danez! - Drop support for Node.js
    version 14.

    The minimum supported version is now 16.14.0

  • #​846
    62e692f
    Thanks @​danez! - resolveToValue will not resolve
    to ImportDeclaration anymore but instead to one of the possible specifiers
    (ImportSpecifier, ImportDefaultSpecifier or ImportNamespaceSpecifier).
    This gives better understanding to which specifier exactly resolveToValue
    did resolve a NodePath to.

    Here is a possible easy fix for this in a code snippet that uses
    resolveToValue

    const resolved = resolveToValue(path);

-if (resolved.isImportDeclaration()) {
+if (resolved.parentPath?.isImportDeclaration()) {
    // do smth
}
Minor Changes

  • #​862
    40ebb00
    Thanks @​danez! - Support PropsWithoutRef,
    PropsWithRef and PropsWithChildren in TypeScript.

    Component props are now detected correctly when these builtin types are used,
    but they do currently not add any props to the documentation.

  • #​846
    82154c3
    Thanks @​danez! - Add support for React.FC in
    TypeScript.

Patch Changes

v6.0.4

Compare Source

Patch Changes

v6.0.3

Compare Source

Patch Changes

v6.0.2

Compare Source

Patch Changes

v6.0.1

Compare Source

Patch Changes

v6.0.0

Compare Source

Major Changes

  • 96d6e9e
    Thanks @​danez! - Rename flowTypeHandler to
    codeTypeHandler because it handles Flow and TypeScript

  • #​719
    d7a39af
    Thanks @​danez! - Refactored
    resolveComponentDefinition utility.

    • 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.

  • #​761
    dfc2f85
    Thanks @​danez! - Renamed propDocBlockHandler to
    propDocblockHandler for consistency

  • 96d6e9e
    Thanks @​danez! - Simplify
    resolveObjectValuesToArray and remove type handling. None of the code that
    was handling types was used.

  • caae6bf
    Thanks @​danez! - The return values of
    resolveObjectValuesToArray are 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 like path.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-docgen into its own package @react-docgen/cli.

    Check out https://react-docgen.dev/docs/getting-started/cli for the
    documentation.

  • 96d6e9e
    Thanks @​danez! - The main parse API 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 method toObject to
    build in the DocumentationBuilder.

    This method might be used by integrations.

  • 96d6e9e
    Thanks @​danez! - Renamed some of the main exports
    for clarity.

    Renamed handlers to builtinHandlers Renamed resolver to
    builtinResolvers Renamed importers to builtinImporters

  • #​743
    5215bab
    Thanks @​danez! - Removed support for the
    @extends React.Component annotation on react class components.

    Instead, you can use the new @component annotation or define your own
    annotation by creating a custom FindAnnotatedDefinitionsResolver instance

  • #​714
    80e4c74
    Thanks @​danez! - Renamed and migrated built-in
    resolvers to classes.

    • findAllComponentDefinitions was renamed to FindAllDefinitionsResolver
      and is now a class.

      -const resolver = builtinResolvers.findAllComponentDefinitions
+const resolver = new builtinResolvers.FindAllDefinitionsResolver()

    • findAllExportedComponentDefinitions was renamed to
      FindExportedDefinitionsResolver and is now a class.

      -const resolver = builtinResolvers.findAllExportedComponentDefinitions
+const resolver = new builtinResolvers.FindExportedDefinitionsResolver()

    • findExportedComponentDefinition was removed. Use
      FindExportedDefinitionsResolver with the limit option instead.

      This is still the default resolver.

      -const resolver = builtinResolvers.findExportedComponentDefinition
+const resolver = new builtinResolvers.FindExportedDefinitionsResolver({ limit: 1 })

  • 96d6e9e
    Thanks @​danez! - Migrated to babel toolchain

    This 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 .cts and .mts
    extension when using typescript

  • 96d6e9e
    Thanks @​danez! - Treat functions returning
    React.Children.map as components

  • 96d6e9e
    Thanks @​danez! - Improve performance by creating
    all visitors only once

  • 96d6e9e
    Thanks @​danez! - Support all possible kinds of
    functions in the displayNameHandler

  • #​786
    0a2481d
    Thanks @​danez! - Export the type for the
    DocumentationBuilder.

  • #​786
    0a2481d
    Thanks @​danez! - The types NodePath and
    babelTypes are now exported.

    These types are useful when building integrations in TypeScript.

    babelTypes includes 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

  • 96d6e9e
    Thanks @​danez! - Support flow qualified type names

  • 96d6e9e
    Thanks @​danez! - Support class and function
    declarations without identifier

  • 96d6e9e
    Thanks @​danez! - Support resolving of
    destructuring in resolveToValue

  • #​714
    80e4c74
    Thanks @​danez! - Allow resolvers to be classes in
    addition to functions.

    import type { ResolverClass, ResolverFunction } from "react-docgen";

// This was the only option until now
const functionResolver: ResolverFunction = (file: FileState) => {
  //needs to return array of found components
};

// This is the new class resolver
class MyResolver implements ResolverClass {
  resolve(file: FileState) {
    //needs to return array of found components
  }
}

const classResolver = new MyResolver();

  • 96d6e9e
    Thanks @​danez! - Improve performance drastically
    by making changes to AST traversal

    Visitors are now pre-exploded and are cached in the module scope instead of
    creating them on every call. This change brought the benchmark from 170ops/s
    to 225ops/sec

  • 96d6e9e
    Thanks @​danez! - Add codes to errors to be able to
    easily detect them

    There is a new export ERROR_CODES that contains all possible error codes.
    The two errors that have codes right now are:

    • MISSING_DEFINITION: No component found in a file
    • MULTIPLE_DEFINITIONS: Multiple components found in one file

  • 96d6e9e
    Thanks @​danez! - Support handling
    useImperativeHandle correctly

  • #​743
    5215bab
    Thanks @​danez! - Added a new resolver that finds
    annotated components. This resolver is also enabled by default.

    To use this feature simply annotated a component with @component.

    // @&#8203;component
class MyComponent {}
Patch Changes

Configuration

📅 Schedule: Branch creation - "before 4am" (UTC), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

  • If you want to rebase/retry this PR, check this box

This PR has been generated by Mend Renovate. View repository job log here.

@renovate renovate bot added the renovatebot label Mar 27, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers
No reviews
Assignees
No one assigned
Labels
renovatebot
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.

None yet
0 participants