v0.20.0

[chrisvxd]

Puck 0.20 introduces inline text editing, overlay portals for interacting with components in the preview, resizable sidebars, and several other improvements that make the editor more flexible for both users and developers.

Read the Puck 0.20 release post for a list of all the new features, and the Puck 0.20 upgrade guide for upgrading from Puck 0.19.3.

Below is a summary of the main new features and the complete changelog.

Summary

• Inline text editing: edit text, textarea, and custom fields directly in the canvas without using the sidebar.
• FieldTransforms API: modify the values that fields pass to component render functions. It can be used to adjust the value, like applying toUpperCase to a string, or map it to a different type entirely.
• Resizable sidebars: drag the borders of the editor sidebars to resize them. Sidebar widths can also be read programmatically via the internal PuckAPI.
• Custom overlays: customize how the overlay appears when a component is hovered or selected in the editor with the componentOverlay override.
• Overlay portals: exclude component elements from the editor overlay so they remain interactive in the canvas.

Full changelog

Features

• add componentOverlay override (1a47857)
• add fieldTransform API for modifying field values rendering in canvas (e67152b)
• add inline text editing to custom fields (042f4b2)
• add inline text editing to text and textarea fields (ed7c12e)
• add no-external.css bundle without external fonts (d97af5e)
• add overlay portals for interactive UI under overlay (7d50c23)
• add setDeep convenience utility (676e2ab)
• enable resizing the sidebars (8909f8c)
• export SlotComponent type (d12fc3a)
• extend migrate function to support dynamic DropZones to slots (3da831b)
• make overrides optional in plugins (baed208)
• rename components & componentList overrides to drawer & drawerItem (e40fdfe)
• simplify generic type API on Config and ComponentConfig (04fc574)
• support object, null and undefined in select/radio options (6dace1c)
• support theming of font family (6cf56a8)

Bug Fixes

• add missing tiny-invariant dependency in remix recipe (d405985)
• address error when using disallow on a slot in root (93d525c)
• don't revert custom Drawer.Items during drag (0578004)
• ensure nested name is propagated to custom fields (f09540d)
• prevent field zoom on mobile devices (660fd08)
• prevent iframe hanging when stylesheets empty (ea0610a)
• reattach inline ref if element changes (ba585f9)
• remove erroneous get() API from usePuck (c119ed0)
• respect user generic in usePuck hook (6760121)
• respect user types in getItemBySelector and getItemById (f2d031f)
• retain DropZone content in interactive mode (d2e09bd)
• retain metadata in interactive preview mode (68dd73b)
• support user-defined fields in overrides (5cb4cc6)
• type object, array, and external field types correctly (f768aab)
• type user fields in overrides (54d71e3)

Contributors

• BAHAA-THE-KING
• shannonhochkins
• tlahmann

---

This discussion was created from the release v0.20.0.