Skip to content

v1.0.0

Latest

Choose a tag to compare

@franciscpd franciscpd released this 14 Oct 19:11
a903146

1.0.0 (2026-09-29)

⚠ BREAKING CHANGES

  • toast-stack: the toast-stack markup changed. The stack root is no longer a live region, it now contains two persistent regions ([data-lyra-toast-region="polite"] and [data-lyra-toast-region="assertive"]), and toast rows no longer carry role="status". It requires @lyra-ds/alpine ^1.1 (the politeToasts / assertiveToasts getters) and @lyra-ds/styles ^1.1. Migration: update tests/CSS that select [role=status] on the stack or its rows to select [data-lyra-toast-region] .lyra-toast (or [data-lyra-toast-region="assertive"] .lyra-toast for danger toasts), and upgrade the Alpine and styles packages to 1.1 or later. Passing x-data to <x-lyra::toast-stack> is not supported; wrap it instead (<div x-data="{...}"><x-lyra::toast-stack /></div>). The stack owns its x-data and does not forward a consumer one.
  • file-upload: adopt the controlled upload lifecycle of Alpine 1.x (#54)
  • navigation: navigation items that have an href now render <a> instead of <button> (sidebar-group / app-sidebar .lyra-sbgroup__item, bottom-nav .lyra-bottomnav__item); breadcrumb non-final items without href render <span> instead of <a href="#">. Migration: CSS and JS selectors that targeted button.lyra-sbgroup__item or button.lyra-bottomnav__item must use the class alone (or :is(a, button)); rely on class selectors rather than a[href="#"] for breadcrumb items; items without href are unchanged and still render buttons. Reset styles for a (text-decoration, color) may need review if you override the item classes.
  • tabs: the public id passthrough now lands on the Tabs root (div[data-lyra-tabs]) instead of the tablist, and the markup requires @lyra-ds/alpine ^1.1 and @lyra-ds/styles ^1.1. Markup and selectors changed: root has data-lyra-tabs; a fallback nav[data-lyra-tabs-fallback] of anchors is added; the tablist is [data-lyra-tabs-enhanced] and starts hidden with no static role, aria-selected, tabindex or lyra-tab--active (Alpine sets them at runtime); panels are section[data-value] with an h2 heading instead of div[role=tabpanel]; tab and panel ids derive from the root id (<id>-tab-N, <id>-panel-N). To migrate: move any test or CSS selector that targeted #your-id as the tablist to #your-id [data-lyra-tabs-enhanced] (or .lyra-tabs), select tabs with [data-lyra-tabs] button[data-value] and panels with section[data-value], rely on [role=tab][aria-selected=true] only after Alpine is ready, and upgrade @lyra-ds/alpine and @lyra-ds/styles to ^1.1.
  • shell,workspace-switcher: WorkspaceSwitcher markup has migrated from a listbox pattern to a disclosure pattern, requiring @lyra-ds/alpine ^1.1 and @lyra-ds/styles ^1.1.
    • Popover container (.lyra-wssw__pop) now emits role="group" with IDs {id}-popover and {id}-popover-label (previously role="listbox" with {id}-listbox and {id}-listbox-label). The trigger button no longer emits aria-haspopup="listbox", and aria-controls now points to {id}-popover.
    • Items (.lyra-wssw__item[data-id]) no longer emit role="option" or aria-selected. The active workspace item is marked with aria-current="true".
    • Workspaces with an href now render as native anchor links (<a class="lyra-wssw__item" href data-id>) that navigate natively on click instead of emitting events. Button items (<button type="button" class="lyra-wssw__item">) and the create action continue to dispatch lyra:change events with { value: dataId }.
    • Shell markup adjustment: When sidebar-as="div", aria-label is no longer emitted on the sidebar container (to avoid invalid landmark labeling on generic div elements). When skipLink is supplied, <main> receives tabindex="-1" and a generated or provided id, and a skip link is rendered as the first child of the shell.
    • Migration: Update any tests, CSS selectors, or client-side scripts targeting old listbox selectors ([role="listbox"], [role="option"], [aria-selected], or #*-listbox) to query .lyra-wssw__pop, .lyra-wssw__item[data-id], and [aria-current]. If tests or integrations relied on anchor-based workspace items emitting lyra:change, note that links now navigate natively.

Features

  • add Blade OTP input component (#45) (e3bbee7)
  • calendar-view: add CalendarView component (#63) (e6b4c9d)
  • create-workspace-dialog: add CreateWorkspaceDialog component (#64) (af2e34b)
  • data-table,date-range-picker: data-table and date-range-picker accessibility (lyra#275, lyra#274) (#55) (56763b5)
  • dropdown,tooltip: item ids, Button-styled trigger, focusable tooltip description (#49) (4745185)
  • enforce owned-root x-data policy for Alpine-bound components (#58) (76d6ca4)
  • file-manager: dispatch open and navigate events (#62) (8bda259)
  • file-upload: adopt the controlled upload lifecycle of Alpine 1.x (#54) (ff9bc43)
  • restore focus for dialog, drawer, bottom-sheet, command-palette and date-picker overlays (#52) (03a0aec)
  • shell,workspace-switcher: banner/skip link; disclosure semantics (#50) (2c75860)
  • tag,toast,action-bar: interactive remove, close and clear actions (#61) (415b9ab)

Bug Fixes

  • brand: fall back to aria-label for the initial (#24) (f6348e3)
  • container max validation parity and app-chrome icons (#47) (c97c33a)
  • make brand mark optional (#22) (6936205)
  • map container max keywords to pixel widths (#21) (08a19aa)
  • navigation: render real links in app-sidebar, bottom-nav and breadcrumb (#48) (425cddc)
  • tabs: emit Alpine 1.x progressive-enhancement markup (#46) (287c241)
  • toast-stack: announce through persistent live regions (#53) (872abe2)