@8wave/ai-elements 0.121.0-beta.59 → 0.121.0-beta.60

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.
package/README.md CHANGED
@@ -949,7 +949,9 @@ The snapshot reads the page as a screen reader would: visible elements only, eac
949
949
  as a line with its role, its accessible name, its state and a reference the action tools use.
950
950
 
951
951
  - Names come from `aria-label`, `aria-labelledby`, the `<label>` of a field, `alt`,
952
- `placeholder` and `title`, then the element's text.
952
+ `placeholder` and `title`, then the element's text. A field with none of these takes the
953
+ `<label>` written beside it and tied to nothing (no `for`, no control inside), when it is the
954
+ only one before the field in the nearest container that holds one: a guess, so tie your labels.
953
955
  - Open shadow roots and slotted content are read. Elements hidden from the user are skipped
954
956
  (in browsers with `Element.checkVisibility`, which every current browser has).
955
957
  - Never read: `script`, `style`, `svg`, `canvas`, `iframe`, `object`, `embed`, `video`, `audio`,
@@ -967,6 +969,10 @@ as a line with its role, its accessible name, its state and a reference the acti
967
969
  select) reads with the choice it shows, as the user sees it on the closed box:
968
970
  `combobox "Role" value="User"`. Its value is empty while it shows a placeholder, which the
969
971
  widget tells from the options of the list it controls (`aria-controls`), none `aria-selected`.
972
+ - A combobox field that opens a list as the user types (`aria-expanded="true"` and
973
+ `aria-controls` or `aria-owns` on its list, as react-select does): the agent writes the text,
974
+ the result shows the list with its options, and the agent picks one with a click. The fields
975
+ after it in the same `page_fill` wait, since writing one would close the list.
970
976
  - While your page has a modal `<dialog>` open (`showModal()`), a snapshot of the page reads that
971
977
  dialog only, and says so: the rest of the page is inert for the user until it closes.
972
978
  - A field says the language of its text (`lang it`) when it, or a container of it below `<html>`,
@@ -994,7 +1000,9 @@ Other sensitive fields must be marked by your site, or listed in **Excluded area
994
1000
 
995
1001
  At **Page control**, a card in the chat asks the user before:
996
1002
 
997
- - a click on a submit button, or Enter in a field that submits its form. The card lists the
1003
+ - a click on a submit button, or Enter in a field that submits its form (not in a combobox with
1004
+ its list open, where Enter picks an option: the form is not sent, and a submit your own handler
1005
+ of the key starts with `requestSubmit()` or a click on the button is stopped). The card lists the
998
1006
  filled fields of the form with their values, leaving out the ones the agent never reads: first
999
1007
  every field whose value changed since the agent first read the form, whether the agent wrote it
1000
1008
  or your page did (after a dialog of yours, say), a long one from where it changed, then the