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

Packages ready to publish #805

Merged
merged 1 commit into from
Jun 16, 2023
Merged

Packages ready to publish #805

merged 1 commit into from
Jun 16, 2023

Conversation

danez-bot
Copy link
Collaborator

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

[email protected]

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.

    // @component
class MyComponent {}

Patch Changes

  • #745
    8fe3dbf
    Thanks @danez! - Fix crash when using TypeScript
    mapped types

  • #789
    7c99f15
    Thanks @danez! - Fix TypeScript types when strict
    null checks are disabled

  • 96d6e9e
    Thanks @danez! - Handle React.forwardRef calls
    without a function

  • 96d6e9e
    Thanks @danez! - Fixed the handling of some edge
    cases in resolveToValue

  • 96d6e9e
    Thanks @danez! - Remove trailing commas and
    semicolons from raw values in the documentation

  • #767
    a684d82
    Thanks @danez! - Fix handling of PropTypes.oneOf
    to handle unresolved imported values correctly

  • #761
    cc94da2
    Thanks @danez! - Fix using react-docgen in
    browsers

  • #761
    98a1138
    Thanks @danez! - Add displayName and
    description to Documentation type

  • 96d6e9e
    Thanks @danez! - Parse jsdoc comments for
    TypeScript structs

  • #748
    ea25b16
    Thanks @danez! - Handle cyclic references in
    PropTypes shape() and exact() methods.

  • #787
    5a226ac
    Thanks @danez! - Fix @babel/traverse import to
    work in non ESM environments

  • 96d6e9e
    Thanks @danez! - Correctly handle ObjectProperties
    in isReactComponentMethod

  • #747
    1aa0249
    Thanks @danez! - Handle typeof import('...') and
    typeof MyType.property correctly in TypeScript

  • 050313d
    Thanks @danez! - Correctly add LICENSE file to
    published packages

  • 96d6e9e
    Thanks @danez! - Add support for TSAsExpressions
    when trying to stringify expressions

  • #720
    f6e4fe7
    Thanks @renovate! - Update dependency
    strip-indent to v4

  • #769
    e08e08d
    Thanks @danez! - Correctly resolve the values in
    an Object.values() call

@react-docgen/[email protected]

Major Changes

  • #693
    3b28f6e
    Thanks @danez! - Introducing the new CLI package
    @react-docgen/cli which was extracted from react-docgen and is a complete
    rewrite. Compared to the old CLI these are some of the major differences:

    • Does not support input via stdin anymore
    • The path argument is now a glob
    • -x, --extension was removed in favor of globs
    • -e, --exclude was removed
    • -i, --ignore now accepts a glob
    • --handler added
    • --importer added
    • --failOnWarning added

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

  • #714
    80e4c74
    Thanks @danez! - Renamed --handlers option to
    --handler. This unifies all options to be singular.

Minor Changes

  • #714
    80e4c74
    Thanks @danez! - --resolver option can now be
    used multiple times.

    If used multiple times the resolvers will be chained in the defined order and
    all components from all resolvers will be used.

  • #753
    217a005
    Thanks @danez! - Add support for the
    FindAnnotatedDefinitionsResolver.

    Can be used with

    react-docgen --resolver find-all-annotated-components

Patch Changes

@netlify
Copy link

netlify bot commented Jun 16, 2023 •
edited
Loading

✅ Deploy Preview for react-docgen ready!

Name Link
🔨 Latest commit 5f0d750
🔍 Latest deploy log https://app.netlify.com/sites/react-docgen/deploys/648ccb86aec7f000083da1e6
😎 Deploy Preview https://deploy-preview-805--react-docgen.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site settings.

@danez danez merged commit 7c1e9f1 into main Jun 16, 2023
@danez danez deleted the changeset-release/main branch June 16, 2023 20:57
@github-actions github-actions bot locked as resolved and limited conversation to collaborators Jun 20, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Reviewers
No reviews
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
2 participants
@danez-bot @danez