@tensor_1/react 2.8.0 → 2.10.0

package/dist/components/Input.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { InputHTMLAttributes, ReactNode } from 'react';
+import { InputHTMLAttributes, ReactNode, AriaAttributes } from 'react';
 
 interface InputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size'> {
     size?: 'sm' | 'md';
@@ -12,7 +12,18 @@ interface InputGroupProps {
     leadingIcon?: ReactNode;
     trailingIcon?: ReactNode;
     className?: string;
+    /** Injected by `<Field>` when it wraps the group; forwarded onto the child control. */
+    id?: string;
+    'aria-describedby'?: string;
+    'aria-invalid'?: AriaAttributes['aria-invalid'];
+    'aria-required'?: AriaAttributes['aria-required'];
 }
-declare function InputGroup({ children, leadingIcon, trailingIcon, className }: InputGroupProps): react.JSX.Element;
+/**
+ * Icon-adorned wrapper for a child `<Input>`. The control is passed as `children`, so
+ * `<Field>`'s injected `id`/`aria-*` land on this wrapper — they're forwarded onto the
+ * single child element (the child's own props win) so label/message association survives
+ * the extra div (UIX-A11Y-3).
+ */
+declare function InputGroup({ children, leadingIcon, trailingIcon, className, id, 'aria-describedby': describedBy, 'aria-invalid': invalid, 'aria-required': required, }: InputGroupProps): react.JSX.Element;
 
 export { Input, InputGroup, type InputGroupProps, type InputProps };

package/dist/components/Input.js

@@ -1,5 +1,5 @@
 import { jsx, jsxs } from "react/jsx-runtime";
-import { forwardRef } from "react";
+import { cloneElement, forwardRef, isValidElement } from "react";
 import { cx } from "../cx.js";
 const Input = forwardRef(
   ({ size = "md", invalid, valid, className, ...props }, ref) => /* @__PURE__ */ jsx(
@@ -14,7 +14,22 @@ const Input = forwardRef(
   )
 );
 Input.displayName = "Input";
-function InputGroup({ children, leadingIcon, trailingIcon, className }) {
+function InputGroup({
+  children,
+  leadingIcon,
+  trailingIcon,
+  className,
+  id,
+  "aria-describedby": describedBy,
+  "aria-invalid": invalid,
+  "aria-required": required
+}) {
+  const control = isValidElement(children) && (id ?? describedBy ?? invalid ?? required) != null ? cloneElement(children, {
+    id: children.props.id ?? id,
+    "aria-describedby": children.props["aria-describedby"] ?? describedBy,
+    "aria-invalid": children.props["aria-invalid"] ?? invalid,
+    "aria-required": children.props["aria-required"] ?? required
+  }) : children;
   return /* @__PURE__ */ jsxs(
     "div",
     {
@@ -25,9 +40,9 @@ function InputGroup({ children, leadingIcon, trailingIcon, className }) {
         className
       ),
       children: [
-        leadingIcon && /* @__PURE__ */ jsx("span", { className: "uix-input-group__icon", children: leadingIcon }),
-        children,
-        trailingIcon && /* @__PURE__ */ jsx("span", { className: "uix-input-group__icon uix-input-group__icon--trailing", children: trailingIcon })
+        leadingIcon && /* @__PURE__ */ jsx("span", { className: "uix-input-group__icon", "aria-hidden": "true", children: leadingIcon }),
+        control,
+        trailingIcon && /* @__PURE__ */ jsx("span", { className: "uix-input-group__icon uix-input-group__icon--trailing", "aria-hidden": "true", children: trailingIcon })
       ]
     }
   );

package/dist/components/Kanban.d.ts

@@ -2,20 +2,32 @@ import * as react from 'react';
 import { HTMLAttributes, ReactNode } from 'react';
 
 interface KanbanProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Polite live-region text for keyboard moves (UIX-A11Y-2). `onMove` implementations
+     * should set it, e.g. "Card X moved to Doing, position 2 of 4".
+     */
+    announcement?: string;
     children?: ReactNode;
 }
-declare function Kanban({ children, className, ...props }: KanbanProps): react.JSX.Element;
+declare function Kanban({ announcement, children, className, ...props }: KanbanProps): react.JSX.Element;
 interface KanbanColumnProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
     title?: ReactNode;
     count?: number;
     children?: ReactNode;
 }
 declare function KanbanColumn({ title, count, children, className, ...props }: KanbanColumnProps): react.JSX.Element;
+type KanbanMoveDirection = 'up' | 'down' | 'left' | 'right';
 interface KanbanCardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
     title?: ReactNode;
     meta?: ReactNode;
+    /**
+     * Keyboard move contract (UIX-A11Y-2): when provided, Alt+Arrow on the focused card
+     * calls it — the same accelerator convention as NavFavourites row moves. Pair with
+     * the board-level `announcement` so SR users hear the result.
+     */
+    onMove?: (dir: KanbanMoveDirection) => void;
     children?: ReactNode;
 }
-declare function KanbanCard({ title, meta, children, className, ...props }: KanbanCardProps): react.JSX.Element;
+declare function KanbanCard({ title, meta, children, className, onMove, onKeyDown, ...props }: KanbanCardProps): react.JSX.Element;
 
-export { Kanban, KanbanCard, type KanbanCardProps, KanbanColumn, type KanbanColumnProps, type KanbanProps };
+export { Kanban, KanbanCard, type KanbanCardProps, KanbanColumn, type KanbanColumnProps, type KanbanMoveDirection, type KanbanProps };

package/dist/components/Kanban.js

@@ -1,23 +1,55 @@
+"use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { useId } from "react";
 import { cx } from "../cx.js";
-function Kanban({ children, className, ...props }) {
-  return /* @__PURE__ */ jsx("div", { className: cx("uix-kanban", className), ...props, children });
+function Kanban({ announcement, children, className, ...props }) {
+  return /* @__PURE__ */ jsxs("div", { className: cx("uix-kanban", className), ...props, children: [
+    announcement != null && /* @__PURE__ */ jsx("div", { role: "status", className: "uix-visually-hidden", children: announcement }),
+    children
+  ] });
 }
 function KanbanColumn({ title, count, children, className, ...props }) {
+  const headId = useId();
+  const hasHead = title != null || count != null;
   return /* @__PURE__ */ jsxs("div", { className: cx("uix-kanban__col", className), ...props, children: [
-    (title != null || count != null) && /* @__PURE__ */ jsxs("div", { className: "uix-kanban__head", children: [
+    hasHead && /* @__PURE__ */ jsxs("div", { className: "uix-kanban__head", id: headId, children: [
       title,
       count != null && /* @__PURE__ */ jsx("span", { className: "uix-kanban__count", children: count })
     ] }),
-    /* @__PURE__ */ jsx("div", { className: "uix-kanban__body", children })
+    /* @__PURE__ */ jsx("div", { className: "uix-kanban__body", role: "list", "aria-labelledby": hasHead ? headId : void 0, children })
   ] });
 }
-function KanbanCard({ title, meta, children, className, ...props }) {
-  return /* @__PURE__ */ jsxs("div", { className: cx("uix-kanban__card", className), ...props, children: [
-    title && /* @__PURE__ */ jsx("div", { className: "uix-kanban__card-title", children: title }),
-    meta && /* @__PURE__ */ jsx("div", { className: "uix-kanban__card-meta", children: meta }),
-    children
-  ] });
+const MOVE_KEYS = {
+  ArrowUp: "up",
+  ArrowDown: "down",
+  ArrowLeft: "left",
+  ArrowRight: "right"
+};
+function KanbanCard({ title, meta, children, className, onMove, onKeyDown, ...props }) {
+  const handleKeyDown = (e) => {
+    onKeyDown?.(e);
+    if (!onMove || !e.altKey || e.defaultPrevented) return;
+    const dir = MOVE_KEYS[e.key];
+    if (dir) {
+      e.preventDefault();
+      onMove(dir);
+    }
+  };
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      role: "listitem",
+      tabIndex: 0,
+      className: cx("uix-kanban__card", className),
+      onKeyDown: handleKeyDown,
+      ...props,
+      children: [
+        title && /* @__PURE__ */ jsx("div", { className: "uix-kanban__card-title", children: title }),
+        meta && /* @__PURE__ */ jsx("div", { className: "uix-kanban__card-meta", children: meta }),
+        children
+      ]
+    }
+  );
 }
 export {
   Kanban,

package/dist/components/Meter.d.ts

@@ -8,8 +8,10 @@ interface MeterProps extends HTMLAttributes<HTMLDivElement> {
     value?: number;
     /** Threshold tone applied via `data-tone` on the fill element. `success` is the implicit default (no attribute). */
     tone?: MeterTone;
+    /** Accessible name — rendered as `aria-label` (an explicit `aria-label` prop wins). */
+    label?: string;
 }
 /** Horizontal utilization / threshold bar backed by `.uix-meter`. */
-declare function Meter({ value, tone, className, ...props }: MeterProps): react.JSX.Element;
+declare function Meter({ value, tone, label, className, ...props }: MeterProps): react.JSX.Element;
 
 export { Meter, type MeterProps, type MeterTone };

package/dist/components/Meter.js

@@ -1,7 +1,13 @@
 "use client";
 import { jsx } from "react/jsx-runtime";
 import { cx } from "../cx.js";
-function Meter({ value = 0, tone, className, ...props }) {
+const toneText = {
+  warning: "warning",
+  danger: "critical",
+  attention: "needs attention",
+  overdue: "overdue"
+};
+function Meter({ value = 0, tone, label, className, ...props }) {
   const pct = Math.max(0, Math.min(100, value));
   return /* @__PURE__ */ jsx(
     "div",
@@ -10,6 +16,8 @@ function Meter({ value = 0, tone, className, ...props }) {
       "aria-valuenow": pct,
       "aria-valuemin": 0,
       "aria-valuemax": 100,
+      "aria-valuetext": tone && tone !== "success" ? `${pct}%, ${toneText[tone]}` : void 0,
+      "aria-label": label,
       className: cx("uix-meter", className),
       ...props,
       children: /* @__PURE__ */ jsx(

package/dist/components/Modal.d.ts

@@ -1,15 +1,13 @@
 import * as react from 'react';
-import { ReactNode, CSSProperties } from 'react';
+import { HTMLAttributes, ReactNode } from 'react';
 
-interface ModalProps {
+interface ModalProps extends Omit<HTMLAttributes<HTMLDialogElement>, 'title'> {
     open: boolean;
     onClose?: () => void;
     title?: ReactNode;
     children?: ReactNode;
     footer?: ReactNode;
-    className?: string;
-    style?: CSSProperties;
 }
-declare function Modal({ open, onClose, title, children, footer, className, style }: ModalProps): react.JSX.Element;
+declare function Modal({ open, onClose, title, children, footer, className, ...rest }: ModalProps): react.JSX.Element;
 
 export { Modal, type ModalProps };

package/dist/components/Modal.js

@@ -1,13 +1,15 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { useId } from "react";
 import { cx } from "../cx.js";
 import { useDialog } from "../hooks/useDialog.js";
 const CloseIcon = () => /* @__PURE__ */ jsx("svg", { width: "16", height: "16", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: 1.5, strokeLinecap: "round", "aria-hidden": "true", children: /* @__PURE__ */ jsx("path", { d: "M4 4l8 8M12 4l-8 8" }) });
-function Modal({ open, onClose, title, children, footer, className, style }) {
-  const ref = useDialog(open);
-  return /* @__PURE__ */ jsxs("dialog", { ref, className: cx("uix-dialog", className), style, onClose, children: [
+function Modal({ open, onClose, title, children, footer, className, ...rest }) {
+  const ref = useDialog(open, onClose);
+  const titleId = useId();
+  return /* @__PURE__ */ jsxs("dialog", { ref, className: cx("uix-dialog", className), "aria-labelledby": title ? titleId : void 0, ...rest, children: [
     (title != null || onClose) && /* @__PURE__ */ jsxs("div", { className: "uix-dialog__header", children: [
-      title && /* @__PURE__ */ jsx("div", { className: "uix-dialog__title", children: title }),
+      title && /* @__PURE__ */ jsx("h2", { className: "uix-dialog__title", id: titleId, children: title }),
       onClose && /* @__PURE__ */ jsx("button", { className: "uix-dialog__close", onClick: onClose, "aria-label": "Close dialog", children: /* @__PURE__ */ jsx(CloseIcon, {}) })
     ] }),
     children != null && /* @__PURE__ */ jsx("div", { className: "uix-dialog__body", children }),

package/dist/components/NavFavourites.js

@@ -67,6 +67,7 @@ function NavFavourites({
   const regionId = useId();
   const headerRef = useRef(null);
   const regionRef = useRef(null);
+  const [announcement, setAnnouncement] = useState("");
   const focusAfterRef = useRef(null);
   const triggerRefs = useRef(/* @__PURE__ */ new Map());
   const order = items.map((i) => i.id);
@@ -96,6 +97,8 @@ function NavFavourites({
     if (it === void 0) return;
     reordered.splice(next, 0, it);
     focusAfterRef.current = id;
+    const moved = items.find((i) => i.id === id);
+    if (moved) setAnnouncement(`${moved.label} moved to position ${next + 1} of ${order.length}`);
     onReorder(reordered);
   };
   const remove = (id) => {
@@ -105,6 +108,7 @@ function NavFavourites({
     onRemove(id);
   };
   return /* @__PURE__ */ jsxs("div", { className: cx("uix-favourites", className), style: { marginBottom: "var(--uix-space-1)" }, children: [
+    /* @__PURE__ */ jsx("div", { role: "status", className: "uix-visually-hidden", children: announcement }),
     /* @__PURE__ */ jsxs(
       "button",
       {
@@ -208,6 +212,12 @@ function FavouriteRow({
     } else if (e.key === "ArrowUp") {
       e.preventDefault();
       menuItems[(currentIdx - 1 + menuItems.length) % menuItems.length]?.focus();
+    } else if (e.key === "Home") {
+      e.preventDefault();
+      menuItems[0]?.focus();
+    } else if (e.key === "End") {
+      e.preventDefault();
+      menuItems[menuItems.length - 1]?.focus();
     } else if (e.key === "Escape") {
       e.preventDefault();
       closeAndReturnFocus();
@@ -288,6 +298,7 @@ function FavouriteRow({
               {
                 id: menuId,
                 role: "menu",
+                "aria-label": optionsTemplate.replace("{label}", item.label),
                 onKeyDown: onMenuKeyDown,
                 style: {
                   position: "absolute",

package/dist/components/PageHeader.d.ts

@@ -4,6 +4,8 @@ import { HTMLAttributes, ReactNode } from 'react';
 interface PageHeaderProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
     eyebrow?: ReactNode;
     title: ReactNode;
+    /** Heading level for the title — drop to `h2` when the page already owns an `h1` (UIX-A11Y-4). */
+    as?: 'h1' | 'h2';
     /** Supporting copy under the title. */
     subtitle?: ReactNode;
     /** Right-aligned action area (buttons, menus). */
@@ -13,6 +15,6 @@ interface PageHeaderProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
  * Page header — eyebrow / title / subtitle + actions row, over `.uix-page-header`.
  * The hairline + breathing room below come from the component CSS.
  */
-declare function PageHeader({ eyebrow, title, subtitle, actions, className, ...props }: PageHeaderProps): react.JSX.Element;
+declare function PageHeader({ eyebrow, title, subtitle, actions, as: TitleTag, className, ...props }: PageHeaderProps): react.JSX.Element;
 
 export { PageHeader, type PageHeaderProps };

package/dist/components/PageHeader.js

@@ -1,10 +1,10 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { cx } from "../cx.js";
-function PageHeader({ eyebrow, title, subtitle, actions, className, ...props }) {
+function PageHeader({ eyebrow, title, subtitle, actions, as: TitleTag = "h1", className, ...props }) {
   return /* @__PURE__ */ jsxs("header", { className: cx("uix-page-header", className), ...props, children: [
     /* @__PURE__ */ jsxs("div", { className: "uix-page-header__titles", children: [
       eyebrow != null && /* @__PURE__ */ jsx("div", { className: "uix-page-header__eyebrow", children: eyebrow }),
-      /* @__PURE__ */ jsx("h1", { className: "uix-page-header__title", children: title }),
+      /* @__PURE__ */ jsx(TitleTag, { className: "uix-page-header__title", children: title }),
       subtitle != null && /* @__PURE__ */ jsx("p", { className: "uix-page-header__subtitle", children: subtitle })
     ] }),
     actions != null && /* @__PURE__ */ jsx("div", { className: "uix-page-header__actions", children: actions })

package/dist/components/Peek.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
-import { ReactNode } from 'react';
+import { HTMLAttributes, ReactNode } from 'react';
 
-interface PeekProps {
+interface PeekProps extends Omit<HTMLAttributes<HTMLDialogElement>, 'title'> {
     open: boolean;
     onClose?: () => void;
     title?: ReactNode;
@@ -10,8 +10,7 @@ interface PeekProps {
     onNavPrev?: () => void;
     onNavNext?: () => void;
     hint?: string;
-    className?: string;
 }
-declare function Peek({ open, onClose, title, children, footer, onNavPrev, onNavNext, hint, className }: PeekProps): react.JSX.Element;
+declare function Peek({ open, onClose, title, children, footer, onNavPrev, onNavNext, hint, className, onClick, ...rest }: PeekProps): react.JSX.Element;
 
 export { Peek, type PeekProps };

package/dist/components/Peek.js

@@ -1,27 +1,30 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { useId } from "react";
 import { cx } from "../cx.js";
 import { useDialog } from "../hooks/useDialog.js";
 const CloseIcon = () => /* @__PURE__ */ jsx("svg", { width: "16", height: "16", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: 1.5, strokeLinecap: "round", "aria-hidden": "true", children: /* @__PURE__ */ jsx("path", { d: "M4 4l8 8M12 4l-8 8" }) });
 const ChevronUp = () => /* @__PURE__ */ jsx("svg", { width: "12", height: "12", viewBox: "0 0 12 12", fill: "none", stroke: "currentColor", strokeWidth: 1.5, strokeLinecap: "round", "aria-hidden": "true", children: /* @__PURE__ */ jsx("path", { d: "M2 8l4-4 4 4" }) });
 const ChevronDown = () => /* @__PURE__ */ jsx("svg", { width: "12", height: "12", viewBox: "0 0 12 12", fill: "none", stroke: "currentColor", strokeWidth: 1.5, strokeLinecap: "round", "aria-hidden": "true", children: /* @__PURE__ */ jsx("path", { d: "M2 4l4 4 4-4" }) });
-function Peek({ open, onClose, title, children, footer, onNavPrev, onNavNext, hint, className }) {
-  const ref = useDialog(open);
+function Peek({ open, onClose, title, children, footer, onNavPrev, onNavNext, hint, className, onClick, ...rest }) {
+  const ref = useDialog(open, onClose);
   const hasNav = onNavPrev != null || onNavNext != null;
+  const titleId = useId();
   const onBackdropClick = (e) => {
+    onClick?.(e);
     if (!onClose || e.target !== e.currentTarget) return;
     const r = e.currentTarget.getBoundingClientRect();
     if (r.width === 0) return;
     const outside = e.clientX < r.left || e.clientX > r.right || e.clientY < r.top || e.clientY > r.bottom;
     if (outside) onClose();
   };
-  return /* @__PURE__ */ jsxs("dialog", { ref, className: cx("uix-peek", className), onClose, onClick: onBackdropClick, children: [
+  return /* @__PURE__ */ jsxs("dialog", { ref, className: cx("uix-peek", className), "aria-labelledby": title ? titleId : void 0, ...rest, onClick: onBackdropClick, children: [
     /* @__PURE__ */ jsxs("div", { className: "uix-peek__header", children: [
       hasNav && /* @__PURE__ */ jsxs("div", { className: "uix-peek__nav", children: [
-        /* @__PURE__ */ jsx("button", { className: "uix-peek__navbtn", onClick: onNavPrev, disabled: !onNavPrev, "aria-label": "Previous record", children: /* @__PURE__ */ jsx(ChevronUp, {}) }),
-        /* @__PURE__ */ jsx("button", { className: "uix-peek__navbtn", onClick: onNavNext, disabled: !onNavNext, "aria-label": "Next record", children: /* @__PURE__ */ jsx(ChevronDown, {}) })
+        /* @__PURE__ */ jsx("button", { className: "uix-peek__navbtn", onClick: () => onNavPrev?.(), "aria-disabled": onNavPrev ? void 0 : true, "aria-label": "Previous record", children: /* @__PURE__ */ jsx(ChevronUp, {}) }),
+        /* @__PURE__ */ jsx("button", { className: "uix-peek__navbtn", onClick: () => onNavNext?.(), "aria-disabled": onNavNext ? void 0 : true, "aria-label": "Next record", children: /* @__PURE__ */ jsx(ChevronDown, {}) })
       ] }),
-      title && /* @__PURE__ */ jsx("div", { className: "uix-peek__title", children: title }),
+      title && /* @__PURE__ */ jsx("h2", { className: "uix-peek__title", id: titleId, children: title }),
       hint && /* @__PURE__ */ jsx("span", { className: "uix-peek__hint", children: hint }),
       onClose && /* @__PURE__ */ jsx("button", { className: "uix-peek__close", onClick: onClose, "aria-label": "Close preview", children: /* @__PURE__ */ jsx(CloseIcon, {}) })
     ] }),

package/dist/components/Progress.d.ts

@@ -8,7 +8,9 @@ interface ProgressProps extends HTMLAttributes<HTMLDivElement> {
     max?: number;
     /** Continuous slide animation when the amount of work is unknown. */
     indeterminate?: boolean;
+    /** Accessible name — rendered as `aria-label` (an explicit `aria-label` prop wins). */
+    label?: string;
 }
-declare function Progress({ value, max, indeterminate, className, ...props }: ProgressProps): react.JSX.Element;
+declare function Progress({ value, max, indeterminate, label, className, ...props }: ProgressProps): react.JSX.Element;
 
 export { Progress, type ProgressProps };

package/dist/components/Progress.js

@@ -1,14 +1,16 @@
 import { jsx } from "react/jsx-runtime";
 import { cx } from "../cx.js";
-function Progress({ value = 0, max = 100, indeterminate, className, ...props }) {
-  const pct = Math.max(0, Math.min(100, value / (max || 100) * 100));
+function Progress({ value = 0, max = 100, indeterminate, label, className, ...props }) {
+  const clamped = Math.max(0, Math.min(max || 100, value));
+  const pct = clamped / (max || 100) * 100;
   return /* @__PURE__ */ jsx(
     "div",
     {
       role: "progressbar",
       "aria-valuemin": 0,
       "aria-valuemax": max,
-      "aria-valuenow": indeterminate ? void 0 : value,
+      "aria-valuenow": indeterminate ? void 0 : clamped,
+      "aria-label": label,
       className: cx("uix-progress", indeterminate && "uix-progress--indeterminate", className),
       ...props,
       children: /* @__PURE__ */ jsx("div", { className: "uix-progress__bar", style: indeterminate ? void 0 : { width: `${pct}%` } })

package/dist/components/Radio.d.ts

@@ -8,7 +8,9 @@ declare const Radio: react.ForwardRefExoticComponent<RadioProps & react.RefAttri
 interface RadioGroupProps {
     children: ReactNode;
     className?: string;
+    /** Group name; when set the group renders as fieldset/legend so it's announced with each radio. */
+    label?: ReactNode;
 }
-declare function RadioGroup({ children, className }: RadioGroupProps): react.JSX.Element;
+declare function RadioGroup({ children, className, label }: RadioGroupProps): react.JSX.Element;
 
 export { Radio, RadioGroup, type RadioGroupProps, type RadioProps };

package/dist/components/Radio.js

@@ -9,8 +9,12 @@ const Radio = forwardRef(
   ] })
 );
 Radio.displayName = "Radio";
-function RadioGroup({ children, className }) {
-  return /* @__PURE__ */ jsx("div", { className: cx("uix-radio-group", className), children });
+function RadioGroup({ children, className, label }) {
+  if (label == null) return /* @__PURE__ */ jsx("div", { className: cx("uix-radio-group", className), children });
+  return /* @__PURE__ */ jsxs("fieldset", { className: cx("uix-radio-group", className), children: [
+    /* @__PURE__ */ jsx("legend", { className: "uix-radio-group__legend", children: label }),
+    children
+  ] });
 }
 export {
   Radio,

package/dist/components/Sidebar.js

@@ -1,6 +1,6 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { useState } from "react";
+import { useId, useState } from "react";
 import { cx } from "../cx.js";
 const ChevronIcon = () => /* @__PURE__ */ jsx("svg", { className: "uix-navgroup__chevron", viewBox: "0 0 12 12", fill: "none", stroke: "currentColor", strokeWidth: 1.5, strokeLinecap: "round", "aria-hidden": "true", children: /* @__PURE__ */ jsx("path", { d: "M2 4l4 4 4-4" }) });
 function Sidebar({ collapsed, onToggle, brand, toggleIcon, children, className, ...props }) {
@@ -55,12 +55,14 @@ function NavItem({ icon, badge, active, as: Tag = "a", children, className, ...p
 }
 function NavGroup({ icon, label, children, defaultExpanded = true }) {
   const [expanded, setExpanded] = useState(defaultExpanded);
+  const panelId = useId();
   return /* @__PURE__ */ jsxs("div", { className: "uix-navgroup", children: [
     /* @__PURE__ */ jsxs(
       "button",
       {
         className: "uix-navitem uix-navgroup__trigger",
         "aria-expanded": expanded,
+        "aria-controls": panelId,
         onClick: () => setExpanded((v) => !v),
         children: [
           icon && /* @__PURE__ */ jsx("span", { className: "uix-navitem__icon", "aria-hidden": "true", children: icon }),
@@ -69,7 +71,7 @@ function NavGroup({ icon, label, children, defaultExpanded = true }) {
         ]
       }
     ),
-    /* @__PURE__ */ jsx("div", { className: "uix-navgroup__panel", children: /* @__PURE__ */ jsx("div", { children }) })
+    /* @__PURE__ */ jsx("div", { className: "uix-navgroup__panel", id: panelId, children: /* @__PURE__ */ jsx("div", { children }) })
   ] });
 }
 function SubNavItem({ active, as: Tag = "a", children, className, ...props }) {

package/dist/components/Spinner.d.ts

@@ -4,7 +4,9 @@ import { HTMLAttributes } from 'react';
 interface SpinnerProps extends HTMLAttributes<HTMLSpanElement> {
     size?: 'md' | 'lg';
     accent?: boolean;
+    /** Announced loading text (default "Loading…"). */
+    label?: string;
 }
-declare function Spinner({ size, accent, className, ...props }: SpinnerProps): react.JSX.Element;
+declare function Spinner({ size, accent, label, className, ...props }: SpinnerProps): react.JSX.Element;
 
 export { Spinner, type SpinnerProps };

package/dist/components/Spinner.js

@@ -1,13 +1,13 @@
 import { jsx } from "react/jsx-runtime";
 import { cx } from "../cx.js";
-function Spinner({ size = "md", accent, className, ...props }) {
+function Spinner({ size = "md", accent, label, className, ...props }) {
   return /* @__PURE__ */ jsx(
     "span",
     {
       className: cx("uix-spinner", accent && "uix-spinner--accent", size === "lg" && "uix-spinner--lg", className),
       role: "status",
-      "aria-label": "Loading",
-      ...props
+      ...props,
+      children: /* @__PURE__ */ jsx("span", { className: "uix-visually-hidden", children: label ?? "Loading\u2026" })
     }
   );
 }

package/dist/components/Stat.js

@@ -8,7 +8,11 @@ function Stat({ label, value, icon, meta, trend, className, ...props }) {
     ] }),
     /* @__PURE__ */ jsx("div", { className: "uix-stat__value", children: value }),
     (meta != null || trend != null) && /* @__PURE__ */ jsxs("div", { className: "uix-stat__meta", children: [
-      trend != null && /* @__PURE__ */ jsx("span", { className: cx("uix-stat__trend", `uix-stat__trend--${trend.direction}`), children: trend.label }),
+      trend != null && /* @__PURE__ */ jsxs("span", { className: cx("uix-stat__trend", `uix-stat__trend--${trend.direction}`), children: [
+        /* @__PURE__ */ jsx("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: trend.direction === "up" ? /* @__PURE__ */ jsx("path", { d: "M12 19V5m-6 6 6-6 6 6" }) : /* @__PURE__ */ jsx("path", { d: "M12 5v14m6-6-6 6-6-6" }) }),
+        /* @__PURE__ */ jsx("span", { className: "uix-visually-hidden", children: trend.direction === "up" ? "up" : "down" }),
+        trend.label
+      ] }),
       meta
     ] })
   ] });

package/dist/components/States.d.ts

@@ -31,8 +31,10 @@ declare function Skeleton({ variant, width, height, className, style, ...props }
 interface LoadingStateProps extends HTMLAttributes<HTMLDivElement> {
     /** Number of skeleton rows to render. */
     rows?: number;
+    /** Announced loading text (default "Loading"). */
+    label?: string;
 }
 /** A stack of skeleton rows for list/section loading. `role="status"`. */
-declare function LoadingState({ rows, className, ...props }: LoadingStateProps): react.JSX.Element;
+declare function LoadingState({ rows, label, className, ...props }: LoadingStateProps): react.JSX.Element;
 
 export { EmptyState, type EmptyStateProps, ErrorState, type ErrorStateProps, LoadingState, type LoadingStateProps, Skeleton, type SkeletonProps };

package/dist/components/States.js

@@ -32,8 +32,14 @@ function Skeleton({ variant = "block", width, height, className, style, ...props
     }
   );
 }
-function LoadingState({ rows = 3, className, ...props }) {
-  return /* @__PURE__ */ jsx("div", { className: cx("uix-stack", className), role: "status", "aria-busy": "true", ...props, children: Array.from({ length: rows }, (_, i) => /* @__PURE__ */ jsx(Skeleton, { variant: "text", width: `${92 - i % 3 * 14}%` }, i)) });
+function LoadingState({ rows = 3, label, className, ...props }) {
+  return (
+    // no aria-busy: busy=true tells AT the region isn't ready and suppresses the announcement (UIX-A11Y-4)
+    /* @__PURE__ */ jsxs("div", { className: cx("uix-stack", className), role: "status", ...props, children: [
+      /* @__PURE__ */ jsx("span", { className: "uix-visually-hidden", children: label ?? "Loading" }),
+      Array.from({ length: rows }, (_, i) => /* @__PURE__ */ jsx(Skeleton, { variant: "text", width: `${92 - i % 3 * 14}%` }, i))
+    ] })
+  );
 }
 export {
   EmptyState,

package/dist/components/Table.d.ts

@@ -2,9 +2,14 @@ import * as react from 'react';
 import { HTMLAttributes, ReactNode, ButtonHTMLAttributes, TdHTMLAttributes, TableHTMLAttributes, ThHTMLAttributes } from 'react';
 
 interface TableWrapProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Polite live-region text for table state changes — "Sorted by …", "N results",
+     * "N selected". Pass `useTable().announcement` straight through (UIX-A11Y-2).
+     */
+    announcement?: string;
     children?: ReactNode;
 }
-declare function TableWrap({ children, className, ...props }: TableWrapProps): react.JSX.Element;
+declare function TableWrap({ announcement, children, className, ...props }: TableWrapProps): react.JSX.Element;
 type TableDensity = 'compact' | 'standard' | 'comfortable';
 type SortDirection = 'ascending' | 'descending' | 'none';
 interface TableProps extends TableHTMLAttributes<HTMLTableElement> {
@@ -53,9 +58,11 @@ interface RowActionProps extends ButtonHTMLAttributes<HTMLButtonElement> {
 declare function RowAction({ children, className, type, ...props }: RowActionProps): react.JSX.Element;
 interface ExpandToggleProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     expanded?: boolean;
+    /** id of the detail row this toggle controls → `aria-controls` (UIX-A11Y-2). */
+    controls?: string;
 }
 /** Chevron button that expands/collapses an inline detail row. */
-declare function ExpandToggle({ expanded, className, type, ...props }: ExpandToggleProps): react.JSX.Element;
+declare function ExpandToggle({ expanded, controls, className, type, ...props }: ExpandToggleProps): react.JSX.Element;
 /** Emphasised primary cell text. */
 declare function CellStrong({ children, className, ...props }: HTMLAttributes<HTMLSpanElement>): react.JSX.Element;
 /** Secondary line under a primary cell value (muted, meta size). */