@quidgest/ui 0.32.0 → 0.32.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (68) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/dist/json/api.json +198 -28
  3. package/dist/ui.css +291 -108
  4. package/dist/ui.esm.js +989 -966
  5. package/dist/ui.min.css +1 -1
  6. package/dist/ui.scss +433 -105
  7. package/lib/components/QAlert/QAlert.d.ts.map +1 -1
  8. package/lib/components/QAlert/QAlert.vue.js +13 -3
  9. package/lib/components/QAlert/types.d.ts +12 -0
  10. package/lib/components/QAlert/types.d.ts.map +1 -1
  11. package/lib/components/QBadge/QBadge.d.ts.map +1 -1
  12. package/lib/components/QBadge/QBadge.vue.js +20 -12
  13. package/lib/components/QBadge/types.d.ts +11 -0
  14. package/lib/components/QBadge/types.d.ts.map +1 -1
  15. package/lib/components/QDateTimePicker/QDateTimePicker.d.ts.map +1 -1
  16. package/lib/components/QDateTimePicker/QDateTimePicker.vue.js +596 -574
  17. package/lib/components/QDefaultsProvider/QDefaultsProvider.vue.js +4 -2
  18. package/lib/components/QDefaultsProvider/types.d.ts +10 -0
  19. package/lib/components/QDefaultsProvider/types.d.ts.map +1 -1
  20. package/lib/components/QDrawer/QDrawer.d.ts.map +1 -1
  21. package/lib/components/QDrawer/QDrawer.vue.js +204 -201
  22. package/lib/components/QDropdownMenu/QDropdownMenuContent.d.ts.map +1 -1
  23. package/lib/components/QDropdownMenu/QDropdownMenuContent.vue.js +95 -83
  24. package/lib/components/QField/types.d.ts +4 -4
  25. package/lib/components/QGauge/QGauge.d.ts.map +1 -1
  26. package/lib/components/QGauge/QGauge.vue.js +149 -121
  27. package/lib/components/QGauge/types.d.ts +16 -1
  28. package/lib/components/QGauge/types.d.ts.map +1 -1
  29. package/lib/components/QInputGroup/QInputGroup.d.ts +8 -7
  30. package/lib/components/QInputGroup/QInputGroup.d.ts.map +1 -1
  31. package/lib/components/QInputGroup/QInputGroup.vue.js +82 -43
  32. package/lib/components/QLabel/QLabel.d.ts.map +1 -1
  33. package/lib/components/QLabel/QLabel.vue.js +1 -0
  34. package/lib/components/QList/QListItem.d.ts.map +1 -1
  35. package/lib/components/QList/QListItem.vue.js +39 -32
  36. package/lib/components/QMeter/types.d.ts +3 -0
  37. package/lib/components/QMeter/types.d.ts.map +1 -1
  38. package/lib/components/QOverlay/QOverlay.d.ts.map +1 -1
  39. package/lib/components/QOverlay/QOverlay.vue.js +88 -85
  40. package/lib/components/QPhoneField/QPhoneField.d.ts +6 -0
  41. package/lib/components/QPhoneField/QPhoneField.d.ts.map +1 -1
  42. package/lib/components/QPhoneField/QPhoneField.vue.js +1 -1
  43. package/lib/components/QPhoneField/index.d.ts +3 -0
  44. package/lib/components/QPhoneField/index.d.ts.map +1 -1
  45. package/lib/components/QProgress/QProgress.d.ts.map +1 -1
  46. package/lib/components/QProgress/QProgress.vue.js +66 -47
  47. package/lib/components/QProgress/types.d.ts +3 -0
  48. package/lib/components/QProgress/types.d.ts.map +1 -1
  49. package/lib/components/QRadioGroup/QRadioGroup.d.ts +1 -1
  50. package/lib/components/QRadioGroup/index.d.ts +3 -3
  51. package/lib/components/QSelect/QSelect.d.ts +6 -0
  52. package/lib/components/QSelect/QSelect.d.ts.map +1 -1
  53. package/lib/components/QSelect/index.d.ts +3 -0
  54. package/lib/components/QSelect/index.d.ts.map +1 -1
  55. package/lib/components/QToast/QToaster.d.ts.map +1 -1
  56. package/lib/components/QToast/QToaster.vue.js +61 -58
  57. package/lib/composables/defaults.d.ts +25 -1
  58. package/lib/composables/defaults.d.ts.map +1 -1
  59. package/lib/composables/defaults.js +15 -7
  60. package/lib/composables/useColor/index.d.ts +2 -0
  61. package/lib/composables/useColor/index.d.ts.map +1 -1
  62. package/lib/composables/useColor/index.js +25 -19
  63. package/lib/composables/useColor/types.d.ts +12 -0
  64. package/lib/composables/useColor/types.d.ts.map +1 -1
  65. package/lib/utils/bidi.d.ts +27 -0
  66. package/lib/utils/bidi.d.ts.map +1 -0
  67. package/lib/utils/bidi.js +15 -0
  68. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -7,6 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  Entries below start at **0.16.0**. There's a section for every release (major, minor, and patch), including public API breaks with migration steps plus notable Added/Changed/Fixed entries. This file also ships in the npm package.
9
9
 
10
+ ## [0.32.1] - 2026-11-16
11
+
12
+ ### Added
13
+
14
+ - `QBadge` and `QAlert` `surface` — set it to the color of a banner they sit on (for example `<q-alert surface="primary">`). A non-bold button in a bold alert's actions now reads on the alert's fill
15
+ - `QDefaultsProvider` `local` — defaults that stop at overlays, temporary drawers, and toasts declared in its slot. Without it, nothing changes
16
+ - `--q-capitals-lift` — icons and choice controls next to text sit 0.1 of the cap height higher (under a pixel at the default sizes), so they read centered next to lowercase text; uppercase titles stay centered on the capitals. Set `0` to center on the capitals exactly. An app that turns headings off uppercase (`--q-headings-text-transform: none`) should also set `--q-headings-capitals-lift: var(--q-capitals-lift)`
17
+
18
+ ### Changed
19
+
20
+ - Fields with an error or a warning show a 2px shadow around the control, and an input group's text and icon addons take the error or warning border too. A field inside a container with `overflow: hidden` and no padding may get the shadow clipped at the edges
21
+ - The hover of a bold alert's dismiss button and a bold badge's remove button moves away from the fill instead of the page, as every button on a colored surface does (for example light primary badge `#0e3963` → `#569fe7`). Focus rings are unchanged
22
+ - `QList`, `QSelect`, and `QCombobox`: the check element (`.q-list-item__check-container`) is now inside `.q-list-item__container`, positioned at the end of the item. App styles that targeted it as a direct child of the item no longer match
23
+
24
+ ### Fixed
25
+
26
+ - `QList`, `QSelect`, and `QCombobox` — the check sits level with the option's text, beside the label when the row is taller than one line (an avatar or a badge after the label), and above a description when the line is shorter than the box
27
+ - `QInputGroup` — addons no longer stretch into a nested field's label, error, warning, or extras; nested fields fill the group in proportion to their sizes; the group joins correctly in right-to-left pages
28
+ - A checkbox, switch, or radio field with an error shows its error icon level with its text
29
+ - `QDateTimePicker` — no white seams between the days of a range at 125% or 150% scaling, range ends round on the outside in right-to-left pages, and days of the months before and after are no longer bold when in the range or selected
30
+ - `QDropdownMenu` — hovering an item moves focus to it, so only one item looks active at a time, also when the keyboard takes over; submenus work for items keyed by a custom `itemValue`
31
+ - `QSidebar` with `showLabels` keeps its items square (they were several times taller than the strip, pushing later items out of view)
32
+ - Right-to-left pages: `QProgress` sheen and stripes move right to left, and the numbers `QProgress` and `QGauge` write show as written (`-10`, not `10-`); app texts (`QGauge` `tickFormatter`, `valueLabel`, `targetLabel`; `QMeter` `valueLabel`; `QProgress` `text`) read in the direction of their first letter
33
+
10
34
  ## [0.32.0] - 2026-11-12
11
35
 
12
36
  ### Added
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "0.32.0",
2
+ "version": "0.32.1",
3
3
  "components": [
4
4
  {
5
5
  "name": "QAccordion",
@@ -233,6 +233,16 @@
233
233
  "required": false,
234
234
  "category": "Presentation"
235
235
  },
236
+ {
237
+ "name": "surface",
238
+ "type": {
239
+ "kind": "primitive",
240
+ "name": "string"
241
+ },
242
+ "description": "The color the alert sits on, when it is not the theme background: a utility color like\n'primary', or a CSS color code. The text color of the `tonal` and `outlined` variants is\nmeasured against it, so the alert stays readable on a colored banner. The dismiss button\nand the buttons in the `actions` slot (by default) are measured against what they sit on:\nthe tint over it in a `tonal` alert, the surface itself in an `outlined` one. A `bold`\nalert's buttons sit on its own fill, with or without a surface. Defaults to the theme\nbackground.",
243
+ "required": false,
244
+ "category": "Presentation"
245
+ },
236
246
  {
237
247
  "name": "variant",
238
248
  "type": {
@@ -351,6 +361,11 @@
351
361
  "description": "Warning (and other light colors) darken the text for contrast on the page. The outlined border takes that same color, not the raw theme color.",
352
362
  "code": "<QAlert color=\"warning\" variant=\"outlined\" />"
353
363
  },
364
+ {
365
+ "title": "Surface",
366
+ "description": "On a colored banner, set `surface` to the banner's color. The text of the `tonal` and `outlined` variants is then measured against the banner instead of the page, and the dismiss button and the actions get it too. A `bold` alert's buttons sit on its own fill.",
367
+ "code": "<div style=\"display: flex; flex-direction: column; gap: 0.5rem; padding: 1rem; border-radius: var(--q-border-radius); background-color: var(--q-theme-primary)\">\n\t\t\t\t<q-alert\n\t\t\t\t\tv-for=\"variant in variants\"\n\t\t\t\t\t:key=\"variant\"\n\t\t\t\t\t:variant\n\t\t\t\t\tcolor=\"info\"\n\t\t\t\t\tsurface=\"primary\"\n\t\t\t\t\t:text=\"'A ' + variant + ' alert on a primary banner.'\"\n\t\t\t\t\tdismissible>\n\t\t\t\t\t<template #actions>\n\t\t\t\t\t\t<q-button\n\t\t\t\t\t\t\tvariant=\"outlined\"\n\t\t\t\t\t\t\tlabel=\"Undo\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-alert>\n\t\t\t</div>"
368
+ },
354
369
  {
355
370
  "title": "Custom Color",
356
371
  "description": "Any CSS color works too. Colors other than the four severities have no default icon, no screen reader prefix, and use `role=\"status\"`. Pass an icon in the `icon` slot to show one. The slot also replaces the icon of a severity alert.",
@@ -542,6 +557,16 @@
542
557
  "required": false,
543
558
  "category": "Presentation"
544
559
  },
560
+ {
561
+ "name": "surface",
562
+ "type": {
563
+ "kind": "primitive",
564
+ "name": "string"
565
+ },
566
+ "description": "The color the badge sits on, when it is not the theme background: a utility color like\n'primary', or a CSS color code. The text color of the `tonal` and `outlined` variants, and\nthe hover color, are measured against it, so the badge stays readable on a colored banner.\nIts buttons are measured against what they sit on: the badge's fill when `bold` (with or\nwithout a surface), its tint over the surface when `tonal`, and the surface when\n`outlined` or when the badge is clickable. Defaults to the theme background.",
567
+ "required": false,
568
+ "category": "Presentation"
569
+ },
545
570
  {
546
571
  "name": "pill",
547
572
  "type": {
@@ -660,6 +685,11 @@
660
685
  "description": "Warning (and other light colors) darken the text for contrast on the page. The outlined border takes that same color, not the raw theme color.",
661
686
  "code": "<q-badge\n\t\t\t\tvariant=\"outlined\"\n\t\t\t\tcolor=\"warning\">\n\t\t\t\tWarning\n\t\t\t</q-badge>"
662
687
  },
688
+ {
689
+ "title": "Surface",
690
+ "description": "On a colored banner, set `surface` to the banner's color. The text of the `tonal` and `outlined` variants is then measured against the banner instead of the page, so it stays readable. The remove button is measured against what it sits on: the badge's fill when `bold`, its tint over the banner when `tonal`, and the banner when `outlined`.",
691
+ "code": "<div style=\"display: flex; flex-wrap: wrap; gap: 0.5rem; padding: 1rem; border-radius: var(--q-border-radius); background-color: var(--q-theme-primary)\">\n\t\t\t\t<q-badge\n\t\t\t\t\tv-for=\"variant in variants\"\n\t\t\t\t\t:key=\"variant\"\n\t\t\t\t\t:variant\n\t\t\t\t\tcolor=\"danger\"\n\t\t\t\t\tsurface=\"primary\"\n\t\t\t\t\tremovable>\n\t\t\t\t\t{{ variant }}\n\t\t\t\t</q-badge>\n\t\t\t</div>"
692
+ },
663
693
  {
664
694
  "title": "Trailing Icon",
665
695
  "description": "Displays an icon before the text.",
@@ -2134,7 +2164,7 @@
2134
2164
  {
2135
2165
  "title": "Size",
2136
2166
  "description": "A demonstration of checkboxes with different size overrides. Combines with the global density toolbar (product = global × size).",
2137
- "code": "<div style=\"display: flex; align-items: center; gap: 2rem\">\n\t\t\t\t<q-checkbox model-value label=\"Small\" size=\"small\" />\n\t\t\t\t<q-checkbox model-value label=\"Medium\" size=\"medium\" />\n\t\t\t\t<q-checkbox model-value label=\"Large\" size=\"large\" />\n\t\t\t</div>"
2167
+ "code": "<div style=\"display: flex; flex-wrap: wrap; align-items: center; gap: 2rem\">\n\t\t\t\t<q-checkbox model-value label=\"Small\" size=\"small\" />\n\t\t\t\t<q-checkbox model-value label=\"Medium\" size=\"medium\" />\n\t\t\t\t<q-checkbox model-value label=\"Large\" size=\"large\" />\n\t\t\t</div>"
2138
2168
  },
2139
2169
  {
2140
2170
  "title": "Icons",
@@ -2772,7 +2802,7 @@
2772
2802
  "kind": "primitive",
2773
2803
  "name": "boolean"
2774
2804
  },
2775
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
2805
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
2776
2806
  "required": false,
2777
2807
  "category": "State"
2778
2808
  },
@@ -3267,7 +3297,7 @@
3267
3297
  "kind": "primitive",
3268
3298
  "name": "boolean"
3269
3299
  },
3270
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
3300
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
3271
3301
  "required": false,
3272
3302
  "category": "State"
3273
3303
  },
@@ -3443,9 +3473,19 @@
3443
3473
  },
3444
3474
  {
3445
3475
  "title": "Range Around Today",
3446
- "description": "A range around today. The band's edges above and below are a shadow, so today keeps its own border, in the main color on every side, inside the range.",
3476
+ "description": "A range around today, in both themes. The band of a week is a layer under the days: today keeps its own border, in the main color on every side, over it. The tint is too faint to show the range on its own (about 1.2:1), so the band takes edges in the text color, which show it.",
3447
3477
  "code": "<QDateTimePicker label=\"Select a date range\" :range=\"true\" format=\"dd/MM/yyyy\" :model-value=\"[\n\t\t\tnew Date(now.getFullYear(), now.getMonth(), now.getDate() - 3),\n\t\t\tnew Date(now.getFullYear(), now.getMonth(), now.getDate() + 3)\n\t\t]\" />"
3448
3478
  },
3479
+ {
3480
+ "title": "Range Across Months",
3481
+ "description": "A range from one month into the next. Its days in the next month stay as light as that month's other days, not bold: only the days of the month on display are bold, in a range or not. The band runs through the days of a week with no seam between them, at any scale.",
3482
+ "code": "<QDateTimePicker label=\"Select a date range\" :range=\"true\" format=\"dd/MM/yyyy\" :model-value=\"[new Date(2026, 3, 3), new Date(2026, 4, 10)]\" />"
3483
+ },
3484
+ {
3485
+ "title": "Range Right To Left",
3486
+ "description": "A range in a right-to-left page. The band runs from the start, on the right, to the end, on the left, and the ends round on the outside of the range: the start on the right, the end on the left. The menu opens in place (`inline`), in the story's right-to-left container.",
3487
+ "code": "<QDateTimePicker label=\"Select a date range\" :range=\"true\" :inline=\"true\" format=\"dd/MM/yyyy\" :model-value=\"[new Date(2026, 3, 3), new Date(2026, 3, 15)]\" />"
3488
+ },
3449
3489
  {
3450
3490
  "title": "Typed Text Not A Date",
3451
3491
  "description": "Text that is not a date stays in the field for the user to fix. The field turns invalid and says how to type one, with today as the example (`texts.invalidValue`), and the model keeps its last value. So does a date that does not exist, such as 31 February: it is not changed to one that does. A date clears the error.",
@@ -3496,6 +3536,16 @@
3496
3536
  "description": "The default configuration values to provide to child components.\nThese values will be **merged with each component's own defaults**.",
3497
3537
  "required": true,
3498
3538
  "category": "Configuration"
3539
+ },
3540
+ {
3541
+ "name": "local",
3542
+ "type": {
3543
+ "kind": "primitive",
3544
+ "name": "boolean"
3545
+ },
3546
+ "description": "Keeps the defaults out of what is drawn on its own surface, over the page, but declared in\nthe slot: overlays (dialogs, popovers, menus), temporary drawers and toasts. They reach every\nother component in it. For defaults that depend on where the content is drawn, such as the\n`surface` of buttons on a colored banner. The defaults the app sets, and those of other\nproviders, still reach them.",
3547
+ "required": false,
3548
+ "category": "Configuration"
3499
3549
  }
3500
3550
  ],
3501
3551
  "events": [],
@@ -4574,6 +4624,11 @@
4574
4624
  "description": "`railExpand=\"replace\"`: collapsed `#rail` is the same destinations as icons only; hover widens into a labeled nav (top level + one sub-level at most) and the strip yields. No group separators. Strip and panel stay in sync on click.",
4575
4625
  "code": "<div class=\"q-drawer-story-shell q-drawer-rail-nav-demo\">\n\t\t\t\t<!-- Explicit after v-bind so Controls cannot reset railExpand to beside. -->\n\t\t\t\t<q-drawer v-model=\"args.modelValue\" v-bind=\"args\" rail-expand=\"replace\">\n\t\t\t\t\t<template #rail>\n\t\t\t\t\t\t<q-button\n\t\t\t\t\t\t\tv-for=\"item in items\"\n\t\t\t\t\t\t\t:key=\"item.id\"\n\t\t\t\t\t\t\tvariant=\"ghost\"\n\t\t\t\t\t\t\t:color=\"active === item.id || item.children?.some((c) => c.id === active) ? 'primary' : 'neutral'\"\n\t\t\t\t\t\t\tborderless\n\t\t\t\t\t\t\t:title=\"item.label\"\n\t\t\t\t\t\t\t:aria-label=\"item.label\"\n\t\t\t\t\t\t\t:aria-pressed=\"active === item.id || item.children?.some((c) => c.id === active)\"\n\t\t\t\t\t\t\t@click=\"selectFromRail(item.id)\">\n\t\t\t\t\t\t\t<q-icon :icon=\"item.icon\" />\n\t\t\t\t\t\t</q-button>\n\t\t\t\t\t</template>\n\t\t\t\t\t<nav class=\"q-drawer-rail-nav\" :aria-label=\"args.label\">\n\t\t\t\t\t\t<template v-for=\"item in items\" :key=\"item.id\">\n\t\t\t\t\t\t\t<q-button\n\t\t\t\t\t\t\t\tclass=\"q-drawer-rail-nav__item\"\n\t\t\t\t\t\t\t\tvariant=\"ghost\"\n\t\t\t\t\t\t\t\t:color=\"active === item.id || item.children?.some((c) => c.id === active) ? 'primary' : 'neutral'\"\n\t\t\t\t\t\t\t\tborderless\n\t\t\t\t\t\t\t\t:aria-pressed=\"active === item.id || item.children?.some((c) => c.id === active)\"\n\t\t\t\t\t\t\t\t:aria-expanded=\"item.children ? Boolean(expanded[item.id]) : undefined\"\n\t\t\t\t\t\t\t\t@click=\"selectFromPanel(item.id)\">\n\t\t\t\t\t\t\t\t<q-icon :icon=\"item.icon\" />\n\t\t\t\t\t\t\t\t<span class=\"q-drawer-rail-nav__item-label\">{{ item.label }}</span>\n\t\t\t\t\t\t\t\t<q-icon\n\t\t\t\t\t\t\t\t\tv-if=\"item.children\"\n\t\t\t\t\t\t\t\t\t:icon=\"expanded[item.id] ? 'chevron-up' : 'chevron-down'\" />\n\t\t\t\t\t\t\t</q-button>\n\t\t\t\t\t\t\t<div\n\t\t\t\t\t\t\t\tv-if=\"item.children && expanded[item.id]\"\n\t\t\t\t\t\t\t\tclass=\"q-drawer-rail-nav__children\">\n\t\t\t\t\t\t\t\t<q-button\n\t\t\t\t\t\t\t\t\tv-for=\"child in item.children\"\n\t\t\t\t\t\t\t\t\t:key=\"child.id\"\n\t\t\t\t\t\t\t\t\tclass=\"q-drawer-rail-nav__child\"\n\t\t\t\t\t\t\t\t\tvariant=\"ghost\"\n\t\t\t\t\t\t\t\t\t:color=\"active === child.id ? 'primary' : 'neutral'\"\n\t\t\t\t\t\t\t\t\tborderless\n\t\t\t\t\t\t\t\t\t:aria-pressed=\"active === child.id\"\n\t\t\t\t\t\t\t\t\t@click=\"selectChild(child.id)\">\n\t\t\t\t\t\t\t\t\t<q-badge\n\t\t\t\t\t\t\t\t\t\tv-if=\"child.code\"\n\t\t\t\t\t\t\t\t\t\tvariant=\"tonal\"\n\t\t\t\t\t\t\t\t\t\tcolor=\"primary\"\n\t\t\t\t\t\t\t\t\t\tsize=\"small\"\n\t\t\t\t\t\t\t\t\t\tpill>\n\t\t\t\t\t\t\t\t\t\t{{ child.code }}\n\t\t\t\t\t\t\t\t\t</q-badge>\n\t\t\t\t\t\t\t\t\t<q-icon v-else-if=\"child.icon\" :icon=\"child.icon\" />\n\t\t\t\t\t\t\t\t\t<span class=\"q-drawer-rail-nav__item-label\">{{ child.label }}</span>\n\t\t\t\t\t\t\t\t</q-button>\n\t\t\t\t\t\t\t</div>\n\t\t\t\t\t\t</template>\n\t\t\t\t\t</nav>\n\t\t\t\t</q-drawer>\n\t\t\t\t<main :style=\"mainStyle\">\n\t\t\t\t\t<p>\n\t\t\t\t\t\tSame destinations as the icon strip — labels plus one sub-level when a\n\t\t\t\t\t\tsection is open. No separators or deeper nesting.\n\t\t\t\t\t</p>\n\t\t\t\t\t<p style=\"color: var(--q-text-color-secondary);\">\n\t\t\t\t\t\tActive: {{ activeLabel }}\n\t\t\t\t\t</p>\n\t\t\t\t</main>\n\t\t\t</div>"
4576
4626
  },
4627
+ {
4628
+ "title": "Rail Menus",
4629
+ "description": "A permanent `rail` with no panel: only the icon strip ever shows (no `expandOnHover`, no default slot). Each strip button opens its own `QDropdownMenu` beside the strip, titled in its `#prepend` slot, and each menu shows another option of the dropdown: icons, groups, descriptions, submenus, shortcuts, and groups with icons.",
4630
+ "code": "<div class=\"q-drawer-story-shell\">\n\t\t\t\t<q-drawer v-model=\"args.modelValue\" v-bind=\"args\">\n\t\t\t\t\t<template #rail>\n\t\t\t\t\t\t<q-button\n\t\t\t\t\t\t\tv-for=\"menu in menus\"\n\t\t\t\t\t\t\t:key=\"menu.id\"\n\t\t\t\t\t\t\t:ref=\"(button) => setActivator(menu.id, button)\"\n\t\t\t\t\t\t\t:class=\"['q-drawer-rail-menus__button', { 'q-drawer-rail-menus__button--open': open[menu.id] }]\"\n\t\t\t\t\t\t\tvariant=\"ghost\"\n\t\t\t\t\t\t\t:color=\"open[menu.id] ? 'primary' : 'neutral'\"\n\t\t\t\t\t\t\tborderless\n\t\t\t\t\t\t\t:title=\"menu.label\"\n\t\t\t\t\t\t\t:aria-label=\"menu.label\">\n\t\t\t\t\t\t\t<q-icon :icon=\"menu.icon\" />\n\t\t\t\t\t\t</q-button>\n\t\t\t\t\t</template>\n\t\t\t\t</q-drawer>\n\t\t\t\t<q-dropdown-menu\n\t\t\t\t\tv-for=\"menu in menus\"\n\t\t\t\t\t:key=\"menu.id\"\n\t\t\t\t\tv-model=\"open[menu.id]\"\n\t\t\t\t\t:activator=\"activators[menu.id]\"\n\t\t\t\t\t:items=\"menu.items\"\n\t\t\t\t\t:groups=\"menu.groups\"\n\t\t\t\t\tplacement=\"right-start\"\n\t\t\t\t\t@select=\"(key) => onSelect(menu, key)\">\n\t\t\t\t\t<template #prepend>\n\t\t\t\t\t\t<div class=\"q-drawer-rail-menus__title\">{{ menu.label }}</div>\n\t\t\t\t\t\t<q-divider />\n\t\t\t\t\t</template>\n\t\t\t\t</q-dropdown-menu>\n\t\t\t\t<main :style=\"mainStyle\">\n\t\t\t\t\t<p>\n\t\t\t\t\t\tOnly the icon strip shows. Each icon opens its own menu: Create has icons,\n\t\t\t\t\t\tProjects groups, Notifications descriptions, Reports submenus, Tools\n\t\t\t\t\t\tshortcuts, and Account groups with icons.\n\t\t\t\t\t</p>\n\t\t\t\t\t<p style=\"color: var(--q-text-color-secondary);\">\n\t\t\t\t\t\tLast choice: {{ lastChoice }}\n\t\t\t\t\t</p>\n\t\t\t\t</main>\n\t\t\t</div>"
4631
+ },
4577
4632
  {
4578
4633
  "title": "Resizable",
4579
4634
  "description": "Resizable permanent drawer. Drag the free edge, use ArrowLeft / ArrowRight on the handle (Home / End for min / max), or the Narrow / Widen buttons (WCAG 2.5.7).",
@@ -4993,7 +5048,7 @@
4993
5048
  "kind": "primitive",
4994
5049
  "name": "boolean"
4995
5050
  },
4996
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
5051
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
4997
5052
  "required": false,
4998
5053
  "category": "State"
4999
5054
  }
@@ -5192,7 +5247,7 @@
5192
5247
  "kind": "primitive",
5193
5248
  "name": "boolean"
5194
5249
  },
5195
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
5250
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
5196
5251
  "required": false,
5197
5252
  "category": "State"
5198
5253
  },
@@ -5507,7 +5562,7 @@
5507
5562
  }
5508
5563
  ]
5509
5564
  },
5510
- "description": "Text or formatter used as the fallback display and as the current-value part\nof `aria-valuetext`. Set this when the `value` slot changes how the value\nshould be announced, because slot markup cannot be inferred reliably for\naccessibility. When provided, it is treated as complete current-value text,\nso the unit is not appended there automatically.",
5565
+ "description": "Text or formatter used as the fallback display and as the current-value part\nof `aria-valuetext`. Set this when the `value` slot changes how the value\nshould be announced, because slot markup cannot be inferred reliably for\naccessibility. When provided, it is treated as complete current-value text,\nso the unit is not appended there automatically.\n\nIn a right-to-left page, the text reads in the direction of its first letter: Arabic or Hebrew\nright to left, and a text with no letter, such as `-20%`, left to right, as written. The numbers\nthe gauge formats itself always read left to right.",
5511
5566
  "required": false,
5512
5567
  "category": "Content"
5513
5568
  },
@@ -5549,7 +5604,7 @@
5549
5604
  }
5550
5605
  ]
5551
5606
  },
5552
- "description": "Text or formatter used to describe the target value.",
5607
+ "description": "Text or formatter used to describe the target value.\n\nIn a right-to-left page, the text reads in the direction of its first letter: Arabic or Hebrew\nright to left, and a text with no letter, such as `-20%`, left to right, as written. The numbers\nthe gauge formats itself always read left to right.",
5553
5608
  "required": false,
5554
5609
  "category": "Content"
5555
5610
  },
@@ -5591,7 +5646,7 @@
5591
5646
  "kind": "primitive",
5592
5647
  "name": "string"
5593
5648
  },
5594
- "description": "Unit displayed next to the current value.",
5649
+ "description": "Unit displayed next to the current value, and after the target value.\n\nIn a right-to-left page, the unit reads in the direction of its first letter: `°C` as written,\nand a unit in Arabic or Hebrew right to left.",
5595
5650
  "required": false,
5596
5651
  "category": "Content"
5597
5652
  },
@@ -5622,7 +5677,7 @@
5622
5677
  "kind": "unknown",
5623
5678
  "raw": "((value: number) => string) | undefined"
5624
5679
  },
5625
- "description": "Formatter used for scale labels.",
5680
+ "description": "Formatter used for scale labels.\n\nIn a right-to-left page, the text reads in the direction of its first letter: Arabic or Hebrew\nright to left, and a text with no letter, such as `-20%`, left to right, as written. The numbers\nthe gauge formats itself always read left to right.",
5626
5681
  "required": false,
5627
5682
  "category": "Configuration"
5628
5683
  },
@@ -5671,6 +5726,16 @@
5671
5726
  "title": "Responsive Composition",
5672
5727
  "description": "Gauges remain responsive when composed into a KPI dashboard owned by the consumer.",
5673
5728
  "code": "<div class=\"q-gauge-story-grid\">\n\t\t\t\t<q-gauge\n\t\t\t\t\tv-for=\"item in items\"\n\t\t\t\t\t:key=\"item.label\"\n\t\t\t\t\t:model-value=\"item.value\"\n\t\t\t\t\t:label=\"item.label\"\n\t\t\t\t\t:target=\"item.target\"\n\t\t\t\t\t:unit=\"item.unit\"\n\t\t\t\t\t:ranges=\"performanceRanges\"\n\t\t\t\t\t:show-legend=\"false\"\n\t\t\t\t/>\n\t\t\t</div>"
5729
+ },
5730
+ {
5731
+ "title": "Right To Left",
5732
+ "description": "In a right-to-left page, the dial stays as it is, with the lowest value on the left, as a speedometer or a clock does; the label, the value and the legend around it read from the right. The numbers show as written (`-20`, not `20-`): on the scale, in the value and at the target, and so does the unit (`°C`, not `C°`), which reads in the direction of its first letter.",
5733
+ "code": "<div dir=\"rtl\" style=\"width: 20rem\">\n\t\t\t\t<q-gauge v-bind=\"args\" />\n\t\t\t</div>"
5734
+ },
5735
+ {
5736
+ "title": "Right To Left Formatted",
5737
+ "description": "In a right-to-left page, a tick label, value or target value the app formats reads in the direction of its first letter, so a number alone, such as `-20%`, reads as written.",
5738
+ "code": "<div dir=\"rtl\" style=\"width: 20rem\">\n\t\t\t\t<q-gauge v-bind=\"args\" />\n\t\t\t</div>"
5674
5739
  }
5675
5740
  ]
5676
5741
  },
@@ -5891,7 +5956,7 @@
5891
5956
  "kind": "primitive",
5892
5957
  "name": "boolean"
5893
5958
  },
5894
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
5959
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
5895
5960
  "required": false,
5896
5961
  "category": "State"
5897
5962
  },
@@ -6043,10 +6108,55 @@
6043
6108
  "description": "Makes every field in the group read-only, while its buttons stay enabled. A field that sets its own `readonly` keeps it.",
6044
6109
  "code": "<QInputGroup :readonly=\"true\" />"
6045
6110
  },
6111
+ {
6112
+ "title": "Invalid",
6113
+ "description": "Put the message in the group's `errors` slot and pass the fields the `invalid` and `describedBy` of the default slot. The group draws one danger shadow around all its parts, and its text and icon addons take the danger border with the fields. A button addon keeps its own.",
6114
+ "code": "<QInputGroup label=\"Email\" :prepend-icon=\"{\n\t\t\ticon: 'email'\n\t\t}\" :invalid=\"true\" />"
6115
+ },
6116
+ {
6117
+ "title": "Warning Message",
6118
+ "description": "A warning in the group's `warnings` slot draws the group's shadow and its addons' border in warning-dark, and leaves the fields valid.",
6119
+ "code": "<QInputGroup label=\"Email\" :prepend-icon=\"{\n\t\t\ticon: 'email'\n\t\t}\" />"
6120
+ },
6121
+ {
6122
+ "title": "Warning With Invalid Field",
6123
+ "description": "A field marked invalid on its own, in a group with a warning: the error wins, as it does in a field, so the group draws its shadow and its addons' border in danger.",
6124
+ "code": "<QInputGroup label=\"Email\" :prepend-icon=\"{\n\t\t\ticon: 'email'\n\t\t}\" />"
6125
+ },
6126
+ {
6127
+ "title": "Invalid With Nested Messages",
6128
+ "description": "The group's shadow wraps its control row alone: the labels of the nested fields above it and their messages under it stay outside.",
6129
+ "code": "<q-input-group v-bind=\"args\">\n\t\t\t\t<template #default=\"{ invalid }\">\n\t\t\t\t\t<q-text-field label=\"Name\" :invalid=\"invalid\">\n\t\t\t\t\t\t<template #errors>Enter your name</template>\n\t\t\t\t\t</q-text-field>\n\t\t\t\t\t<q-text-field label=\"Email\" :invalid=\"invalid\">\n\t\t\t\t\t\t<template #extras>We never share it</template>\n\t\t\t\t\t</q-text-field>\n\t\t\t\t</template>\n\t\t\t\t<template #errors>Enter a name and an email</template>\n\t\t\t</q-input-group>"
6130
+ },
6046
6131
  {
6047
6132
  "title": "Mixed Heights",
6048
- "description": "Keeps sibling controls aligned when one child has a larger intrinsic height.",
6049
- "code": "<q-input-group v-bind=\"args\">\n\t\t\t\t<q-text-field aria-label=\"Name\" placeholder=\"Name\" />\n\t\t\t\t<q-text-area aria-label=\"Notes\" placeholder=\"Notes\" :rows=\"3\" />\n\t\t\t</q-input-group>"
6133
+ "description": "Keeps sibling controls aligned when one child has a larger intrinsic height. An error under one field must not stretch the other controls into the message area.",
6134
+ "code": "<div>\n\t\t\t\t<q-input-group v-bind=\"args\">\n\t\t\t\t\t<q-text-field aria-label=\"Name\" placeholder=\"Name\" />\n\t\t\t\t\t<q-text-area aria-label=\"Notes\" placeholder=\"Notes\" :rows=\"3\" />\n\t\t\t\t\t<q-date-time-picker\n\t\t\t\t\t\taria-label=\"Due date\"\n\t\t\t\t\t\tformat=\"dd/MM/yyyy\"\n\t\t\t\t\t\tplaceholder=\"Due date\" />\n\t\t\t\t\t<q-text-field\n\t\t\t\t\t\taria-label=\"Code\"\n\t\t\t\t\t\tplaceholder=\"Code\"\n\t\t\t\t\t\tsize=\"mini\"\n\t\t\t\t\t\tinvalid>\n\t\t\t\t\t\t<template #errors>\n\t\t\t\t\t\t\tThis error is long enough to wrap onto several lines in a narrow field\n\t\t\t\t\t\t</template>\n\t\t\t\t\t\t<template #warnings>Also a warning under the error</template>\n\t\t\t\t\t</q-text-field>\n\t\t\t\t\t<template #append>\n\t\t\t\t\t\t<q-button aria-label=\"Lookup\">\n\t\t\t\t\t\t\t<q-icon icon=\"format-list-bulleted\" />\n\t\t\t\t\t\t</q-button>\n\t\t\t\t\t</template>\n\t\t\t\t</q-input-group>\n\t\t\t\t<p data-testid=\"after-group\">Next row</p>\n\t\t\t</div>"
6135
+ },
6136
+ {
6137
+ "title": "Sized Beside Block",
6138
+ "description": "A field with a size keeps it beside a field without one, as outside a group: the area code stays small and the number takes the rest of the group.",
6139
+ "code": "<q-input-group v-bind=\"args\">\n\t\t\t\t<q-text-field aria-label=\"Area code\" size=\"small\" />\n\t\t\t\t<q-text-field aria-label=\"Number\" />\n\t\t\t</q-input-group>"
6140
+ },
6141
+ {
6142
+ "title": "Labeled Controls",
6143
+ "description": "A field with a label of its own keeps it above the control row and its messages under it, so the addons and the other fields line up with its control. A checkbox with its label beside it sits in the control row. A checkbox or switch keeps its content width, labeled or not, and the text field takes the rest.",
6144
+ "code": "<div>\n\t\t\t<q-input-group v-bind=\"args\">\n\t\t\t\t<q-text-field aria-label=\"Email\" invalid>\n\t\t\t\t\t<template #errors>Enter a valid email address</template>\n\t\t\t\t</q-text-field>\n\t\t\t\t<q-checkbox label=\"Weekly\" />\n\t\t\t\t<template #append>\n\t\t\t\t\t<q-button label=\"Subscribe\" />\n\t\t\t\t</template>\n\t\t\t</q-input-group>\n\t\t\t<q-input-group label=\"Search\">\n\t\t\t\t<q-text-field label=\"Query\" invalid>\n\t\t\t\t\t<template #errors>Enter at least three characters</template>\n\t\t\t\t</q-text-field>\n\t\t\t\t<q-text-field aria-label=\"Scope\" />\n\t\t\t\t<template #append>\n\t\t\t\t\t<q-button label=\"Go\" />\n\t\t\t\t</template>\n\t\t\t</q-input-group>\n\t\t\t<q-input-group label=\"Status\">\n\t\t\t\t<q-text-field aria-label=\"Name\" />\n\t\t\t\t<q-checkbox aria-label=\"Active\" />\n\t\t\t</q-input-group>\n\t\t\t</div>"
6145
+ },
6146
+ {
6147
+ "title": "Nested Help",
6148
+ "description": "A nested field without a label shows its popover help button beside its control. The control fills the field's column, so the help button meets the next control with no gap.",
6149
+ "code": "<q-input-group v-bind=\"args\">\n\t\t\t\t<q-text-field\n\t\t\t\t\taria-label=\"Code\"\n\t\t\t\t\thelp=\"Find the code in your welcome email\"\n\t\t\t\t\thelp-display=\"popover\" />\n\t\t\t\t<template #append>\n\t\t\t\t\t<q-button label=\"Apply\" />\n\t\t\t\t</template>\n\t\t\t</q-input-group>"
6150
+ },
6151
+ {
6152
+ "title": "Right To Left",
6153
+ "description": "In a right-to-left page the group starts on the right: the prepend sits there with the rounded corners, and neighbors share one border.",
6154
+ "code": "<div dir=\"rtl\">\n\t\t\t\t<q-input-group v-bind=\"args\">\n\t\t\t\t\t<q-text-field aria-label=\"Address\" />\n\t\t\t\t\t<template #prepend>\n\t\t\t\t\t\t<span>https://</span>\n\t\t\t\t\t</template>\n\t\t\t\t\t<template #append>\n\t\t\t\t\t\t<span>.com</span>\n\t\t\t\t\t</template>\n\t\t\t\t</q-input-group>\n\t\t\t</div>"
6155
+ },
6156
+ {
6157
+ "title": "Narrow",
6158
+ "description": "In a narrow layout the field shrinks first, down to its content and the target size of its input, while the addon text and the button keep their whole width.",
6159
+ "code": "<div data-testid=\"container\">\n\t\t\t\t<q-input-group v-bind=\"args\">\n\t\t\t\t\t<q-text-field aria-label=\"User\" />\n\t\t\t\t\t<template #append>\n\t\t\t\t\t\t<span>@example.com</span>\n\t\t\t\t\t\t<q-button label=\"Search\" />\n\t\t\t\t\t</template>\n\t\t\t\t</q-input-group>\n\t\t\t</div>"
6050
6160
  },
6051
6161
  {
6052
6162
  "title": "Advanced Usage",
@@ -6437,19 +6547,49 @@
6437
6547
  },
6438
6548
  {
6439
6549
  "title": "Selectable",
6440
- "description": "Allows the user to select items from the list.",
6550
+ "description": "Allows the user to select items from the list. The check of the selected item centers on the capitals of its label, raised by the optical lift, as a checkbox's box does next to its label.",
6441
6551
  "code": "<QList :items=\"[\n\t\t\t{ key: 'item1', label: 'Item 1' },\n\t\t\t{ key: 'item2', label: 'Item 2' },\n\t\t\t{ key: 'item3', label: 'Item 3' }\n\t\t]\" :selectable=\"true\" />"
6442
6552
  },
6553
+ {
6554
+ "title": "Selectable Font Icon",
6555
+ "description": "A check an app sets as a font icon. Its font is the icon size, so its own capitals are not the label's: the line that holds it moves, in the label's font, so it centers on the label's capitals as the default check does.",
6556
+ "code": "<QList :icons=\"{ ...DEFAULT_ICONS, check: { icon: 'check', type: 'font' } }\" />"
6557
+ },
6558
+ {
6559
+ "title": "Selectable Sized Check",
6560
+ "description": "A check an app sets at a size of its own (`icons.check.size`, in rem), as an SVG and as a font icon: the option keeps room for it at that size, so a label that fills the row stops before it.",
6561
+ "code": "<div style=\"width: 15rem\">\n\t\t\t\t<q-list v-bind=\"args\" :icons=\"svg\" />\n\t\t\t\t<q-list v-bind=\"args\" :icons=\"font\" />\n\t\t\t</div>"
6562
+ },
6443
6563
  {
6444
6564
  "title": "Multiple",
6445
6565
  "description": "Allows the user to select items from the list.",
6446
6566
  "code": "<QList :items=\"[\n\t\t\t{ key: 'item1', label: 'Item 1' },\n\t\t\t{ key: 'item2', label: 'Item 2' },\n\t\t\t{ key: 'item3', label: 'Item 3' }\n\t\t]\" :multiple=\"true\" />"
6447
6567
  },
6568
+ {
6569
+ "title": "Multiple Wrapping Label",
6570
+ "description": "A label longer than its row wraps, and the box stays beside its first line: the box's line keeps its width, so the box never wraps under it.",
6571
+ "code": "<div style=\"width: 12.5rem\">\n\t\t\t\t<q-list v-bind=\"args\" />\n\t\t\t</div>"
6572
+ },
6448
6573
  {
6449
6574
  "title": "Multiple With Description",
6450
6575
  "description": "Allows the user to select items from the list with icons.",
6451
6576
  "code": "<QList :items=\"[\n\t\t\t{\n\t\t\t\ticon: { icon: 'content-copy' },\n\t\t\t\tkey: 'item1',\n\t\t\t\tlabel: 'Item 1',\n\t\t\t\tdescription: 'Description for items'\n\t\t\t},\n\t\t\t{\n\t\t\t\ticon: { icon: 'content-duplicate' },\n\t\t\t\tkey: 'item2',\n\t\t\t\tlabel: 'Item 2',\n\t\t\t\tdescription: 'This item is nice :)'\n\t\t\t},\n\t\t\t{\n\t\t\t\ticon: { icon: 'content-paste' },\n\t\t\t\tkey: 'item3',\n\t\t\t\tlabel: 'Item 3',\n\t\t\t\tdescription: 'This is a description for this item'\n\t\t\t}\n\t\t]\" :multiple=\"true\" />"
6452
6577
  },
6578
+ {
6579
+ "title": "Multiple Tall Append",
6580
+ "description": "A row taller than its label for another reason, such as an avatar after the label (`item.append`): the label centers in the row, and the box stays beside it.",
6581
+ "code": "<q-list v-bind=\"args\">\n\t\t\t\t<template #item.append=\"{ item }\">\n\t\t\t\t\t<q-avatar :initials=\"item.label.split(' ').map((name) => name[0]).join('')\" />\n\t\t\t\t</template>\n\t\t\t</q-list>"
6582
+ },
6583
+ {
6584
+ "title": "Multiple Short Line",
6585
+ "description": "A line an app makes shorter than the box (`--q-line-height-md`), above a description: the label is the first line of the row, and the box stays beside it.",
6586
+ "code": "<div style=\"--q-line-height-md: 1rem\">\n\t\t\t\t<q-list v-bind=\"args\" />\n\t\t\t</div>"
6587
+ },
6588
+ {
6589
+ "title": "Multiple Right To Left",
6590
+ "description": "A list in a right-to-left page: the box is at the left end of the option, in the room the option keeps for it, and a label that fills the row stops before it.",
6591
+ "code": "<div dir=\"rtl\" style=\"width: 12.5rem\">\n\t\t\t\t<q-list v-bind=\"args\" />\n\t\t\t</div>"
6592
+ },
6453
6593
  {
6454
6594
  "title": "Selectable And Required",
6455
6595
  "description": "Allows the user to select items from the list and requires at least one item to be selected.",
@@ -6497,8 +6637,13 @@
6497
6637
  },
6498
6638
  {
6499
6639
  "title": "Highlighted",
6500
- "description": "The option the keyboard is on in a list that keeps focus elsewhere, as `QSelect` and `QCombobox` drive it (`highlighted`), shows the focus ring, and the selected one keeps its tint without it.",
6501
- "code": "<QList :items=\"[\n\t\t\t{ key: 'item1', label: 'Item 1' },\n\t\t\t{ key: 'item2', label: 'Item 2' },\n\t\t\t{ key: 'item3', label: 'Item 3' }\n\t\t]\" :selectable=\"true\" model-value=\"item3\" highlighted=\"item2\" />"
6640
+ "description": "The option the keyboard is on in a list that keeps focus elsewhere, as `QCombobox` and `QDropdownMenu` drive it (`highlighted`), shows the focus ring, and the selected one keeps its tint without it. Focus stays in the field, whose Up and Down arrows move the highlight, and the field points `aria-activedescendant` at the highlighted option.",
6641
+ "code": "<div style=\"display: flex; flex-direction: column; gap: 0.5rem;\">\n\t\t\t\t<q-text-field\n\t\t\t\t\tlabel=\"Item\"\n\t\t\t\t\trole=\"combobox\"\n\t\t\t\t\taria-expanded=\"true\"\n\t\t\t\t\t:aria-controls=\"args.id\"\n\t\t\t\t\t:aria-activedescendant=\"activeId\"\n\t\t\t\t\t@keydown=\"onKeydown\" />\n\t\t\t\t<q-list\n\t\t\t\t\tv-bind=\"args\"\n\t\t\t\t\tref=\"list\"\n\t\t\t\t\t:highlighted=\"highlighted\" />\n\t\t\t</div>"
6642
+ },
6643
+ {
6644
+ "title": "Item Append",
6645
+ "description": "The `item.append` slot adds content at the end of each item, such as a count and a chevron. An item is named by its label alone, which replaces its content, so screen readers read the count only through the item's `ariaDescribedby`, which points at the badge. Words only screen readers need, such as what the number counts, go in the badge as `.q-sr-only` text.",
6646
+ "code": "<q-list\n\t\t\t\tv-bind=\"args\"\n\t\t\t\tstyle=\"max-width: 20rem;\">\n\t\t\t\t<template #item.append=\"{ item }\">\n\t\t\t\t\t<q-badge\n\t\t\t\t\t\t:id=\"item.ariaDescribedby\"\n\t\t\t\t\t\tcolor=\"info\">\n\t\t\t\t\t\t{{ item.count }}<span class=\"q-sr-only\"> open tickets</span>\n\t\t\t\t\t</q-badge>\n\t\t\t\t\t<q-icon icon=\"chevron-right\" />\n\t\t\t\t</template>\n\t\t\t</q-list>"
6502
6647
  },
6503
6648
  {
6504
6649
  "title": "Keyboard Navigation",
@@ -6582,7 +6727,7 @@
6582
6727
  }
6583
6728
  ]
6584
6729
  },
6585
- "description": "Label to display next to the meter value.",
6730
+ "description": "Label to display next to the meter value.\n\nIn a right-to-left page, the text reads in the direction of its first letter: Arabic or Hebrew\nright to left, and a text with no letter, such as `-20%`, left to right, as written.",
6586
6731
  "required": false,
6587
6732
  "category": "Content"
6588
6733
  },
@@ -6637,6 +6782,11 @@
6637
6782
  "title": "Semantic",
6638
6783
  "description": "The meter bar color can be used to convey semantic meaning, such as status or severity.",
6639
6784
  "code": "<QMeter :model-value=\"75\" :max=\"100\" color=\"success\" label=\"Storage\" :value-label=\"(value: number, max: number) => `${value} GB available of ${max} GB`\" />"
6785
+ },
6786
+ {
6787
+ "title": "Right To Left",
6788
+ "description": "In a right-to-left page, the meter fills from the right, where the line starts, and its value, a text the app formats, reads in the direction of its first letter: `-5 °C` as written.",
6789
+ "code": "<div dir=\"rtl\" style=\"width: 20rem\">\n\t\t\t\t<q-meter v-bind=\"args\" />\n\t\t\t</div>"
6640
6790
  }
6641
6791
  ]
6642
6792
  },
@@ -6794,7 +6944,7 @@
6794
6944
  "kind": "primitive",
6795
6945
  "name": "boolean"
6796
6946
  },
6797
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
6947
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
6798
6948
  "required": false,
6799
6949
  "category": "State"
6800
6950
  },
@@ -7753,7 +7903,7 @@
7753
7903
  "kind": "primitive",
7754
7904
  "name": "boolean"
7755
7905
  },
7756
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
7906
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
7757
7907
  "required": false,
7758
7908
  "category": "State"
7759
7909
  },
@@ -8107,7 +8257,7 @@
8107
8257
  "kind": "primitive",
8108
8258
  "name": "boolean"
8109
8259
  },
8110
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
8260
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
8111
8261
  "required": false,
8112
8262
  "category": "State"
8113
8263
  },
@@ -9053,6 +9203,11 @@
9053
9203
  "title": "Invalid",
9054
9204
  "description": "Combines an application-provided invalid state with the component validation styling. The app's message, in the `errors` slot, takes the place of the field's own while `invalid` is true.",
9055
9205
  "code": "<q-phone-field v-bind=\"args\">\n\t\t\t\t<template #errors>This number is already registered</template>\n\t\t\t</q-phone-field>"
9206
+ },
9207
+ {
9208
+ "title": "Open On Selection",
9209
+ "description": "The country list open on the selected country, which shows its check mark next to its calling code. The play leaves the list open, so the story checks measure the options, the check mark among them.",
9210
+ "code": "<QPhoneField label=\"Phone number\" />"
9056
9211
  }
9057
9212
  ]
9058
9213
  },
@@ -9322,7 +9477,7 @@
9322
9477
  "kind": "primitive",
9323
9478
  "name": "string"
9324
9479
  },
9325
- "description": "Text displayed in the progress bar.\nNot shown if the 'mini' prop is true.",
9480
+ "description": "Text displayed in the progress bar.\nNot shown if the 'mini' prop is true.\n\nIn a right-to-left page, the text reads in the direction of its first letter: Arabic or Hebrew\nright to left, and a text with no letter, such as `-20%`, left to right, as written.",
9326
9481
  "required": false,
9327
9482
  "category": "Content"
9328
9483
  },
@@ -9504,6 +9659,11 @@
9504
9659
  "title": "With Limits And Percent",
9505
9660
  "description": "Displays the current percent along with the min and max limits.",
9506
9661
  "code": "<q-progress v-bind=\"args\" />"
9662
+ },
9663
+ {
9664
+ "title": "Right To Left",
9665
+ "description": "In a right-to-left page, the bar fills from the right, where the line starts: the sheen sweeps and the stripes move from right to left, and the numbers show as written (`-10`, not `10-`). A text the app passes reads in the direction of its first letter.",
9666
+ "code": "<div dir=\"rtl\" style=\"display: grid; gap: 1rem; width: 20rem\">\n\t\t\t\t<q-progress v-bind=\"args\" label=\"Temperature\" />\n\t\t\t\t<q-progress :model-value=\"25\" label=\"Outside\" text=\"-5 °C\" />\n\t\t\t\t<q-progress :model-value=\"33\" label=\"Still\" striped />\n\t\t\t</div>"
9507
9667
  }
9508
9668
  ]
9509
9669
  },
@@ -9811,7 +9971,7 @@
9811
9971
  "kind": "primitive",
9812
9972
  "name": "boolean"
9813
9973
  },
9814
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
9974
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
9815
9975
  "required": false,
9816
9976
  "category": "State"
9817
9977
  },
@@ -10216,6 +10376,11 @@
10216
10376
  "description": "Group box with different styling variants.",
10217
10377
  "code": "<div style=\"display: flex; flex-direction: column; gap: 1rem;\">\n\t\t\t\t<q-section title=\"Default\" variant=\"default\">\n\t\t\t\t\t<p>Default variant content</p>\n\t\t\t\t</q-section>\n\t\t\t\t<q-section title=\"Background\" variant=\"background\">\n\t\t\t\t\t<p>Background variant content</p>\n\t\t\t\t</q-section>\n\t\t\t\t<q-section title=\"Minor\" variant=\"minor\">\n\t\t\t\t\t<p>Minor variant content</p>\n\t\t\t\t</q-section>\n\t\t\t\t<q-section title=\"Minor Border Top\" variant=\"minor-border-top\">\n\t\t\t\t\t<p>Minor with border top variant content</p>\n\t\t\t\t</q-section>\n\t\t\t\t<q-section title=\"Title Background\" variant=\"title-background\">\n\t\t\t\t\t<p>Title background variant content</p>\n\t\t\t\t</q-section>\n\t\t\t</div>"
10218
10378
  },
10379
+ {
10380
+ "title": "Variants With Help",
10381
+ "description": "Every variant with help, whose button sits next to the title. Uppercase titles center it on their capitals as they are; the minor variants, not uppercase, raise it by the optical lift, as next to any text with lowercase letters.",
10382
+ "code": "<div style=\"display: flex; flex-direction: column; gap: 1rem;\">\n\t\t\t\t<q-section\n\t\t\t\t\tv-for=\"variant in variants\"\n\t\t\t\t\t:key=\"variant\"\n\t\t\t\t\t:title=\"'Variant ' + variant\"\n\t\t\t\t\t:variant=\"variant\"\n\t\t\t\t\thelp=\"What this section holds\">\n\t\t\t\t\t<p>Content</p>\n\t\t\t\t</q-section>\n\t\t\t</div>"
10383
+ },
10219
10384
  {
10220
10385
  "title": "Custom Title",
10221
10386
  "description": "A section with custom content prepended and appended to the title.",
@@ -10379,7 +10544,7 @@
10379
10544
  "kind": "primitive",
10380
10545
  "name": "boolean"
10381
10546
  },
10382
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
10547
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
10383
10548
  "required": false,
10384
10549
  "category": "State"
10385
10550
  },
@@ -11899,7 +12064,7 @@
11899
12064
  "kind": "primitive",
11900
12065
  "name": "boolean"
11901
12066
  },
11902
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
12067
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
11903
12068
  "required": false,
11904
12069
  "category": "State"
11905
12070
  },
@@ -12242,7 +12407,7 @@
12242
12407
  "kind": "primitive",
12243
12408
  "name": "boolean"
12244
12409
  },
12245
- "description": "Whether the input is invalid. Shows a danger border and sets `aria-invalid` on the\ncontrol. Put the message in the `errors` slot: it shows under the control, after an\nicon and `texts.error`, and describes the control, only while `invalid` is true.\nWithout a message, the field shows only the border.",
12410
+ "description": "Whether the input is invalid. Shows a danger border with a shadow of its color, and sets\n`aria-invalid` on the control. Put the message in the `errors` slot: it shows under the\ncontrol, after an icon and `texts.error`, and describes the control, only while\n`invalid` is true. Without a message, the field shows only the border and its shadow.",
12246
12411
  "required": false,
12247
12412
  "category": "State"
12248
12413
  },
@@ -12398,8 +12563,13 @@
12398
12563
  },
12399
12564
  {
12400
12565
  "title": "Warning Message",
12401
- "description": "The `warnings` slot points out something the user may want to check, without blocking: the value stays valid. The warning shows whenever the slot renders something, so render it conditionally. It shows under the field after a warning icon, with a warning border, and describes the input. Screen readers announce it as it appears, after the text \"Warning:\" (`texts.warning`). With an error too, both show, the error first, and the border is the error's.",
12402
- "code": "<q-text-field\n\t\t\t\tv-bind=\"args\"\n\t\t\t\tv-model=\"value\"\n\t\t\t\t:invalid=\"invalid\">\n\t\t\t\t<template #errors>Use at least 3 characters</template>\n\t\t\t\t<template\n\t\t\t\t\tv-if=\"uppercase\"\n\t\t\t\t\t#warnings>\n\t\t\t\t\tUsernames are usually all lowercase\n\t\t\t\t</template>\n\t\t\t</q-text-field>"
12566
+ "description": "The `warnings` slot points out something the user may want to check, without blocking: the value stays valid. The warning shows whenever the slot renders something, so render it conditionally. It shows under the field after a warning icon, with a warning border and a shadow of its color, and describes the input. Screen readers announce it as it appears, after the text \"Warning:\" (`texts.warning`).",
12567
+ "code": "<q-text-field\n\t\t\t\tv-bind=\"args\"\n\t\t\t\tv-model=\"value\">\n\t\t\t\t<template\n\t\t\t\t\tv-if=\"uppercase\"\n\t\t\t\t\t#warnings>\n\t\t\t\t\tUsernames are usually all lowercase\n\t\t\t\t</template>\n\t\t\t</q-text-field>"
12568
+ },
12569
+ {
12570
+ "title": "Error And Warning",
12571
+ "description": "With an error and a warning, both show, the error first, and the border and its shadow are the error's.",
12572
+ "code": "<q-text-field\n\t\t\t\tv-bind=\"args\"\n\t\t\t\tv-model=\"value\">\n\t\t\t\t<template #errors>Use at least 3 characters</template>\n\t\t\t\t<template #warnings>Usernames are usually all lowercase</template>\n\t\t\t</q-text-field>"
12403
12573
  },
12404
12574
  {
12405
12575
  "title": "Message Icon Size",