@jirawatpyk/aura-react 5.67.0 → 5.68.0

package/README.md

@@ -186,6 +186,11 @@ DataTable with sort and page in the URL (4.17): `onStateChange={({ sort, page })
 - **Time zone**: `timeZone` on AuraProvider, DatePicker, DateRangePicker and Calendar decides "today" (the marker, `min`/`max="today"`, the first month shown); or pass `today` as an ISO date. `todayIn('Asia/Bangkok')` is exported from the root and `/server`.
 - **Toasts** queue past three instead of dropping: six in a row all show, in order, three at a time.
 
+## 5.68 — Chamber-OS addendum 85 (#184)
+
+- **A disabled group dims its legend:** `RadioGroup` and `CheckboxGroup` with `disabled` add `is-disabled` to the fieldset, so the legend takes the disabled colour (`fg-secondary`) a disabled `Field`'s label has — a form that disables its fields while submitting no longer shows group legends at full contrast over dimmed controls.
+- **`errorLive` — an error line that announces:** on `CheckboxGroup`, `RadioGroup` and `Field`, `errorLive` gives the error line `aria-live="polite"` and keeps it in the page, empty and taking no room, while there is no error (the hint shows), so a message that appears as the user changes the field ("Choose at least one membership category" the moment the last box is unticked) is read once. Off by default: an error shown on submit, with focus moved to the field, is read already. Under a `Field`, your own control should still point at `{id}-error` in its `aria-describedby` while there is an error, so the message stays its description. Not on TextField and the other controls. Hand-written markup with an empty `.aura-field__error` placeholder is now hidden until it has content. Drop a hand-made `sr-only` `role="status"` beside the group.
+
 ## 5.67 — Chamber-OS addendum 84 (#183)
 
 - **`CheckboxGroup` — RadioGroup's many-choice twin:** one `fieldset` named by its `legend`, with RadioGroup's props — `label`, `hint`, `error`, `required` (the same `*` marker), `disabled` (every box), `orientation`, `touchHeight` (44px rows), `options` (`{ value, label, description?, disabled? }` or strings), `name` — and a set of values: `value: string[]` / `defaultValue` / `onChange(values)`, always in option order whatever order they were ticked in. The group is described by the hint, or by the error line, which also marks every box `aria-invalid` and edges the empty ones. `required` shows the `*` and adds a hidden "(required)" to the group's name (localised), since a group can't take `aria-required` and a native `required` on each box would demand all of them; "at least one" is yours to check (pass `error`, which each box then also points at). Values not among the options (archived, still loading) are kept, after the others. `focus()` on the ref lands on the first ticked enabled box. Replaces a hand-made fieldset of Checkboxes.

package/dist/aura.bundle.js

@@ -2081,12 +2081,19 @@ window.Aura = (() => {
       ) : null,
       hasAddon(props.labelAddon) ? /* @__PURE__ */ React13.createElement("div", { className: "aura-field__addon", id: props.id + "-addon" }, props.labelAddon) : null,
       props.children,
-      props.error ? /* @__PURE__ */ React13.createElement("p", { className: "aura-field__error", id: props.id + "-error" }, /* @__PURE__ */ React13.createElement(Icon, { name: /* @__PURE__ */ React13.createElement(IconCircleAlert, null), size: 14 }), props.error) : props.hint ? /* @__PURE__ */ React13.createElement("p", { className: "aura-field__hint", id: props.id + "-hint" }, props.hint) : null
+      fieldNote(props.id, props.error, props.hint, props.errorLive)
     );
   });
   function describedBy(id, p) {
     return p.error ? id + "-error" : p.hint ? id + "-hint" : void 0;
   }
+  function fieldNote(id, error, hint, live) {
+    const err = error ? /* @__PURE__ */ React13.createElement(React13.Fragment, null, /* @__PURE__ */ React13.createElement(Icon, { name: /* @__PURE__ */ React13.createElement(IconCircleAlert, null), size: 14 }), error) : null;
+    const hintLine = hint ? /* @__PURE__ */ React13.createElement("p", { className: "aura-field__hint", id: id + "-hint" }, hint) : null;
+    if (!live)
+      return err ? /* @__PURE__ */ React13.createElement("p", { className: "aura-field__error", id: id + "-error" }, err) : hintLine;
+    return /* @__PURE__ */ React13.createElement(React13.Fragment, null, err ? null : hintLine, /* @__PURE__ */ React13.createElement("p", { className: "aura-field__error", id: id == null ? void 0 : id + "-error", "aria-live": "polite" }, err));
+  }
   function hasAddon(n3) {
     return n3 != null && typeof n3 !== "boolean" && n3 !== "";
   }
@@ -3872,6 +3879,7 @@ window.Aura = (() => {
         className: cx(
           "aura-field aura-radio-group",
           props.error && "is-invalid",
+          props.disabled && "is-disabled",
           touchClass(props.touchHeight),
           props.className
         ),
@@ -3901,7 +3909,7 @@ window.Aura = (() => {
           }
         ), /* @__PURE__ */ React20.createElement("span", { className: "aura-choice__text" }, /* @__PURE__ */ React20.createElement("span", { className: "aura-choice__label", id: oid ? oid + "-label" : void 0 }, v.label), v.description ? /* @__PURE__ */ React20.createElement("span", { className: "aura-choice__desc", id: oid + "-desc" }, v.description) : null));
       })),
-      props.error ? /* @__PURE__ */ React20.createElement("p", { className: "aura-field__error", id: id + "-error" }, /* @__PURE__ */ React20.createElement(Icon, { name: /* @__PURE__ */ React20.createElement(IconCircleAlert, null), size: 14 }), props.error) : props.hint ? /* @__PURE__ */ React20.createElement("p", { className: "aura-field__hint", id: id + "-hint" }, props.hint) : null
+      fieldNote(id, props.error, props.hint, props.errorLive)
     );
   });
 
@@ -3936,6 +3944,7 @@ window.Aura = (() => {
           className: cx(
             "aura-field aura-radio-group aura-checkbox-group",
             props.error && "is-invalid",
+            props.disabled && "is-disabled",
             touchClass(props.touchHeight),
             props.className
           ),
@@ -3973,7 +3982,7 @@ window.Aura = (() => {
             v.label
           );
         })),
-        props.error ? /* @__PURE__ */ React21.createElement("p", { className: "aura-field__error", id: id + "-error" }, /* @__PURE__ */ React21.createElement(Icon, { name: /* @__PURE__ */ React21.createElement(IconCircleAlert, null), size: 14 }), props.error) : props.hint ? /* @__PURE__ */ React21.createElement("p", { className: "aura-field__hint", id: id + "-hint" }, props.hint) : null
+        fieldNote(id, props.error, props.hint, props.errorLive)
       );
     }
   );

package/dist/cjs/index.cjs

@@ -2063,12 +2063,19 @@ var Field = React13.forwardRef(function Field2(props, ref) {
     ) : null,
     hasAddon(props.labelAddon) ? /* @__PURE__ */ React13.createElement("div", { className: "aura-field__addon", id: props.id + "-addon" }, props.labelAddon) : null,
     props.children,
-    props.error ? /* @__PURE__ */ React13.createElement("p", { className: "aura-field__error", id: props.id + "-error" }, /* @__PURE__ */ React13.createElement(Icon, { name: /* @__PURE__ */ React13.createElement(IconCircleAlert, null), size: 14 }), props.error) : props.hint ? /* @__PURE__ */ React13.createElement("p", { className: "aura-field__hint", id: props.id + "-hint" }, props.hint) : null
+    fieldNote(props.id, props.error, props.hint, props.errorLive)
   );
 });
 function describedBy(id, p) {
   return p.error ? id + "-error" : p.hint ? id + "-hint" : void 0;
 }
+function fieldNote(id, error, hint, live) {
+  const err = error ? /* @__PURE__ */ React13.createElement(React13.Fragment, null, /* @__PURE__ */ React13.createElement(Icon, { name: /* @__PURE__ */ React13.createElement(IconCircleAlert, null), size: 14 }), error) : null;
+  const hintLine = hint ? /* @__PURE__ */ React13.createElement("p", { className: "aura-field__hint", id: id + "-hint" }, hint) : null;
+  if (!live)
+    return err ? /* @__PURE__ */ React13.createElement("p", { className: "aura-field__error", id: id + "-error" }, err) : hintLine;
+  return /* @__PURE__ */ React13.createElement(React13.Fragment, null, err ? null : hintLine, /* @__PURE__ */ React13.createElement("p", { className: "aura-field__error", id: id == null ? void 0 : id + "-error", "aria-live": "polite" }, err));
+}
 function hasAddon(n3) {
   return n3 != null && typeof n3 !== "boolean" && n3 !== "";
 }
@@ -3854,6 +3861,7 @@ var RadioGroup = React20.forwardRef(function RadioGroup2(props, ref) {
       className: cx(
         "aura-field aura-radio-group",
         props.error && "is-invalid",
+        props.disabled && "is-disabled",
         touchClass(props.touchHeight),
         props.className
       ),
@@ -3883,7 +3891,7 @@ var RadioGroup = React20.forwardRef(function RadioGroup2(props, ref) {
         }
       ), /* @__PURE__ */ React20.createElement("span", { className: "aura-choice__text" }, /* @__PURE__ */ React20.createElement("span", { className: "aura-choice__label", id: oid ? oid + "-label" : void 0 }, v.label), v.description ? /* @__PURE__ */ React20.createElement("span", { className: "aura-choice__desc", id: oid + "-desc" }, v.description) : null));
     })),
-    props.error ? /* @__PURE__ */ React20.createElement("p", { className: "aura-field__error", id: id + "-error" }, /* @__PURE__ */ React20.createElement(Icon, { name: /* @__PURE__ */ React20.createElement(IconCircleAlert, null), size: 14 }), props.error) : props.hint ? /* @__PURE__ */ React20.createElement("p", { className: "aura-field__hint", id: id + "-hint" }, props.hint) : null
+    fieldNote(id, props.error, props.hint, props.errorLive)
   );
 });
 
@@ -3918,6 +3926,7 @@ var CheckboxGroup = React21.forwardRef(
         className: cx(
           "aura-field aura-radio-group aura-checkbox-group",
           props.error && "is-invalid",
+          props.disabled && "is-disabled",
           touchClass(props.touchHeight),
           props.className
         ),
@@ -3955,7 +3964,7 @@ var CheckboxGroup = React21.forwardRef(
           v.label
         );
       })),
-      props.error ? /* @__PURE__ */ React21.createElement("p", { className: "aura-field__error", id: id + "-error" }, /* @__PURE__ */ React21.createElement(Icon, { name: /* @__PURE__ */ React21.createElement(IconCircleAlert, null), size: 14 }), props.error) : props.hint ? /* @__PURE__ */ React21.createElement("p", { className: "aura-field__hint", id: id + "-hint" }, props.hint) : null
+      fieldNote(id, props.error, props.hint, props.errorLive)
     );
   }
 );

package/dist/esm/CheckboxGroup.js

@@ -1,11 +1,9 @@
 'use client';
 import * as React from "react";
 import { Checkbox } from "./Checkbox.js";
-import { describedBy } from "./Field.js";
-import { Icon } from "./Icon.js";
+import { describedBy, fieldNote } from "./Field.js";
 import { cx, touchClass, uid, useMaybeControlled } from "./internal.js";
 import { useStrings } from "./locale.js";
-import { IconCircleAlert } from "./icons.js";
 const CheckboxGroup = React.forwardRef(
   function CheckboxGroup2(props, ref) {
     const t = useStrings();
@@ -35,6 +33,7 @@ const CheckboxGroup = React.forwardRef(
         className: cx(
           "aura-field aura-radio-group aura-checkbox-group",
           props.error && "is-invalid",
+          props.disabled && "is-disabled",
           touchClass(props.touchHeight),
           props.className
         ),
@@ -72,7 +71,7 @@ const CheckboxGroup = React.forwardRef(
           v.label
         );
       })),
-      props.error ? /* @__PURE__ */ React.createElement("p", { className: "aura-field__error", id: id + "-error" }, /* @__PURE__ */ React.createElement(Icon, { name: /* @__PURE__ */ React.createElement(IconCircleAlert, null), size: 14 }), props.error) : props.hint ? /* @__PURE__ */ React.createElement("p", { className: "aura-field__hint", id: id + "-hint" }, props.hint) : null
+      fieldNote(id, props.error, props.hint, props.errorLive)
     );
   }
 );

package/dist/esm/Field.js

@@ -27,12 +27,19 @@ const Field = React.forwardRef(function Field2(props, ref) {
     ) : null,
     hasAddon(props.labelAddon) ? /* @__PURE__ */ React.createElement("div", { className: "aura-field__addon", id: props.id + "-addon" }, props.labelAddon) : null,
     props.children,
-    props.error ? /* @__PURE__ */ React.createElement("p", { className: "aura-field__error", id: props.id + "-error" }, /* @__PURE__ */ React.createElement(Icon, { name: /* @__PURE__ */ React.createElement(IconCircleAlert, null), size: 14 }), props.error) : props.hint ? /* @__PURE__ */ React.createElement("p", { className: "aura-field__hint", id: props.id + "-hint" }, props.hint) : null
+    fieldNote(props.id, props.error, props.hint, props.errorLive)
   );
 });
 function describedBy(id, p) {
   return p.error ? id + "-error" : p.hint ? id + "-hint" : void 0;
 }
+function fieldNote(id, error, hint, live) {
+  const err = error ? /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement(Icon, { name: /* @__PURE__ */ React.createElement(IconCircleAlert, null), size: 14 }), error) : null;
+  const hintLine = hint ? /* @__PURE__ */ React.createElement("p", { className: "aura-field__hint", id: id + "-hint" }, hint) : null;
+  if (!live)
+    return err ? /* @__PURE__ */ React.createElement("p", { className: "aura-field__error", id: id + "-error" }, err) : hintLine;
+  return /* @__PURE__ */ React.createElement(React.Fragment, null, err ? null : hintLine, /* @__PURE__ */ React.createElement("p", { className: "aura-field__error", id: id == null ? void 0 : id + "-error", "aria-live": "polite" }, err));
+}
 function hasAddon(n) {
   return n != null && typeof n !== "boolean" && n !== "";
 }
@@ -68,6 +75,7 @@ export {
   FIELD_KEYS,
   Field,
   describedBy,
+  fieldNote,
   hasAddon,
   joinDescribedBy
 };

package/dist/esm/RadioGroup.js

@@ -1,9 +1,7 @@
 'use client';
 import * as React from "react";
-import { describedBy } from "./Field.js";
-import { Icon } from "./Icon.js";
+import { describedBy, fieldNote } from "./Field.js";
 import { cx, touchClass, uid, useMaybeControlled } from "./internal.js";
-import { IconCircleAlert } from "./icons.js";
 const RadioGroup = React.forwardRef(function RadioGroup2(props, ref) {
   const auto = uid(), id = props.id || auto;
   const st = useMaybeControlled(
@@ -31,6 +29,7 @@ const RadioGroup = React.forwardRef(function RadioGroup2(props, ref) {
       className: cx(
         "aura-field aura-radio-group",
         props.error && "is-invalid",
+        props.disabled && "is-disabled",
         touchClass(props.touchHeight),
         props.className
       ),
@@ -60,7 +59,7 @@ const RadioGroup = React.forwardRef(function RadioGroup2(props, ref) {
         }
       ), /* @__PURE__ */ React.createElement("span", { className: "aura-choice__text" }, /* @__PURE__ */ React.createElement("span", { className: "aura-choice__label", id: oid ? oid + "-label" : void 0 }, v.label), v.description ? /* @__PURE__ */ React.createElement("span", { className: "aura-choice__desc", id: oid + "-desc" }, v.description) : null));
     })),
-    props.error ? /* @__PURE__ */ React.createElement("p", { className: "aura-field__error", id: id + "-error" }, /* @__PURE__ */ React.createElement(Icon, { name: /* @__PURE__ */ React.createElement(IconCircleAlert, null), size: 14 }), props.error) : props.hint ? /* @__PURE__ */ React.createElement("p", { className: "aura-field__hint", id: id + "-hint" }, props.hint) : null
+    fieldNote(id, props.error, props.hint, props.errorLive)
   );
 });
 export {

package/dist/index.d.cts

@@ -680,7 +680,12 @@ export interface RadioGroupProps extends FieldProps {
 	name?: string | undefined;
 	/** Default `vertical`. */
 	orientation?: "vertical" | "horizontal" | undefined;
+	/** Disables every option and (5.68) dims the legend, as Field does its label. */
 	disabled?: boolean | undefined;
+	/** 5.68 (Chamber-OS 184): announce the error line when it appears (`aria-live="polite"`) — for an error shown as
+	 * the user changes the group ("Choose at least one…" when the last box is unticked), not on submit. The error line
+	 * stays in the page, empty, while there is none, so the first message is read too. Off by default. */
+	errorLive?: boolean | undefined;
 	id?: string | undefined;
 	className?: string | undefined;
 	/** 44px rows (5.30, Chamber-OS 135), the one-line label centred: `true` below 640px or on a coarse pointer (touch
@@ -700,7 +705,12 @@ export interface CheckboxGroupProps extends FieldProps {
 	name?: string | undefined;
 	/** Default `vertical`. */
 	orientation?: "vertical" | "horizontal" | undefined;
+	/** Disables every option and (5.68) dims the legend, as Field does its label. */
 	disabled?: boolean | undefined;
+	/** 5.68 (Chamber-OS 184): announce the error line when it appears (`aria-live="polite"`) — for an error shown as
+	 * the user changes the group ("Choose at least one…" when the last box is unticked), not on submit. The error line
+	 * stays in the page, empty, while there is none, so the first message is read too. Off by default. */
+	errorLive?: boolean | undefined;
 	id?: string | undefined;
 	className?: string | undefined;
 	/** 44px rows, as RadioGroup: `true` below 640px or on a coarse pointer, `'always'` at every width. */
@@ -1927,6 +1937,12 @@ export interface FieldComponentProps extends Omit<FieldPropsPublic, "label"> {
 	/** The control's id: the label points at it, and the hint/error ids derive from it. */
 	id?: string | undefined;
 	children?: React$1.ReactNode | undefined;
+	/** 5.68 (Chamber-OS 184): announce the error line when it appears — for an error shown as the user types or ticks,
+	 * not on submit. The error `<p>` gets `aria-live="polite"` and stays in the page, empty, while there is no error, so
+	 * the first message is read too. Off by default: an error shown on submit, with focus moved to the field, is read
+	 * already, and a live line would read it twice. Your control should still point at `{id}-error` in its
+	 * `aria-describedby` while there is an error (TextField and the others do), so the message stays its description. */
+	errorLive?: boolean | undefined;
 	/** 5.31 (Chamber-OS addendum 41): a node between the label and the control, in a `.aura-field__addon` box with the
 	 * id `{id}-addon`. TextField and Textarea add that id to the input's `aria-describedby`; a custom control should too. */
 	labelAddon?: React$1.ReactNode | undefined;

package/dist/index.d.ts

@@ -680,7 +680,12 @@ export interface RadioGroupProps extends FieldProps {
 	name?: string | undefined;
 	/** Default `vertical`. */
 	orientation?: "vertical" | "horizontal" | undefined;
+	/** Disables every option and (5.68) dims the legend, as Field does its label. */
 	disabled?: boolean | undefined;
+	/** 5.68 (Chamber-OS 184): announce the error line when it appears (`aria-live="polite"`) — for an error shown as
+	 * the user changes the group ("Choose at least one…" when the last box is unticked), not on submit. The error line
+	 * stays in the page, empty, while there is none, so the first message is read too. Off by default. */
+	errorLive?: boolean | undefined;
 	id?: string | undefined;
 	className?: string | undefined;
 	/** 44px rows (5.30, Chamber-OS 135), the one-line label centred: `true` below 640px or on a coarse pointer (touch
@@ -700,7 +705,12 @@ export interface CheckboxGroupProps extends FieldProps {
 	name?: string | undefined;
 	/** Default `vertical`. */
 	orientation?: "vertical" | "horizontal" | undefined;
+	/** Disables every option and (5.68) dims the legend, as Field does its label. */
 	disabled?: boolean | undefined;
+	/** 5.68 (Chamber-OS 184): announce the error line when it appears (`aria-live="polite"`) — for an error shown as
+	 * the user changes the group ("Choose at least one…" when the last box is unticked), not on submit. The error line
+	 * stays in the page, empty, while there is none, so the first message is read too. Off by default. */
+	errorLive?: boolean | undefined;
 	id?: string | undefined;
 	className?: string | undefined;
 	/** 44px rows, as RadioGroup: `true` below 640px or on a coarse pointer, `'always'` at every width. */
@@ -1927,6 +1937,12 @@ export interface FieldComponentProps extends Omit<FieldPropsPublic, "label"> {
 	/** The control's id: the label points at it, and the hint/error ids derive from it. */
 	id?: string | undefined;
 	children?: React$1.ReactNode | undefined;
+	/** 5.68 (Chamber-OS 184): announce the error line when it appears — for an error shown as the user types or ticks,
+	 * not on submit. The error `<p>` gets `aria-live="polite"` and stays in the page, empty, while there is no error, so
+	 * the first message is read too. Off by default: an error shown on submit, with focus moved to the field, is read
+	 * already, and a live line would read it twice. Your control should still point at `{id}-error` in its
+	 * `aria-describedby` while there is an error (TextField and the others do), so the message stays its description. */
+	errorLive?: boolean | undefined;
 	/** 5.31 (Chamber-OS addendum 41): a node between the label and the control, in a `.aura-field__addon` box with the
 	 * id `{id}-addon`. TextField and Textarea add that id to the input's `aria-describedby`; a custom control should too. */
 	labelAddon?: React$1.ReactNode | undefined;

package/dist/styles.css

@@ -525,6 +525,9 @@ a.aura-icon-btn { text-decoration: none; }
 .aura-field__hint, .aura-field__error { display: flex; align-items: flex-start; gap: var(--aura-space-1); margin: 0; font-size: max(12px, .75rem); line-height: 1.5; color: var(--aura-fg-secondary); }
 .aura-field__error { color: var(--aura-fg-danger); }
 .aura-field__error .aura-icon { margin-top: 2px; }
+/* 5.68 (Chamber-OS 184): an `errorLive` error line waits in the page, empty, until there is an error. Out of the
+ * flow (an absolute child takes no gap) and clipped; the screen reader still has the live region. */
+.aura-field__error:empty { position: absolute; width: 1px; height: 1px; margin: -1px; padding: 0; border: 0; overflow: hidden; clip-path: inset(50%); white-space: nowrap; }
 /* 5.31 (Chamber-OS addendum 41): TextField/Textarea `labelAddon`, between the label and the box, in the field's gap. */
 .aura-field__addon { min-width: 0; font-size: max(13px, .8125rem); line-height: 1.5; color: var(--aura-fg-primary); }
 .aura-field.is-disabled .aura-field__label { color: var(--aura-fg-secondary); }

package/dist/styles.layer.css

@@ -527,6 +527,9 @@ a.aura-icon-btn { text-decoration: none; }
 .aura-field__hint, .aura-field__error { display: flex; align-items: flex-start; gap: var(--aura-space-1); margin: 0; font-size: max(12px, .75rem); line-height: 1.5; color: var(--aura-fg-secondary); }
 .aura-field__error { color: var(--aura-fg-danger); }
 .aura-field__error .aura-icon { margin-top: 2px; }
+/* 5.68 (Chamber-OS 184): an `errorLive` error line waits in the page, empty, until there is an error. Out of the
+ * flow (an absolute child takes no gap) and clipped; the screen reader still has the live region. */
+.aura-field__error:empty { position: absolute; width: 1px; height: 1px; margin: -1px; padding: 0; border: 0; overflow: hidden; clip-path: inset(50%); white-space: nowrap; }
 /* 5.31 (Chamber-OS addendum 41): TextField/Textarea `labelAddon`, between the label and the box, in the field's gap. */
 .aura-field__addon { min-width: 0; font-size: max(13px, .8125rem); line-height: 1.5; color: var(--aura-fg-primary); }
 .aura-field.is-disabled .aura-field__label { color: var(--aura-fg-secondary); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jirawatpyk/aura-react",
-  "version": "5.67.0",
+  "version": "5.68.0",
   "description": "AURA Design System — React components (Enterprise Standard, Human Creative). Thai-first: Buddhist-era dates, Thai collation.",
   "license": "MIT",
   "type": "module",