@skdx/react 0.28.0 → 0.30.0

package/dist/field/Field.d.ts

@@ -1,23 +1,11 @@
 import * as React from 'react';
-import type { FieldContextValue, FieldProps, FieldRootProps, FieldsetProps } from './types.js';
-export declare const FieldProvider: {
-    (props: FieldContextValue & {
-        children: React.ReactNode;
-    }): React.JSX.Element;
-    displayName: string;
-}, useFieldContext: (consumerName: string) => FieldContextValue;
+import type { FieldContextValue, FieldProps, FieldRootProps, FieldsetProps, FieldValidateHandle } from './types.js';
+export declare const FieldProvider: React.FC<FieldContextValue & {
+    children: React.ReactNode;
+}>, useFieldContext: (consumerName: string) => FieldContextValue;
 /**
- * Wires one form control to its label, description, error: generates ids,
- * `aria-describedby`, `aria-invalid`, and state hooks
- * (`data-valid`/`data-invalid`/`data-touched`/`data-dirty`/`data-filled`).
- *
- * Any control works (skdx, native `<input>`, third-party) because Field
- * discovers it in its subtree, not via cooperation. Owns validation model:
- * `validate` (sync/async), `mode`, server `errors`, native constraint
- * validation as fallback.
- *
- * `Field` (recipe below) adds `FieldAnatomy`. For manual composition and
- * `FieldCharacterCount`, use `@skdx/react/primitives/field`'s `FieldRoot`.
+ * Wires a form control to its label, description and error, generating ids,
+ * `aria-describedby`, `aria-invalid`, and validation state attributes.
  *
  * @example
  * ```tsx
@@ -31,20 +19,15 @@ export declare const FieldProvider: {
  * </FieldRoot>
  * ```
  */
-export declare const FieldRoot: React.ForwardRefExoticComponent<Omit<FieldRootProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const FieldRoot: {
+    ({ validate, mode, errors, value, name, required, disabled, onValidityChange, getCharacterCountMessage, invalidMessage, validationDebounceTime, ref: forwardedRef, density, ...props }: Omit<FieldRootProps, "ref"> & {
+        ref?: React.Ref<HTMLDivElement & FieldValidateHandle> | undefined;
+    }): React.ReactNode;
+    displayName: string;
+};
 /**
- * One form control with its label, help text and error message, wired
- * together.
- *
- * Always draws the derived anatomy from `label`/`description`: the label with
- * the required marker *inside* it — where it joins the control's accessible
- * name rather than sitting beside it — the control (`children`), the help
- * text, and the error. `children` is the control, never a switch: this
- * component never inspects what it was given.
- *
- * Everything {@link FieldRoot} owns still applies — the validation model, the
- * `aria-describedby`/`aria-invalid` wiring, the state hooks. Deriving only
- * makes the wiring automatic.
+ * Renders one form control with its label, help text and error message,
+ * wired together via {@link FieldRoot}.
  *
  * @example
  * ```tsx
@@ -57,27 +40,16 @@ export declare const FieldRoot: React.ForwardRefExoticComponent<Omit<FieldRootPr
  *   <TextField />
  * </Field>
  * ```
- *
- * @example Validating on demand, through a ref typed as `FieldHandle`:
- * ```tsx
- * const ref = React.useRef<FieldHandle>(null);
- * <Field ref={ref} label="Name" validate={required}><TextField /></Field>;
- * if (await ref.current?.checkValidity()) goToNextStep();
- * // …and afterwards, on a form that stays mounted:
- * ref.current?.reset();
- * ```
  */
-export declare const Field: React.ForwardRefExoticComponent<Omit<FieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const Field: {
+    ({ label, description, children, ref: forwardedRef, ...rest }: Omit<FieldProps, "ref"> & {
+        ref?: React.Ref<HTMLDivElement & FieldValidateHandle> | undefined;
+    }): React.ReactNode;
+    displayName: string;
+};
 /**
- * A {@link Field} that renders a `<fieldset>` and puts its `FieldLabel` in a
- * `<legend>` — the grouping a `RadioGroup` or a set of checkboxes needs,
- * since a `<label for>` may not point at a `[role="radiogroup"]`. Same props,
- * same validation model, same state hooks; the group control is named with
- * `aria-labelledby` instead of `for`/`id`. Renders `children` verbatim.
- *
- * An alternative root rather than a leaf part, so it is public alongside
- * `Field`. It derives nothing — compose the label, control and error yourself
- * from `@skdx/react/primitives/field`.
+ * A {@link Field} that renders a `<fieldset>` with its label in a `<legend>`,
+ * naming the group with `aria-labelledby` instead of `for`/`id`.
  *
  * @example
  * ```tsx
@@ -90,12 +62,10 @@ export declare const Field: React.ForwardRefExoticComponent<Omit<FieldProps, "re
  *   <FieldError />
  * </Fieldset>
  * ```
- *
- * @example Validating on demand, through a ref typed as `FieldsetHandle`:
- * ```tsx
- * const ref = React.useRef<FieldsetHandle>(null);
- * <Fieldset ref={ref} validate={required}>…</Fieldset>;
- * if (await ref.current?.checkValidity()) goToNextStep();
- * ```
  */
-export declare const Fieldset: React.ForwardRefExoticComponent<Omit<FieldsetProps, "ref"> & React.RefAttributes<HTMLFieldSetElement>>;
+export declare const Fieldset: {
+    ({ validate, mode, errors, value, name, required, disabled, onValidityChange, getCharacterCountMessage, invalidMessage, validationDebounceTime, ref: forwardedRef, density, ...props }: Omit<FieldsetProps, "ref"> & {
+        ref?: React.Ref<HTMLFieldSetElement & FieldValidateHandle> | undefined;
+    }): React.ReactNode;
+    displayName: string;
+};

package/dist/field/Field.js

@@ -1 +1,2 @@
-import*as s from"react";import{createSafeContext as We}from"../utils/createContext.js";import{announce as Xe}from"../utils/liveAnnouncer.js";import{skdxPart as Je}from"../utils/part.js";import{Primitive as me}from"../utils/primitive.js";import{useCallbackRef as Ze}from"../utils/useCallbackRef.js";import*as re from"react";import{skdxPart as we}from"../utils/part.js";import{Primitive as ke}from"../utils/primitive.js";var Z="validity-change",v="data-skdx-field",g="data-skdx-field-name",O="data-skdx-field-message",H="data-skdx-field-description",L="data-skdx-field-error",B="data-skdx-field-character-count",z="data-skdx-field-pending",M="data-skdx-field-resubmit",I="data-skdx-form-field",ee="data-skdx-form-message",Fe=["validity-change","invalid","change","blur"],ge="data-skdx-error-summary",ye=1e3;function x(r){let e=Math.abs(r),t=e===1?"character":"characters";return r<0?`You have ${e} ${t} too many`:`You have ${e} ${t} remaining`}function _(r,e,t=0){return t<=0?!0:r>=e*t/100}var te="This field is invalid.",S="data-skdx-field-control",U=[`[${S}]`,'input:not([type="hidden"])',"select","textarea",'[role="textbox"]','[role="searchbox"]','[role="combobox"]','[role="listbox"]','[role="radiogroup"]','[role="group"]','[role="slider"]','[role="spinbutton"]','[role="checkbox"]','[role="radio"]','[role="switch"]'].join(", "),q="data-skdx-field-required-indicator",Ce=new Set(["INPUT","SELECT","TEXTAREA"]),Ie=new Set(["radiogroup","group"]),Ae=['input:not([disabled]):not([type="hidden"])',"select:not([disabled])","textarea:not([disabled])","button:not([disabled])",'[tabindex]:not([tabindex="-1"])'].join(", ");function W(r){return r==null?[]:(Array.isArray(r)?r:[r]).filter(t=>typeof t=="string"&&t.trim()!=="")}function $(r){for(let e of Array.from(r.querySelectorAll(U)))if(e.getAttribute("aria-hidden")!=="true"&&e.closest(`[${v}]`)===r)return e;return null}function N(r,e){return V(r,v,e)}function V(r,e,t){for(let i of Array.from(r.querySelectorAll(t)))if(i.closest(`[${e}]`)===r)return i;return null}function Le(r){if(!r)return;let e=r;return e.type==="checkbox"||e.type==="radio"?e.checked:"value"in r?e.value:r.querySelector('input[aria-hidden="true"]')?.value}function b(r){return r==null||r===!1||r===""?!1:!(Array.isArray(r)&&r.length===0)}function E(r,e,t){t?r.setAttribute(e,""):r.removeAttribute(e)}function X(r,...e){let t=r.split(/\s+/).filter(Boolean);for(let i of e)i&&!t.includes(i)&&t.push(i);return t.join(" ")}function xe(r){return r.closest("form, skdx-form")??r.parentElement??r}function _e(r){let e=$(r),i=N(r,`[${L}]`)?.textContent?.trim()||r.getAttribute(O)||r.getAttribute(g)||"";return!e?.id||!i?[]:[{id:e.id,message:i}]}function Se(r){let e=V(r,I,U);if(!e?.id||e.getAttribute("aria-invalid")!=="true")return[];let i=V(r,I,`[${ee}]:not([hidden])`)?.textContent?.trim()||r.getAttribute(g)||"";return i?[{id:e.id,message:i}]:[]}function Pe(r){return Array.from(r.querySelectorAll(`[${v}][data-invalid], [${I}]`)).flatMap(t=>(t.hasAttribute(v)?_e:Se)(t))}var w="__skdxFieldCheckValidity",k="__skdxFieldReset";async function De(r){let e=Array.from(r.querySelectorAll(`[${v}]`));return(await Promise.all(e.map(i=>i[w]?.()??!0))).every(Boolean)}function Me(r){for(let e of Array.from(r.querySelectorAll(`[${v}]`)))e[k]?.()}function Oe(r,e=document){let t=e.getElementById(r);if(!t)return;let i=t.getAttribute("role"),n=(t.tagName==="FIELDSET"||i!==null&&Ie.has(i)?t.querySelector(Ae):null)??t;n.focus(),n.scrollIntoView?.({block:"center"})}var A=class{constructor(e){this.options=e;this.props={};this.root=null;this.form=null;this.control=null;this.baseDescribedBy="";this.baseLabelledBy="";this.wroteLabelledBy=!1;this.wroteRequired=!1;this.wroteDisabled=!1;this.runToken=0;this.pending=!1;this.injected=[];this.custom=[];this.characterCount=null;this.awaitingSubmit=!1;this.handleInput=()=>{let e=this.isOverLimit(this.snapshot.count),t=this.readCount();this.update({dirty:!0,filled:b(this.resolveValue()),count:t,errors:this.composeErrors(t)}),this.scheduleCountAnnouncement(t,e),(this.props.mode==="change"||this.snapshot.errors.length>0)&&this.scheduleValidation()};this.handleFocusOut=()=>{let e=this.readCount();this.update({touched:!0,filled:b(this.resolveValue()),count:e,errors:this.composeErrors(e)});let t=this.validationTimer!==void 0;clearTimeout(this.validationTimer),this.validationTimer=void 0;let i=this.props.mode??"blur";(t||i==="blur"||this.snapshot.errors.length>0)&&this.runValidation()};this.handleSubmit=e=>{if(e.target!==this.form||this.isEngineResubmit(e))return;this.markTouched();let t=this.runValidation({silent:this.hasErrorSummary()});if(J(t)){e.preventDefault(),this.awaitingSubmit=!0,Promise.resolve(t).then(()=>{this.awaitingSubmit&&(this.awaitingSubmit=!1,this.resubmitIfSettled())});return}(t.length>0||this.pending)&&e.preventDefault()};this.snapshot={controlId:"",errors:[],valid:!0,touched:!1,dirty:!1,filled:!1,count:0,validity:null}}get state(){return this.snapshot}setProps(e){let t=this.props.value;this.props=e;let i=W(e.errors??null),o=!Ne(this.injected,i);o&&(this.injected=i);let n=e.value!==t;if(!o&&!n)return;let a=this.readCount();this.update({count:a,filled:b(this.resolveValue()),errors:this.composeErrors(a)})}setCharacterCount(e){if((this.characterCount?.maxLength??null)===(e?.maxLength??null)&&(this.characterCount?.threshold??0)===(e?.threshold??0))return;this.characterCount=e;let i=this.readCount();this.update({count:i,errors:this.composeErrors(i)})}readCount(){let e=this.resolveValue();return typeof e=="string"?e.length:0}countMessage(e){return(this.props.getCharacterCountMessage??x)(e)}isOverLimit(e){return this.characterCount!==null&&e>this.characterCount.maxLength}composeErrors(e=this.snapshot.count){let t=[...this.injected,...this.custom];return this.characterCount&&this.isOverLimit(e)&&t.push(this.countMessage(this.characterCount.maxLength-e)),t}scheduleCountAnnouncement(e,t){let i=this.characterCount;if(!i)return;if(clearTimeout(this.announceTimer),this.isOverLimit(e)){t||this.options.announce(this.countMessage(i.maxLength-e),"assertive");return}if(!_(e,i.maxLength,i.threshold))return;let o=i.maxLength-e;this.announceTimer=setTimeout(()=>{this.options.announce(this.countMessage(o),"polite")},1e3)}connect(e){this.root=e,e.setAttribute(v,""),Object.defineProperty(e,w,{value:()=>this.validate(),configurable:!0,enumerable:!1,writable:!0}),Object.defineProperty(e,k,{value:()=>this.reset(),configurable:!0,enumerable:!1,writable:!0}),e.addEventListener("input",this.handleInput,!0),e.addEventListener("change",this.handleInput,!0),e.addEventListener("focusout",this.handleFocusOut,!0),this.form=e.closest("form"),this.form&&e.ownerDocument.addEventListener("submit",this.handleSubmit,!0),this.sync();let t=this.readCount();this.update({filled:b(this.resolveValue()),count:t,errors:this.composeErrors(t)})}disconnect(){clearTimeout(this.announceTimer),clearTimeout(this.validationTimer),this.validationTimer=void 0,this.awaitingSubmit=!1;let e=this.root;e&&(e.removeEventListener("input",this.handleInput,!0),e.removeEventListener("change",this.handleInput,!0),e.removeEventListener("focusout",this.handleFocusOut,!0),this.form&&e.ownerDocument.removeEventListener("submit",this.handleSubmit,!0),delete e[w],delete e[k],this.root=null,this.form=null,this.control=null)}sync(){let e=this.root;if(!e)return;let t=$(e);t!==this.control&&(this.control=t,this.baseDescribedBy=t?.getAttribute("aria-describedby")??"",this.baseLabelledBy=t?.getAttribute("aria-labelledby")??"",this.wroteLabelledBy=!1,this.wroteRequired=!1,this.wroteDisabled=!1);let{name:i}=this.props;i?e.setAttribute(g,i):e.removeAttribute(g);let o=this.snapshot.errors.join(" ");if(o?e.setAttribute(O,o):e.removeAttribute(O),this.applyStateAttributes(e),!t)return;t.id||(t.id=this.options.controlId),t.id!==this.snapshot.controlId&&(this.snapshot={...this.snapshot,controlId:t.id,validity:this.readValidity()},this.options.onSnapshotChange(this.snapshot));let n=N(e,`[${H}]`)!==null,a=N(e,`[${L}]`)!==null,l=X(this.baseDescribedBy,n?this.options.descriptionId:void 0,a?this.options.errorId:void 0);l?t.setAttribute("aria-describedby",l):t.removeAttribute("aria-describedby"),this.snapshot.errors.length>0?t.setAttribute("aria-invalid","true"):t.removeAttribute("aria-invalid");let p=e.ownerDocument.getElementById(this.options.labelId)!==null;this.options.grouped&&p?(t.setAttribute("aria-labelledby",X(this.baseLabelledBy,this.options.labelId)),this.wroteLabelledBy=!0):this.wroteLabelledBy&&(this.baseLabelledBy?t.setAttribute("aria-labelledby",this.baseLabelledBy):t.removeAttribute("aria-labelledby"),this.wroteLabelledBy=!1),this.applyConstraintState(t),this.applyStateAttributes(t)}applyConstraintState(e){let t=Ce.has(e.tagName),i=this.props.required===!0,o=this.props.disabled===!0;i?(t?e.setAttribute("required",""):e.setAttribute("aria-required","true"),this.wroteRequired=!0):this.wroteRequired&&(e.removeAttribute(t?"required":"aria-required"),this.wroteRequired=!1),o?(t?e.setAttribute("disabled",""):e.setAttribute("aria-disabled","true"),this.wroteDisabled=!0):this.wroteDisabled&&(e.removeAttribute(t?"disabled":"aria-disabled"),this.wroteDisabled=!1)}validate(){return Promise.resolve(this.runValidation()).then(e=>e.length===0)}reset(){this.injected=[],this.custom=[],this.pending=!1,this.awaitingSubmit=!1,this.runToken++,clearTimeout(this.announceTimer),clearTimeout(this.validationTimer),this.validationTimer=void 0,this.markPending(!1);let e=this.readCount();this.update({touched:!1,dirty:!1,count:e,filled:b(this.resolveValue()),errors:this.composeErrors(e)}),this.sync()}markTouched(){this.snapshot.touched||this.update({touched:!0})}applyStateAttributes(e){let{errors:t,touched:i,dirty:o,filled:n,count:a}=this.snapshot;E(e,"data-invalid",t.length>0),E(e,"data-valid",t.length===0),E(e,"data-touched",i),E(e,"data-dirty",o),E(e,"data-filled",n),E(e,"data-over-limit",this.isOverLimit(a)),E(e,"data-disabled",this.props.disabled===!0)}resolveValue(){return this.props.value!==void 0?this.props.value:Le(this.control)}readValidity(){return this.control?.validity??null}markPending(e){this.root&&E(this.root,z,e)}nativeMessage(){let e=this.control;return!e?.validity||e.validity.valid?null:e.validationMessage||this.props.invalidMessage||te}runValidation(e={}){let t=++this.runToken,i=this.props.validate?.(this.resolveValue());return J(i)?(this.pending=!0,this.markPending(!0),Promise.resolve(i).then(o=>t!==this.runToken?this.snapshot.errors:(this.pending=!1,this.markPending(!1),this.commit(o,e)))):this.commit(i,e)}commit(e,t){this.custom=W(e);let i=this.nativeMessage();i&&!this.custom.includes(i)&&!this.injected.includes(i)&&(this.custom=[...this.custom,i]);let o=this.readCount(),n=this.composeErrors(o),a=this.snapshot.errors.length===0;this.update({errors:n,count:o,filled:b(this.resolveValue())});let l=n[0];return l&&a&&!t.silent&&this.options.announce(l,"assertive"),n}update(e){let t={...this.snapshot,...e,valid:!0,validity:this.readValidity()};t.valid=t.errors.length===0,!Ve(this.snapshot,t)&&(this.snapshot=t,this.sync(),this.options.onSnapshotChange(t),this.root?.dispatchEvent(new CustomEvent(Z,{bubbles:!0,composed:!0,detail:{valid:t.valid,errors:t.errors,touched:t.touched,dirty:t.dirty,filled:t.filled,count:t.count,validity:t.validity}})))}scheduleValidation(){clearTimeout(this.validationTimer),this.validationTimer=void 0;let e=this.props.mode==="change"?this.props.validationDebounceTime??0:0;if(e<=0){this.runValidation();return}this.validationTimer=setTimeout(()=>{this.validationTimer=void 0,this.runValidation()},e)}hasErrorSummary(){return this.form?.querySelector(`[${ge}]`)!=null}isEngineResubmit(e){return this.form?.hasAttribute(M)?(this.snapshot.errors.length>0&&e.preventDefault(),!0):!1}resubmitIfSettled(){let e=this.form;if(!(!e||typeof e.requestSubmit!="function")&&!e.querySelector(`[${z}]`)&&!e.querySelector(`[${v}][data-invalid]`)){e.setAttribute(M,"");try{e.requestSubmit()}finally{e.removeAttribute(M)}}}};function J(r){return typeof r?.then=="function"}function Ne(r,e){return r.length===e.length&&r.every((t,i)=>t===e[i])}function Ve(r,e){return r.controlId===e.controlId&&r.valid===e.valid&&r.touched===e.touched&&r.dirty===e.dirty&&r.filled===e.filled&&r.count===e.count&&r.validity===e.validity&&r.errors.length===e.errors.length&&r.errors.every((t,i)=>t===e.errors[i])}import{jsx as He}from"react/jsx-runtime";var Y=re.forwardRef(({as:r="span",...e},t)=>{let i=c("FieldDescription"),o=ke[r];return He(o,{id:i.descriptionId,[H]:"",...e,...we("field","description",e.className),ref:t})});Y.displayName="FieldDescription";import*as ie from"react";import{skdxPart as Be}from"../utils/part.js";import{Primitive as Ue}from"../utils/primitive.js";import{jsx as qe}from"react/jsx-runtime";var G=ie.forwardRef(({as:r="span",children:e,...t},i)=>{let o=c("FieldError");if(o.errors.length===0)return null;let n=Ue[r];return qe(n,{id:o.errorId,[L]:"",...t,...Be("field","error",t.className),ref:i,children:e??o.errors.join(" ")})});G.displayName="FieldError";import*as de from"react";import{skdxPart as oe}from"../utils/part.js";import{composeEventHandlers as ne,Primitive as se}from"../utils/primitive.js";import{jsx as le}from"react/jsx-runtime";function ae(r){!r.defaultPrevented&&r.detail>1&&r.preventDefault()}var j=de.forwardRef((r,e)=>{let t=c("FieldLabel");return t.grouped?le(se.legend,{id:t.labelId,...r,...oe("field","label",r.className),ref:e,onMouseDown:ne(r.onMouseDown,ae)}):le(se.label,{id:t.labelId,htmlFor:t.controlId,...r,...oe("field","label",r.className),ref:e,onMouseDown:ne(r.onMouseDown,ae)})});j.displayName="FieldLabel";import*as ue from"react";import{skdxPart as $e}from"../utils/part.js";import{Primitive as Ye}from"../utils/primitive.js";import{jsx as Ge}from"react/jsx-runtime";var Q=ue.forwardRef(({children:r,...e},t)=>c("FieldRequiredIndicator").required?Ge(Ye.span,{[q]:"",...e,...$e("field","required-indicator",e.className),ref:t,children:r??"*"}):null);Q.displayName="FieldRequiredIndicator";import{Fragment as je,jsx as K,jsxs as ce}from"react/jsx-runtime";function he({label:r,description:e,children:t}){return ce(je,{children:[r?ce(j,{children:[r,K(Q,{})]}):null,t,e?K(Y,{children:e}):null,K(G,{})]})}import*as h from"react";var Qe=new Set(["input","select","textarea"]),Ke=new Set(["textbox","searchbox","combobox","listbox","radiogroup","group","slider","spinbutton","checkbox","radio","switch"]);function ze(r){let e=r.props;return e["aria-hidden"]===!0||e["aria-hidden"]==="true"?!1:e[S]!==void 0||typeof e.role=="string"&&Ke.has(e.role)?!0:typeof r.type!="string"||!Qe.has(r.type)?!1:!(r.type==="input"&&e.type==="hidden")}function P(r,e,t){if(t.found||!r)return r;if(Array.isArray(r))return h.Children.map(r,o=>P(o,e,t));if(!h.isValidElement(r))return r;let i=r;return i.type===h.Fragment?h.cloneElement(i,void 0,P(i.props.children,e,t)):ze(i)?(t.found=!0,typeof i.props.id=="string"&&i.props.id!==""?(t.controlId=i.props.id,i):(t.controlId=e,h.cloneElement(i,{id:e}))):typeof i.type=="string"&&i.props.children!==void 0?h.cloneElement(i,void 0,P(i.props.children,e,t)):r}function pe(r,e){let t={controlId:void 0,found:!1};return{children:P(r,e,t),controlId:t.controlId}}import{jsx as y}from"react/jsx-runtime";var[fe,c]=We("Field");function Ee(r,e,t,i){let o=s.useId(),n=s.useMemo(()=>({labelId:`${o}label`,descriptionId:`${o}description`,errorId:`${o}error`,controlId:`${o}control`}),[o]),a=pe(i,n.controlId),[l,p]=s.useState(()=>({controlId:"",errors:[],valid:!0,touched:!1,dirty:!1,filled:!1,count:0,validity:null})),R=Ze(r.onValidityChange),d=s.useMemo(()=>new A({...n,grouped:e,onSnapshotChange:u=>{p(u);let{controlId:C,...F}=u;R(F)},announce:Xe}),[n,e,R]);s.useEffect(()=>{let u=t.current;if(u)return d.connect(u),p(d.state),()=>d.disconnect()},[d,t]),s.useEffect(()=>{d.setProps({validate:r.validate,mode:r.mode,errors:r.errors,value:r.value,name:r.name,required:r.required,disabled:r.disabled,getCharacterCountMessage:r.getCharacterCountMessage,invalidMessage:r.invalidMessage,validationDebounceTime:r.validationDebounceTime}),d.sync()});let m=s.useCallback(u=>d.setCharacterCount(u),[d]),T=s.useMemo(()=>({checkValidity:()=>d.validate(),reset:()=>d.reset()}),[d]);return{context:{...n,controlId:l.controlId||a.controlId,errors:l.errors,grouped:e,required:r.required===!0,count:l.count,setCharacterCount:m,getCharacterCountMessage:r.getCharacterCountMessage},children:a.children,handle:T}}function ve(r,e,t){s.useImperativeHandle(r,()=>e.current?Object.assign(e.current,t):t)}var Re=s.forwardRef(({validate:r,mode:e,errors:t,value:i,name:o,required:n,disabled:a,onValidityChange:l,getCharacterCountMessage:p,invalidMessage:R,validationDebounceTime:d,...m},T)=>{let f=s.useRef(null),{context:u,children:C,handle:F}=Ee({validate:r,mode:e,errors:t,value:i,name:o,required:n,disabled:a,onValidityChange:l,getCharacterCountMessage:p,invalidMessage:R,validationDebounceTime:d},!1,f,m.children);return ve(T,f,F),y(fe,{...u,children:y(me.div,{...m,...Je("field","root",m.className),ref:f,children:C})})});Re.displayName="FieldRoot";var be=s.forwardRef(({label:r,description:e,children:t,...i},o)=>y(Re,{...i,ref:o,children:he({label:r,description:e,children:t})}));be.displayName="Field";var Te=s.forwardRef(({validate:r,mode:e,errors:t,value:i,name:o,required:n,disabled:a,onValidityChange:l,getCharacterCountMessage:p,invalidMessage:R,validationDebounceTime:d,...m},T)=>{let f=s.useRef(null),{context:u,children:C,handle:F}=Ee({validate:r,mode:e,errors:t,value:i,name:o,required:n,disabled:a,onValidityChange:l,getCharacterCountMessage:p,invalidMessage:R,validationDebounceTime:d},!0,f,m.children);return ve(T,f,F),y(fe,{...u,children:y(me.fieldset,{...m,ref:f,children:C})})});Te.displayName="Fieldset";import*as D from"react";import{skdxPart as et}from"../utils/part.js";import{Primitive as tt}from"../utils/primitive.js";import{jsx as it}from"react/jsx-runtime";var rt=D.forwardRef(({maxLength:r,threshold:e=0,children:t,...i},o)=>{let n=c("FieldCharacterCount"),{setCharacterCount:a}=n;if(D.useEffect(()=>(a({maxLength:r,threshold:e}),()=>a(null)),[a,r,e]),!_(n.count,r,e))return null;let l=r-n.count;return it(tt.span,{[B]:"","data-over-limit":l<0?"":void 0,...i,...et("field","character-count",i.className),ref:o,children:t??(n.getCharacterCountMessage??x)(l)})});rt.displayName="FieldCharacterCount";export{ye as CHARACTER_COUNT_ANNOUNCE_DELAY_MS,Fe as ERROR_SUMMARY_RESCAN_EVENTS,B as FIELD_CHARACTER_COUNT_ATTRIBUTE,S as FIELD_CONTROL_ATTRIBUTE,U as FIELD_CONTROL_SELECTOR,g as FIELD_NAME_ATTRIBUTE,q as FIELD_REQUIRED_INDICATOR_ATTRIBUTE,Z as FIELD_VALIDITY_CHANGE_EVENT,I as FORM_FIELD_ATTRIBUTE,ee as FORM_MESSAGE_ATTRIBUTE,be as Field,rt as FieldCharacterCount,Y as FieldDescription,G as FieldError,j as FieldLabel,fe as FieldProvider,Q as FieldRequiredIndicator,Re as FieldRoot,Te as Fieldset,te as NATIVE_INVALID_FALLBACK_MESSAGE,x as characterCountMessage,_ as characterCountVisible,Pe as collectFieldErrors,xe as errorSummaryScope,$ as findFieldControl,Oe as focusFieldTarget,Me as resetFields,c as useFieldContext,De as validateFields};
+'use client';
+import*as n from"react";import{appearanceAttrs as S}from"../utils/appearance.js";import{createSafeContext as ce}from"../utils/createContext.js";import{FieldController as se}from"../utils/field-core.js";import{announce as fe}from"../utils/liveAnnouncer.js";import{skdxPart as V}from"../utils/part.js";import{Primitive as U}from"../utils/primitive.js";import{useCallbackRef as ue}from"../utils/useCallbackRef.js";import{FIELD_DESCRIPTION_ATTRIBUTE as Q}from"../utils/field-core.js";import{skdxPart as K}from"../utils/part.js";import{Primitive as W}from"../utils/primitive.js";import{jsx as z}from"react/jsx-runtime";var h=({as:e="span",ref:t,...r})=>{let o=u("FieldDescription"),i=W[e];return z(i,{id:o.descriptionId,[Q]:"",...r,...K("field","description",r.className),ref:t})};h.displayName="FieldDescription";import{FIELD_ERROR_ATTRIBUTE as J}from"../utils/field-core.js";import{skdxPart as X}from"../utils/part.js";import{Primitive as Z}from"../utils/primitive.js";import{jsx as j}from"react/jsx-runtime";var P=({as:e="span",children:t,ref:r,...o})=>{let i=u("FieldError");if(i.errors.length===0)return null;let a=Z[e];return j(a,{id:i.errorId,[J]:"",...o,...X("field","error",o.className),ref:r,children:t??i.errors.join(" ")})};P.displayName="FieldError";import{skdxPart as b}from"../utils/part.js";import{composeEventHandlers as D,Primitive as A}from"../utils/primitive.js";import{jsx as M}from"react/jsx-runtime";function x(e){!e.defaultPrevented&&e.detail>1&&e.preventDefault()}var _=({ref:e,...t})=>{let r=u("FieldLabel");return r.grouped?M(A.legend,{id:r.labelId,...t,...b("field","label",t.className),ref:e,onMouseDown:D(t.onMouseDown,x)}):M(A.label,{id:r.labelId,htmlFor:r.controlId,...t,...b("field","label",t.className),ref:e,onMouseDown:D(t.onMouseDown,x)})};_.displayName="FieldLabel";import{FIELD_REQUIRED_INDICATOR_ATTRIBUTE as ee}from"../utils/field-core.js";import{skdxPart as te}from"../utils/part.js";import{Primitive as re}from"../utils/primitive.js";import{jsx as oe}from"react/jsx-runtime";var v=({children:e,ref:t,...r})=>u("FieldRequiredIndicator").required?oe(re.span,{[ee]:"",...r,...te("field","required-indicator",r.className),ref:t,children:e??"*"}):null;v.displayName="FieldRequiredIndicator";import{Fragment as ie,jsx as L,jsxs as g}from"react/jsx-runtime";function O({label:e,description:t,children:r}){return g(ie,{children:[e?g(_,{children:[e,L(v,{})]}):null,r,t?L(h,{children:t}):null,L(P,{})]})}import*as m from"react";import{FIELD_CONTROL_ATTRIBUTE as ne}from"../utils/field-core.js";var ae=new Set(["input","select","textarea"]),de=new Set(["textbox","searchbox","combobox","listbox","radiogroup","group","slider","spinbutton","checkbox","radio","switch"]);function le(e){let t=e.props;return t["aria-hidden"]===!0||t["aria-hidden"]==="true"?!1:t[ne]!==void 0||typeof t.role=="string"&&de.has(t.role)?!0:typeof e.type!="string"||!ae.has(e.type)?!1:!(e.type==="input"&&t.type==="hidden")}function N(e,t,r){if(r.found||!e)return e;if(Array.isArray(e))return m.Children.map(e,i=>N(i,t,r));if(!m.isValidElement(e))return e;let o=e;return o.type===m.Fragment?m.cloneElement(o,void 0,N(o.props.children,t,r)):le(o)?(r.found=!0,typeof o.props.id=="string"&&o.props.id!==""?(r.controlId=o.props.id,o):(r.controlId=t,m.cloneElement(o,{id:t}))):typeof o.type=="string"&&o.props.children!==void 0?m.cloneElement(o,void 0,N(o.props.children,t,r)):e}function H(e,t){let r={controlId:void 0,found:!1};return{children:N(e,t,r),controlId:r.controlId}}import{jsx as I}from"react/jsx-runtime";var[w,u]=ce("Field");function k(e,t,r,o){let i=n.useId(),a=n.useMemo(()=>({labelId:`${i}label`,descriptionId:`${i}description`,errorId:`${i}error`,controlId:`${i}control`}),[i]),c=H(o,a.controlId),[l,p]=n.useState(()=>({controlId:"",errors:[],valid:!0,touched:!1,dirty:!1,filled:!1,count:0,validity:null})),F=ue(e.onValidityChange),d=n.useMemo(()=>new se({...a,grouped:t,onSnapshotChange:f=>{p(f);let{controlId:y,...T}=f;F(T)},announce:fe}),[a,t,F]);n.useEffect(()=>{let f=r.current;if(f)return d.connect(f),p(d.state),()=>d.disconnect()},[d,r]);let C=`${l.controlId}|${l.errors.length>0}`;n.useEffect(()=>{d.setProps({validate:e.validate,mode:e.mode,errors:e.errors,value:e.value,name:e.name,required:e.required,disabled:e.disabled,getCharacterCountMessage:e.getCharacterCountMessage,invalidMessage:e.invalidMessage,validationDebounceTime:e.validationDebounceTime}),d.sync()},[d,o,C,e.validate,e.mode,e.errors,e.value,e.name,e.required,e.disabled,e.getCharacterCountMessage,e.invalidMessage,e.validationDebounceTime]);let E=n.useCallback(f=>d.setCharacterCount(f),[d]),s={checkValidity:()=>d.validate(),reset:()=>d.reset()};return{context:{...a,controlId:l.controlId||c.controlId,errors:l.errors,grouped:t,required:e.required===!0,count:l.count,setCharacterCount:E,getCharacterCountMessage:e.getCharacterCountMessage},children:c.children,handle:s}}function q(e,t,r){n.useImperativeHandle(e,()=>t.current?Object.assign(t.current,r):r)}var B=({validate:e,mode:t,errors:r,value:o,name:i,required:a,disabled:c,onValidityChange:l,getCharacterCountMessage:p,invalidMessage:F,validationDebounceTime:d,ref:C,density:E,...s})=>{let R=n.useRef(null),{context:f,children:y,handle:T}=k({validate:e,mode:t,errors:r,value:o,name:i,required:a,disabled:c,onValidityChange:l,getCharacterCountMessage:p,invalidMessage:F,validationDebounceTime:d},!1,R,s.children);return q(C,R,T),I(w,{...f,children:I(U.div,{...s,...S({density:E},s),...V("field","root",s.className),ref:R,children:y})})};B.displayName="FieldRoot";var $=({label:e,description:t,children:r,ref:o,...i})=>I(B,{...i,ref:o,children:O({label:e,description:t,children:r})});$.displayName="Field";var G=({validate:e,mode:t,errors:r,value:o,name:i,required:a,disabled:c,onValidityChange:l,getCharacterCountMessage:p,invalidMessage:F,validationDebounceTime:d,ref:C,density:E,...s})=>{let R=n.useRef(null),{context:f,children:y,handle:T}=k({validate:e,mode:t,errors:r,value:o,name:i,required:a,disabled:c,onValidityChange:l,getCharacterCountMessage:p,invalidMessage:F,validationDebounceTime:d},!0,R,s.children);return q(C,R,T),I(w,{...f,children:I(U.fieldset,{...s,...S({density:E},s),...V("field","root",s.className),disabled:c,ref:R,children:y})})};G.displayName="Fieldset";import{CHARACTER_COUNT_ANNOUNCE_DELAY_MS as Ct,characterCountMessage as Et,characterCountVisible as Tt,FIELD_CHARACTER_COUNT_ATTRIBUTE as It,FIELD_REQUIRED_INDICATOR_ATTRIBUTE as yt,FIELD_CONTROL_ATTRIBUTE as Nt,FIELD_CONTROL_SELECTOR as ht,FIELD_VALIDITY_CHANGE_EVENT as Pt,NATIVE_INVALID_FALLBACK_MESSAGE as _t,findFieldControl as vt,collectFieldErrors as Lt,ERROR_SUMMARY_RESCAN_EVENTS as bt,errorSummaryScope as Dt,FORM_FIELD_ATTRIBUTE as At,FORM_MESSAGE_ATTRIBUTE as xt,FIELD_NAME_ATTRIBUTE as Mt,focusFieldTarget as gt,resetFields as Ot,validateFields as Ht}from"../utils/field-core.js";import*as Y from"react";import{characterCountMessage as me,characterCountVisible as Re,FIELD_CHARACTER_COUNT_ATTRIBUTE as pe}from"../utils/field-core.js";import{skdxPart as Fe}from"../utils/part.js";import{Primitive as Ce}from"../utils/primitive.js";import{jsx as Te}from"react/jsx-runtime";var Ee=({maxLength:e,threshold:t=0,children:r,ref:o,...i})=>{let a=u("FieldCharacterCount"),{setCharacterCount:c}=a;if(Y.useEffect(()=>(c({maxLength:e,threshold:t}),()=>c(null)),[c,e,t]),!Re(a.count,e,t))return null;let l=e-a.count;return Te(Ce.span,{[pe]:"","data-over-limit":l<0?"":void 0,...i,...Fe("field","character-count",i.className),ref:o,children:r??(a.getCharacterCountMessage??me)(l)})};Ee.displayName="FieldCharacterCount";export{Ct as CHARACTER_COUNT_ANNOUNCE_DELAY_MS,bt as ERROR_SUMMARY_RESCAN_EVENTS,It as FIELD_CHARACTER_COUNT_ATTRIBUTE,Nt as FIELD_CONTROL_ATTRIBUTE,ht as FIELD_CONTROL_SELECTOR,Mt as FIELD_NAME_ATTRIBUTE,yt as FIELD_REQUIRED_INDICATOR_ATTRIBUTE,Pt as FIELD_VALIDITY_CHANGE_EVENT,At as FORM_FIELD_ATTRIBUTE,xt as FORM_MESSAGE_ATTRIBUTE,$ as Field,Ee as FieldCharacterCount,h as FieldDescription,P as FieldError,_ as FieldLabel,w as FieldProvider,v as FieldRequiredIndicator,B as FieldRoot,G as Fieldset,_t as NATIVE_INVALID_FALLBACK_MESSAGE,Et as characterCountMessage,Tt as characterCountVisible,Lt as collectFieldErrors,Dt as errorSummaryScope,vt as findFieldControl,gt as focusFieldTarget,Ot as resetFields,u as useFieldContext,Ht as validateFields};

package/dist/field/FieldAnatomy.d.cts

@@ -5,7 +5,7 @@ import type * as React from 'react';
  * @internal
  */
 export declare function FieldAnatomy({ label, description, children, }: {
-    label?: React.ReactNode;
-    description?: React.ReactNode;
-    children?: React.ReactNode;
+    label?: React.ReactNode | undefined;
+    description?: React.ReactNode | undefined;
+    children?: React.ReactNode | undefined;
 }): React.ReactNode;

package/dist/field/FieldAnatomy.d.ts

@@ -5,7 +5,7 @@ import type * as React from 'react';
  * @internal
  */
 export declare function FieldAnatomy({ label, description, children, }: {
-    label?: React.ReactNode;
-    description?: React.ReactNode;
-    children?: React.ReactNode;
+    label?: React.ReactNode | undefined;
+    description?: React.ReactNode | undefined;
+    children?: React.ReactNode | undefined;
 }): React.ReactNode;

package/dist/field/FieldCharacterCount.d.cts

@@ -14,4 +14,7 @@ import type { FieldCharacterCountProps } from './types.cjs';
  * </Field>
  * ```
  */
-export declare const FieldCharacterCount: React.ForwardRefExoticComponent<Omit<FieldCharacterCountProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export declare const FieldCharacterCount: {
+    ({ maxLength, threshold, children, ref: forwardedRef, ...props }: FieldCharacterCountProps): React.ReactNode;
+    displayName: string;
+};

package/dist/field/FieldCharacterCount.d.ts

@@ -14,4 +14,7 @@ import type { FieldCharacterCountProps } from './types.js';
  * </Field>
  * ```
  */
-export declare const FieldCharacterCount: React.ForwardRefExoticComponent<Omit<FieldCharacterCountProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export declare const FieldCharacterCount: {
+    ({ maxLength, threshold, children, ref: forwardedRef, ...props }: FieldCharacterCountProps): React.ReactNode;
+    displayName: string;
+};

package/dist/field/FieldDescription.d.cts

@@ -1,4 +1,4 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { FieldDescriptionProps } from './types.cjs';
 /**
  * Help text for a {@link Field}. Its `id` is added to the wrapped control's
@@ -13,4 +13,7 @@ import type { FieldDescriptionProps } from './types.cjs';
  * </Field>
  * ```
  */
-export declare const FieldDescription: React.ForwardRefExoticComponent<Omit<FieldDescriptionProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export declare const FieldDescription: {
+    ({ as, ref: forwardedRef, ...props }: FieldDescriptionProps): React.ReactNode;
+    displayName: string;
+};

package/dist/field/FieldDescription.d.ts

@@ -1,4 +1,4 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { FieldDescriptionProps } from './types.js';
 /**
  * Help text for a {@link Field}. Its `id` is added to the wrapped control's
@@ -13,4 +13,7 @@ import type { FieldDescriptionProps } from './types.js';
  * </Field>
  * ```
  */
-export declare const FieldDescription: React.ForwardRefExoticComponent<Omit<FieldDescriptionProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export declare const FieldDescription: {
+    ({ as, ref: forwardedRef, ...props }: FieldDescriptionProps): React.ReactNode;
+    displayName: string;
+};

package/dist/field/FieldError.d.cts

@@ -1,4 +1,4 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { FieldErrorProps } from './types.cjs';
 /**
  * Error text for a Field. Renders nothing while valid; when rendered, joins `aria-describedby` and sets `aria-invalid`.
@@ -12,4 +12,7 @@ import type { FieldErrorProps } from './types.cjs';
  * </Field>
  * ```
  */
-export declare const FieldError: React.ForwardRefExoticComponent<Omit<FieldErrorProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export declare const FieldError: {
+    ({ as, children, ref: forwardedRef, ...props }: FieldErrorProps): React.ReactNode;
+    displayName: string;
+};

package/dist/field/FieldError.d.ts

@@ -1,4 +1,4 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { FieldErrorProps } from './types.js';
 /**
  * Error text for a Field. Renders nothing while valid; when rendered, joins `aria-describedby` and sets `aria-invalid`.
@@ -12,4 +12,7 @@ import type { FieldErrorProps } from './types.js';
  * </Field>
  * ```
  */
-export declare const FieldError: React.ForwardRefExoticComponent<Omit<FieldErrorProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export declare const FieldError: {
+    ({ as, children, ref: forwardedRef, ...props }: FieldErrorProps): React.ReactNode;
+    displayName: string;
+};

package/dist/field/FieldLabel.d.cts

@@ -1,11 +1,8 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { FieldLabelProps } from './types.cjs';
 /**
- * The label for a {@link Field}'s control. Renders a `<label>` whose
- * `htmlFor` points at whatever control the Field discovered — or a
- * `<legend>` inside a {@link Fieldset}, since a `<label for>` may not
- * reference a `[role="radiogroup"]` (there the Field puts `aria-labelledby`
- * on the group instead).
+ * Label for a {@link Field}'s control, rendering a `<label>` or, inside a
+ * {@link Fieldset}, a `<legend>` named with `aria-labelledby`.
  *
  * @example
  * ```tsx
@@ -15,4 +12,7 @@ import type { FieldLabelProps } from './types.cjs';
  * </Field>
  * ```
  */
-export declare const FieldLabel: React.ForwardRefExoticComponent<Omit<FieldLabelProps, "ref"> & React.RefAttributes<HTMLLabelElement>>;
+export declare const FieldLabel: {
+    ({ ref: forwardedRef, ...props }: FieldLabelProps): React.ReactNode;
+    displayName: string;
+};

package/dist/field/FieldLabel.d.ts

@@ -1,11 +1,8 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { FieldLabelProps } from './types.js';
 /**
- * The label for a {@link Field}'s control. Renders a `<label>` whose
- * `htmlFor` points at whatever control the Field discovered — or a
- * `<legend>` inside a {@link Fieldset}, since a `<label for>` may not
- * reference a `[role="radiogroup"]` (there the Field puts `aria-labelledby`
- * on the group instead).
+ * Label for a {@link Field}'s control, rendering a `<label>` or, inside a
+ * {@link Fieldset}, a `<legend>` named with `aria-labelledby`.
  *
  * @example
  * ```tsx
@@ -15,4 +12,7 @@ import type { FieldLabelProps } from './types.js';
  * </Field>
  * ```
  */
-export declare const FieldLabel: React.ForwardRefExoticComponent<Omit<FieldLabelProps, "ref"> & React.RefAttributes<HTMLLabelElement>>;
+export declare const FieldLabel: {
+    ({ ref: forwardedRef, ...props }: FieldLabelProps): React.ReactNode;
+    displayName: string;
+};

package/dist/field/FieldRequiredIndicator.d.cts

@@ -1,9 +1,8 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { FieldRequiredIndicatorProps } from './types.cjs';
 /**
- * "This field is required" marker for a {@link Field}, renders inside `FieldLabel` only.
- *
- * Inside the label it joins the control's accessible name — screen readers announce the requirement. Not `aria-hidden` because that would announce it only to sighted users.
+ * "This field is required" marker for a {@link Field}, rendered only inside
+ * `FieldLabel` so it joins the control's accessible name.
  *
  * @example
  * ```tsx
@@ -15,4 +14,7 @@ import type { FieldRequiredIndicatorProps } from './types.cjs';
  * </Field>
  * ```
  */
-export declare const FieldRequiredIndicator: React.ForwardRefExoticComponent<Omit<FieldRequiredIndicatorProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export declare const FieldRequiredIndicator: {
+    ({ children, ref: forwardedRef, ...props }: FieldRequiredIndicatorProps): React.ReactNode;
+    displayName: string;
+};

package/dist/field/FieldRequiredIndicator.d.ts

@@ -1,9 +1,8 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { FieldRequiredIndicatorProps } from './types.js';
 /**
- * "This field is required" marker for a {@link Field}, renders inside `FieldLabel` only.
- *
- * Inside the label it joins the control's accessible name — screen readers announce the requirement. Not `aria-hidden` because that would announce it only to sighted users.
+ * "This field is required" marker for a {@link Field}, rendered only inside
+ * `FieldLabel` so it joins the control's accessible name.
  *
  * @example
  * ```tsx
@@ -15,4 +14,7 @@ import type { FieldRequiredIndicatorProps } from './types.js';
  * </Field>
  * ```
  */
-export declare const FieldRequiredIndicator: React.ForwardRefExoticComponent<Omit<FieldRequiredIndicatorProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export declare const FieldRequiredIndicator: {
+    ({ children, ref: forwardedRef, ...props }: FieldRequiredIndicatorProps): React.ReactNode;
+    displayName: string;
+};

package/dist/field/fieldControlId.d.cts

@@ -3,11 +3,7 @@ import * as React from 'react';
 export interface FieldControlIdResult {
     /** The children to render, with the generated id cloned onto the control when one was found. */
     children: React.ReactNode;
-    /**
-     * The id the control carries in this render's markup, or `undefined` when no
-     * control was recognisable from the element tree — in which case the label
-     * emits no `for` at all rather than one that resolves to nothing.
-     */
+    /** The id the control carries in this render's markup, or `undefined` when none was recognisable. */
     controlId: string | undefined;
 }
 /**

package/dist/field/fieldControlId.d.ts

@@ -3,11 +3,7 @@ import * as React from 'react';
 export interface FieldControlIdResult {
     /** The children to render, with the generated id cloned onto the control when one was found. */
     children: React.ReactNode;
-    /**
-     * The id the control carries in this render's markup, or `undefined` when no
-     * control was recognisable from the element tree — in which case the label
-     * emits no `for` at all rather than one that resolves to nothing.
-     */
+    /** The id the control carries in this render's markup, or `undefined` when none was recognisable. */
     controlId: string | undefined;
 }
 /**

package/dist/field/index.d.cts

@@ -1,3 +1,3 @@
 export { Field, Fieldset } from './Field.cjs';
 export type { FieldProps, FieldsetProps, FieldsetHandle, FieldOwnProps, FieldValidityDetail, FieldValidateHandle, FieldHandle, FieldMode, FieldValidator, FieldValidationResult, } from './types.cjs';
-export { CHARACTER_COUNT_ANNOUNCE_DELAY_MS, characterCountMessage, characterCountVisible, FIELD_CHARACTER_COUNT_ATTRIBUTE, FIELD_REQUIRED_INDICATOR_ATTRIBUTE, FIELD_CONTROL_ATTRIBUTE, FIELD_CONTROL_SELECTOR, FIELD_VALIDITY_CHANGE_EVENT, NATIVE_INVALID_FALLBACK_MESSAGE, findFieldControl, type FieldSnapshot, collectFieldErrors, ERROR_SUMMARY_RESCAN_EVENTS, errorSummaryScope, FORM_FIELD_ATTRIBUTE, FORM_MESSAGE_ATTRIBUTE, FIELD_NAME_ATTRIBUTE, focusFieldTarget, type FieldErrorEntry, resetFields, validateFields, } from './fieldCore.cjs';
+export { CHARACTER_COUNT_ANNOUNCE_DELAY_MS, characterCountMessage, characterCountVisible, FIELD_CHARACTER_COUNT_ATTRIBUTE, FIELD_REQUIRED_INDICATOR_ATTRIBUTE, FIELD_CONTROL_ATTRIBUTE, FIELD_CONTROL_SELECTOR, FIELD_VALIDITY_CHANGE_EVENT, NATIVE_INVALID_FALLBACK_MESSAGE, findFieldControl, type FieldSnapshot, collectFieldErrors, ERROR_SUMMARY_RESCAN_EVENTS, errorSummaryScope, FORM_FIELD_ATTRIBUTE, FORM_MESSAGE_ATTRIBUTE, FIELD_NAME_ATTRIBUTE, focusFieldTarget, type FieldErrorEntry, resetFields, validateFields, } from '../utils/field-core.cjs';

package/dist/field/index.d.ts

@@ -1,3 +1,3 @@
 export { Field, Fieldset } from './Field.js';
 export type { FieldProps, FieldsetProps, FieldsetHandle, FieldOwnProps, FieldValidityDetail, FieldValidateHandle, FieldHandle, FieldMode, FieldValidator, FieldValidationResult, } from './types.js';
-export { CHARACTER_COUNT_ANNOUNCE_DELAY_MS, characterCountMessage, characterCountVisible, FIELD_CHARACTER_COUNT_ATTRIBUTE, FIELD_REQUIRED_INDICATOR_ATTRIBUTE, FIELD_CONTROL_ATTRIBUTE, FIELD_CONTROL_SELECTOR, FIELD_VALIDITY_CHANGE_EVENT, NATIVE_INVALID_FALLBACK_MESSAGE, findFieldControl, type FieldSnapshot, collectFieldErrors, ERROR_SUMMARY_RESCAN_EVENTS, errorSummaryScope, FORM_FIELD_ATTRIBUTE, FORM_MESSAGE_ATTRIBUTE, FIELD_NAME_ATTRIBUTE, focusFieldTarget, type FieldErrorEntry, resetFields, validateFields, } from './fieldCore.js';
+export { CHARACTER_COUNT_ANNOUNCE_DELAY_MS, characterCountMessage, characterCountVisible, FIELD_CHARACTER_COUNT_ATTRIBUTE, FIELD_REQUIRED_INDICATOR_ATTRIBUTE, FIELD_CONTROL_ATTRIBUTE, FIELD_CONTROL_SELECTOR, FIELD_VALIDITY_CHANGE_EVENT, NATIVE_INVALID_FALLBACK_MESSAGE, findFieldControl, type FieldSnapshot, collectFieldErrors, ERROR_SUMMARY_RESCAN_EVENTS, errorSummaryScope, FORM_FIELD_ATTRIBUTE, FORM_MESSAGE_ATTRIBUTE, FIELD_NAME_ATTRIBUTE, focusFieldTarget, type FieldErrorEntry, resetFields, validateFields, } from '../utils/field-core.js';