Skip to main content

CHANGELOG.md 

# Changelog

All notable changes to Aurora UI are documented here. The format follows
[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project uses
[Semantic Versioning](https://semver.org/spec/v2.0.0.html).

Aurora UI's public API is the set of documented `AuroraUI.Components.*` function
components, their attributes/slots, the `--aui-*` CSS custom-property contract,
and the registered JavaScript hook names/DOM contract. Internal modules
(`AuroraUI.Internal`) may change without notice.

## [Unreleased]

## [0.1.1] — 2026-07-11

Interaction and layout fixes found in a full visual/interaction QA pass of the
component lab. All are backward compatible.

### Fixed

- **Overlays now open from a trigger.** `dialog`, `alert_dialog`, and `drawer`
  are opened by toggling `data-aui-open` with `Phoenix.LiveView.JS.set_attribute`
  — a client-side change that never fires the hook's `updated()`. The hooks now
  observe the attribute (`MutationObserver`), so triggers work. The drawer also
  calls the native `show()`/`showModal()` so the `<dialog>` actually renders
  (and a modal drawer regains its backdrop, top layer, and inert background).
- **Dialog is centered.** Consumer resets (e.g. Tailwind Preflight's
  `dialog { margin: 0 }`) clobbered the UA's centering and pinned the modal to
  the top-left; `.aui-dialog` now owns `margin: auto`.
- **Tooltip renders.** The `AuroraTooltip` hook was mounted on the tooltip root
  wrapper and hid it (trigger included). The hook now lives on the bubble, so the
  trigger stays visible and the bubble shows on hover/focus.
- **Popover opens.** The panel carries the native `popover` attribute (CSS shows
  it via `:popover-open`), but the hook toggled `hidden` and never called
  `showPopover()`. It now uses the native popover API (`popover="manual"`, hook
  owns dismissal).
- **Command palette opens from its button.** `mountCommandPalette` never wired
  the visible trigger's click (only the ⌘K shortcut). It now does. The listbox
  gained the `data-aui-command-list` marker the hook queries for.
- **Combobox hook activates.** `phx-hook="AuroraCombobox"` moved from the
  `<input>` to the root container (where `mountCombobox` looks for the input and
  list); added the `data-aui-combobox-input`/`-list` markers.
- **Gallery is a grid again.** `gallery` claims `inline-size: 100%` so its
  auto-fill grid gets real column space inside flex/inline parents instead of
  collapsing to one column.

## [0.1.0] — 2026-07-11

Initial public release.

### Added

- **15 component families** as `Phoenix.Component` function components: Actions,
  Field, Choices, Selection, Navigation, Tabs & disclosure, Overlays, Floating
  UI, Feedback, Data display, Data navigation, Loading/progress, Search/command,
  Media/content, and Experience.
- **Semantic token system** (`assets/css/aurora_ui.css`): brand-neutral
  `--aui-*` custom properties for color, spacing, type, radii, elevation,
  layering, and motion, with independent hand-authored light and dark themes and
  a contrast test.
- **Core JavaScript hooks** (`aurora_ui` entry) plus lazily-imported
  `command`, `motion`, and `three` entry points that stay out of consumer
  bundles until their component is rendered.
- **Fully-implemented Three.js scene host** with static/semantic fallbacks,
  capability detection, pause/resize/context-recovery/disposal.
- **Docs + component lab** (`demo/`) and an example application proving the
  install story end to end.
- Accessibility, browser, bundle, and visual-regression evidence under
  `docs/evidence/`.
- Governance: MIT license, security policy, contribution guide, code of conduct,
  support/compatibility policy, third-party notices, and architecture decision
  records.

[Unreleased]: https://github.com/liamkillingback/aurora-ui/compare/v0.1.1...HEAD
[0.1.1]: https://github.com/liamkillingback/aurora-ui/compare/v0.1.0...v0.1.1
[0.1.0]: https://github.com/liamkillingback/aurora-ui/releases/tag/v0.1.0