@skdx/react 0.28.0 → 0.29.0

package/dist/editable/types.d.cts

@@ -3,9 +3,7 @@ import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
 /** The element `EditableInput` or `EditableTextarea` renders — whichever one the consumer mounted. */
 export type EditableInputElement = HTMLInputElement | HTMLTextAreaElement;
 /**
- * How interacting with `EditablePreview` enters edit mode. Keyboard
- * activation (Enter/Space) always works, in every mode including `'none'`,
- * since the preview is a `role="button"` tab stop either way.
+ * How interacting with `EditablePreview` enters edit mode; keyboard activation (Enter/Space) always works, even under `'none'`, since the preview is a `role="button"` tab stop either way.
  */
 export type EditableActivationMode = 'click' | 'dblclick' | 'focus' | 'none';
 /** The payload of {@link EditableProps.onValueRevert}. */
@@ -67,32 +65,31 @@ export interface EditableContextValue {
 /** Props for the {@link Editable} root. */
 export interface EditableProps extends Omit<PrimitivePropsWithRef<'div'>, 'onChange'> {
     /**
-     * Manually-composed parts for full control over the anatomy; omitted, the
-     * field derives its own preview and editor from `multiline`.
+     * Manually-composed parts for full control over the anatomy; omitted, the field derives its own preview and editor from `multiline`.
      * @default undefined — the field derives its anatomy.
      */
-    children?: React.ReactNode;
+    children?: React.ReactNode | undefined;
     /**
      * Current text, for controlled usage, tracking the live draft while editing; use `onValueCommit` for the submitted result only.
      * @default undefined — uncontrolled, tracks its own value internally.
      */
-    value?: string;
+    value?: string | undefined;
     /**
      * Initial text, for uncontrolled usage, seeding the first render.
      * @default undefined — starts empty, so the preview shows `placeholder` and the root carries `data-empty`.
      */
-    defaultValue?: string;
+    defaultValue?: string | undefined;
     /**
      * Fires with the new text on every keystroke while editing, and again with the restored text when an edit is cancelled or rejected.
      * @default undefined — no-op if omitted.
      */
-    onValueChange?: (value: string) => void;
+    onValueChange?: ((value: string) => void) | undefined;
     /**
      * Fires once with the final text when an edit is successfully submitted;
      * never for an Escape-cancel or a rejected `required` blank submit.
      * @default undefined — no-op if omitted.
      */
-    onValueCommit?: (value: string) => void;
+    onValueCommit?: ((value: string) => void) | undefined;
     /**
      * Fires when an edit is abandoned rather than committed — Escape, an
      * `EditableCancelTrigger` click, or a `required` field submitted blank;
@@ -100,105 +97,94 @@ export interface EditableProps extends Omit<PrimitivePropsWithRef<'div'>, 'onCha
      * `previousValue` is the discarded draft.
      * @default undefined — no-op if omitted.
      */
-    onValueRevert?: (detail: EditableRevertDetail) => void;
+    onValueRevert?: ((detail: EditableRevertDetail) => void) | undefined;
     /**
      * Whether the input is showing instead of the preview, for controlled usage. Pair with `onEditChange`.
      * @default undefined — uncontrolled, tracks its own edit state internally.
      */
-    editing?: boolean;
+    editing?: boolean | undefined;
     /**
      * Whether to start in edit mode, for uncontrolled usage; starting `true` focuses the input on mount.
      * @default false — starts showing the preview.
      */
-    defaultEditing?: boolean;
+    defaultEditing?: boolean | undefined;
     /**
      * Fires with the new edit state whenever it flips, controlled or not.
      * @default undefined — no-op if omitted.
      */
-    onEditChange?: (editing: boolean) => void;
+    onEditChange?: ((editing: boolean) => void) | undefined;
     /**
-     * Text rendered by `EditablePreview` when the value is empty, and set as
-     * the editor's `placeholder`. A plain string sets both; the `{ edit,
-     * preview }` object form sets them separately, since the preview's
-     * placeholder doubles as its accessible name while empty.
+     * Text rendered by `EditablePreview` when the value is empty and set as the editor's `placeholder`; a plain string sets both, the `{ edit, preview }` object form sets them separately.
      * @default undefined — an empty value renders an empty preview.
      */
-    placeholder?: string | EditablePlaceholder;
+    placeholder?: string | EditablePlaceholder | undefined;
     /**
-     * Where focus goes when the edit ends, overriding the default of the
-     * preview; a function so the target is resolved at the moment focus moves,
-     * not at render. Returning `null` falls back to the preview.
+     * Where focus goes when the edit ends, overriding the preview default; a function so the target is resolved when focus moves, not at render, with `null` falling back to the preview.
      * @default undefined — focus returns to `EditablePreview`.
      */
-    finalFocusEl?: () => HTMLElement | null;
+    finalFocusEl?: (() => HTMLElement | null) | undefined;
     /**
      * Blocks editing entirely and takes the preview out of the tab order.
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
     /**
      * Shows the value but blocks entering edit mode; the preview stays focusable, unlike `disabled`.
      * @default false
      */
-    readOnly?: boolean;
+    readOnly?: boolean | undefined;
     /**
      * Rejects a submit that would leave the value blank (whitespace counts):
      * the pre-edit text is restored, `onValueCommit` does not fire, and edit mode closes.
      * @default false — an empty submit is committed like any other.
      */
-    required?: boolean;
+    required?: boolean | undefined;
     /**
      * Maximum number of characters the input accepts, forwarded to the native `maxLength` attribute.
      * @default undefined — no limit.
      */
-    maxLength?: number;
+    maxLength?: number | undefined;
     /**
      * Form field name; when set, the root renders one hidden input carrying the committed value, not the live draft.
      * @default undefined — renders no hidden input; submits nothing.
      */
-    name?: string;
+    name?: string | undefined;
     /**
      * Id of the `<form>` to submit with, mirroring the native `form` attribute on the hidden input `name` renders.
      * @default undefined — associates with the nearest ancestor `<form>`.
      */
-    form?: string;
+    form?: string | undefined;
     /**
-     * Which pointer gesture on `EditablePreview` enters edit mode; `'none'`
-     * matches none, for a control entered only via `EditableEditTrigger` or a
-     * controlled `editing` prop. Enter/Space always opens the editor regardless of mode.
+     * Which pointer gesture on `EditablePreview` enters edit mode; `'none'` matches none, leaving `EditableEditTrigger` or a controlled `editing` prop as the way in. Enter/Space always opens the editor regardless.
      * @default 'click' — a single click on the preview starts editing.
      */
-    activationMode?: EditableActivationMode;
+    activationMode?: EditableActivationMode | undefined;
     /**
      * Which gestures commit the draft: `'enter'`, `'blur'`, `'both'`, or
      * `'none'` (leaving it to `EditableSubmitTrigger`). Escape always cancels regardless.
      * @default 'both' — Enter and blur each submit.
      */
-    submitMode?: EditableSubmitMode;
+    submitMode?: EditableSubmitMode | undefined;
     /**
-     * Marks the current value as invalid — a commit the server rejected, or a
-     * rule the surrounding `Field` owns. Published as `data-invalid` on root,
-     * preview and editor, and as `aria-invalid` on the editor only, since that
-     * state is deprecated on the preview's `role="button"` in ARIA 1.2.
+     * Marks the current value as invalid, published as `data-invalid` on root, preview and editor, and as `aria-invalid` on the editor only, since that state is deprecated on the preview's `role="button"`.
      * @default false
      */
-    invalid?: boolean;
+    invalid?: boolean | undefined;
     /**
      * Select the whole value when edit mode opens, so typing replaces it; `false` places the caret at the end instead.
      * @default true — entering edit mode selects everything.
      */
-    selectOnFocus?: boolean;
+    selectOnFocus?: boolean | undefined;
     /**
-     * Whether the derived anatomy's editor is an `EditableTextarea` instead of an `EditableInput`. Ignored when `children` is given.
+     * Whether the derived anatomy's editor is an `EditableTextarea` instead of an `EditableInput`; ignored when `children` is given.
      * @default false — a single-line `EditableInput`.
      */
-    multiline?: boolean;
+    multiline?: boolean | undefined;
     /**
-     * Whether the derived anatomy renders an `EditableSubmitTrigger` /
-     * `EditableCancelTrigger` pair after the editor. Ignored when `children` is given.
+     * Whether the derived anatomy renders an `EditableSubmitTrigger`/`EditableCancelTrigger` pair after the editor; ignored when `children` is given.
      * @default false
      */
-    showControls?: boolean;
+    showControls?: boolean | undefined;
 }
 /** Props for {@link EditablePreview}, the read-mode text that starts an edit. Renders nothing while editing. */
 export interface EditablePreviewProps extends PrimitivePropsWithRef<'span'> {
@@ -212,18 +198,18 @@ export interface EditableTextareaProps extends Omit<PrimitivePropsWithRef<'texta
      * Grow the editor to fit its content instead of showing a scrollbar.
      * @default false — the editor keeps its `rows` height and scrolls.
      */
-    autoResize?: boolean;
+    autoResize?: boolean | undefined;
     /**
      * Caps auto-resize growth to this many rows, based on computed line-height; past the cap the editor scrolls again.
      * @default undefined — grows without limit.
      */
-    maxRows?: number;
+    maxRows?: number | undefined;
     /**
      * The editor's opening size and the floor auto-resize will not shrink
      * below; where `minRows` and `maxRows` disagree, `maxRows` wins.
      * @default 2 — the platform's own `rows` default.
      */
-    minRows?: number;
+    minRows?: number | undefined;
 }
 /** Props for {@link EditableLabel}, the `<label>` naming the editor and the preview. */
 export interface EditableLabelProps extends PrimitivePropsWithRef<'label'> {

package/dist/editable/types.d.ts

@@ -3,9 +3,7 @@ import type { PrimitivePropsWithRef } from '../utils/primitive.js';
 /** The element `EditableInput` or `EditableTextarea` renders — whichever one the consumer mounted. */
 export type EditableInputElement = HTMLInputElement | HTMLTextAreaElement;
 /**
- * How interacting with `EditablePreview` enters edit mode. Keyboard
- * activation (Enter/Space) always works, in every mode including `'none'`,
- * since the preview is a `role="button"` tab stop either way.
+ * How interacting with `EditablePreview` enters edit mode; keyboard activation (Enter/Space) always works, even under `'none'`, since the preview is a `role="button"` tab stop either way.
  */
 export type EditableActivationMode = 'click' | 'dblclick' | 'focus' | 'none';
 /** The payload of {@link EditableProps.onValueRevert}. */
@@ -67,32 +65,31 @@ export interface EditableContextValue {
 /** Props for the {@link Editable} root. */
 export interface EditableProps extends Omit<PrimitivePropsWithRef<'div'>, 'onChange'> {
     /**
-     * Manually-composed parts for full control over the anatomy; omitted, the
-     * field derives its own preview and editor from `multiline`.
+     * Manually-composed parts for full control over the anatomy; omitted, the field derives its own preview and editor from `multiline`.
      * @default undefined — the field derives its anatomy.
      */
-    children?: React.ReactNode;
+    children?: React.ReactNode | undefined;
     /**
      * Current text, for controlled usage, tracking the live draft while editing; use `onValueCommit` for the submitted result only.
      * @default undefined — uncontrolled, tracks its own value internally.
      */
-    value?: string;
+    value?: string | undefined;
     /**
      * Initial text, for uncontrolled usage, seeding the first render.
      * @default undefined — starts empty, so the preview shows `placeholder` and the root carries `data-empty`.
      */
-    defaultValue?: string;
+    defaultValue?: string | undefined;
     /**
      * Fires with the new text on every keystroke while editing, and again with the restored text when an edit is cancelled or rejected.
      * @default undefined — no-op if omitted.
      */
-    onValueChange?: (value: string) => void;
+    onValueChange?: ((value: string) => void) | undefined;
     /**
      * Fires once with the final text when an edit is successfully submitted;
      * never for an Escape-cancel or a rejected `required` blank submit.
      * @default undefined — no-op if omitted.
      */
-    onValueCommit?: (value: string) => void;
+    onValueCommit?: ((value: string) => void) | undefined;
     /**
      * Fires when an edit is abandoned rather than committed — Escape, an
      * `EditableCancelTrigger` click, or a `required` field submitted blank;
@@ -100,105 +97,94 @@ export interface EditableProps extends Omit<PrimitivePropsWithRef<'div'>, 'onCha
      * `previousValue` is the discarded draft.
      * @default undefined — no-op if omitted.
      */
-    onValueRevert?: (detail: EditableRevertDetail) => void;
+    onValueRevert?: ((detail: EditableRevertDetail) => void) | undefined;
     /**
      * Whether the input is showing instead of the preview, for controlled usage. Pair with `onEditChange`.
      * @default undefined — uncontrolled, tracks its own edit state internally.
      */
-    editing?: boolean;
+    editing?: boolean | undefined;
     /**
      * Whether to start in edit mode, for uncontrolled usage; starting `true` focuses the input on mount.
      * @default false — starts showing the preview.
      */
-    defaultEditing?: boolean;
+    defaultEditing?: boolean | undefined;
     /**
      * Fires with the new edit state whenever it flips, controlled or not.
      * @default undefined — no-op if omitted.
      */
-    onEditChange?: (editing: boolean) => void;
+    onEditChange?: ((editing: boolean) => void) | undefined;
     /**
-     * Text rendered by `EditablePreview` when the value is empty, and set as
-     * the editor's `placeholder`. A plain string sets both; the `{ edit,
-     * preview }` object form sets them separately, since the preview's
-     * placeholder doubles as its accessible name while empty.
+     * Text rendered by `EditablePreview` when the value is empty and set as the editor's `placeholder`; a plain string sets both, the `{ edit, preview }` object form sets them separately.
      * @default undefined — an empty value renders an empty preview.
      */
-    placeholder?: string | EditablePlaceholder;
+    placeholder?: string | EditablePlaceholder | undefined;
     /**
-     * Where focus goes when the edit ends, overriding the default of the
-     * preview; a function so the target is resolved at the moment focus moves,
-     * not at render. Returning `null` falls back to the preview.
+     * Where focus goes when the edit ends, overriding the preview default; a function so the target is resolved when focus moves, not at render, with `null` falling back to the preview.
      * @default undefined — focus returns to `EditablePreview`.
      */
-    finalFocusEl?: () => HTMLElement | null;
+    finalFocusEl?: (() => HTMLElement | null) | undefined;
     /**
      * Blocks editing entirely and takes the preview out of the tab order.
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
     /**
      * Shows the value but blocks entering edit mode; the preview stays focusable, unlike `disabled`.
      * @default false
      */
-    readOnly?: boolean;
+    readOnly?: boolean | undefined;
     /**
      * Rejects a submit that would leave the value blank (whitespace counts):
      * the pre-edit text is restored, `onValueCommit` does not fire, and edit mode closes.
      * @default false — an empty submit is committed like any other.
      */
-    required?: boolean;
+    required?: boolean | undefined;
     /**
      * Maximum number of characters the input accepts, forwarded to the native `maxLength` attribute.
      * @default undefined — no limit.
      */
-    maxLength?: number;
+    maxLength?: number | undefined;
     /**
      * Form field name; when set, the root renders one hidden input carrying the committed value, not the live draft.
      * @default undefined — renders no hidden input; submits nothing.
      */
-    name?: string;
+    name?: string | undefined;
     /**
      * Id of the `<form>` to submit with, mirroring the native `form` attribute on the hidden input `name` renders.
      * @default undefined — associates with the nearest ancestor `<form>`.
      */
-    form?: string;
+    form?: string | undefined;
     /**
-     * Which pointer gesture on `EditablePreview` enters edit mode; `'none'`
-     * matches none, for a control entered only via `EditableEditTrigger` or a
-     * controlled `editing` prop. Enter/Space always opens the editor regardless of mode.
+     * Which pointer gesture on `EditablePreview` enters edit mode; `'none'` matches none, leaving `EditableEditTrigger` or a controlled `editing` prop as the way in. Enter/Space always opens the editor regardless.
      * @default 'click' — a single click on the preview starts editing.
      */
-    activationMode?: EditableActivationMode;
+    activationMode?: EditableActivationMode | undefined;
     /**
      * Which gestures commit the draft: `'enter'`, `'blur'`, `'both'`, or
      * `'none'` (leaving it to `EditableSubmitTrigger`). Escape always cancels regardless.
      * @default 'both' — Enter and blur each submit.
      */
-    submitMode?: EditableSubmitMode;
+    submitMode?: EditableSubmitMode | undefined;
     /**
-     * Marks the current value as invalid — a commit the server rejected, or a
-     * rule the surrounding `Field` owns. Published as `data-invalid` on root,
-     * preview and editor, and as `aria-invalid` on the editor only, since that
-     * state is deprecated on the preview's `role="button"` in ARIA 1.2.
+     * Marks the current value as invalid, published as `data-invalid` on root, preview and editor, and as `aria-invalid` on the editor only, since that state is deprecated on the preview's `role="button"`.
      * @default false
      */
-    invalid?: boolean;
+    invalid?: boolean | undefined;
     /**
      * Select the whole value when edit mode opens, so typing replaces it; `false` places the caret at the end instead.
      * @default true — entering edit mode selects everything.
      */
-    selectOnFocus?: boolean;
+    selectOnFocus?: boolean | undefined;
     /**
-     * Whether the derived anatomy's editor is an `EditableTextarea` instead of an `EditableInput`. Ignored when `children` is given.
+     * Whether the derived anatomy's editor is an `EditableTextarea` instead of an `EditableInput`; ignored when `children` is given.
      * @default false — a single-line `EditableInput`.
      */
-    multiline?: boolean;
+    multiline?: boolean | undefined;
     /**
-     * Whether the derived anatomy renders an `EditableSubmitTrigger` /
-     * `EditableCancelTrigger` pair after the editor. Ignored when `children` is given.
+     * Whether the derived anatomy renders an `EditableSubmitTrigger`/`EditableCancelTrigger` pair after the editor; ignored when `children` is given.
      * @default false
      */
-    showControls?: boolean;
+    showControls?: boolean | undefined;
 }
 /** Props for {@link EditablePreview}, the read-mode text that starts an edit. Renders nothing while editing. */
 export interface EditablePreviewProps extends PrimitivePropsWithRef<'span'> {
@@ -212,18 +198,18 @@ export interface EditableTextareaProps extends Omit<PrimitivePropsWithRef<'texta
      * Grow the editor to fit its content instead of showing a scrollbar.
      * @default false — the editor keeps its `rows` height and scrolls.
      */
-    autoResize?: boolean;
+    autoResize?: boolean | undefined;
     /**
      * Caps auto-resize growth to this many rows, based on computed line-height; past the cap the editor scrolls again.
      * @default undefined — grows without limit.
      */
-    maxRows?: number;
+    maxRows?: number | undefined;
     /**
      * The editor's opening size and the floor auto-resize will not shrink
      * below; where `minRows` and `maxRows` disagree, `maxRows` wins.
      * @default 2 — the platform's own `rows` default.
      */
-    minRows?: number;
+    minRows?: number | undefined;
 }
 /** Props for {@link EditableLabel}, the `<label>` naming the editor and the preview. */
 export interface EditableLabelProps extends PrimitivePropsWithRef<'label'> {

package/dist/field/Field.cjs

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

package/dist/field/Field.d.cts

@@ -1,23 +1,11 @@
 import * as React from 'react';
-import type { FieldContextValue, FieldProps, FieldRootProps, FieldsetProps } from './types.cjs';
-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.cjs';
+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;
+};