@quidgest/ui 0.27.0 → 0.28.0

package/CHANGELOG.md

@@ -9,6 +9,66 @@ On `0.x`, breaking changes typically ship as a **minor** bump. The `/release` wo
 
 Entries below start at **0.16.0**. Earlier history is in git / GitLab MRs. Patch releases within a minor line may be summarized under that minor unless a break shipped in between.
 
+## [0.28.0] - 2026-10-13
+
+### Added
+
+- `QAlert` — inline, persistent feedback for forms and page content: `title` (a heading, level set by `headingLevel`), `text` or the default slot, `color`, `variant` (`tonal`, `bold`, `outlined`), `dismissible`, `live`, and `icon` / `actions` slots. `info`, `success`, `warning`, and `danger` add a severity icon, a screen-reader prefix ("Warning:"), and a live region role
+- Help on `QField` and every field built on it: `help` with `helpDisplay` `popover` (default), `tooltip`, or `subtext`, linked to the control through `aria-describedby`
+- `QSection` — `help` on the title as a popover (default), tooltip, or subtext. A titled section is a `role="group"` named by its title
+- `QTab` and `QSteps` — `help` renders as subtext at the top of the panel or step content
+- `QButton` and `QToggle` — `help` and `helpDisplay`, with the same displays as the fields
+- `QButton` `surface` — the color the button sits on, so a button on a colored banner keeps a readable label (`<q-button color="background" surface="primary">`)
+- `QToast` — severity icon for `info`, `success`, `warning`, and `danger`, an `icon` slot, and a `live` prop. `QToaster` announces each toast to screen readers through its own live regions
+- `QTabs`, `QAccordion`, `QList`, `QTextField`, `QColorPicker`, and `QPhoneField` — `icons` prop (`QTabs` and `QAccordion` also `texts`), forwarded to the components they render
+- `QCheckbox` and `QRadioButton` `color` accept any CSS color, not only theme keys
+- `QHelpDisplay`, `QLive`, and `QSelectionLabelPlacement` types exported from the package root
+
+### Changed
+
+- **Breaking:** `icons` and `texts` props require every key: pass the full object or omit the prop. A partial object is not merged with the defaults. Renamed and new keys:
+    - `QOverflow` / `QCarousel` `texts`: `previousText` → `back`, `nextText` → `forward`
+    - `QBadge` / `QSelect` `texts`: `removeText` → `remove`
+    - `QField` and every component built on it: `icons.help` and `texts.showHelp`
+    - `QToast` `icons` and `texts`: `info`, `success`, `warning`, `danger` (also in `useToast` calls and `createFramework` defaults)
+    - `QTabs` / `QSteps`: `texts.back`, `texts.forward`; `icons.back`, `icons.forward`, `icons.up`, `icons.down`
+    - `QPasswordField`: `icons.clear`. `QDialog`: `texts.clearValue`, `texts.showHelp`, `icons.clear`, `icons.help`
+    - `QSelect`, `QCombobox`, `QDropdownMenu`, `QBreadcrumbs`: `icons.check`, `icons.description`. `QSelect` also `icons.remove`; `QBreadcrumbs` also `icons.expand`
+    - `QPhoneField` `texts`: `placeholder`, `showOptions`, `remove`
+- **Breaking:** `createFramework({ defaults })` set on a child no longer reaches it inside a parent that renders it; the parent forwards its own `icons` / `texts`. Move these defaults to the parent: `QListItem.icons` → `QList`, `QSelect`, `QCombobox`, `QDropdownMenu`, `QBreadcrumbs`, `QPhoneField`; `QBadge.icons` → `QSelect`; `QDropdownMenu.icons` → `QBreadcrumbs`; `QOverflow` → `QTabs`, `QSteps`; `QTab.texts` → `QTabs.texts`; `QCollapsible` → `QAccordion`; `QSelect` → `QPhoneField`; `QField` and `QClearButton` → `QTextField` and the components that wrap it (`QPasswordField`, `QCombobox`, `QColorPicker`, `QDateTimePicker`, `QPhoneField`, `QDialog`); `QTextField` → `QColorPicker`, `QDialog`, `QDateTimePicker`, `QPhoneField`; `QClearButton` → `QPhoneField`
+- **Breaking:** Hover colors of components that take their colors from `useColor` (`QButton`, `QBadge`, `QAlert`, `QToast`, `QSteps`, and others) derive from the color itself, not from the theme's `*Dark` / `on*Dark` tokens. In the default dark theme, `secondary`, `highlight`, `info`, `success`, and `warning` now darken on hover instead of lightening. Remove `*Dark` overrides that were only meant for hover, or style the hover in app CSS.
+- **Breaking:** Selection and highlight tints (`QList` options, `QFileUpload` drag-over, `QCard` / `QSection` `background` variant, `QPropertyList` row hover) and the `QSidebar` active indicator derive from `primary`. A theme's own `primaryLight` / `primaryDark`, and CSS overrides of `--q-theme-primary-light` / `--q-theme-primary-dark`, no longer reach them.
+- **Breaking:** `QButton` — `.q-button--background` is removed. `color="background"` goes through `useColor` like every other color: `outlined`, `ghost`, and `text` labels are readable on the page, and it hovers to gray instead of `primaryDark`. On a colored banner, set `surface` to the banner's color. Styles that targeted `.q-button--background` must target the button directly.
+- **Breaking:** `QCheckbox` / `QRadioButton` no longer emit `q-checkbox--{color}` (including `q-checkbox--primary`) or `q-radio-button--{color}`. Set `color`, or override `--q-checkbox-main-color`, `--q-checkbox-on-main-color`, or `--q-radio-button-checked-color`. Non-primary theme colors resolve from the active theme, so CSS overrides such as `--q-theme-success` no longer reach them; `--q-theme-primary` still works for the default.
+- **Breaking:** `QField` wraps its `control` slot in `div.q-field__slot`. Selectors such as `.q-field > .q-field__control` no longer match in `QFileUpload`, `QRadioGroup`, `QObfuscation`, or any other `#control` consumer.
+- **Breaking:** `QCheckbox` and `QSwitch` are built on `QField`, and `class` lands on the field root. `QCheckbox`'s root is `.q-field.q-checkbox-field`: `.q-checkbox` is only the box, the label sits outside it (`.q-checkbox label` no longer matches), `.q-checkbox__label` and `.q-checkbox__label-wrapper` are removed, and the focus ring is on `.q-checkbox-field`. `QSwitch`'s root is `.q-field.q-switch-field` instead of `.q-switch__container`, and `.q-switch` is only the control.
+- **Breaking:** `QCheckbox` `labelPlacement` uses `start` / `end` like `QRadioButton`: migrate `left` → `start` and `right` → `end`. A leftover `left` or `right` silently falls back to `end`. `QCheckbox` no longer accepts the ignored `labelPosition`. `QCheckboxLabel`, `QCheckboxLabelProps`, `QCheckboxLabelPlacement`, and `QRadioButtonLabelPlacement` are removed; use `QSelectionLabelPlacement`.
+- **Breaking:** `QSwitch`, `QCombobox`, and `QPasswordField` now apply `labelPosition`, and `QCombobox` now applies `invalid`. Both were accepted and ignored before, so check call sites that pass them.
+- **Breaking:** `QToast` shows a severity icon by default, including toasts with no `color` (the default is `info`). Move icons from `title.prepend` to the `icon` slot. A `QToast` rendered without `QToaster` gets `role="status"` or `role="alert"`; set `live="off"` to remove it.
+- **Breaking:** `QToaster`'s root is a plain `div` that also holds two visually hidden live regions, so selectors such as `.q-toaster > div` match them too. The regions repeat each toast's text: scope test queries such as `getByText` to `.q-toast`, or ignore `.q-sr-only` content.
+- **Breaking:** `QList` exposed methods (`getItem`, `getActiveItemIndex`, `getAdjacentItemIndex`, `getFirstFocusableItemIndex`, `getLastFocusableItemIndex`) count only the list's own options. Group titles and options of a nested submenu no longer take an index, and the focus methods skip disabled options. Drop any offset added for group titles.
+- **Breaking:** `QDropdownMenu` no longer has a `depth` prop; the menu sets it internally. Remove it from call sites (TypeScript rejects it on `QDropdownMenuProps`).
+- **Breaking:** `QPropertyListGroup` `texts` and `QPropertyListPanel` `icons` are removed. Neither was read.
+- `QToggle` — the pressed state is a 12% tonal fill in the toggle's own `color`, so `color="danger"` no longer presses in primary
+
+### Fixed
+
+- `QList`, `QCombobox`, `QDropdownMenu` — keyboard navigation, typeahead, `aria-activedescendant`, and submenus stay on the right option with titled groups; arrow keys, Home, and End skip disabled options
+- Hover follows an app's own base colors: a theme that sets only `primary` no longer hovers to the default navy, and near-black colors (`#000`, `#222`) lighten on hover instead of staying unchanged
+- `QIcon` — SVG icons without a `bundle` no longer request the current page and emit `error`; font icons with a `variant` but no `library` no longer get a stray class
+- `QSwitch` — a disabled switch dims its label too, and the idle state label on a checked switch reaches 6.5:1 contrast
+- `QPasswordField` / `QColorPicker` — `texts` reach the inner field, so the help and clear button labels follow them
+
+## [0.27.1] - 2026-10-07
+
+### Changed
+
+- `QPropertyList` — panel content gap tightened from `--q-space-4` to `--q-space-1`
+
+### Fixed
+
+- `QIcon` — SVG icons that share a bundle now request it once and reuse the cached markup
+
 ## [0.27.0] - 2026-10-01
 
 ### Added