CHANGELOG.md

Changelog

0.6.0 (2026-03-23)

Overview

This beta moves the library further toward a platform-native shape. Instead of treating every pattern as a runtime widget, inclusive-elements now combines:

• native-first pattern guidance where the platform already provides the right primitives
• focused custom elements for the patterns that still need runtime coordination

The runtime surface is now centered on ui-alerts, ui-menu, ui-tabs, ui-toolbar, and ui-tooltip, while the other patterns are documented as native recommendations.

Breaking Changes

• modal has been removed as a runtime custom element. Use the native <dialog> pattern instead.
• popup has been removed as a runtime custom element. Use the native Popover API pattern instead.
• accordion is now documented as a native pattern based on grouped <details name>, not shipped as a runtime custom element.
• disclosure is now documented as a native pattern based on <details> and <summary>, not shipped as a runtime custom element.

Component Changes

• alerts: clarified and simplified the alert stack behavior around announcement politeness, timing, replacement by key, and styling hooks for enter, leave, and move transitions.
• menu: rebuilt around native popovers with managed menu semantics, root-trigger keyboard opening, submenu coordination, typeahead, horizontal menu support, and clearer trigger ownership rules.
• tabs: simplified the internal structure syncing, kept selection and panel relationships normalized from the DOM, and tightened keyboard, panel visibility, and managed tabindex behavior.
• toolbar: aligned the toolbar around a single-tab-stop roving focus model with automatic syncing when controls are added, removed, hidden, or disabled.
• tooltip: moved to a native hint-popover model with explicit or adjacent-sibling owner resolution, managed aria-describedby, disabled-owner handling, and cleaner focus and hover interaction rules.

Documentation

• Reworked the component READMEs into a more consistent format with clearer behavior sections, platform requirement notes, and updated examples.
• Added native-first guidance for accordion, disclosure, dialog, and popover.

Tooling

• Add automated test suites around core functionality for alerts, menu, tabs, toolbar, and tooltip.

0.5.5 (2026-03-16)

Features

• menu: add support for horizontal menus (ec720f9)
• tooltip: handle arrow keys as tooltip focus triggers (b50b49b)

0.5.4 (2026-02-20)

Features

• tabs: add selectTab() to programmatically select tabs (f9599c8)

0.5.3 (2026-02-19)

Bug Fixes

• tabs: ensure correct initial tab is selected when none are aria-selected (c127943)

0.5.2 (2026-02-18)

Features

• tabs: dispatch change event on tab selection changes (a1ba27b)
• tabs: select initial tab based on aria-selected attribute (9b4639a)

0.5.1 (2026-01-25)

Bug Fixes

• popup: remove stopPropagation from menuitem clicks (7cbe32a)

0.5.0 (2026-01-18)

Bug Fixes

• tooltip: prevent tooltips showing due to mouse emulation events on touch devices (0582447)

0.5.0-beta.3 (2025-09-27)

Features

• popup: allow popup to initialize with open attribute (e2e8483)

Bug Fixes

• popup: don't hide popup if losing focus to nothing (6a72581)
• popup: prevent menuitem click from bubbling up to any parent popups (bebd0fb)
• tooltip: prevent error if tooltip element no longer exists (eb69dd2)

0.5.0-beta.2 (2024-01-10)

⚠ BREAKING CHANGES

• alerts: alerts can no longer be added by appending to the container

Features

• tooltip: add open and close events (d2800e7)
• tooltip: expose show and hide methods (987d933)

Bug Fixes

• alerts: alerts can no longer be added by appending to the container (4c2c433)
• tooltip: keep tooltip class updated (cb19f93)

0.5.0-beta.1 (2023-11-06)

Features

• alerts: remove hello-goodbye (8e6583a)
• modal: lock body scrolling while modal is open (59e693d)
• popup: use fixed positioning strategy instead of absolute (d00137f)
• tooltip: don't show tooltip on touch (c8998bc)
• tooltip: only show tooltip on focus via Tab key (bb9b0ce)

Bug Fixes

• modal: activate focus trap after transition and fix autofocus (66e0ca1)
• modal: activate focus trap reliably at start of transition (5036a4f)
• modal: fall back to default focus strategy if there is no autofocus element (fe57357)
• popup: subtract margins when calculating max popup size (f842b6d)

0.4.6 (2023-06-29)

Bug Fixes

• tooltip: prevent creating multiple positioners (4dfc42d)

0.4.5 (2023-06-29)

Bug Fixes

• tooltip: clean up tooltip positioner on disconnect (a163ad7)

0.4.4 (2023-06-25)

Bug Fixes

• alerts: fix regression causing alerts not to show (da0b283)

0.4.3 (2023-06-25)

Bug Fixes

• alerts: fix previous alert with same key not being dismissed (356e028)
• update hello-goodbye to fix transitions not running reliably (89f23df)

0.4.2 (2023-06-11)

Features

• tooltip: auto-update position on scroll, resize, etc (587de3b)

Bug Fixes

• tooltip: only update tooltip content if original element content has changed (62ad220)

0.4.1 (2023-04-15)

Bug Fixes

• attempt to fix tree shaking (ac1f1b1)

0.4.0 (2023-04-15)

⚠ BREAKING CHANGES

• disclosure: open and close events have been removed - use toggle instead

Features

• disclosure: add toggle event for consistency with <details> (9fc7f74)
• tabs: new tabs element (4097e73)

0.3.4 (2023-03-21)

Bug Fixes

• disclosure: fix issue with widget not closing in some cases (cb3ae5d)

0.3.3 (2023-03-17)

Bug Fixes

• popup: fix layout flicker when opening popup (42a397b)

0.3.2 (2023-03-17)

Bug Fixes

• tooltip: prevent tooltip flicker on touch scroll (2e461de)

0.3.1 (2023-03-17)

Bug Fixes

• tooltip: show tooltip on touch (d421649)

0.3.0 (2023-03-16)

Features

• add Disclosure and Accordion elements (0df80d3)

Bug Fixes

• modal: prevent scroll on focus trap (de)activation (4e09d5f)
• popup: allow popup trigger button to be nested (6c62efd)

0.2.2 - 2023-03-05

Added

• Alerts: Handle pre-existing children and any subsequently added to the container. Options can be specified as [data-*] attributes.
• Popup: Allow popups to be disabled using the [disabled] attribute.
• Popup: Don't open popup if modifier keys are pressed. This allows link popup triggers to be opened in a new tab.

Fixed

• Popup: Clean up event listeners when popup element is disconnected.

0.2.1 - 2022-08-05

Fixed

• Fix package not including dist files.

0.2.0 - 2022-08-05

Changed

• Upgrade to @floating-ui/dom 1.0.0.
• Switch build tool from Rollup to Vite.

0.1.3 - 2022-06-05

Added

• Popup: Update popup position on resize.

Fixed

• Alerts: Dismiss all alerts by key, not just the first one.
• Modal: Fix some focus issues.
• Popup: Fix max size not being applied.
• Tooltip: Clear timeout on disconnect.

0.1.2 - 2022-03-03

Fixed

• Popup: Fix calculated max size overriding CSS max-size declaration, even if it's larger.

0.1.1 - 2022-02-22

Fixed

• Popup: Fix popup content not having a max size applied.

0.1.0 - 2022-01-28

Fixed

• Menu: Ensure that Arrow keys only navigate to items that are focusable.
• Modal: Fix focus not being placed correctly when modal is open on creation.

0.1.0-beta.9 - 2022-01-27

Added

• New element: Toolbar.
• Support for tree-shaking so unused elements won't be included in the bundle.
• Use prefers-reduced-motion media queries for transition CSS examples.
• Alerts: New clear method to dismiss all alerts.
• Popup: Additional discussion and demonstration of use-cases.
• Tooltip: Support for hovering over tooltip contents (opt-out with pointer-events: none).

Changed

• External dependencies are no longer included in the bundle, meaning a bundler is required for use.
• Modal: Use focus-trap instead of inert so that modals do not have to be placed as a direct child of the <body>.
• Popup, Tooltip: Use Floating UI instead of Placement.js for element positioning.

Fixed

• Set various ARIA attributes less aggressively (ie. only if they haven't already been set).
• Alerts: Export the AlertOptions type definition.
• Menu: Attach event listeners to menu element rather than document.
• Popup: Only add aria-haspopup="true" if the content has the menu role.
• Popup: Close the popup if the user tabs away from it.
• Tooltip: Hide the tooltip when the page is scrolled.

0.1.0-beta.8 - 2021-09-12

Added

• Tooltip: Hide tooltip when Escape key is pressed. (3bcdfcc8)

Removed

• Tooltip: Remove support for touch devices. (7e1c0e69)

Fixed

• Tooltip: Fix parent event listeners not being removed properly on disconnect. (a75b6997)

0.1.0-beta.7 - 2021-05-27

Fixed

• Tooltip: Only remove event listeners on disconnection if parent still exists.

0.1.0-beta.6 - 2021-05-20

Changed

• Alerts: Increase default alert duration to 10 seconds.

Fixed

• Tooltip: Fix behavior on touch devices.
• Update Placement.js to fix incorrect positions when horizontally scrolled.

0.1.0-beta.5 - 2021-05-18

Changed

• Update hello-goodbye version.

0.1.0-beta.4 - 2021-05-09

Changed

• Popup: Don't close when a menuitemcheckbox is clicked.
• Popup: Only return focus to button when Escape key is used to close popup.

Fixed

• Tooltip: Hide tooltip on click, or if parent becomes disabled.
• Implemented disconnect callbacks to properly clean up element side effects.

Removed

• Popup: Don't set z-index - leave this to the userspace.

0.1.0-beta.3 - 2021-03-05

Fixed

• Recompile dist file.

0.1.0-beta.2 - 2021-03-05

Fixed

• Update hello-goodbye version.
• Mark package as side-effect free.