@chassis-ui/react 0.4.1 → 0.5.0

package/dist/chunks/{index-CTpwB1yR.d.ts → index-BxrIOrAc.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { n as PolymorphicRef, t as PolymorphicComponentProps } from "./polymorphic-CVHbTHSN.js";
 import { i as IconValue } from "./iconConfig-C6gbYhsD.js";
 import React, { ButtonHTMLAttributes, ElementType, HTMLAttributes, ReactElement } from "react";
@@ -23,8 +23,10 @@ interface CarouselSlideDetail {
 }
 interface CarouselProps extends HTMLAttributes<HTMLDivElement> {
   /**
-   * The active slide's index, for controlled usage. Pair with `onSlide` or `onSlid` to feed the
-   * new index back — they're the only way a controlled carousel's `activeIndex` gets updated.
+   * The active slide's index, for controlled usage. Pair with `onSlide` to feed the new index
+   * back: it is the only way a controlled carousel's `activeIndex` gets updated. `onSlid` can't
+   * do that, as it reports a slide that has arrived, which a controlled carousel doesn't leave
+   * for until `activeIndex` names it.
    */
   activeIndex?: number;
   /**
@@ -68,7 +70,9 @@ interface CarouselProps extends HTMLAttributes<HTMLDivElement> {
    */
   itemsPeek?: string;
   /**
-   * Move to the previous/next slide with the Left/Right arrow keys while focus is inside the carousel.
+   * Move to the previous/next slide with the Left/Right arrow keys while focus is inside the
+   * carousel. The keys follow the slides: in a right-to-left layout the next slide is to the
+   * left, and Left Arrow moves to it.
    */
   keyboard?: boolean;
   /**
@@ -228,9 +232,10 @@ interface CarouselPlayPauseProps extends ButtonHTMLAttributes<HTMLButtonElement>
 /**
  * A discoverable toggle so a viewer can stop an autoplaying carousel, as required by WCAG 2.2
  * Success Criterion 2.2.2 (Pause, Stop, Hide). Reflects the current state automatically — a pause
- * icon while playing, a play icon once stopped.
+ * icon while playing, a play icon once stopped. On the last slide of an `ends="stop"` carousel
+ * there is nothing left to play, and the stopped toggle is disabled, as the next control is.
  */
 declare const CarouselPlayPause: React.ForwardRefExoticComponent<CarouselPlayPauseProps & React.RefAttributes<HTMLButtonElement>>;
 //#endregion
 export { CarouselSlideDetail as _, CarouselItem as a, CarouselInnerProps as c, CarouselControlPrev as d, CarouselControlPrevProps as f, CarouselProps as g, Carousel as h, CarouselOverlayProps as i, CarouselIndicators as l, CarouselControlNextProps as m, CarouselPlayPauseProps as n, CarouselItemProps as o, CarouselControlNext as p, CarouselOverlay as r, CarouselInner as s, CarouselPlayPause as t, CarouselIndicatorsProps as u, CarouselTransition as v, CarouselEnds as y };
-//# sourceMappingURL=index-CTpwB1yR.d.ts.map
+//# sourceMappingURL=index-BxrIOrAc.d.ts.map

package/dist/chunks/{index-DHcztR18.d.ts → index-ByBbC4Jh.d.ts}

@@ -1,7 +1,7 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { n as PolymorphicRef, t as PolymorphicComponentProps } from "./polymorphic-CVHbTHSN.js";
 import { r as ContextColor } from "./types-D6FM7bYR.js";
-import { n as ButtonProps } from "./Button-BuZ_GOHS.js";
+import { n as ButtonProps } from "./Button-DblYVwl-.js";
 import { n as IconProps } from "./Icon-CioraWLF.js";
 import React, { DialogHTMLAttributes, ElementType, ReactElement } from "react";
 //#region src/components/alert/Alert.d.ts
@@ -205,4 +205,4 @@ type AlertTitleComponent = (<C extends ElementType = 'h2'>(props: AlertTitleProp
 declare const AlertTitle: AlertTitleComponent;
 //#endregion
 export { AlertIcon as a, AlertFooterProps as c, AlertCancel as d, AlertCancelProps as f, AlertProps as g, Alert as h, AlertTextProps as i, AlertCode as l, AlertBodyProps as m, AlertTitleProps as n, AlertIconProps as o, AlertBody as p, AlertText as r, AlertFooter as s, AlertTitle as t, AlertCodeProps as u };
-//# sourceMappingURL=index-DHcztR18.d.ts.map
+//# sourceMappingURL=index-ByBbC4Jh.d.ts.map

package/dist/chunks/{index-DHGgezXU.d.ts → index-C-IrFdKe.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import React, { ChangeEventHandler, InputHTMLAttributes, ReactNode } from "react";
 //#region src/components/color-input/ColorInput.d.ts
 interface ColorInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size'> {
@@ -56,4 +56,4 @@ interface ColorInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 's
 declare const ColorInput: React.ForwardRefExoticComponent<ColorInputProps & React.RefAttributes<HTMLInputElement>>;
 //#endregion
 export { ColorInputProps as n, ColorInput as t };
-//# sourceMappingURL=index-DHGgezXU.d.ts.map
+//# sourceMappingURL=index-C-IrFdKe.d.ts.map

package/dist/chunks/{index-B8uaSJA9.d.ts → index-C0g8NSXY.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import React, { HTMLAttributes, ReactNode } from "react";
 //#region src/components/chip-input/ChipInput.d.ts
 interface ChipInputProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
@@ -40,11 +40,14 @@ interface ChipInputProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'
    */
   id?: string;
   /**
-   * Set component validation state to invalid.
+   * Set component validation state to invalid. Left unset, the component shows as invalid by itself
+   * from a submit it held back (an empty `required` one, say) until it no longer would, or its
+   * form is reset. Set it, to `false` too, and it alone decides.
    */
   invalid?: boolean;
   /**
-   * An error message for the field, rendered below the chips when `invalid` is set.
+   * An error message for the field, rendered below the chips when `invalid` is set, and after a
+   * submit the field held back, until it no longer would.
    */
   invalidFeedback?: ReactNode;
   /**
@@ -68,6 +71,12 @@ interface ChipInputProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'
    * Placeholder shown in the input when empty.
    */
   placeholder?: string;
+  /**
+   * Toggle the required state for the component. A required chip input with no chips holds its
+   * form back from submitting, and its text input takes focus: text typed there and not added as
+   * a chip is not a value.
+   */
+  required?: boolean;
   /**
    * Character that creates a new chip when typed, or pasted text is split on. Set to `null` to
    * disable. Defaults to `,`.
@@ -93,4 +102,4 @@ interface ChipInputProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'
 declare const ChipInput: React.ForwardRefExoticComponent<ChipInputProps & React.RefAttributes<HTMLDivElement>>;
 //#endregion
 export { ChipInputProps as n, ChipInput as t };
-//# sourceMappingURL=index-B8uaSJA9.d.ts.map
+//# sourceMappingURL=index-C0g8NSXY.d.ts.map

package/dist/chunks/{index-CFnQubsV.d.ts → index-C1RKm3hQ.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { n as PolymorphicRef, t as PolymorphicComponentProps } from "./polymorphic-CVHbTHSN.js";
 import { t as NavVariant } from "./navVariant-CnD21GBS.js";
 import React, { AriaAttributes, ElementType, HTMLAttributes, ReactElement, ReactNode } from "react";
@@ -35,7 +35,9 @@ type TabsOwnProps<C extends ElementType> = {
    */
   onSelectionChange?: (key: Key$1) => void;
   /**
-   * The orientation of the tab list.
+   * The orientation of the tab list. `'vertical'` stacks the tabs, with the `flex-column` class
+   * on the list, and moves between them with the up and down arrow keys. The panels stay below
+   * the list: to put them beside it, lay out the root with `className`.
    */
   orientation?: 'horizontal' | 'vertical';
   /**
@@ -120,4 +122,4 @@ interface TabPanelProps extends Omit<HTMLAttributes<HTMLDivElement>, 'id'> {
 declare const TabPanel: React.ForwardRefExoticComponent<TabPanelProps & React.RefAttributes<HTMLDivElement>>;
 //#endregion
 export { Tab as a, TabsProps as c, TabListProps as i, TabPanelProps as n, TabProps as o, TabList as r, Tabs as s, TabPanel as t };
-//# sourceMappingURL=index-CFnQubsV.d.ts.map
+//# sourceMappingURL=index-C1RKm3hQ.d.ts.map

package/dist/chunks/{index-BxROljJI.d.ts → index-C3qqMzs5.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import "./Icon-CioraWLF.js";
 import { n as IconConfig } from "./iconConfig-C6gbYhsD.js";
 import React, { ReactNode } from "react";
@@ -15,4 +15,4 @@ declare const IconProvider: {
 };
 //#endregion
 export { IconProviderProps as n, IconProvider as t };
-//# sourceMappingURL=index-BxROljJI.d.ts.map
+//# sourceMappingURL=index-C3qqMzs5.d.ts.map

package/dist/chunks/{index-Dcc_W6Kv.d.ts → index-C6F3DQCd.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { n as PolymorphicRef, t as PolymorphicComponentProps } from "./polymorphic-CVHbTHSN.js";
 import React, { DetailsHTMLAttributes, ElementType, HTMLAttributes, ReactElement, ReactNode } from "react";
 //#region src/components/accordion/Accordion.d.ts
@@ -144,4 +144,4 @@ interface AccordionItemProps extends DetailsHTMLAttributes<HTMLDetailsElement> {
 declare const AccordionItem: React.ForwardRefExoticComponent<AccordionItemProps & React.RefAttributes<HTMLDetailsElement>>;
 //#endregion
 export { AccordionBody as a, AccordionItemDef as c, AccordionHeaderProps as i, AccordionProps as l, AccordionItemProps as n, AccordionBodyProps as o, AccordionHeader as r, Accordion as s, AccordionItem as t };
-//# sourceMappingURL=index-Dcc_W6Kv.d.ts.map
+//# sourceMappingURL=index-C6F3DQCd.d.ts.map

package/dist/chunks/{index-x0vZRyoU.d.ts → index-CEPAXElM.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { n as PolymorphicRef, r as PolymorphicRefWithFallback, t as PolymorphicComponentProps } from "./polymorphic-CVHbTHSN.js";
 import { i as ContextStyle, r as ContextColor, t as Breakpoint } from "./types-D6FM7bYR.js";
 import { i as IconValue } from "./iconConfig-C6gbYhsD.js";
@@ -18,7 +18,8 @@ type NavbarOwnProps<C extends ElementType> = {
    */
   component?: C;
   /**
-   * Defines optional container wrapping children elements.
+   * Wraps the children in a `.container`, as `Container` renders one: `true` for the default,
+   * `'fluid'` for one as wide as the navbar, or a breakpoint for one that is fluid until it.
    */
   container?: boolean | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'fluid';
   /**
@@ -135,4 +136,4 @@ interface NavbarTogglerProps extends HTMLAttributes<HTMLButtonElement> {
 declare const NavbarToggler: React.ForwardRefExoticComponent<NavbarTogglerProps & React.RefAttributes<HTMLButtonElement>>;
 //#endregion
 export { NavbarNav as a, NavbarBrandProps as c, NavbarTextProps as i, Navbar as l, NavbarTogglerProps as n, NavbarNavProps as o, NavbarText as r, NavbarBrand as s, NavbarToggler as t, NavbarProps as u };
-//# sourceMappingURL=index-x0vZRyoU.d.ts.map
+//# sourceMappingURL=index-CEPAXElM.d.ts.map

package/dist/chunks/{index-DaHQdNul.d.ts → index-COVY45gK.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { i as IconValue } from "./iconConfig-C6gbYhsD.js";
 import { CSSProperties, ReactElement, ReactNode, Ref } from "react";
 import { Key as Key$1, Selection } from "react-aria-components";
@@ -179,4 +179,4 @@ declare const TreeItem$1: <T extends object = object>(props: TreeItemProps<T> &
 }) => ReactElement;
 //#endregion
 export { TreeProps as i, TreeItemProps as n, Tree$1 as r, TreeItem$1 as t };
-//# sourceMappingURL=index-DaHQdNul.d.ts.map
+//# sourceMappingURL=index-COVY45gK.d.ts.map

package/dist/chunks/{index-DJfga0Ce.d.ts → index-COq1jJ6Y.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { t as Placement } from "./overlayPlacement-CIsLpycT.js";
 import React, { HTMLAttributes, ReactElement, ReactNode } from "react";
 //#region src/components/tooltip/Tooltip.d.ts
@@ -54,4 +54,4 @@ interface TooltipProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' |
 declare const Tooltip: React.ForwardRefExoticComponent<TooltipProps & React.RefAttributes<HTMLDivElement>>;
 //#endregion
 export { TooltipProps as n, Tooltip as t };
-//# sourceMappingURL=index-DJfga0Ce.d.ts.map
+//# sourceMappingURL=index-COq1jJ6Y.d.ts.map

package/dist/chunks/{index-HrKN6s8z.d.ts → index-CSRGr7pU.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import React, { ChangeEventHandler, InputHTMLAttributes, ReactNode } from "react";
 //#region src/components/range-input/RangeInput.d.ts
 interface RangeInputProps extends InputHTMLAttributes<HTMLInputElement> {
@@ -64,4 +64,4 @@ interface RangeInputProps extends InputHTMLAttributes<HTMLInputElement> {
 declare const RangeInput: React.ForwardRefExoticComponent<RangeInputProps & React.RefAttributes<HTMLInputElement>>;
 //#endregion
 export { RangeInputProps as n, RangeInput as t };
-//# sourceMappingURL=index-HrKN6s8z.d.ts.map
+//# sourceMappingURL=index-CSRGr7pU.d.ts.map

package/dist/chunks/{index-B1kw0jzM.d.ts → index-CTNqEMug.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { r as PolymorphicRefWithFallback, t as PolymorphicComponentProps } from "./polymorphic-CVHbTHSN.js";
 import { i as ContextStyle, r as ContextColor } from "./types-D6FM7bYR.js";
 import { ElementType, MouseEventHandler, ReactElement } from "react";
@@ -34,7 +34,10 @@ type ChipOwnProps<C extends ElementType> = {
   onClick?: MouseEventHandler<HTMLElement>;
   /**
    * Marks the chip as pressed for toggle-style usage (e.g. a filter chip). Applies the `.active`
-   * class and sets `aria-pressed` so assistive technology announces the toggle state.
+   * class and sets `aria-pressed` so assistive technology announces the toggle state. A chip
+   * with no `onClick` or `component="button"` is not a button and gets the class alone: a static
+   * chip, and a link (`href`, or an `<a>` as `component` or the `asChild` element), which has no
+   * pressed state to announce unless you give it `role="button"`.
    */
   pressed?: boolean;
   /**
@@ -60,4 +63,4 @@ type ChipComponent = (<C extends ElementType = 'span'>(props: ChipProps<C> & {
 declare const Chip: ChipComponent;
 //#endregion
 export { ChipProps as n, Chip as t };
-//# sourceMappingURL=index-B1kw0jzM.d.ts.map
+//# sourceMappingURL=index-CTNqEMug.d.ts.map

package/dist/chunks/{index-6uob77s9.d.ts → index-CW94lG-e.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import React, { InputHTMLAttributes, ReactNode } from "react";
 //#region src/components/text-input/TextInput.d.ts
 interface TextInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'defaultValue' | 'onChange' | 'size' | 'value'> {
@@ -31,11 +31,14 @@ interface TextInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'de
    */
   help?: ReactNode;
   /**
-   * Set component validation state to invalid.
+   * Set component validation state to invalid. Left unset, the component shows as invalid by itself
+   * from a submit it held back (an empty `required` one, say) until it no longer would, or its
+   * form is reset. Set it, to `false` too, and it alone decides.
    */
   invalid?: boolean;
   /**
-   * An error message for the field, rendered below the input when `invalid` is set.
+   * An error message for the field, rendered below the input when `invalid` is set, and after a
+   * submit the field held back, until it no longer would.
    */
   invalidFeedback?: ReactNode;
   /**
@@ -78,4 +81,4 @@ interface TextInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'de
 declare const TextInput: React.ForwardRefExoticComponent<TextInputProps & React.RefAttributes<HTMLInputElement>>;
 //#endregion
 export { TextInputProps as n, TextInput as t };
-//# sourceMappingURL=index-6uob77s9.d.ts.map
+//# sourceMappingURL=index-CW94lG-e.d.ts.map

package/dist/chunks/{index-Ddd7iWfm.d.ts → index-CY-A60p6.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { n as PolymorphicRef, t as PolymorphicComponentProps } from "./polymorphic-CVHbTHSN.js";
 import { ElementType, ReactElement } from "react";
 //#region src/components/visually-hidden/VisuallyHidden.d.ts
@@ -29,4 +29,4 @@ type VisuallyHiddenComponent = (<C extends ElementType = 'span'>(props: Visually
 declare const VisuallyHidden: VisuallyHiddenComponent;
 //#endregion
 export { VisuallyHiddenProps as n, VisuallyHidden as t };
-//# sourceMappingURL=index-Ddd7iWfm.d.ts.map
+//# sourceMappingURL=index-CY-A60p6.d.ts.map

package/dist/chunks/{index-lSPcxiii.d.ts → index-CbcFEGCh.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { r as ContextColor } from "./types-D6FM7bYR.js";
 import React, { InputHTMLAttributes, ReactNode } from "react";
 //#region src/components/switch/Switch.d.ts
@@ -20,7 +20,9 @@ interface SwitchProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'check
    */
   id?: string;
   /**
-   * Set component validation state to invalid.
+   * Set component validation state to invalid. Left unset, the component shows as invalid by itself
+   * from a submit it held back (an empty `required` one, say) until it no longer would, or its
+   * form is reset. Set it, to `false` too, and it alone decides.
    */
   invalid?: boolean;
   /**
@@ -56,4 +58,4 @@ interface SwitchProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'check
 declare const Switch: React.ForwardRefExoticComponent<SwitchProps & React.RefAttributes<HTMLInputElement>>;
 //#endregion
 export { SwitchProps as n, Switch as t };
-//# sourceMappingURL=index-lSPcxiii.d.ts.map
+//# sourceMappingURL=index-CbcFEGCh.d.ts.map

package/dist/chunks/{index-9rQeMqVI.d.ts → index-Ce0f-bDM.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { r as PolymorphicRefWithFallback, t as PolymorphicComponentProps } from "./polymorphic-CVHbTHSN.js";
 import { ElementType, ReactElement, ReactNode } from "react";
 //#region src/components/divider/Divider.d.ts
@@ -39,4 +39,4 @@ type DividerComponent = (<C extends ElementType = 'hr'>(props: DividerProps<C> &
 declare const Divider: DividerComponent;
 //#endregion
 export { DividerProps as n, Divider as t };
-//# sourceMappingURL=index-9rQeMqVI.d.ts.map
+//# sourceMappingURL=index-Ce0f-bDM.d.ts.map

package/dist/chunks/{index-Ci7AEgEc.d.ts → index-Cf3gHDjh.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { t as FormFieldIds } from "./renderFormField-ChNagAFN.js";
 import { ReactNode } from "react";
 //#region src/components/form-field/FormField.d.ts
@@ -44,4 +44,4 @@ interface FormFieldProps {
 declare const FormField: import("react").ForwardRefExoticComponent<FormFieldProps & import("react").RefAttributes<HTMLDivElement>>;
 //#endregion
 export { FormFieldProps as n, FormField as t };
-//# sourceMappingURL=index-Ci7AEgEc.d.ts.map
+//# sourceMappingURL=index-Cf3gHDjh.d.ts.map

package/dist/chunks/{index-BVGGIaPX.d.ts → index-Cm3rPbI1.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import React, { ChangeEventHandler, InputHTMLAttributes, ReactNode } from "react";
 //#region src/components/select/Select.d.ts
 interface SelectOptionDef {
@@ -53,11 +53,14 @@ interface SelectProps extends Omit<InputHTMLAttributes<HTMLSelectElement>, 'size
    */
   htmlSize?: number;
   /**
-   * Set component validation state to invalid.
+   * Set component validation state to invalid. Left unset, the component shows as invalid by itself
+   * from a submit it held back (an empty `required` one, say) until it no longer would, or its
+   * form is reset. Set it, to `false` too, and it alone decides.
    */
   invalid?: boolean;
   /**
-   * An error message for the field, rendered below the select when `invalid` is set.
+   * An error message for the field, rendered below the select when `invalid` is set, and after a
+   * submit the field held back, until it no longer would.
    */
   invalidFeedback?: ReactNode;
   /**
@@ -83,7 +86,9 @@ interface SelectProps extends Omit<InputHTMLAttributes<HTMLSelectElement>, 'size
   options?: SelectOptionDef[] | string[];
   /**
    * Renders a disabled placeholder option as the first item (e.g. `"Select a country…"`).
-   * The option has an empty value so it is not selectable once another option is chosen.
+   * The option has an empty value so it is not selectable once another option is chosen. A
+   * single select with no `value`, `defaultValue` or `selected` option starts on it, so its value
+   * is `''` and a `required` one holds its form back until an option is chosen.
    */
   placeholder?: string;
   /**
@@ -108,4 +113,4 @@ interface SelectProps extends Omit<InputHTMLAttributes<HTMLSelectElement>, 'size
 declare const Select: React.ForwardRefExoticComponent<SelectProps & React.RefAttributes<HTMLSelectElement>>;
 //#endregion
 export { SelectOptionDef as n, SelectProps as r, Select as t };
-//# sourceMappingURL=index-BVGGIaPX.d.ts.map
+//# sourceMappingURL=index-Cm3rPbI1.d.ts.map

package/dist/chunks/{index-DPCwFiJL.d.ts → index-CmljNQ8F.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { n as PolymorphicRef, t as PolymorphicComponentProps } from "./polymorphic-CVHbTHSN.js";
 import { t as Breakpoint } from "./types-D6FM7bYR.js";
 import { i as IconValue } from "./iconConfig-C6gbYhsD.js";
@@ -92,4 +92,4 @@ type NavOverflowComponent = (<C extends ElementType = 'div'>(props: NavOverflowP
 declare const NavOverflow: NavOverflowComponent;
 //#endregion
 export { NavOverflowDetail as n, NavOverflowProps as r, NavOverflow as t };
-//# sourceMappingURL=index-DPCwFiJL.d.ts.map
+//# sourceMappingURL=index-CmljNQ8F.d.ts.map

package/dist/chunks/{index-DQImhbhy.d.ts → index-Cpifcw5a.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { n as PolymorphicRef, t as PolymorphicComponentProps } from "./polymorphic-CVHbTHSN.js";
 import { n as LinkProps } from "./Link-CKymd2ru.js";
 import { t as NavVariant } from "./navVariant-CnD21GBS.js";
@@ -107,4 +107,4 @@ interface NavTitleProps extends HTMLAttributes<HTMLLIElement> {
 declare const NavTitle: React.ForwardRefExoticComponent<NavTitleProps & React.RefAttributes<HTMLLIElement>>;
 //#endregion
 export { NavLink as a, NavItemDef as c, NavItemProps as i, NavProps as l, NavTitleProps as n, NavLinkProps as o, NavItem as r, Nav as s, NavTitle as t };
-//# sourceMappingURL=index-DQImhbhy.d.ts.map
+//# sourceMappingURL=index-Cpifcw5a.d.ts.map

package/dist/chunks/{index-B_UzbGOa.d.ts → index-Ctf5hLue.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { n as PolymorphicRef, t as PolymorphicComponentProps } from "./polymorphic-CVHbTHSN.js";
 import React, { DialogHTMLAttributes, ElementType, ReactElement } from "react";
 //#region src/components/modal/Modal.d.ts
@@ -187,9 +187,9 @@ type ModalTitleComponent = (<C extends ElementType = 'h2'>(props: ModalTitleProp
 };
 declare const ModalTitle: ModalTitleComponent;
 //#endregion
-//#region src/hooks/useModal.d.ts
+//#region src/components/modal/useModal.d.ts
 type UseModalResult = ModalContextProps;
 declare const useModal: () => UseModalResult;
 //#endregion
 export { ModalHeader as a, ModalFooterProps as c, Modal as d, ModalProps as f, ModalTitleProps as i, ModalBody as l, useModal as n, ModalHeaderProps as o, ModalTitle as r, ModalFooter as s, UseModalResult as t, ModalBodyProps as u };
-//# sourceMappingURL=index-B_UzbGOa.d.ts.map
+//# sourceMappingURL=index-Ctf5hLue.d.ts.map

package/dist/chunks/{index-DM01FX3a.d.ts → index-D0Dhs7YI.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { r as ContextColor } from "./types-D6FM7bYR.js";
 import { t as ButtonObject } from "./renderFormCheck-nKgpa_a3.js";
 import React, { HTMLAttributes, InputHTMLAttributes, ReactNode } from "react";
@@ -30,7 +30,9 @@ interface CheckboxProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'che
    */
   indeterminate?: boolean;
   /**
-   * Set component validation state to invalid.
+   * Set component validation state to invalid. Left unset, the component shows as invalid by itself
+   * from a submit it held back (an empty `required` one, say) until it no longer would, or its
+   * form is reset. Set it, to `false` too, and it alone decides.
    */
   invalid?: boolean;
   /**
@@ -91,11 +93,19 @@ interface CheckboxGroupProps extends Omit<HTMLAttributes<HTMLFieldSetElement>, '
    */
   disabled?: boolean;
   /**
-   * An error message for the group, rendered below the options when `invalid` is set.
+   * An error message for the group, rendered below the options when `invalid` is set, and after
+   * a submit the group held back, until it no longer would.
    */
   errorMessage?: ReactNode;
   /**
-   * Set group validation state to invalid.
+   * The id of the `<form>` the group belongs to, for a group rendered outside it. Reaches every
+   * checkbox; a `Checkbox` with its own `form` keeps it.
+   */
+  form?: string;
+  /**
+   * Set group validation state to invalid. Left unset, the group shows as invalid by itself
+   * from a submit it held back (an empty `required` one, say) until it no longer would, or its
+   * form is reset. Set it, to `false` too, and it alone decides.
    */
   invalid?: boolean;
   /**
@@ -115,7 +125,9 @@ interface CheckboxGroupProps extends Omit<HTMLAttributes<HTMLFieldSetElement>, '
    */
   orientation?: 'horizontal' | 'vertical';
   /**
-   * Marks the group as required.
+   * Requires at least one checkbox of the group. While none is selected each carries the native
+   * `required`, so a form isn't submitted until one is; a `Checkbox` with its own `required`
+   * stays required whatever the others are.
    */
   required?: boolean;
   /**
@@ -130,4 +142,4 @@ interface CheckboxGroupProps extends Omit<HTMLAttributes<HTMLFieldSetElement>, '
 declare const CheckboxGroup: React.ForwardRefExoticComponent<CheckboxGroupProps & React.RefAttributes<HTMLFieldSetElement>>;
 //#endregion
 export { CheckboxProps as i, CheckboxGroupProps as n, Checkbox as r, CheckboxGroup as t };
-//# sourceMappingURL=index-DM01FX3a.d.ts.map
+//# sourceMappingURL=index-D0Dhs7YI.d.ts.map

package/dist/chunks/{index-BAsbRx5n.d.ts → index-D5KJRfMg.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { n as PolymorphicRef, t as PolymorphicComponentProps } from "./polymorphic-CVHbTHSN.js";
 import { ElementType, ReactElement } from "react";
 //#region src/components/button-group/ButtonGroup.d.ts
@@ -51,4 +51,4 @@ type ButtonToolbarComponent = (<C extends ElementType = 'div'>(props: ButtonTool
 declare const ButtonToolbar: ButtonToolbarComponent;
 //#endregion
 export { ButtonGroupProps as i, ButtonToolbarProps as n, ButtonGroup as r, ButtonToolbar as t };
-//# sourceMappingURL=index-BAsbRx5n.d.ts.map
+//# sourceMappingURL=index-D5KJRfMg.d.ts.map

package/dist/chunks/{index-Bz8MDq0H.d.ts → index-DD6Z5NW-.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { i as IconValue } from "./iconConfig-C6gbYhsD.js";
 import React, { InputHTMLAttributes, ReactNode } from "react";
 //#region src/components/search-field/SearchField.d.ts
@@ -29,11 +29,14 @@ interface SearchFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, '
    */
   help?: ReactNode;
   /**
-   * Set component validation state to invalid.
+   * Set component validation state to invalid. Left unset, the component shows as invalid by itself
+   * from a submit it held back (an empty `required` one, say) until it no longer would, or its
+   * form is reset. Set it, to `false` too, and it alone decides.
    */
   invalid?: boolean;
   /**
-   * An error message for the field, rendered below it when `invalid` is set.
+   * An error message for the field, rendered below it when `invalid` is set, and after a submit
+   * the field held back, until it no longer would.
    */
   invalidFeedback?: ReactNode;
   /**
@@ -82,4 +85,4 @@ interface SearchFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, '
 declare const SearchField: React.ForwardRefExoticComponent<SearchFieldProps & React.RefAttributes<HTMLInputElement>>;
 //#endregion
 export { SearchFieldProps as n, SearchField as t };
-//# sourceMappingURL=index-Bz8MDq0H.d.ts.map
+//# sourceMappingURL=index-DD6Z5NW-.d.ts.map

package/dist/chunks/{index-Dfg4Ftb8.d.ts → index-DFKBJxqA.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import React, { ReactNode, TextareaHTMLAttributes } from "react";
 //#region src/components/textarea/Textarea.d.ts
 interface TextareaProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'defaultValue' | 'onChange' | 'value'> {
@@ -19,11 +19,14 @@ interface TextareaProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>
    */
   help?: ReactNode;
   /**
-   * Set component validation state to invalid.
+   * Set component validation state to invalid. Left unset, the component shows as invalid by itself
+   * from a submit it held back (an empty `required` one, say) until it no longer would, or its
+   * form is reset. Set it, to `false` too, and it alone decides.
    */
   invalid?: boolean;
   /**
-   * An error message for the field, rendered below the textarea when `invalid` is set.
+   * An error message for the field, rendered below the textarea when `invalid` is set, and after a
+   * submit the field held back, until it no longer would.
    */
   invalidFeedback?: ReactNode;
   /**
@@ -66,4 +69,4 @@ interface TextareaProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>
 declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
 //#endregion
 export { TextareaProps as n, Textarea as t };
-//# sourceMappingURL=index-Dfg4Ftb8.d.ts.map
+//# sourceMappingURL=index-DFKBJxqA.d.ts.map

package/dist/chunks/{index-BMkbJVHg.d.ts → index-DGGyvlEQ.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { n as PolymorphicRef, t as PolymorphicComponentProps } from "./polymorphic-CVHbTHSN.js";
 import { r as ContextColor } from "./types-D6FM7bYR.js";
 import { n as IconProps } from "./Icon-CioraWLF.js";
@@ -185,9 +185,9 @@ interface NotificationContextProps {
   close: () => void;
 }
 //#endregion
-//#region src/hooks/useNotification.d.ts
+//#region src/components/notification/useNotification.d.ts
 type UseNotificationResult = NotificationContextProps;
 declare const useNotification: () => UseNotificationResult;
 //#endregion
 export { closeNotification as a, NotificationStackProps as c, NotificationIcon as d, NotificationIconProps as f, NotificationProps as g, Notification as h, addNotification as i, NotificationText as l, NotificationTitleProps as m, useNotification as n, notificationQueue as o, NotificationTitle as p, NotificationContent as r, NotificationStack as s, UseNotificationResult as t, NotificationTextProps as u };
-//# sourceMappingURL=index-BMkbJVHg.d.ts.map
+//# sourceMappingURL=index-DGGyvlEQ.d.ts.map

package/dist/chunks/{index-YJ9QdBuq.d.ts → index-DOxVxbb9.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { n as PolymorphicRef, t as PolymorphicComponentProps } from "./polymorphic-CVHbTHSN.js";
 import { l as Spacing, o as Responsive } from "./types-D6FM7bYR.js";
 import { ElementType, ReactElement } from "react";
@@ -21,11 +21,12 @@ type StackOwnProps<C extends ElementType> = {
    */
   direction?: Responsive<'horizontal' | 'vertical'>;
   /**
-   * Spacing between children, mapped to the `gap-*` utility classes.
+   * Spacing between children, mapped to the `gap-*` utility classes. Takes an object per
+   * breakpoint, as `direction` does: `{ base: 'sm', md: 'lg' }`.
    *
-   * @type { Spacing | 0 }
+   * @type { Responsive<Spacing | 0> }
    */
-  gap?: Spacing | 0;
+  gap?: Responsive<Spacing | 0>;
 };
 type StackProps<C extends ElementType = 'div'> = PolymorphicComponentProps<C, StackOwnProps<C>>;
 type StackComponent = (<C extends ElementType = 'div'>(props: StackProps<C> & {
@@ -36,4 +37,4 @@ type StackComponent = (<C extends ElementType = 'div'>(props: StackProps<C> & {
 declare const Stack: StackComponent;
 //#endregion
 export { StackProps as n, Stack as t };
-//# sourceMappingURL=index-YJ9QdBuq.d.ts.map
+//# sourceMappingURL=index-DOxVxbb9.d.ts.map

package/dist/chunks/{index-CxjNw4ss.d.ts → index-DVK16_FU.d.ts}

@@ -1,4 +1,4 @@
-import "./focus-ring-SR_LwaN7.js";
+import "./focus-ring-Bs80iIBN.js";
 import { n as PolymorphicRef, t as PolymorphicComponentProps } from "./polymorphic-CVHbTHSN.js";
 import { l as Spacing, n as ContainerBreakpoint, o as Responsive, t as Breakpoint } from "./types-D6FM7bYR.js";
 import { ElementType, ReactElement } from "react";
@@ -213,4 +213,4 @@ type GridItemComponent = (<C extends ElementType = 'div'>(props: GridItemProps<C
 declare const GridItem: GridItemComponent;
 //#endregion
 export { GridProps as a, GridFlow as i, GridItemProps as n, Container as o, Grid as r, ContainerProps as s, GridItem as t };
-//# sourceMappingURL=index-CxjNw4ss.d.ts.map
+//# sourceMappingURL=index-DVK16_FU.d.ts.map