@allxsmith/bestax-bulma 5.45.1 → 5.47.0

package/dist/types-cjs/helpers/useTreeView.d.ts

@@ -20,6 +20,14 @@ export interface TreeViewItemInfo extends TreeViewItemRecord {
 }
 /** A box's state: checked, unchecked or mixed. */
 export type TreeViewCheckState = boolean | 'mixed';
+/**
+ * Where an item sits among the items beside it, for its `aria-posinset` and
+ * `aria-setsize`: its number, from 1, and how many there are.
+ */
+export interface TreeViewPosition {
+    posinset: number;
+    setsize: number;
+}
 /**
  * What an item shows of the selection: `selected` in a `single` tree,
  * `checked` in a `checkbox` tree, and neither with `none`.
@@ -59,6 +67,12 @@ export interface TreeViewEngine {
      * the server.
      */
     stateOf: (value: string, path: string[], disabled: boolean) => TreeViewItemState;
+    /**
+     * Where the item with this key sits among the items beside it, read off
+     * the page after each render and whenever items move. Nothing until the
+     * tree has mounted, as on the server.
+     */
+    positionOf: (key: string) => TreeViewPosition | undefined;
     /** Records an item from its layout effect. Returns the function that forgets it. */
     register: (value: string, record: TreeViewItemRecord) => () => void;
     /** For each item's `<li>` ref: records it, and notices focus leaving with it. */
@@ -76,9 +90,11 @@ export interface TreeViewEngine {
     onClick: (element: HTMLLIElement, item: TreeViewItemInfo, onToggle: boolean) => void;
 }
 /**
- * The open state, the selection, the keys, the tab stop and the registry of
- * a TreeView (#1096). Focus moves for real, with a roving tabindex, rather
- * than through `aria-activedescendant`.
+ * The open state, the selection, the keys, the tab stop, the positions and
+ * the registry of a TreeView (#1096). Focus moves for real, with a roving
+ * tabindex, rather than through `aria-activedescendant`. Each item's
+ * position among the items beside it is declared rather than left to the
+ * browser (#1171), read off the page once the tree has mounted.
  *
  * Every item registers its value, its parent and whether it's disabled from
  * a layout effect. In a checkbox tree a closed item's children still render

package/dist/types-cjs/helpers/useVisibilityClasses.d.ts

@@ -3,7 +3,11 @@ import { validVisibilities, BulmaViewportProps, BulmaDisplayProps } from './bulm
  * Props for applying Bulma visibility and display helper classes.
  */
 export interface BulmaVisibilityProps extends BulmaViewportProps, BulmaDisplayProps {
-    /** Visibility (e.g., 'hidden', 'sr-only'). */
+    /**
+     * Hides the element. `'hidden'` takes it off the page, `'invisible'` hides
+     * it and keeps its space, and `'sr-only'` (screen reader only) hides it
+     * visually while screen readers still read it.
+     */
     visibility?: (typeof validVisibilities)[number];
     /** Visibility for mobile viewport (up to 768px). */
     visibilityMobile?: (typeof validVisibilities)[number];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allxsmith/bestax-bulma",
-  "version": "5.45.1",
+  "version": "5.47.0",
   "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.",
   "main": "dist/index.cjs",
   "module": "dist/index.esm.js",
@@ -22,6 +22,7 @@
   "devDependencies": {
     "@faker-js/faker": "^10.6.0",
     "@fortawesome/fontawesome-free": "^7.3.1",
+    "@guidepup/virtual-screen-reader": "0.33.0",
     "@mdi/font": "^7.4.47",
     "@rollup/plugin-commonjs": "^29.0.3",
     "@rollup/plugin-node-resolve": "^16.0.1",