Skip to content
Bladewell

Changelog

Notable changes to bladewell/bladewell, by widget. The format follows Keep a Changelog, and versions follow Semantic Versioning.

Updating

A release changes nothing in your app until you run php artisan bladewell:add --installed. It updates the files you haven't edited and lists the ones you have; php artisan bladewell:diff shows what those would miss.

Component names, props and their values, data-* hooks, JS exports, the bladewell:* commands and flags, and config keys are only ever added to, never renamed or removed. A release can still reject input that never worked (a mistyped value that was ignored now throws); those changes are under Changed.

Unreleased

1.5.5 - 2026-11-20

Added

  • toast: "Dismiss all" above the stack while two or more toasts are up (three on a phone, where its row takes room and two are quickly swiped away); its text is the dismiss-all-label prop. Focus goes back where it was.
  • toast: an action button, like Undo: toast.success('Invoice deleted.', { action: { label: 'Undo', onClick } }). A toast with one stays until it's used or dismissed, is never merged with another, and is read out with "Actions available".
  • toast: each toast is marked data-toast-item.
  • toast: on a touch screen, a toast swipes away sideways, either way: past a third of its width or on a flick. A shorter swipe springs it back, up and down still scroll the stack, and its time holds while it's in the finger.

Changed

  • theme: the light theme's warning colour is amber (#b54708) instead of yellow, so warning dots, borders, icons and bar segments can be seen: 5.4:1 on white, where the yellow was 1.3:1. The dark theme keeps its yellow. If you set --color-warning yourself, nothing changes for you.
  • file-upload: sizes are written as the app's locale writes numbers ("2,5 MB" in German), in the hint, the file list and the too-big message, where the intl extension is installed. Large ones are grouped ("1,000 MB"). UploadLimits::size() takes an optional locale.
  • toast: the layout snippet now sets :alert-auto-close="false", so errors and warnings stay until they're dismissed. The default is unchanged: add it to your layout to get the same.
  • toast: the same toast shown again while it's still up (same kind, title and message) no longer stacks a copy: the one showing counts it (×3), comes back to the top, starts its time again and is read out again. Loading toasts are left as they are. toast.success() and the others return the id of the toast that showed it; merge: false always gives a toast of its own.

Fixed

  • toast: past what fits on screen, the stack scrolls; the toasts were squeezed shorter instead, cutting off their messages.
  • toast: the same toast shown twice at once is read out once, not twice in a row.
  • toast: flashed messages show without JavaScript too, plainly, where the toasts would be.
  • toast: flashed messages show after Turbo and htmx page swaps, not only after a full load or Livewire's wire:navigate.
  • toast: on a touch screen, Dismiss all and an action button take a finger from 44px, as the close button does.

1.5.4 - 2026-11-20

Added

  • field: composing(event) export, true while an input method (Chinese, Japanese, Korean…) is composing.
  • otp: required-message prop, shown when a required code is submitted with boxes left empty.
  • chat: data-chat-error-live in the composer, the live region that reads out a message the server turned away.
  • toast: alert-auto-close prop, how long error and warning toasts stay; false keeps them until dismissed. Unset, they follow auto-close as before.
  • image-cropper: move left, right, up and down buttons (data-image-cropper-action="pan-left" and so on, named by pan-left-label and the like), so the crop can be moved without dragging, as the arrow keys move it.
  • time-picker: variant="native", the browser's own time field, which opens the phone's time picker on a touch screen.

Changed

  • clock: dates follow the locale's own order and words, so in English they now read "Sunday, September 27" (en_GB: "Sunday 27 September"). AM/PM comes from ICU too, with a narrow no-break space before it.
  • command: a click on the dimmed area closes the palette only when the press started there as well, as the modal already did.
  • tabs: closed panels are hidden="until-found" and out of the Tab order (tabindex="-1"). If your CSS keeps closed panels laid out (stacked in one grid cell, say), add content-visibility: visible to that rule.

Fixed

  • all widgets: keyboard focus shows in Windows High Contrast (forced colours), where the focus ring used to vanish. The rule is in base.css.
  • switch, radio, tabs, progress, stepper, datepicker, date-range-picker, calendar, color-picker: the on, checked, open, done, chosen and today states stay visible in Windows High Contrast.
  • phone, select, search, tags: Enter that confirms characters in an input method no longer picks a country, an option or a suggestion, or adds a tag. Tags already handled this in Chrome and now does in Safari too.
  • table: the scrollbars drawn over a table that scrolls inside itself are easier to see.
  • tooltip, tooltip-cursor: a tooltip that only repeats its element's name (an icon button labelled Edit, with Edit as its tooltip) is no longer read out twice.
  • otp: a required code can't be submitted with boxes left empty, and screen readers hear that it's required.
  • progress: with reduced motion, an indeterminate bar or ring slows down instead of stopping on what looked like a value.
  • table: tabbing upwards through a table that scrolls inside itself no longer hides the focused row under the header.
  • pagination: the previous, next, first and last arrows point the right way in a right-to-left page.
  • tabs: a disabled link tab no longer goes to its page when clicked.
  • sidebar-layout: on a narrow screen, the open menu and panel are announced as dialogs, and a Livewire render keeps them so.
  • chat: a message the server turns away is read out, and focus stays in the chat when Load older messages or Retry goes.
  • file-upload: each upload's progress is a progress bar screen readers can follow.
  • kanban, calendar: lists stay lists for VoiceOver in Safari, so a kanban column's card count is heard again.
  • kanban: a radio in a card being dragged no longer unticks the card's own.
  • number, phone: your own autocomplete and inputmode replace the widget's, instead of being ignored next to them.
  • modal: a modal opened again starts with no return value, so an Esc doesn't report the last button again; a locked modal also asks the browser to ignore Esc and the back gesture.
  • command: a text selection dragged out of the search box no longer closes the palette, and the page behind no longer scrolls while it's open.
  • clock: the date and AM/PM are written in the app's locale, in its own order and words (Sonntag, 27. September; 11月19日星期四), on the first frame and as it ticks. An analog clock's time is read out the locale's way too (午後5:41).
  • otp, select, tags, datepicker, date-range-picker, time-picker: a required field that is also readonly no longer stops its form, as a browser doesn't for a readonly input.
  • toast, alert, chat: messages are read out with ariaNotify() where the browser has it, so the first one is never missed; the live regions still say them elsewhere.
  • sortable, kanban: a moved item keeps its focus, and a dragged one its pointer, where the browser can move elements without taking them out of the page (moveBefore()).
  • price-roll: a new value arriving mid-roll no longer makes the digits still rolling jump.
  • tabs, tree: find in page reaches the text in closed tab panels and branches (hidden="until-found"), and opens the tab or branch it found it in.
  • accordion: an item opened by find in page or a link to something in it closes the others in its group, as a click does.
  • pagination: counts are grouped as the app's locale groups them (12.345 in German), where the intl extension is installed.
  • pagination, tree, table: Load more, an item's children and a table's next rows give up after 20 seconds with their error, instead of staying busy for good when the server never answers.
  • captcha: the basic example plays the code aloud too, and the docs say to give an audio version with every image.
  • otp, verification-code: the docs recommend the verification code for codes sent by text or email.

1.5.3 - 2026-11-15

Changed

  • table: the selection bar stays in place, with its buttons disabled until a row is ticked, so ticking a row no longer shifts the rows.

Fixed

  • alert: dismissing one no longer makes the content below jump.
  • button: secondary and tertiary no longer flicker on hover, and the press feels smoother.
  • command, pagination: the command palette and the pagination drawer's backdrop fade in and out, as a modal does.
  • select: the open list follows the field when picked chips wrap onto a new line.
  • select, datepicker, date-range-picker, time-picker, phone, search, table: popups open and close smoothly, as the dropdown does.
  • tags, select: chips ease in and out as they're added and removed.
  • tooltip-cursor: fades in, as the tooltip does.
  • tree: nodes open and close smoothly.

1.5.2 - 2026-11-13

Added

  • tags: required stops an empty submit in the browser, with the field's own error style and focus in the box, as select and the pickers do. The message is the new required-message prop.

Fixed

  • datepicker, date-range-picker: the calendar closes when Tab moves focus out of it.
  • dropdown: type-ahead stays on the focused item when it already matches the letter; pressing the letter again moves on.
  • file-upload: the direct-upload route in Usage checks the file type on the server and stores on the private local disk.
  • image-cropper: lets go of each crop's memory as soon as it's cut, so picking several large photos on a phone no longer reloads the tab.
  • pagination, table: the extra Apply button only shows when JavaScript is off.
  • phone: resetting the form puts the country back along with the number.
  • popover: a popover stays in place, and closes when its trigger scrolls away, after a popover opened inside it closes.
  • select: follows a Livewire render that changes its search address, multiple or display, or draws its chips and clear button again.
  • select, search, time-picker, phone: a list that can't fit beside its field, with the on-screen keyboard up, stays on screen.
  • sortable: a list with another list inside one of its items submits only its own items' order, from the start.
  • table: after a sort, screen readers hear the column that was clicked, also with multi-sort, and "Sort removed from …" when it leaves the sort.
  • tabs: tab keys that differ only in punctuation or spacing (a b, a-b) each get their own ids, so every tab still labels its own panel.
  • tags: a suggestion picked from the browser's list is added at once.
  • toast: toasts shown together are all announced, not just the last, and toasts already showing move into a modal opened after them, where they can be clicked.

1.5.1 - 2026-11-13

Fixed

  • alert, datepicker, date-range-picker, modal, pagination: smoother with Livewire. Each new flash message is announced, the pickers and the page sheet keep their open state through a render, and open modals also open after wire:navigate.
  • color-picker: Enter on a three-digit colour (#abc) submits it as #aabbcc.
  • number, phone, verification-code: pasting reads numbers with thousands separators (1,234), and a whole number or code pasted into a filled field replaces what was there. Undo in a number field always leaves a number.
  • otp, verification-code: the complete event fires once per code, and a letter typed over an OTP digit keeps the digit.
  • popover: clicking the trigger again closes it in Chrome and Edge.
  • price-roll: accepts locales written as de_DE, and shows a plain number for a currency code the browser doesn't know.
  • slider: readonly also holds for pointer drags.
  • toast: appears in the top-most modal when several are open.
  • tooltip-cursor: names an icon with no text for screen readers.

1.5.0 - 2026-11-12

Added

  • calendar: events in a month, week or day view, or as an agenda on narrow screens. Multi-day bars, overlapping events side by side, a "more" list for busy days and a line at the current time. All-day events keep their dates in any timezone. views adds a switch between views, the arrows change the period without reloading the page, and keys reads your models' own fields. Works with Livewire. php artisan bladewell:add calendar
  • sortable: drag, keyboard and Move up/down reordering for lists and grids, like FAQs, menu links or photos. Moves are announced, undoable and keep focus. move-url saves them one at a time, version catches conflicting edits, and name submits the order as name[]. Works with Livewire. php artisan bladewell:add sortable
  • repeater: rows of fields people add, remove and reorder, like order lines. Rows are keyed, so old input, errors and focus stay with the right row. min, max, compact, movable and Livewire actions. php artisan bladewell:add repeater
  • image-cropper: crop an image by drag, pinch or keyboard before it's uploaded, or send coordinates for the server to cut a stored one. Square, round or 16:9 frames, quarter turns, resized and EXIF-free output. php artisan bladewell:add image-cropper
  • filter-builder: people build filters from field, condition and value rows, matching all or any. Filters and FilterField validate them and apply them to a query or a collection, the same on MySQL, PostgreSQL and SQLite. Works with Livewire. php artisan bladewell:add filter-builder

Changed

  • button: its colours ease over a slightly longer moment on hover and press, and don't animate for people who've asked their system for less motion.
  • time-picker, table, select: lighter markup for the time-picker, a new TableSort helper for the table (added by bladewell:add --installed), and a reorganised select script. Nothing looks or works differently.

Fixed

  • tooltip-cursor: shows over an element whose middle is covered while its edges can still be seen, instead of staying hidden.
  • file-upload: a long file name is cut short with an ellipsis on a narrow screen, instead of pushing its row out of the page.
  • table, select, search, pagination: the usage notes' searches match the same on MySQL, PostgreSQL and SQLite, and % and _ match themselves. No widget changes.

1.4.11 - 2026-11-04

Fixed

  • chat: the Livewire and history usage examples are more robust when messages arrive at the same time. No widget changes.

1.4.10 - 2026-11-03

Fixed

  • chat, select, kanban, search, command, otp, verification-code, show-if: server-side usage examples and notes refined. No widget changes.
  • datepicker, date-range-picker: the notes on timezones and caching are clearer. Run php artisan boost:update for the matching Boost guidelines.

1.4.9 - 2026-11-03

Fixed

  • kanban, file-upload, select, chat, table, date-range-picker: the usage examples now follow their own server notes. No widget changes.

1.4.8 - 2026-11-03

Fixed

  • table: clickable rows accept the same links as search and command.

1.4.7 - 2026-11-03

Added

  • password, otp, verification-code, text-input, textarea, number, tags, phone, checkbox, switch, datepicker, date-range-picker, time-picker, color-picker, select, table, pagination, chat, file-upload, search, command, kanban, tree, captcha: notes on what to check and what to keep cheap in the routes behind them, with OWASP and Laravel links. They show under "On the server" on each page, and under consider in bladewell:list --json and the MCP server's get_component and add_components.
  • bladewell:add points to those notes for the widgets you name, and the Laravel Boost guidelines and MCP server tell your agent to read them before writing a widget's routes. Run php artisan boost:update.
  • kanban: a moved card rings for a moment where it lands, and red for longer when your route or Livewire component sends it back.

Fixed

  • date-range-picker, modal: no "Using null as an array offset" deprecation on PHP 8.5 from a date range picker without wire:model or x-model, or a centred modal.
  • pagination: the footer shows "0 of 470" on a page with no rows, not "0–0", and no longer passes null to number_format().

1.4.6 - 2026-10-31

Added

  • tooltip, tooltip-cursor: on a touch screen, a long press on a button or link shows its tooltip without pressing it; a tap still presses. iOS's link preview is off on these elements.
  • tooltip-cursor: on a touch screen, hold a chart bar and slide to read each bar without scrolling the page.

Fixed

  • tooltip, tooltip-cursor: a tooltip opened by a finger shows above it, not under the finger.

1.4.5 - 2026-10-30

Added

  • kanban: cards drag by touch: hold a finger on a card, then drag. A swipe still scrolls, and moves are saved as before.

1.4.4 - 2026-10-28

Added

  • kanban: a new widget, php artisan bladewell:add kanban. Columns of your own cards, moved by a Move menu, the keyboard, a tap or a mouse drag. Moves are announced, can be undone, fire kanban:move, and with move-url are saved to your route, which can refuse them. Readonly boards and columns, locked cards, and wire:kanban-move in Livewire.
  • captcha: Turnstile, reCAPTCHA and hCaptcha work with wire:model. The token is set when issued and cleared when it expires, and a form that fails validation gets a new one.

1.4.3 - 2026-10-27

Fixed

  • toast: the layout usage note gave the default position as top-center; it's top-right.
  • The Laravel Boost guidelines tell your agent not to wrap widgets in wire:ignore, and to set a control's value from the server or Livewire, not a script. Run php artisan boost:update.

1.4.2 - 2026-10-27

Added

  • tags: layout="below" keeps the box to one line and lists the tags under it.

Fixed

  • chat: sending while scrolled up takes you to your message, and a reply that arrives meanwhile shows too.
  • dropdown, popover: a panel opened after the window grew stays on screen. Pressing the same letter again in a dropdown moves to the next item starting with it.
  • dropdown, popover, command: in a disable-close modal, Escape closes the menu, popover or palette on top and returns focus.
  • command: disabled items are greyed out and can't be run; stale results can't be chosen mid-search; no spinner is left after closing.
  • otp: a pasted code fills from the first box, deleting in the middle closes the gap, and digits from any keyboard are read. verification-code reads them too.
  • tags: a readonly field keeps its tags, and a paste over selected text replaces it.
  • search: clearing the box clears the last suggestions.
  • color-picker: emptying the hex box clears the swatch and preview.
  • number: a readonly stepper ignores the arrow keys.
  • captcha: showing another code empties the answer for wire:model too.
  • All widgets in a Livewire component (ElementIds): Livewire::test() no longer throws "Duplicate element id" for a widget with its own id.
  • tabs (remember): an unreadable link entry no longer stops the other remembered tabs opening.
  • stepper: with no steps it draws nothing.
  • toast: a tall stack scrolls, and an updated toast keeps focus on its close button.
  • time-picker: Ctrl, Cmd and Alt shortcuts go to the browser, so Ctrl+A no longer switches a segmented time to AM.
  • tooltip, tooltip-cursor: in a modal, Escape closes the tooltip first. Both stay placed after a resize or a late font.
  • tree: open nodes stay open through a Livewire render, and checkbox parents show the right state at any depth.

1.4.1 - 2026-10-25

Fixed

  • bladewell:add --force and the MCP force option overwrite only the widgets you name, not theme.css, base.css or shared widgets such as field.
  • chat: line breaks survive the server's copy of a message; a refused message stays as Not sent with Edit; Livewire errors show under the box; older messages that fail to load offer Try again.
  • file-upload: a rejected image restores the saved one, Retry respects max-files, and resetting the form empties the widget.
  • select: readonly multiple selects keep their choices; with search-url, only the latest search can show an error and added options stay.
  • datepicker, date-range-picker: without min or max the calendar has no limit; changed limits apply on the next open; 29 February counts as 28 February for birthday and MinimumAge.
  • table: with several tables on a page, changing one leaves the others alone, and a failed filter can be retried.
  • modal: Escape closes only the top modal, and reset-on-close resets any form.
  • time-picker: a segmented time can be edited part by part, its arrows follow step, and typing 1 in a 12-hour list goes to 1:00.
  • number: reads digits from any keyboard, and a stepper without min or negative stops at 0.
  • phone: reads digits from any keyboard, accepts a leading 00, and drops the national prefix for Russia, Kazakhstan and Hungary, in the browser and in Countries::international().
  • bladewell:* commands: work when composer.json maps a namespace to several directories. bladewell:mcp answers batched requests.

1.4.0 - 2026-10-24

Added

  • sidebar-layout: a new widget, an app frame with a sidebar (brand, accordion menu, footer), a fixed top bar and a scrolling page. On large screens it collapses to a rail of icons (collapsed, and remember to keep the choice in a cookie); on phones it slides in over the page. A panel slot adds a side panel such as a chat. RTL and reduced motion supported.
  • accordion: an icon prop on accordion.menu-item and menu groups, shown in a collapsed sidebar-layout.
  • icon: panel-left.
  • chat: a new widget. variant="assistant" for AI replies (Markdown, code blocks, streaming) and variant="messages" for bubbles with names, avatars, times and delivery state. It opens at the newest message, keeps your place when new ones arrive, and loads older ones from history-url. Parts: chat.message, chat.attachment, chat.divider, chat.typing and chat.composer (Enter to send, attachments, async sending, maxlength). compact for narrow columns. Works with wire:submit, wire:model and wire:stream.
  • auth-layout: a new widget for sign-in, sign-up and password pages, with a title, subtitle, form and footer. variant="split" puts a brand panel beside the form; variant="centered" puts it on a card. No script.

Fixed

  • accordion (variant="menu"): closing a group while scrolled no longer leaves empty space and a useless scrollbar.

1.3.3 - 2026-10-22

Changed

  • Theme: --color-field darkens to #ebedf1 and --color-muted to #5d6679, so fields stand out and hints keep 4.5:1. Change these in your copied theme.css; bladewell:add --installed doesn't.
  • All widgets: secondary text goes from text-foreground/60 to /70, to keep 4.5:1 on the darker field.

1.3.2 - 2026-10-14

Changed

  • MCP server (bladewell:mcp): results are compact JSON, using fewer tokens.

1.3.1 - 2026-10-13

Changed

  • Laravel Boost guidelines: point your agent to bladewell:list --json to find widgets. Run php artisan boost:update.

1.3.0 - 2026-10-13

Changed

  • bladewell:add with no names shows a searchable list to pick from (plain text on Windows).
  • bladewell:list shows each widget and what it also installs, without descriptions; those are in --json.
  • bladewell:add with a mistyped name suggests the closest one and reports every unknown name. Exit codes are unchanged.
  • The package requires laravel/prompts (^0.3), which every Laravel 12 and 13 app already has.

1.2.2 - 2026-10-13

Changed

  • Laravel Boost guidelines: widget URLs (suggest-url, search-url, children-url, upload-url) go in routes/web.php, not routes/api.php.
  • search, command: suggestions open only http, https, same-site, mailto: and tel: links; others log a warning.
  • tree: children-url must be on your own site.

1.2.1 - 2026-10-12

Fixed

  • All form fields (base.css): autofilled text follows a switch between light and dark at once.

1.2.0 - 2026-10-12

Added

  • Guidelines for Laravel Boost in resources/boost/guidelines: include bladewell/bladewell in boost:install and your agent learns how to find and add widgets.

1.1.0 - 2026-10-11

Added

  • date-range-picker: on a touch screen, press a start day and slide to the end. Two taps still work, and slides elsewhere scroll.
  • date-range-picker: a tap beside a day's button picks that day.
  • button: confirm, with confirm-message, confirm-label and confirm-cancel, asks before it submits, links or runs wire:click.
  • toast: a data-toast hook shows a toast on click without a script (data-toast-message, data-toast-title; data-toast="dismiss" clears them).
  • select, tags, datepicker, date-range-picker, time-picker, color-picker, slider, otp, checkbox, switch, radio: a readonly prop: the value shows and submits but can't be changed. disabled wins over it, and wire:model still binds.
  • otp: an info hint under the boxes.
  • popover, tabs, tree, clock, command: their script APIs are also on window (window.popover…) and take an id or an element.
  • dropdown: dropdown.open(), close() and toggle(), also on window.dropdown, and dropdown-open / dropdown-close from Livewire.
  • modal, popover, dropdown, tabs, tree, clock, command, progress: a script call or Livewire event for a target that isn't on the page logs a warning.
  • otp, select, textarea: events also sent as otp:complete, select:change and textarea:resize.
  • verification-code: a verification-code:complete event with the code.
  • dropdown: a shared menu for long tables: <x-widget.dropdown.menu id="…"> once, and <x-widget.dropdown menu="…" :values="[…]"> per row. :name placeholders take each row's values and only-if hides items per row. 100 rows go from 564 KB to 251 KB of HTML. New hooks: data-dropdown-values, data-dropdown-shared, data-dropdown-only-if.
  • table: the compact example uses the shared row menu.
  • datepicker: a future example (min="today" :max="false").

Changed

  • select, search, command, table: a prop name from one of the others now throws and names the right one (such as suggest-url on select, which takes search-url), instead of doing nothing.
  • dropdown, popover: an icon-only trigger without label throws, naming the dropdown or popover.

1.0.0 - 2026-10-09

Added

  • modal: bottom sheets (variant="drawer" side="bottom", mobile="sheet") swipe down to close when the backdrop may close them. New hook: data-modal-sheet.
  • pagination (drawer, and the table's page sheet): swipes down to close too.
  • tooltip, tooltip-cursor: on a touch screen, a tap shows the tooltip on plain text, icons and chart bars; the next tap hides it.
  • All widgets (base.css): tap-target and tap-target-y give small controls a 44px tap area on touch screens without drawing them bigger.
  • radio: variant="segmented", a single track for two to four short choices.
  • field: visibleArea() and placeBeside() exports, for placing popovers clear of the on-screen keyboard.
  • color-picker: a new form control: a hex box, the browser's picker (custom) and optional swatches. Works with wire:model.
  • command: a new widget, a command palette opened with Ctrl+K or Cmd+K. Groups and items, search by label or keywords, suggest-url for your app's results, and recent.
  • icon: 40 more icons for apps, commerce, editing and media.
  • popover: a new widget, a panel beside a button that flips when there's no room and handles focus. title, width and align; popover.open(), close() and toggle(); popover-open / popover-close from Livewire.
  • slider: a new form control, one thumb or a range of two, with min, max, step, prefix and suffix. Works with wire:model.
  • tags: a new form control for free-text tags, with suggestions and max. Submits as name[] and works with wire:model.
  • tree: a new widget with four looks (list, cards, org, checkbox), lazy children from children-url, and full keyboard support. Styled through --tree-line, --tree-indent and --tree-gap.

Changed

  • modal, alert, toast, datepicker, date-range-picker: close buttons and month arrows get a 44px tap area on touch screens (tap-target).
  • password, number, captcha, file-upload, select, pagination: small buttons get a 44px tap height on touch screens (tap-target-y).
  • price-roll: the change badge wraps instead of running off a phone's edge.
  • pagination (jump): the on-screen keyboard's return key reads Go.

Fixed

  • modal, toast, pagination: drawers, sheets and toasts stay clear of the notch and home indicator under viewport-fit=cover.
  • search, select, phone, datepicker, date-range-picker, time-picker: lists and calendars open above the field when the on-screen keyboard leaves no room below.

0.3.0 - 2026-10-06

Changed

  • All widgets: LarawellUI is now Bladewell. This release renames the package, commands, config and lock file, with no aliases; widgets and their props, hooks and copied code are unchanged. To upgrade:
    1. composer remove --dev larawellui/larawellui && composer require --dev bladewell/bladewell
    2. Rename config/larawellui.php to config/bladewell.php, if you published it.
    3. Rename larawellui.lock to bladewell.lock before running any command, or bladewell:add --installed will overwrite your edited files.
    4. Use php artisan bladewell:add | list | diff | mcp instead of larawell:*, and update your MCP client's config.
    5. The site is now https://www.bladewellui.com.

0.2.3 - 2026-10-04

Added

  • icon: names outside the built-in set are drawn by Blade Icons (blade-ui-kit/blade-icons) when it's installed, in every widget's icon props.

0.2.2 - 2026-10-04

Added

  • All widgets (base.css): a data-theme-changing hook on <html> holds back colour transitions while the theme switches.

Changed

  • button (<x-widget.button.back>): the arrow sits closer to its label (gap-1.5).

Fixed

  • table: changing page, sort or filter no longer reports CSP violations for the fetched page's inline styles.
  • PHP helpers and validation rules: written in Pint's default style, so running Pint no longer marks them as edited.

0.2.1 - 2026-10-04

Added

  • field: a data-field-info hook on the hint.

Fixed

  • All form widgets: a field with an error is described by the error alone; the hint returns once it clears.
  • table: the sortable example no longer logs a PHP deprecation.

0.2.0 - 2026-10-03

Added

  • show-if: a new widget that shows part of a form only while another field has a given value. Hidden fields don't submit or block the form.
  • breadcrumbs: a new widget, a trail of links to the current page; one link back on phones.
  • search: suggestions as you type from suggest-url, with details, links and groups. suggest-min and messages tune it.
  • select: search-url searches your app as you type, single or multiple, with wire:model. search-min-length, searching and search-failed tune it.
  • All widgets: a dark theme at WCAG AA, with class="dark" or data-theme="dark".
  • Theme: primary-fill, error-fill and success-fill for backgrounds under white text; primary, error and success are for text, borders and tints.
  • icon: 24 more icons.
  • All widgets: examples-use in a manifest names the other widgets its examples need.
  • All widgets: every prop is described on its page, in /r/*.json and through MCP.

Changed

  • button, checkbox, accordion, datepicker, date-range-picker, modal, pagination, progress, stepper, tabs, time-picker: white text sits on the new fill colours.
  • All widgets: a prop value that isn't allowed (variant="primay") now throws and lists the allowed ones. See "Values from your data" in the README.
  • button: type takes only button, submit or reset.
  • dropdown: an item's method takes only GET, POST, PUT, PATCH or DELETE.
  • file-upload: uploaded needs upload-url.
  • modal: size="full" on a drawer, and mobile="sheet" on a drawer or full-screen dialog, now throw.
  • table: a row with both href and details throws; bulk-method takes only GET, POST, PUT, PATCH or DELETE.

Fixed

  • field: required checks skip fields in a disabled fieldset.
  • time-picker: the list and columns are reachable with Tab and arrow keys.
  • table: expandable rows open from a real Details button with aria-expanded.
  • tooltip: around an icon with no text, the wrapper is an image named by the tooltip (role="img").
  • file-upload: inputs no longer get two labels.
  • progress, search: examples pass contrast in dark mode.
  • clock: the countdown no longer gets an empty aria-label.
  • icon, clock, pagination: missing props added to the docs, /r/*.json and MCP.
  • stepper: the bars stepper accepts the same step arrays as the others.

0.1.0 - 2026-10-02

Added

  • 34 widgets: accordion, alert, button, captcha, checkbox, clock, date-range-picker, datepicker, dropdown, field, file-upload, icon, modal, number, otp, pagination, password, phone, price-roll, progress, radio, search, select, stepper, switch, table, tabs, text-input, textarea, time-picker, toast, tooltip, tooltip-cursor and verification-code.
  • bladewell:add, which copies widgets and what they need into your app, with --dry-run, --installed and --force.
  • bladewell:list, with --json.
  • bladewell:diff, showing how your edited copies differ from the package.
  • bladewell:mcp, an MCP server for AI agents.
  • bladewell.lock, so updates replace only files you haven't edited.
  • Livewire 3 and 4 support, with wire:model on every form control.