New

• (Added): A new widget mounting mechanism that renders more correct markup.
• (Added): A new widget rendering mechanism that is fast and consume less memory.
• (Added): A new set of cleaning optimisations that make widget disposing more fast.

Bug fixes

• (Fixed): Rendering incorrect markup(rare cases).
• (Fixed): Hook dispatcher not getting cleaned up on scope unmount.
• (Fixed): Router altering value segments when operating on child navigators.

New

• (Added): HTML's Section widget.
• (Added): HTMLWidgetBase to public API.
• (Added): Entries for all the remaining tags in the DomTagType enum.

Bug fixes

• (Fixed): InheritedWidget: Detached elements getting notified just before getting cleaned.

New

• (Added): Navigator.onDispose callback.
• (Added): MountOptions to runApp(for controlling inline-styles etc).
• (Updated): SDK version constraint to include Dart 3.x.
• (Tested and verified): Compatibility with Dart 3.0 SDK.

Bug Fixes

• (Fixed): Router matching non-exact parts.
• (Fixed): Router pushing incorrect paths(window.location).
• (Fixed): Router ignoring initial on-pop event.
• (Fixed): InheritedWidget: Orphan dependents are not getting cleaned up.
• (Fixed): InheritedWidget: Dispatch order of update notifications is undefined(now LIFO).
• (Fixed): RenderElement: visitAncestorElements() traversing temporary elements.
• (Fixed): RenderElement: traverseAncestorElements() traversing temporary elements.
• (Fixed): RenderElement: Call order of didRender & didUpdate is undefined for nested elements.
• (Fixed): RouterRenderElement: Orphan dependents are not getting cleaned up.

Visual-JSX, a Dart to JSX Visualizer.

Visual-JSX is a feature designed to make managing HTML code written in Dart easier. It transforms HTML widgets into a visually appealing, JSX-like syntax, making it easier to understand and maintain your HTML widgets. You'll find it extremely helpful as a visual aid when working with HTML inside the Dart code.

HTML2Rad, a streamlined method for importing HTML templates into Rad.

No more manual porting of HTML templates to HTML widgets! HTML2Rad allows you to convert HTML markup directly into Rad's HTML widgets with few clicks. Both Visual-JSX and HTML2 are aimed at enhancing development experience and increasing productivity. These two features are published together as an extension that's available for install only on Visual Studio Code(for now). Please refer to this document for usage details.

Bug fixes

• (Fixed): Router incorrectly pushing the Route.name to the address bar instead of the Route.path.
• (Fixed): Calling NavigatorState.open inside onInit, results in multiple routes being left open.

Refs, an easy and predictable way for accessing DOM nodes.

Inspired from Callback-Refs in React, Refs in Rad provides an easy and predictable way to access DOM elements that are associated with Rad widgets. Normally Rad takes cares of creating and updating DOM for you but there are many reasons why you would want to access the actual DOM elements. Common use-cases are managing focus (critical for accessibility) and triggering imperative animations.

Hooks, use state and other features inside widget-functions.

Hooks(inspired by React's Hooks) lets you use state and other features without writing classes(such as StatefulWidget). This release includes few ready-to-use hooks and a easy yet powerful Hooks API that you can use to create your own custom hooks. We've also released a hooks package containing implementations of commonly used React Hooks(see rad_hooks).

RenderEvents, a event system for RenderElements.

RenderEvents are the events that framework will emit when it interacts with a RenderElement. Just like we can add event listeners for user interactions on DOM elements, we can now add event listeners for framework interactions on RenderElements. Similar to DOM events, we've different types of RenderEvents for different types of interactions which are listed below:

• didRender is a event that's emitted after framework finishes rendering the output of render to the DOM.
• didUpdate is a event that's emitted after framework finishes rendering the output of update to the DOM.
• willUnMount is a event that's emitted when framework is about to remove the widget from the DOM.
• didUnMount is a event that's emitted after framework finishes removing the widget from the DOM.

RenderElements can decide to listen to a particular or all render events by adding event listeners.

Comparing RenderEvents with DOM events, there are few differences & restrictions:

• RenderEvents do not have capture/bubble phase.
• RenderEvents are meant to be listened internally inside RenderElements.
• Listeners for RenderEvents can be attached only during initial render, and cannot be updated.

These restrictions are temporary and we'll lift them when needed.

RenderEvents are meant to solve the problem of limited control over lifecycle in RenderElements. Previously we were providing a sub-class WatchfulRenderElement with hardcoded lifecycle. Now, using the new RenderEvents API, you can add as much or as little lifecycle as you want, to any RenderElement(widget). This new API effectively makes WatchfulRenderElement obsolete but we'll keep it for backward compatibility at zero-cost(it's also using the new RenderEvents API from now on).

Bug fixes

• (Fixed) Renderer reconciling all sibling widgets on dependent updates(sometime disposing siblings because of that).

Added following lifecycle methods to State:

• afterMount: Gets called after framework finishes rendering widget to DOM.
• afterUpdate: Gets called after framework finishes re-rendering widget to DOM.
• afterUnMount: Gets called after framework finishes removing widget from DOM.

Added following lifecycle methods to WatchfulRenderElement:

• afterUpdate: Gets called after framework finishes re-rendering widget to DOM.
• dispose: Gets called after framework finishes removing widget from render tree and is about to remove it from DOM.

Others

• Added a public getter EmittedEvent.nativeEvent that returns underlying native event(wrappee object).

Bug fixes

• (Fixed) InputHidden missing from public API.
• (Fixed) Value not setting/updating correctly on following Input widgets: InputUrl, InputTime, InputTelephone, InputSearch, InputRange, InputPassword, InputNumber, InputMonth, InputEmail, InputText, InputDateTimeLocal, InputDate and InputColor.
• (Fixed) WatchfulRenderElement.afterUnMount getting called before framework finishes removing widget from DOM(while it should get called after the complete removal of widget).

This is our first stable release 🎉

Thank you! everyone! for your feedback & contributions.