react changelog | Dart package

7.3.1 #

Set up gha-dart-oss
Fix no_entrypoint_imports warnings

7.3.0 #

Add new, opt-in React 18 JS files (see README for more info)
- The preexisting JS files that use React 17 are now deprecated, and will be removed in the next major version, 8.0.0.
Raise SDK constraint from <3.0.0 to <4.0.0, run CI on Dart 3

7.2.0 #

Add Dart wrapper for React lazy

7.1.3 #

Internal release tooling changes

7.1.2 #

Internal release tooling changes

7.1.1 #

Internal release tooling changes
Tests - switch from mockito to mocktail

7.1.0 #

Add a new ReactNode type, which aliases Object? to mimic the React JS Typescript type.

7.0.1 #

Breaking change - fix nullability/typings for ReactDom.findDomNode and ReactDom.render from package:react/react_client/react_interop.dart:

-Element findDOMNode(dynamic object);
+Element? findDOMNode(dynamic object);

-ReactComponent render(ReactElement component, Element element);
+dynamic render(dynamic component, Element element);

The previous typings were incorrect:

findDOMNode returns null in many cases, but its return type was incorrectly non-nullable.
render returns null for some cases (function components, null), Element for DOM components, and CharacterData for strings and numbers, but was incorrectly typed as non-nullable ReactComponent. The component argument also accepts null and other "ReactNode" arguments to rendered, but its type is incorrectly non-nullable and restricted to just ReactElement.

These typings only affect these APIs under the ReactDom class in package:react/react_client/react_interop.dart, and not the top-level Function-typed findDOMNode and render APIs exported from package:react/react_dom.dart, which most consumers use.

Because these typings were incorrect and will lead to runtime errors in some cases, and the changes have a low likelihood of causing breakages, we feel it's appropriate to release these changes as a patch.

7.0.0 #

Migrate to null safety
Remove deprecated APIs (see below)
Minor API breakages to support null safety migration and improve typing (see below)

Deprecated API removals #

ReducerHook and StateHook class constructors (use hook functions instead)
Ref class constructors: default and useRefInit (use createRef and useRef instead)
forwardRef (use forwardRef2 instead)
main (use htmlMain instead)
memo (use memo2 instead)
APIs that have been no-ops since react-dart 6.0.0
- SyntheticEvent members persist and isPersistent
- unconvertJsEventHandler
APIs that were never intended for public use:
- ComponentStatics, ComponentStatics2
- InteropContextValue
- JsComponentConfig, JsComponentConfig2
- JsError
- JsPropValidator
- React.createFactory
- ReactDartContextInternal
- ReactDartInteropStatics
- ReactElementStore
- createReactDartComponentClass, createReactDartComponentClass2
- markChildValidated
- markChildrenValidated

Other API breakages #

Miscellaneous:

ReducerHook, StateHook, and Ref are now @sealed and may not be inherited from
All PropValidatorInfo arguments are required

Typing improvements:

Top-level DOM factories exported from package:react/react.dart (react.div, react.span, etc.) are now typed as ReactDomComponentFactoryProxy instead of dynamic
The return types of ReactComponentFactoryProxy methods call and build are now ReactElement instead of dynamic
- This matches the type returned from build for all subclasses, which is what’s returned by call, and reflects the type returned at runtime
- Has potential to cause some static analysis issues, but for the most part should not affect anything since ReactElement is typically treated as an opaque type

Changes very unlikely to affect consumers:

Changes to public-but-internal APIs:
- ReactDartComponentInternal constructor now takes a required argument, props field is final
- initComponentInternal arguments are typed to reflect runtime assumptions

Component and Component2 members props/state/jsThis are now late, and will now throw instead of being null if accessed before initialized.

It should be very uncommon for components to be affected by this change, and any affected components are likely doing something wrong to begin with.

These fields are only uninitialized:

for mounting component instances:
- in component class constructors (which we don't encourage)
- in component class field initializers (except for lazy late ones)
in "static" lifecycle methods like getDerivedStateFromProps and defaultProps

Examples of code affected:

class FooComponent extends Component2 {
  // `props` would have always been null when this is initialized, but in 7.0.0 accessing it throws.
  final something = (props ?? {})['something'];

  // We strongly discourage declaring Dart constructors in component classes;
  // for initialization logic, use componentDidMount instead. 
  FooComponent() {
    // `props` would have always been null here, but in 7.0.0 accessing it throws.
    print(props);
  }

  @override
  getDerivedStateFromProps(nextProps, prevState)  {
    // `props` would have always been null here, but in 7.0.0 accessing it throws.
    print(props);
    return {};
  }
}

6.3.0 #

#372, #374 Add and update deprecations in preparation for 7.0.0 release, add WIP changelog
#372 Add APIs in preparation for null safety:
- htmlMain - replacement for deprecated react.main, to be removed in 7.0.0
- useRefInit - useRef can't be used to create non-nullable-typed refs, but useRefInit can

6.2.1 #

#366 Fix lints and eliminate most implicit casts

6.2.0 #

#357 Export Suspense component
#354 Raise analyzer minimum & unpin meta
#355 Pin mockito 5
#356 Unpin mockito, fix CI

6.1.8 #

#350 Return jsUndefined instead of null when children prop is empty

6.1.7 #

#344 Fix identityHashCode error when forwarding props containing JSX children

6.1.6 #

#336 Publish JS bundles to Workiva CDN

6.1.5 #

#333 Remove old, unused file from bin/

6.1.4 #

#327 Fix stable ci build
#328 Work around $identityHash being added to JS objects passed into jsifyAndAllowInterop

6.1.3 #

#308 Bump elliptic from 6.5.3 to 6.5.4
#311 Bump ssri from 6.0.1 to 6.0.2
#312 Bump lodash from 4.17.20 to 4.17.21
#313 Bump browserslist from 4.16.1 to 4.16.6
#318 Bump path-parse from 1.0.6 to 1.0.7
#323 Raise the Dart SDK minimum to at least 2.11.0
#315 Upgrade CI to run using Dart 2.13
#309 Update README.md
#325 Upgrade dependency_validator

6.1.2 #

#321 Fix missing Dart component names in error boundary componentStack

6.1.1 #

#319 Add baseURI polyfill for IE 11 compatibility on Dart 2.13.

6.1.0 #

#316 Export generateJsProps.

6.0.1 #

#305 Fix JsBackedMap for Dart 2.12.

6.0.0 #

This stable, major release of react includes:

ReactJS 17.x Support #

The underlying .js files provided by this package are now ReactJS version 17.0.1.

Full List of Breaking Changes

React 17 Release Blog Post

5.7.1 #

#289 Update most deprecations that were slated for removal in v6.0.0 to be slated for removal in v7.0.0 instead. To keep the migration to v6.0.0 as easy as possible, only APIs that are known to be completely unused will be removed in v6.0.0. Therefore, most APIs that were marked for removal in v6.0.0 will remain until the v7.0.0 release. This PR updated deprecation annotations to reflect this.
#287 Deprecate SyntheticEvent.isFormEvent. Because form events do not exist as their own type in ReactJS, this helper will be removed in v6.0.0. Instead, check for the expected form event types.

5.7.0 #

#282 Add SyntheticEvent helpers that eliminate the need to use synthetic event class constructors. Additionally, added utilities to assist in type checking events without manually using the is keyword.

5.6.1 #

#280 Update React dev JS files to include a workaround to a DDC bug when using Chrome 86+ (fixed in Dart 2.9.3)

5.6.0 #

#275 Add forwardRef2 / memo2 to fix "jsification" of Dart props
- Deprecates forwardRef / memo
#274 (Security update) Bump serialize-javascript JS dependency to version 3.1.0

5.5.1 #

#258 Exclude propTypes from Dart2js output.
- Deprecate registerComponent.
  - Accidentally overlooked when Component was deprecated
#276 Allow null ref value in useImperativeHandle hook

5.5.0 #

New Features

🎉 🎉 🎉 Support for function components, memo and hooks!!! 🎉 🎉 🎉

Sooooo much work from so many amazing people made this possible, but to summarize:
- #221 Add support for function components
- #252 Add support for memo higher order component
- Hooks, hooks, and more hooks!
  - #223 useState
  - #233 useCallback
  - #237 useContext
  - #227 useEffect
  - #248 useLayoutEffect
  - #232 useReducer
  - #245 useRef
  - #250 useMemo
  - #247 useImperativeHandle
  - #246 useDebugValue
It works like this...

Define the component:
```
import 'package:react/react.dart' as react;

final SomeWidget = react.registerFunctionComponent(_SomeWidget, displayName: 'SomeWidget');

_SomeWidget(Map props) {
  // You can use hooks in here, too!

  return react.div({}, [
    // Some children...
  ]);
}
```
Render the component (exact same consumer API as a class-based component):
```
import 'package:react/react_dom.dart' as react_dom;
import 'some_widget.dart'; // Where your component is defined

main() {
  final renderedWidget = SomeWidget({
    // put some props here
  }, [
    // put some children here!
  ]);

  react_dom.render(renderedWidget, querySelector('#idOfSomeNodeInTheDom'));
}
```
Check out all the function component and hooks examples for more information!

Fixes / Updates

#253 Deprecate setClientConfiguration.
- It is no longer necessary - and can be removed from your implementations
#273 Make JsBackedMap.values compatible with MSIE 11

5.4.0 #

New Features

#244 Add support for HTML Composition events
#263 Add support for SyntheticEvent.persist()

Fixes / Updates

#261 Stop errors thrown within the call stack of Component.render() from being swallowed
#256 Documentation updates (thanks @barriehadfield !!!)

JS Dependency Updates

#255 Bump acorn from 6.4.0 to 6.4.1
#260 Bump lodash from 4.17.15 to 4.17.19

5.3.0 #

Unpin the react-redux JS dependency to allow versions 7.1.1 and higher.
Run over_react tests as part of the CI process to prevent another situation where changing JS dependencies regressed tightly coupled libs like over_react_redux (like the one that required the 5.2.1 hotfix).
#242 Implement StrictMode Component

5.2.1 #

Temporarily pin react-redux dependency to version 7.1.0 to prevent widespread test failures as a result of Provider being converted into a function component with hooks.

5.2.0 #

#190 Fix null value handling in setStateWithUpdater
#235 Fix null value handling in getDerivedStateFromError interop
#238 Fix js package security vulnerability
#236 Expose componentZone to allow overriding the zone in which Component2 lifecycle methods are run, for testing

5.1.1 #

Improve the documentation for deprecated Component2 lifecycle methods.

5.1.0 #

Full ReactJS 16.x Component Lifecycle Support

The new Component2 class replaces the now deprecated Component class.
- Faster
- Improved dev experience
- Easier to maintain
- Easier integration with JS libs
  - ReactJsComponentFactoryProxy makes it easy to use JS components with Dart!
    - Check out this example of MaterialUI components!
- Supports new lifecycle methods, allowing us to use Concurrent Mode in the future
  - ~~componentWillMount~~ => componentDidMount
  - ~~componentWillReceiveProps~~ => getDerivedStateFromProps (new)
  - ~~componentWillUpdate~~ => getSnapshotBeforeUpdate (new)
  - componentDidCatch / getDerivedStateFromError (new)
    - Adds support for error boundaries.

Portals

"Portals provide a first-class way to render children into a DOM node that exists outside the DOM hierarchy of the parent component."

Improved, stable Context API

"Context provides a way to pass data through the component tree without having to pass props down manually at every level. … Context is primarily used when some data needs to be accessible by many components at different nesting levels. Apply it sparingly because it makes component reuse more difficult."

Fragments

"A common pattern in React is for a component to return multiple elements. Fragments let you group a list of children without adding extra nodes to the DOM."
Component.render can now return Fragments (multiple children) or other values like strings and lists instead of just a single ReactElement

New and improved ref API: React.createRef

React Redux is now included in the JS bundles and exposed via window.ReactRedux.

Full list of 5.1.0 Changes

5.0.1 #

Pull in 4.9.2 changes that were accidentally reverted as part of 5.0.0.

#220 Fix bug where reading dataTransfer sometimes threw during synthetic event conversion

5.0.0 #

ReactJS 16.x Support

The underlying .js files provided by this package are now ReactJS version 16.
Support for the new / updated lifecycle methods from ReactJS 16 will be released in version 5.1.0.

Full list of 5.0.0 Changes