django-unicorn

• Add template_html to specify inline template HTML on the component.
• Add resolved method which only fires once even when there are multiple actions, e.g. during a debounce.

• Silence warnings about multiple root elements for direct views.
• Handle force_render in nested children for direct views #663.
• Handle error when manually refreshing direct views.
• Handle component field type annotations for dataclasses and Pydantic BaseModel #649 by siliconcow.
• Update startunicorn command to prevent spamming users and handle folder creation for nested components #642 by felipmartins.

Breaking changes

• Unparseable kwarg argument passed into a component will be considered None instead of being converted to a string.

<!-- If `abcde` is not a variable in the template context, it will get set to `name` as `None` whereas before it would get set as 'abcde' -->
{% unicorn 'hello' name=abcde %}

• Update logic to find components #655 by jacksund.
• Add fallback location to look for components.

This release could not have been made possible without the generous support of @winrid and @om-proptech. Thank you for sponsoring me and believing in django-unicorn! It also includes critical improvements to nested components from @imankulov.

• Handle a list of ValidationError or just a string instead of requiring a the dict version.
• Better support for type annotations for component fields.
• Improved nested component support by imankulov.
• Add force_render and $parent.

Breaking changes

Child components will not by default render the parent component anymore. If this is required for your child component, specify self.parent.force_render = True in any action that requires the parent to re-render. This change will reduce network bandwidth and isolates the amount of re-rendering required for nested components.

• Fix: Correctly serialize forms that have a a field with a Select widget.

• Warn if there is a missing root element.
• Use unicorn:id to merge elements with morphdom.

• Handle Alpine.js being loaded with defer.

• Add support for using both Alpine.js and Unicorn together in a component (#597 by imankulov).
• Do not send a 304 if the child has a parent (#595).
• Prevent sending the child DOM if there is a parent to reduce network payload size.
• More verbose error message when a component can not be loaded (#453 by nerdoc).

• Support List/list type annotations for component actions and fields (#582).
• Fix: calling a method in a parent will have the request available ([#583]https://github.com/adamghill/django-unicorn/pull/583).

Breaking changes

• Dropped official support for Python 3.7 because its end of life was June 27, 2023.
• Dropped official support for Django 2.2 because its end of life was April 1, 2022.

• Coerce type annotated arguments in an action method to the specified type (#571).
• Fix: Dictionary fields would sometimes create checksum errors (#572).

• Support passing arguments into a component (#560).
• Fix the handling of None for select elements. (#563).
• Better handling of AuthenticationForm when used in Component.form_class (#552) by lassebomh.

• Use CSRF_COOKIE_NAME Django setting (#545) by frnidito.
• Asterisk wildcard support for targeting loading (#543) by regoawt.

• Fix: remove use of ByteString (#534) by hauntsaninja.
• Fix: Update loading on elements other than the current action element ([#512]https://github.com/adamghill/django-unicorn/pull/512) by bazubii).
• Add new logo and doc changes (#518) by dancaron.
• Fix: Nested children caching issues (#511) by bazubii).
• Fix: Negating a variable for poll.disable would not work correctly in some instances.

• Support more than 1 level of nested children (#476 by bazubii).

• Fix: Calling methods with a model typehint would fail after being called multiple times (#476 by stat1c-void).

• Fix: Missing pp import in Python 3.7.

• Fix: Handle inherited (i.e. subclassed) models #459.
• Fix: Support abbreviated u:view (#464 by nerdoc).
• Add version and build date to minified JavaScript for easier debugging.

• Support for loading nested components from a route that uses a class-based view.
• Better support for children components.

• Fix JavaScript error that sometimes happens with nested components. 237 by clangley

• Add ability to render initial data JavaScript inside the rendered component