@allxsmith/bestax-bulma 5.33.0 → 5.33.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.
@@ -88,11 +88,26 @@ export interface AutocompleteProps extends Omit<React.HTMLAttributes<HTMLDivElem
88
88
  onInfiniteScroll?: () => void;
89
89
  /** Custom render for items. */
90
90
  itemTemplate?: (item: AutocompleteItem | string) => React.ReactNode;
91
- /** Custom header in dropdown. */
91
+ /** Custom header at the top of the dropdown. It sits above the list of options rather than in it, so assistive technology doesn't count it as one. */
92
92
  header?: React.ReactNode;
93
- /** Custom footer in dropdown. */
93
+ /** Custom footer at the bottom of the dropdown. It sits below the list of options rather than in it, so assistive technology doesn't count it as one. */
94
94
  footer?: React.ReactNode;
95
- /** Content to show when no results. */
95
+ /**
96
+ * A message the dropdown shows in place of the options when nothing
97
+ * matches. Keep it to text: `Tab` closes the list, so a keyboard user
98
+ * can't reach a link or button in it. It sits beside the list of options
99
+ * rather than in it, so the input's `aria-expanded` stays false while it
100
+ * shows. When the user's typing leaves nothing that matches, a polite
101
+ * status region announces its text: once each time the matches run out.
102
+ * The text is read when they first run out, and isn't read again as it
103
+ * changes while they stay out, so a message that names the query is heard
104
+ * for that first query only. Keep it static.
105
+ * Opening the list without typing, or emptying the field, announces
106
+ * nothing. While `loading`, or a `Control` with `isLoading` around the
107
+ * Autocomplete, is on, it waits, and it's announced once loading ends
108
+ * with nothing matching. Without `empty`, the dropdown closes when nothing
109
+ * matches and nothing is announced.
110
+ */
96
111
  empty?: React.ReactNode;
97
112
  }
98
113
  /**
@@ -43,10 +43,10 @@ export interface StatusRegionProps<Item extends {
43
43
  describe: (item: Item) => string | null;
44
44
  }
45
45
  /**
46
- * A visually hidden, polite `status` live region that a programmatic
47
- * container announces its items through. The container renders it from the
48
- * moment it mounts, whether or not it has anything to show, so the region is
49
- * already in the page when an announcement is written into it.
46
+ * A visually hidden, polite `status` live region that a container announces
47
+ * its items through. The container renders it from the moment it mounts,
48
+ * whether or not it has anything to show, so the region is already in the
49
+ * page when an announcement is written into it.
50
50
  *
51
51
  * The announcements are this component's own state, so writing and clearing
52
52
  * them re-renders the region and leaves the container's items alone. Each one
@@ -88,11 +88,26 @@ export interface AutocompleteProps extends Omit<React.HTMLAttributes<HTMLDivElem
88
88
  onInfiniteScroll?: () => void;
89
89
  /** Custom render for items. */
90
90
  itemTemplate?: (item: AutocompleteItem | string) => React.ReactNode;
91
- /** Custom header in dropdown. */
91
+ /** Custom header at the top of the dropdown. It sits above the list of options rather than in it, so assistive technology doesn't count it as one. */
92
92
  header?: React.ReactNode;
93
- /** Custom footer in dropdown. */
93
+ /** Custom footer at the bottom of the dropdown. It sits below the list of options rather than in it, so assistive technology doesn't count it as one. */
94
94
  footer?: React.ReactNode;
95
- /** Content to show when no results. */
95
+ /**
96
+ * A message the dropdown shows in place of the options when nothing
97
+ * matches. Keep it to text: `Tab` closes the list, so a keyboard user
98
+ * can't reach a link or button in it. It sits beside the list of options
99
+ * rather than in it, so the input's `aria-expanded` stays false while it
100
+ * shows. When the user's typing leaves nothing that matches, a polite
101
+ * status region announces its text: once each time the matches run out.
102
+ * The text is read when they first run out, and isn't read again as it
103
+ * changes while they stay out, so a message that names the query is heard
104
+ * for that first query only. Keep it static.
105
+ * Opening the list without typing, or emptying the field, announces
106
+ * nothing. While `loading`, or a `Control` with `isLoading` around the
107
+ * Autocomplete, is on, it waits, and it's announced once loading ends
108
+ * with nothing matching. Without `empty`, the dropdown closes when nothing
109
+ * matches and nothing is announced.
110
+ */
96
111
  empty?: React.ReactNode;
97
112
  }
98
113
  /**
@@ -43,10 +43,10 @@ export interface StatusRegionProps<Item extends {
43
43
  describe: (item: Item) => string | null;
44
44
  }
45
45
  /**
46
- * A visually hidden, polite `status` live region that a programmatic
47
- * container announces its items through. The container renders it from the
48
- * moment it mounts, whether or not it has anything to show, so the region is
49
- * already in the page when an announcement is written into it.
46
+ * A visually hidden, polite `status` live region that a container announces
47
+ * its items through. The container renders it from the moment it mounts,
48
+ * whether or not it has anything to show, so the region is already in the
49
+ * page when an announcement is written into it.
50
50
  *
51
51
  * The announcements are this component's own state, so writing and clearing
52
52
  * them re-renders the region and leaves the container's items alone. Each one
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allxsmith/bestax-bulma",
3
- "version": "5.33.0",
3
+ "version": "5.33.1",
4
4
  "description": "A fully-typed React component library for the Bulma CSS framework. Build modern UIs quickly with reusable, accessible, and customizable Bulma-based React components.",
5
5
  "main": "dist/index.cjs",
6
6
  "module": "dist/index.esm.js",