Skip to content

CHANGELOG.md

Latest commit

 

History

History
220 lines (146 loc) · 17.7 KB

CHANGELOG.md

File metadata and controls

220 lines (146 loc) · 17.7 KB

Unreleased

Breaking Changes

  • Dialog, AlertDialog, Popover, Tooltip, Select: Popup portal API (#77452). Add Portal subcomponents and an optional portal prop on Popup (when omitted, the default Portal is used). Remove container from every Popup and portalClassName from Dialog.Popup / AlertDialog.Popup; pass portal={ <Matching.Portal … /> } for container, className, style, and other portal options.
  • Popover, Tooltip, Select: style and className on Popup are now forwarded to the inner Base UI Popup element instead of the outer Positioner. To override the per-instance z-index, pass portal={ <Overlay.Portal style={ { '--wp-ui-<overlay>-z-index': '9999' } } /> } (or set the variable globally on a wrapping element); inline style={ { zIndex: … } } on Popup no longer reaches the positioned element.
  • Dialog, Drawer: Scrolling now requires the new Dialog.Content / Drawer.Content subcomponent; the popup itself no longer scrolls. Rendering Header / Footer as siblings of Content pins them to the popup edges; nesting them inside Content opts out of pinning. AlertDialog.Popup adds stickyHeader / stickyFooter props (default true) for the same choice on its internal chrome (#77559).

New Features

  • Add Drawer primitive (#76690).
  • Add Autocomplete primitive (#77642).
  • Add SelectControl component (#77809).

Documentation

  • Restructure setup docs into "Within standard WordPress editor screens" and "Elsewhere" for clarity (#77338).

Bug Fixes

  • Link: Fix text decoration on the unstyled variant when openInNewTab is enabled, and simplify new-tab icon markup (#77420).
  • Dialog, AlertDialog, Popover, Tooltip, Select: Restore focus-trap tabbability through ThemeProvider's display: contents wrapper (#77381, #77520).
  • Remove the transitive peer dependency on date-fns / @date-fns/tz (#77520), resolving #77395.
  • Text: Apply both heading and paragraph CSS defenses regardless of variant, so the correct defense kicks in based on the rendered element rather than the typographic variant (#77461).
  • CollapsibleCard: Fix missing keyboard focus ring on the header chevron icon when rendered inside wp-admin (#77468).
  • CollapsibleCard: Prevent the focus ring of focusable descendants from being clipped by the panel's overflow once the panel is fully expanded (#77667).
  • Tabs: Fix missing keyboard focus ring on the panel in Windows High Contrast mode when rendered inside wp-admin (#77469).

Enhancements

  • Dialog / AlertDialog / Drawer: Pin header / footer chrome to the popup edges when the body overflows, and show separator borders only while there is off-screen content in that direction (#77559).
  • Dialog: Add Dialog.Description sub-component, expose onOpenChangeComplete, skip the backdrop when modal is not true, use 100dvh for viewport-based heights so the popup fits the dynamic viewport on mobile, and forward className on Dialog.Title (#77194).
  • Dialog: Dialog.Header and Dialog.Footer now default to <header> and <footer> elements for richer landmark semantics. Their ref type widens from HTMLDivElement to HTMLElement; pass render to opt out of the default tag (#76690).
  • Dialog, Popover: Upgrade dev-only title validation from mount-only to cleanup-based re-validation, catching conditionally rendered titles (#77165).
  • Link: Honor openInNewTab consistently instead of treating hash links as a special case (#77422).
  • Select: Tighten spacing after checkmark when Select.Item is size="small" (#77642).
  • Dialog, Drawer, Popover: Align title and description colors across all three overlay primitives. Title color is now authored explicitly (resilient to global CSS defenses), and description color now inherits from the popup foreground token instead of overriding to the weak variant (#77692).
  • Dialog, AlertDialog, Drawer, Popover, Select, Tooltip: Unify the hairline border across overlay popups. Popups without a backdrop show a token-colored border in regular mode; popups with a backdrop hide the border (which would be redundant with the backdrop's containment); all popups show a CanvasText border in forced-colors mode (#77691).
  • Link: Use text-decoration-thickness: from-font so the underline honors the font's metrics, instead of a fixed sub-pixel value that renders inconsistently across device pixel ratios (#77790).

Internal

  • Update @base-ui/react from 1.4.0 to 1.4.1 (#77520).
  • Extract shared useScheduleValidation hook; refactor Dialog, Popover, and Tabs validation contexts to use it (#77165).
  • Tabs: Wrap two validation timeout waits in act(...) to avoid intermittent test warnings (#77319).

0.11.0 (2026-04-15)

Breaking Changes

  • Text: Apply margin: 0, removing user-agent margins when the component renders as block-level elements (for example p or h1–h6 via render prop) (#76970).
  • AlertDialog: Revise component API (#76937):
    • AlertDialog.Root: moved intent prop to AlertDialog.Popup;
    • AlertDialog.Popup: moved onConfirm prop to AlertDialog.Root (now optional; supports async handlers, { close: false } to keep the dialog open, and { error: '...' } to display a built-in error message);
    • AlertDialog.Popup: removed loading prop (async flows are now handled internally via Promise-returning onConfirm);
    • AlertDialog.Popup: made children optional in favor of a new description prop, which describes the alert dialog semantically.

New Features

  • Add Popover primitive (#76438).

Bug Fixes

  • Card.Title, EmptyState.Title, EmptyState.Description: Fix ref and props being lost when a custom render element is provided (#77160).
  • Tabs.List: Fix render prop being silently discarded (#77160).
  • Card: Set default foreground color on Card.Root so content and currentColor icons (for example the CollapsibleCard chevron) are themeable by default (#77013).

Enhancements

  • Dialog: Update Header layout to support multiple trailing elements alongside the title (#77161, #77334).
  • Dialog: Use Text internally for Dialog.Title, adopting the heading-xl variant for consistent typography (#77161).
  • Dialog, AlertDialog, Tooltip, Select: Add container prop to Popup for custom portal targets (#77163).
  • Add defensive styles against global WordPress stylesheets like common.css and forms.css (#76783).
  • VisuallyHidden: Improve Storybook stories and documentation for the render prop composition pattern.

Internal

  • Card: Remove redundant margin: 0 from Card.Title now that Text applies it by default (#77187).
  • Normalize render prop handling across components and document conventions in CONTRIBUTING.md (#77160).
  • AlertDialog: Rewrite internals to use Base UI's AlertDialog primitives directly instead of Dialog wrappers. Introduces an internal state machine for async confirm flows (#76937).
  • Field.Label, Fieldset.Legend, Field.Details: Refactor VisuallyHidden composition to preserve semantic HTML elements when visually hiding content.
  • Badge: Use Text component for typography (#77295).
  • Notice.ActionLink: Use Text component for typography (#77332).
  • Update @base-ui/react from 1.3.0 to 1.4.0 (#77308).

0.10.0 (2026-04-01)

New Features

  • Add AlertDialog primitive (#76847).
  • Add InputControl component (#76653).
  • Dialog: Expose initialFocus and finalFocus props on Dialog.Popup for custom focus management (#76860).
  • CollapsibleCard: Add HeaderDescription subcomponent for supplementary header content with aria-describedby relationship (#76867).

Bug Fixes

  • Card: Add overflow: clip to Card.Root to prevent child content from overflowing rounded corners (#76678).
  • CollapsibleCard: do not animate the focus ring when expanding/collapsing the card (#76459).

Enhancements

  • Dialog.Root: expose disablePointerDismissal prop (#76847).
  • Dialog.Popup: Default initialFocus now deprioritizes the close icon, focusing the first tabbable content element instead (following WAI-ARIA APG guidance) (#76910).

Internal

  • Extract useDeprioritizedInitialFocus shared hook for reuse across overlay components (#76910).
  • Tabs: Add development-mode validation for Tab/Panel count matching (#75170).

TypeScript

  • Remove NoticeIntent type from package exports (#76791).

0.9.0 (2026-03-18)

New Features

  • Add Text primitive with predefined typographic variants (heading-2xl through heading-sm, body-xl through body-sm) built on design tokens (#75870).
  • Add Card and CollapsibleCard primitives (#76252).
  • Add Link primitive (#76013).
  • Add Collapsible primitive (#76280).

Bug Fixes

  • InputLayout.Slot: Forward the incoming className prop instead of letting it be silently overwritten by the rest spread (#76459).
  • VisuallyHidden: Add word-break: normal to prevent text wrapping issues in screen reader content (#75539).

Enhancements

  • Badge: Add border, update text color, and apply neutral-strong background to none intent for better contrast against neutral surfaces (#76356).
  • Dialog: Use --wpds-dimension-surface-width-* design tokens for width constraints (#76494).
  • Notice: Improve narrow layout by letting description and actions span the icon column when a title is present (#76202).
  • Notice: Use Text component for Title and Description typography (#75870).
  • Card: Use Text component for Title typography (#76642).
  • Card, CollapsibleCard: update padding to match legacy Card component (#76368).
  • CollapsibleCard: move trigger to the header (#76265).
  • CollapsibleCard: add animations (#76378).
  • CollapsibleCard: allows the browser page search to find and expand the panel contents via the hiddenUntilFound prop. (#76498).

Internal

0.8.0 (2026-03-04)

Breaking Changes

  • InputLayout: Remove the type prop from InputLayout.Slot (#76011).

New Features

  • Add Notice primitive (#75981).

Enhancements

  • Field.Label, Fieldset.Legend: Add hideFromVision prop to visually hide the label while keeping it accessible to screen readers (#76052).
  • Dialog: Add --wp-ui-dialog-z-index CSS custom property for legacy z-index compatibility (#75874).
  • Tooltip: Change default side from bottom to top. (#76131).

Bug Fixes

  • IconButton: Hide tooltip when the button is truly disabled (#75754).

Internal

  • Update @base-ui/react from 1.0.0 to 1.2.0 (#75698).
  • Input: Align ref type with upstream widening to HTMLElement (#75698).

0.7.0 (2026-02-18)

Breaking Changes

  • Remove Box component. Components that previously used Box should use the equivalent design tokens in their CSS directly (#74981).

New Features

  • Add Dialog primitive (#75183).
  • Add Tabs primitive (#74652).
  • Add Textarea primitive (#74707).

Bug Fixes

  • Tabs: Replace hardcoded font values with design tokens on tab buttons (#75537).
  • Field: Fix default gap spacing (#75446).
  • Button: Fix disabled styles while focusableWhenDisabled={false} (#75568).
  • IconButton: make icon always 24px regardless of size prop (#75677).

Enhancements

  • Button: Add minimum content width (6ch + padding) to prevent overly narrow buttons with short labels (#75133).

Internal

  • Button, InputLayout, Tabs: use semantic dimension tokens (#74557).
  • Button: Fix overriding of internal CSS variables (#75568).

0.6.0 (2026-01-29)

New Features

  • Add Select primitive (#74661).

0.5.0 (2026-01-16)

Breaking Changes

  • Remove numeric multiplier option for spacing tokens from Stack and Box components (#73852, #74008).

New Features