@instructure/ui-form-field 11.7.9-snapshot-5 → 11.7.10

package/types/FormField/v2/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/FormField/v2/index.tsx"],"names":[],"mappings":"AAwBA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AASjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C;;;;GAIG;AACH,cAAM,SAAU,SAAQ,SAAS,CAAC,cAAc,CAAC;IAC/C,MAAM,CAAC,WAAW,SAAc;IAChC,MAAM,CAAC,QAAQ,CAAC,WAAW,eAAc;IAEzC,MAAM,CAAC,YAAY,4DAAe;IAClC,MAAM,CAAC,YAAY;QACjB,MAAM;QACN,MAAM;QACN,UAAU;QACV,MAAM;MACP;IAED,GAAG,EAAE,OAAO,GAAG,IAAI,CAAO;IAE1B,SAAS,OAAQ,OAAO,GAAG,IAAI,UAQ9B;IAED,MAAM,qDAmBL;CACF;eAEc,SAAS;AACxB,OAAO,EAAE,SAAS,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/FormField/v2/index.tsx"],"names":[],"mappings":"AAwBA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AASjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C;;;;GAIG;AACH,cAAM,SAAU,SAAQ,SAAS,CAAC,cAAc,CAAC;IAC/C,MAAM,CAAC,WAAW,SAAc;IAChC,MAAM,CAAC,QAAQ,CAAC,WAAW,eAAc;IAEzC,MAAM,CAAC,YAAY,4DAAe;IAClC,MAAM,CAAC,YAAY;QACjB,MAAM;QACN,MAAM;QACN,UAAU;QACV,MAAM;MACP;IAED,GAAG,EAAE,OAAO,GAAG,IAAI,CAAO;IAE1B,SAAS,OAAQ,OAAO,GAAG,IAAI,UAQ9B;IAED,MAAM,qDAeL;CACF;eAEc,SAAS;AACxB,OAAO,EAAE,SAAS,EAAE,CAAA"}

package/types/FormField/v2/props.d.ts

@@ -2,6 +2,7 @@ import React from 'react';
 import type { OtherHTMLAttributes } from '@instructure/shared-types';
 import type { FormMessage } from '../../utils/v1/FormPropTypes';
 import type { Spacing } from '@instructure/emotion';
+import type { FormFieldLayoutChildren } from '../../FormFieldLayout/v2/props';
 type FormFieldOwnProps = {
     label: React.ReactNode;
     /**
@@ -21,11 +22,17 @@ type FormFieldOwnProps = {
      */
     messagesId?: string;
     /**
-     * id for the label element, so a single form control can reference just the
-     * label text via `aria-labelledby` (keeping messages out of its accessible name)
+     * `id` for the label/legend element. Useful when the control is not a
+     * [labelable](https://developer.mozilla.org/en-US/docs/Web/HTML/Guides/Content_categories#labelable)
+     * element (e.g. a custom widget), and needs to reference the label via
+     * `aria-labelledby`.
      */
     labelId?: string;
-    children?: React.ReactNode;
+    /**
+     * The form control. Can be a function that receives `{ describedBy }`, so
+     * the control can reference the messages via `aria-describedby`.
+     */
+    children?: FormFieldLayoutChildren;
     inline?: boolean;
     layout?: 'stacked' | 'inline';
     labelAlign?: 'start' | 'end';

package/types/FormField/v2/props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../src/FormField/v2/props.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAEnD,KAAK,iBAAiB,GAAG;IACvB,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAA;IACV;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;IAC7B,UAAU,CAAC,EAAE,OAAO,GAAG,KAAK,CAAA;IAC5B,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAA;IAC7D;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAA;IAC9C;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,KAAK,QAAQ,GAAG,MAAM,iBAAiB,CAAA;AAEvC,KAAK,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;AAEhD,KAAK,cAAc,GAAG,iBAAiB,GAAG,mBAAmB,CAAC,iBAAiB,CAAC,CAAA;AAChF,QAAA,MAAM,YAAY,EAAE,eAkBnB,CAAA;AAED,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,CAAA"}
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../src/FormField/v2/props.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AAE7E,KAAK,iBAAiB,GAAG;IACvB,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAA;IACV;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,uBAAuB,CAAA;IAClC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;IAC7B,UAAU,CAAC,EAAE,OAAO,GAAG,KAAK,CAAA;IAC5B,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAA;IAC7D;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAA;IAC9C;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,KAAK,QAAQ,GAAG,MAAM,iBAAiB,CAAA;AAEvC,KAAK,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;AAEhD,KAAK,cAAc,GAAG,iBAAiB,GAAG,mBAAmB,CAAC,iBAAiB,CAAC,CAAA;AAChF,QAAA,MAAM,YAAY,EAAE,eAkBnB,CAAA;AAED,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/types/FormFieldGroup/v2/index.d.ts

@@ -1,5 +1,6 @@
 import { Component } from 'react';
 import type { FormFieldGroupProps } from './props';
+import type { FormFieldLayoutChildrenParams } from '../../FormFieldLayout/v2/props';
 /**
 ---
 category: components
@@ -15,7 +16,7 @@ declare class FormFieldGroup extends Component<FormFieldGroupProps> {
         messagesId?: string;
         disabled?: boolean;
         readOnly?: boolean;
-        children?: React.ReactNode;
+        children?: import("../../FormFieldLayout/v2/props.js").FormFieldLayoutChildren;
         layout?: 'stacked' | 'columns' | 'inline';
         rowSpacing?: 'none' | 'small' | 'medium' | 'large';
         colSpacing?: 'none' | 'small' | 'medium' | 'large';
@@ -32,14 +33,16 @@ declare class FormFieldGroup extends Component<FormFieldGroupProps> {
         vAlign: string;
         isGroup: boolean;
     };
+    constructor(props: FormFieldGroupProps);
+    private readonly _defaultId;
     ref: Element | null;
     handleRef: (el: Element | null) => void;
     componentDidMount(): void;
     componentDidUpdate(): void;
     get invalid(): boolean;
-    renderColumns(): import("@emotion/react/jsx-runtime").JSX.Element[] | null | undefined;
-    renderChildren(): import("@emotion/react/jsx-runtime").JSX.Element;
-    renderFields(): import("@emotion/react/jsx-runtime").JSX.Element;
+    renderColumns(params: FormFieldLayoutChildrenParams): import("@emotion/react/jsx-runtime").JSX.Element[] | null | undefined;
+    renderChildren(params: FormFieldLayoutChildrenParams): import("@emotion/react/jsx-runtime").JSX.Element;
+    renderFields(params: FormFieldLayoutChildrenParams): import("@emotion/react/jsx-runtime").JSX.Element;
     render(): import("@emotion/react/jsx-runtime").JSX.Element;
 }
 export default FormFieldGroup;

package/types/FormFieldGroup/v2/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/FormFieldGroup/v2/index.tsx"],"names":[],"mappings":"AAwBA,OAAO,EACL,SAAS,EAKV,MAAM,OAAO,CAAA;AAiBd,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAElD;;;;GAIG;AACH,cACM,cAAe,SAAQ,SAAS,CAAC,mBAAmB,CAAC;IACzD,MAAM,CAAC,WAAW,SAAmB;IACrC,MAAM,CAAC,QAAQ,CAAC,WAAW,oBAAmB;IAE9C,MAAM,CAAC,YAAY;;;;;;;;;;;;;;;SAAe;IAClC,MAAM,CAAC,YAAY;QACjB,EAAE;QACF,QAAQ;QACR,UAAU;QACV,UAAU;QACV,MAAM;QACN,OAAO;MACR;IAED,GAAG,EAAE,OAAO,GAAG,IAAI,CAAO;IAE1B,SAAS,OAAQ,OAAO,GAAG,IAAI,UAQ9B;IAED,iBAAiB,SAEhB;IAED,kBAAkB,SAEjB;IAED,IAAI,OAAO,YAOV;IAED,aAAa,0EAkBZ;IAED,cAAc,qDAcb;IAED,YAAY,qDAQX;IAED,MAAM,qDA8CL;CACF;eAEc,cAAc;AAC7B,OAAO,EAAE,cAAc,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/FormFieldGroup/v2/index.tsx"],"names":[],"mappings":"AAwBA,OAAO,EACL,SAAS,EAKV,MAAM,OAAO,CAAA;AAkBd,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAA;AAEnF;;;;GAIG;AACH,cAEM,cAAe,SAAQ,SAAS,CAAC,mBAAmB,CAAC;IACzD,MAAM,CAAC,WAAW,SAAmB;IACrC,MAAM,CAAC,QAAQ,CAAC,WAAW,oBAAmB;IAE9C,MAAM,CAAC,YAAY;;;;;;;;;;;;;;;SAAe;IAClC,MAAM,CAAC,YAAY;QACjB,EAAE;QACF,QAAQ;QACR,UAAU;QACV,UAAU;QACV,MAAM;QACN,OAAO;MACR;IAED,YAAY,KAAK,EAAE,mBAAmB,EAGrC;IAED,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IAEnC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAO;IAE1B,SAAS,OAAQ,OAAO,GAAG,IAAI,UAQ9B;IAED,iBAAiB,SAEhB;IAED,kBAAkB,SAEjB;IAED,IAAI,OAAO,YAOV;IAED,aAAa,CAAC,MAAM,EAAE,6BAA6B,yEAmBlD;IAED,cAAc,CAAC,MAAM,EAAE,6BAA6B,oDAcnD;IAED,YAAY,CAAC,MAAM,EAAE,6BAA6B,oDAQjD;IAED,MAAM,qDA+CL;CACF;eAEc,cAAc;AAC7B,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/types/FormFieldGroup/v2/props.d.ts

@@ -1,7 +1,8 @@
 import type { AsElementType, OtherHTMLAttributes } from '@instructure/shared-types';
 import type { WithStyleProps, ComponentStyle, Spacing } from '@instructure/emotion';
-import type { FormFieldLayoutOwnProps } from '../../FormFieldLayout/v2/props';
+import type { FormFieldLayoutChildren, FormFieldLayoutOwnProps } from '../../FormFieldLayout/v2/props';
 import type { FormMessage } from '../../utils/v1/FormPropTypes';
+import type { WithDeterministicIdProps } from '@instructure/ui-react-utils';
 type FormFieldGroupOwnProps = {
     description: React.ReactNode;
     /**
@@ -28,7 +29,11 @@ type FormFieldGroupOwnProps = {
      * Whether the field group is read-only. When true, error and success messages will be hidden.
      */
     readOnly?: boolean;
-    children?: React.ReactNode;
+    /**
+     * The form controls. Can be a function that receives `{ describedBy }`, so
+     * the controls can reference the group messages via `aria-describedby`.
+     */
+    children?: FormFieldLayoutChildren;
     layout?: 'stacked' | 'columns' | 'inline';
     rowSpacing?: 'none' | 'small' | 'medium' | 'large';
     colSpacing?: 'none' | 'small' | 'medium' | 'large';
@@ -47,7 +52,7 @@ type FormFieldGroupOwnProps = {
 };
 type PropKeys = keyof FormFieldGroupOwnProps;
 type AllowedPropKeys = Readonly<Array<PropKeys>>;
-type FormFieldGroupProps = FormFieldGroupOwnProps & WithStyleProps<null, FormFieldGroupStyle> & OtherHTMLAttributes<FormFieldGroupOwnProps> & Omit<FormFieldLayoutOwnProps, 'messages' | 'messagesId' | 'vAlign' | 'layout' | 'label' | 'children'>;
+type FormFieldGroupProps = FormFieldGroupOwnProps & WithStyleProps<null, FormFieldGroupStyle> & OtherHTMLAttributes<FormFieldGroupOwnProps> & WithDeterministicIdProps & Omit<FormFieldLayoutOwnProps, 'id' | 'messages' | 'messagesId' | 'vAlign' | 'layout' | 'label' | 'children'>;
 type FormFieldGroupStyle = ComponentStyle<'formFieldGroup'>;
 declare const allowedProps: AllowedPropKeys;
 export type { FormFieldGroupProps, FormFieldGroupStyle };

package/types/FormFieldGroup/v2/props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../src/FormFieldGroup/v2/props.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACpB,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,OAAO,EACR,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAE/D,KAAK,sBAAsB,GAAG;IAC5B,WAAW,EAAE,KAAK,CAAC,SAAS,CAAA;IAC5B;;OAEG;IACH,EAAE,CAAC,EAAE,aAAa,CAAA;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;IACzC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;IAClD,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;IAClD,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACpC,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAA;IACzD;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAA;CAC/C,CAAA;AAED,KAAK,QAAQ,GAAG,MAAM,sBAAsB,CAAA;AAE5C,KAAK,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;AAEhD,KAAK,mBAAmB,GAAG,sBAAsB,GAC/C,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,GACzC,mBAAmB,CAAC,sBAAsB,CAAC,GAG3C,IAAI,CACF,uBAAuB,EACvB,UAAU,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CACvE,CAAA;AAEH,KAAK,mBAAmB,GAAG,cAAc,CAAC,gBAAgB,CAAC,CAAA;AAC3D,QAAA,MAAM,YAAY,EAAE,eAenB,CAAA;AAED,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,CAAA"}
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../src/FormFieldGroup/v2/props.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACpB,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,OAAO,EACR,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,gCAAgC,CAAA;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AAE3E,KAAK,sBAAsB,GAAG;IAC5B,WAAW,EAAE,KAAK,CAAC,SAAS,CAAA;IAC5B;;OAEG;IACH,EAAE,CAAC,EAAE,aAAa,CAAA;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,uBAAuB,CAAA;IAClC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;IACzC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;IAClD,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;IAClD,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACpC,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAA;IACzD;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAA;CAC/C,CAAA;AAED,KAAK,QAAQ,GAAG,MAAM,sBAAsB,CAAA;AAE5C,KAAK,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;AAEhD,KAAK,mBAAmB,GAAG,sBAAsB,GAC/C,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,GACzC,mBAAmB,CAAC,sBAAsB,CAAC,GAC3C,wBAAwB,GAGxB,IAAI,CACF,uBAAuB,EACrB,IAAI,GACJ,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,UAAU,CACb,CAAA;AAEH,KAAK,mBAAmB,GAAG,cAAc,CAAC,gBAAgB,CAAC,CAAA;AAC3D,QAAA,MAAM,YAAY,EAAE,eAenB,CAAA;AAED,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/types/FormFieldLayout/v2/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/FormFieldLayout/v2/index.tsx"],"names":[],"mappings":"AA+BA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAGzC;;;;GAIG;AACH,QAAA,MAAM,eAAe;;4GAwMpB,CAAA;eAIc,eAAe;AAC9B,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/FormFieldLayout/v2/index.tsx"],"names":[],"mappings":"AA+BA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAwBzC;;;;GAIG;AACH,QAAA,MAAM,eAAe;;4GA2OpB,CAAA;eAIc,eAAe;AAC9B,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,CAAA"}

package/types/FormFieldLayout/v2/props.d.ts

@@ -3,14 +3,34 @@ import type { ComponentStyle, NewThemeOverrideProp, Spacing } from '@instructure
 import type { FormMessage } from '../../utils/v1/FormPropTypes';
 import type { WithDeterministicIdProps } from '@instructure/ui-react-utils';
 import type { NewComponentTypes } from '@instructure/ui-themes';
+type FormFieldLayoutChildrenParams = {
+    /**
+     * The id of the rendered messages, or `undefined` when no messages are
+     * shown. Add it to the control's `aria-describedby`.
+     */
+    describedBy?: string;
+};
+type FormFieldLayoutChildren = React.ReactNode | ((params: FormFieldLayoutChildrenParams) => React.ReactNode);
 type FormFieldLayoutOwnProps = {
+    /**
+     * The label text. Will be appended by a `*` if this field is required.
+     */
     label: React.ReactNode;
     /**
-     * the id of the input (to link it to its label for a11y)
+     * The id of the form control (=the child of this component). It's applied as the
+     * [for](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/for)
+     * attribute of the label, so the control needs to have the same `id`.
+     * Not used when rendering as a `fieldset` (group)
      */
-    id?: string;
+    id: string;
     /**
-     * the element type to render as
+     * The element type to render as, `div` be default.
+     *
+     * Also determines how the `label` will be rendered:
+     * If its value is `fieldset` (for form groups), it be rendered in a
+     * [legend](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/legend),
+     * for all other cases it will be in a
+     * [label](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/label).
      */
     as?: AsElementType;
     /**
@@ -25,11 +45,18 @@ type FormFieldLayoutOwnProps = {
      */
     messagesId?: string;
     /**
-     * id for the label element, so a single form control can reference just the
-     * label text via `aria-labelledby` (keeping messages out of its accessible name)
+     * `id` for the label/legend element. Useful when the control is not a
+     * [labelable](https://developer.mozilla.org/en-US/docs/Web/HTML/Guides/Content_categories#labelable)
+     * element (e.g. a custom widget), and needs to reference the label via
+     * `aria-labelledby={labelId}`.
      */
     labelId?: string;
-    children?: React.ReactNode;
+    /**
+     * The form control(s). Can be a function that receives
+     * `{ describedBy }`, so the control can reference the messages via
+     * `aria-describedby`.
+     */
+    children?: FormFieldLayoutChildren;
     /**
      * If `true` use an inline layout -- content will flow on the left/right side
      * of this component
@@ -90,6 +117,6 @@ type FormFieldStyleProps = {
     hasVisibleLabel: boolean;
     isGroup: boolean;
 };
-export type { FormFieldStyleProps, FormFieldLayoutProps, FormFieldLayoutStyle, FormFieldLayoutOwnProps };
+export type { FormFieldLayoutChildren, FormFieldLayoutChildrenParams, FormFieldStyleProps, FormFieldLayoutProps, FormFieldLayoutStyle, FormFieldLayoutOwnProps };
 export { allowedProps };
 //# sourceMappingURL=props.d.ts.map

package/types/FormFieldLayout/v2/props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../src/FormFieldLayout/v2/props.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACpB,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,OAAO,EACR,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE/D,KAAK,uBAAuB,GAAG;IAC7B,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAA;IACX;;OAEG;IACH,EAAE,CAAC,EAAE,aAAa,CAAA;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;IAC7B;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,KAAK,CAAA;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;IACzD;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAA;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,KAAK,QAAQ,GAAG,MAAM,uBAAuB,CAAA;AAE7C,KAAK,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;AAEhD,KAAK,oBAAoB,GAAG,uBAAuB,GACjD,oBAAoB,CAAC,UAAU,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC,CAAC,GACtE,mBAAmB,CAAC,uBAAuB,CAAC,GAC5C,wBAAwB,CAAA;AAE1B,KAAK,oBAAoB,GAAG,cAAc,CACtC,iBAAiB,GACjB,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,CACrB,CAAA;AACD,QAAA,MAAM,YAAY,EAAE,eAmBnB,CAAA;AAED,KAAK,mBAAmB,GAAG;IACzB,WAAW,EAAE,OAAO,CAAA;IACpB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,eAAe,EAAE,OAAO,CAAA;IACxB,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACxB,CAAA;AACD,OAAO,EAAE,YAAY,EAAE,CAAA"}
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../src/FormFieldLayout/v2/props.ts"],"names":[],"mappings":"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"}

package/types/exports/b.d.ts

@@ -7,6 +7,6 @@ export type { FormMessageType, FormMessage, FormMessageChild } from '../utils/v1
 export type { FormFieldOwnProps, FormFieldProps } from '../FormField/v2/props';
 export type { FormFieldMessageProps } from '../FormFieldMessage/v2/props';
 export type { FormFieldMessagesProps } from '../FormFieldMessages/v2/props';
-export type { FormFieldLayoutProps } from '../FormFieldLayout/v2/props';
+export type { FormFieldLayoutProps, FormFieldLayoutChildrenParams } from '../FormFieldLayout/v2/props';
 export type { FormFieldGroupProps } from '../FormFieldGroup/v2/props';
 //# sourceMappingURL=b.d.ts.map

package/types/exports/b.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"b.d.ts","sourceRoot":"","sources":["../../src/exports/b.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAE9D,YAAY,EACV,eAAe,EACf,WAAW,EACX,gBAAgB,EACjB,MAAM,2BAA2B,CAAA;AAClC,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC9E,YAAY,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACzE,YAAY,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAC3E,YAAY,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AACvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA"}
+{"version":3,"file":"b.d.ts","sourceRoot":"","sources":["../../src/exports/b.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAE9D,YAAY,EACV,eAAe,EACf,WAAW,EACX,gBAAgB,EACjB,MAAM,2BAA2B,CAAA;AAClC,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC9E,YAAY,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACzE,YAAY,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAC3E,YAAY,EACV,oBAAoB,EACpB,6BAA6B,EAC9B,MAAM,6BAA6B,CAAA;AACpC,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA"}