@lit-labs/ssr-dom-shim

Patch Changes

• #3978 3711e665 - Only add suppressHydrationWarning prop when rendered in the client. This will prevent suppresshydrationwarning attribute being added to the host element when using @lit-labs/ssr-react.

Minor Changes

• #3885 7932f7dd - @lit-labs/ssr-react and @lit-labs/react now coordinate prop handling during server rendering and hydration.

  • [Breaking] @lit-labs/ssr-react will call setAttribute() with all props provided during server rendering unless they are provided in <code>_$litProps$</code> object made by @lit-labs/react. Previously, it would call setProperty() for props that were found in the element's prototype, and setAttribute() for those that weren't. If you wish to server render custom elements that take properties that can not be set as attributes (i.e. not serializeable or have different name as attribute/property), you must use @lit-labs/react to create a React wrapper component.
  • @lit-labs/react now has a Node build and export condition to do special prop handling during server rendering. It detects the presence of React.createElement monkey patch by @lit-labs/ssr-react and provides props to be set as properties to the createElement() call.
  • @lit-labs/ssr-react will add the defer-hydration attribute to custom elements that had properties set so that @lit-labs/react wrapped elements have a chance to set properties on the element before Lit element hydration is triggered.
  • @lit-labs/react wrapped components will suppress hydration warnings raised by React due to server rendered attributes.

Patch Changes

• #4141 6b515e43 - Update TypeScript to ~5.2.0

Patch Changes

• #3901 82e9f370 - Bump minimum version of lit-html dependency to 2.7.1 which includes needed shared internals.

Patch Changes

• #4614 ab77cc9c - Fix context types to be compatible with WCCG context protocol types.

Minor Changes

• #4371 62df19da Thanks @autopulated! - ContextProvider can now be added to any HTML elements, not just custom elements implementing a ReactiveControllerHost.

Patch Changes

• #4373 22919f6d - Make property decorated with @provide() with TypeScript experimental decorators configurable. This allows chaining additional decorators that modify the property like @property() from lit.

Major Changes

• #4224 71526898 - Graduate @lit-labs/react to @lit/react, its permanent location. @lit-labs/react is now just a proxy for @lit/react, so code need not be duplicated in projects that depend on both.

Major Changes

• #4210 cf7d96d4 - Graduate @lit-labs/context to @lit/context, its permanent location. @lit-labs/context is now just a proxy for @lit/context, so code need not be duplicated in projects that depend on both.

Major Changes

• #4129 73ac3b06 - Initial release of @lit-labs/preact-signals

Major Changes

• #4128 190ee965 - Initial release of @lit-labs/compiler, vending a Lit template TypeScript transformer.

Major Changes

• @lit/reactive-element is a new package that factors out the base class that provides the reactive update lifecycle based on property/attribute changes to LitElement (what was previously called UpdatingElement) into a separate package. LitElement now extends ReactiveElement to add lit-html rendering via the render() callback. See ReactiveElement API for more details.
• UpdatingElement has been renamed to ReactiveElement.
• The updating-element package has been renamed to @lit/reactive-element.
• The @internalProperty decorator has been renamed to @state.
• For consistency, renamed _getUpdateComplete to getUpdateComplete.
• When a property declaration is reflect: true and its toAttribute function returns undefined the attribute is now removed where previously it was left unchanged (#872).
• Errors that occur during the update cycle were previously squelched to allow subsequent updates to proceed normally. Now errors are re-fired asynchronously so they can be detected. Errors can be observed via an unhandledrejection event handler on window.
• ReactiveElement's renderRoot is now created when the element's connectedCallback is initially run.
• Removed requestUpdateInternal. The requestUpdate method is now identical to this method and should be used instead.
• The initialize method has been removed. This work is now done in the element constructor.

Minor Changes

• Adds static addInitializer for adding a function which is called with the element instance when is created. This can be used, for example, to create decorators which hook into element lifecycle by creating a reactive controller (#1663).
• Added ability to add a controller to an element. A controller can implement callbacks that tie into element lifecycle, including connectedCallback, disconnectedCallback, willUpdate, update, and updated. To ensure it has access to the element lifecycle, a controller should be added in the element's constructor. To add a controller to the element, call addController(controller).
• Added removeController(controller) which can be used to remove a controller from a ReactiveElement.
• Added willUpdate(changedProperties) lifecycle method to UpdatingElement. This is called before the update method and can be used to compute derived state needed for updating. This method is intended to be called during server side rendering and should not manipulate element DOM.