npm - @skdx/vue - Versions diffs - 0.28.0 → 0.30.0 - Mend

@skdx/vue 0.28.0 → 0.30.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3440) hide show

package/dist/utils/dismissal.d.cts ADDED Viewed

@@ -0,0 +1,49 @@
+/** What `onFocusOutside` receives: `focusin` is not cancelable, so the handler gets a cancelable stand-in carrying the original as its `detail`. */
+export type FocusOutsideEvent = CustomEvent<FocusEvent>;
+/** Either flavour of outside interaction, as `onInteractOutside` sees it. */
+export type InteractOutsideEvent = PointerEvent | FocusOutsideEvent;
+/** One open dismissible layer, as the stack knows it: only what counts as inside it. */
+export interface DismissLayer {
+    /** The layer's own elements, read fresh each time since a panel mounts and unmounts under the same layer. */
+    insideElements: () => Array<Element | null | undefined>;
+}
+/** Registers an open layer and returns its teardown; layers close out of order (a parent unmount takes its children), so the teardown removes by identity, not by position. */
+export declare function pushDismissLayer(layer: DismissLayer): () => void;
+/** The layer nothing else is open inside: push order cannot rank nested layers, because a framework's effects run child-first. */
+export declare function topDismissLayer(candidates?: readonly DismissLayer[]): DismissLayer | undefined;
+/** The one layer an Escape belongs to: sibling non-modal layers can be open at once, so the layer holding the key's target answers, and the top layer only when none does. */
+export declare function escapeLayer(target: Node | null): DismissLayer | undefined;
+/**
+ * Runs one layer's share of a document-level Escape keydown: at most one layer
+ * handles a given Escape, and `preventDefault()` comes after the consumer's
+ * handler — never before, so a veto is read from the same event — and only when
+ * this layer was the one that handled it. Preventing matters because the close
+ * watcher of an ancestor native `<dialog>` skips a canceled Escape, which is
+ * what stops one press from closing both the top layer and the Dialog around it.
+ *
+ * Listen on the document, not the panel: a layer must answer Escape while focus
+ * sits outside it (virtual focus, a portalled submenu), which a panel-level
+ * listener never sees.
+ *
+ * @param event the document keydown
+ * @param layer the layer asking whether the key is its own
+ * @param handler the consumer's Escape handler, or `undefined` for a layer that leaves Escape to the platform (a native `<dialog>`)
+ * @returns whether this layer handled the key
+ */
+export declare function handleEscapeKeyDown(event: KeyboardEvent, layer: DismissLayer, handler: ((event: KeyboardEvent) => void) | undefined): boolean;
+/** The cancelable stand-in an auto-focus handler receives; there is no native event for "about to move focus". */
+export type AutoFocusEvent = CustomEvent<null>;
+/** Announces an automatic focus move as a cancelable event and reports whether it may go ahead. */
+export declare function autoFocusEvent(type: 'open-auto-focus' | 'close-auto-focus', handler?: (event: AutoFocusEvent) => void): boolean;
+/** The cancelable stand-in for a `focusin` that landed outside the layer. */
+export declare function focusOutsideEvent(event: FocusEvent): FocusOutsideEvent;
+/** Marks an overlay's open-time focus move so other layers don't read it as outside interaction; released in a microtask because `focus()` dispatches `focusin` synchronously. */
+export declare function focusOnOpen(move: () => void): void;
+/** The node a `focusin` moved focus to, or `null` when it is not a move this layer may be dismissed by: another layer opening, or focus clearing to `<body>`. */
+export declare function focusOutsideTarget(event: FocusEvent): Node | null;
+/** Whether an outside-interaction target is the overlay's own trigger, including through the trigger's shadow root. */
+export declare function triggerContains(trigger: Element | null | undefined, target: Node | null): boolean;
+/**
+ * The native `<dialog>` backdrop, normalised onto the same `PointerEvent` channel as every other outside pointer-down, or `null` when the press landed inside the panel. The backdrop is not an element: a pointer on it targets the dialog itself, which `contains()` would misread as inside.
+ */
+export declare function backdropPointerDown(event: MouseEvent, dialog: Element | null | undefined): PointerEvent | null;

package/dist/utils/dismissal.d.ts ADDED Viewed

@@ -0,0 +1,49 @@
+/** What `onFocusOutside` receives: `focusin` is not cancelable, so the handler gets a cancelable stand-in carrying the original as its `detail`. */
+export type FocusOutsideEvent = CustomEvent<FocusEvent>;
+/** Either flavour of outside interaction, as `onInteractOutside` sees it. */
+export type InteractOutsideEvent = PointerEvent | FocusOutsideEvent;
+/** One open dismissible layer, as the stack knows it: only what counts as inside it. */
+export interface DismissLayer {
+    /** The layer's own elements, read fresh each time since a panel mounts and unmounts under the same layer. */
+    insideElements: () => Array<Element | null | undefined>;
+}
+/** Registers an open layer and returns its teardown; layers close out of order (a parent unmount takes its children), so the teardown removes by identity, not by position. */
+export declare function pushDismissLayer(layer: DismissLayer): () => void;
+/** The layer nothing else is open inside: push order cannot rank nested layers, because a framework's effects run child-first. */
+export declare function topDismissLayer(candidates?: readonly DismissLayer[]): DismissLayer | undefined;
+/** The one layer an Escape belongs to: sibling non-modal layers can be open at once, so the layer holding the key's target answers, and the top layer only when none does. */
+export declare function escapeLayer(target: Node | null): DismissLayer | undefined;
+/**
+ * Runs one layer's share of a document-level Escape keydown: at most one layer
+ * handles a given Escape, and `preventDefault()` comes after the consumer's
+ * handler — never before, so a veto is read from the same event — and only when
+ * this layer was the one that handled it. Preventing matters because the close
+ * watcher of an ancestor native `<dialog>` skips a canceled Escape, which is
+ * what stops one press from closing both the top layer and the Dialog around it.
+ *
+ * Listen on the document, not the panel: a layer must answer Escape while focus
+ * sits outside it (virtual focus, a portalled submenu), which a panel-level
+ * listener never sees.
+ *
+ * @param event the document keydown
+ * @param layer the layer asking whether the key is its own
+ * @param handler the consumer's Escape handler, or `undefined` for a layer that leaves Escape to the platform (a native `<dialog>`)
+ * @returns whether this layer handled the key
+ */
+export declare function handleEscapeKeyDown(event: KeyboardEvent, layer: DismissLayer, handler: ((event: KeyboardEvent) => void) | undefined): boolean;
+/** The cancelable stand-in an auto-focus handler receives; there is no native event for "about to move focus". */
+export type AutoFocusEvent = CustomEvent<null>;
+/** Announces an automatic focus move as a cancelable event and reports whether it may go ahead. */
+export declare function autoFocusEvent(type: 'open-auto-focus' | 'close-auto-focus', handler?: (event: AutoFocusEvent) => void): boolean;
+/** The cancelable stand-in for a `focusin` that landed outside the layer. */
+export declare function focusOutsideEvent(event: FocusEvent): FocusOutsideEvent;
+/** Marks an overlay's open-time focus move so other layers don't read it as outside interaction; released in a microtask because `focus()` dispatches `focusin` synchronously. */
+export declare function focusOnOpen(move: () => void): void;
+/** The node a `focusin` moved focus to, or `null` when it is not a move this layer may be dismissed by: another layer opening, or focus clearing to `<body>`. */
+export declare function focusOutsideTarget(event: FocusEvent): Node | null;
+/** Whether an outside-interaction target is the overlay's own trigger, including through the trigger's shadow root. */
+export declare function triggerContains(trigger: Element | null | undefined, target: Node | null): boolean;
+/**
+ * The native `<dialog>` backdrop, normalised onto the same `PointerEvent` channel as every other outside pointer-down, or `null` when the press landed inside the panel. The backdrop is not an element: a pointer on it targets the dialog itself, which `contains()` would misread as inside.
+ */
+export declare function backdropPointerDown(event: MouseEvent, dialog: Element | null | undefined): PointerEvent | null;

package/dist/utils/dismissal.js ADDED Viewed

@@ -0,0 +1 @@

+ var e=[];function n(e,n){return e.insideElements().some(e=>n.insideElements().some(n=>n&&e?.contains(n)))}function t(n){return e.push(n),()=>{const t=e.indexOf(n);-1!==t&&e.splice(t,1)}}function s(t=e){for(let e=t.length-1;e>=0;e--){const s=t[e];if(!t.some(e=>e!==s&&n(s,e)))return s}}function o(n){return s(n?e.filter(e=>e.insideElements().some(e=>e?.contains(n))):[])??s()}function r(e,n,t){return!("Escape"!==e.key||!t||o(e.target)!==n||(t(e),e.preventDefault(),0))}function u(e,n){if(!n)return!0;const t=new CustomEvent(e,{cancelable:!0,detail:null});return n(t),!t.defaultPrevented}function i(e){return new CustomEvent("focus-outside",{detail:e,cancelable:!0})}var c=0;function a(e){c+=1;try{e()}finally{queueMicrotask(()=>{c-=1})}}function l(e){if(c>0)return null;const n=e.target;return n&&n!==document.body?n:null}function f(e,n){return n&&e.target===n?e instanceof PointerEvent?e:new PointerEvent("pointerdown",{bubbles:!0,cancelable:!0,composed:!0,pointerType:"mouse",clientX:e.clientX,clientY:e.clientY,screenX:e.screenX,screenY:e.screenY,button:e.button,buttons:e.buttons,ctrlKey:e.ctrlKey,shiftKey:e.shiftKey,altKey:e.altKey,metaKey:e.metaKey}):null}export{u as autoFocusEvent,f as backdropPointerDown,o as escapeLayer,a as focusOnOpen,i as focusOutsideEvent,l as focusOutsideTarget,r as handleEscapeKeyDown,t as pushDismissLayer,s as topDismissLayer};

package/dist/utils/field-core.cjs ADDED Viewed

@@ -0,0 +1 @@

+ var I="validity-change",l="data-skdx-field",d="data-skdx-field-name",h="data-skdx-field-message",R="data-skdx-field-description",_="data-skdx-field-error",k="data-skdx-field-character-count",L="data-skdx-field-pending",c="data-skdx-field-resubmit",b="data-skdx-form-field",N="data-skdx-form-message",U=["validity-change","invalid","change","blur"],C="data-skdx-error-summary",S=1e3;function D(t){const e=Math.abs(t),i=e===1?"character":"characters";return t<0?`You have ${e} ${i} too many`:`You have ${e} ${i} remaining`}function F(t,e,i=0){return i<=0?!0:t>=e*i/100}var M="This field is invalid.",B="data-skdx-field-control",v=[`[${B}]`,'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(", "),V="data-skdx-field-required-indicator",w=new Set(["INPUT","SELECT","TEXTAREA"]),O=new Set(["radiogroup","group"]),q=['input:not([disabled]):not([type="hidden"])',"select:not([disabled])","textarea:not([disabled])","button:not([disabled])",'[tabindex]:not([tabindex="-1"])'].join(", ");function f(t){return t==null?[]:(Array.isArray(t)?t:[t]).filter(e=>typeof e=="string"&&e.trim()!=="")}function A(t){for(const e of Array.from(t.querySelectorAll(v)))if(e.getAttribute("aria-hidden")!=="true"&&e.closest("[data-skdx-field]")===t)return e;return null}function m(t,e){return E(t,l,e)}function E(t,e,i){for(const r of Array.from(t.querySelectorAll(i)))if(r.closest(`[${e}]`)===t)return r;return null}function x(t){if(!t)return;const e=t;return e.type==="checkbox"||e.type==="radio"?e.checked:"value"in t?e.value:t.querySelector('input[aria-hidden="true"]')?.value}function o(t){return t==null||t===!1||t===""?!1:!(Array.isArray(t)&&t.length===0)}function a(t,e,i){i?t.setAttribute(e,""):t.removeAttribute(e)}function g(t,...e){const i=t.split(/\s+/).filter(Boolean);for(const r of e)r&&!i.includes(r)&&i.push(r);return i.join(" ")}function P(t){return t.closest("form, skdx-form")??t.parentElement??t}function G(t){const e=A(t),i=m(t,"[data-skdx-field-error]")?.textContent?.trim()||t.getAttribute("data-skdx-field-message")||t.getAttribute("data-skdx-field-name")||"";return!e?.id||!i?[]:[{id:e.id,message:i}]}function $(t){const e=E(t,b,v);if(!e?.id||e.getAttribute("aria-invalid")!=="true")return[];const i=E(t,"data-skdx-form-field","[data-skdx-form-message]:not([hidden])")?.textContent?.trim()||t.getAttribute("data-skdx-field-name")||"";return i?[{id:e.id,message:i}]:[]}function j(t){return Array.from(t.querySelectorAll(`[${l}][data-invalid], [${b}]`)).flatMap(e=>(e.hasAttribute("data-skdx-field")?G:$)(e))}var p="__skdxFieldCheckValidity",T="__skdxFieldReset";async function Y(t){const e=Array.from(t.querySelectorAll(`[${l}]`));return(await Promise.all(e.map(i=>i[p]?.()??Promise.resolve(!0)))).every(Boolean)}function H(t){for(const e of Array.from(t.querySelectorAll(`[${l}]`)))e[T]?.()}function z(t,e=document){const i=e.getElementById(t);if(!i)return;const r=i.getAttribute("role"),s=(i.tagName==="FIELDSET"||r!==null&&O.has(r)?i.querySelector(q):null)??i;s.focus(),s.scrollIntoView?.({block:"center"})}var K=class{constructor(t){this.options=t,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.wroteGroupDisabled=!1,this.runToken=0,this.pending=!1,this.injected=[],this.custom=[],this.characterCount=null,this.awaitingSubmit=!1,this.handleInput=()=>{const e=this.isOverLimit(this.snapshot.count),i=this.readCount();this.update({dirty:!0,filled:o(this.resolveValue()),count:i,errors:this.composeErrors(i)}),this.scheduleCountAnnouncement(i,e),(this.props.mode==="change"||this.snapshot.errors.length>0)&&this.scheduleValidation()},this.handleFocusOut=()=>{const e=this.readCount();this.update({touched:!0,filled:o(this.resolveValue()),count:e,errors:this.composeErrors(e)});const i=this.validationTimer!==void 0;clearTimeout(this.validationTimer),this.validationTimer=void 0;const r=this.props.mode??"blur";(i||r==="blur"||this.snapshot.errors.length>0)&&this.runValidation()},this.handleSubmit=e=>{if(!this.form)return;const i=e.target;if(i!==this.form&&i?.closest?.("form")!==this.form||this.isEngineResubmit(e))return;this.markTouched();const r=this.runValidation({silent:this.hasErrorSummary()});if(y(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(t){const e=this.props.value;this.props=t;const i=f(t.errors??null),r=!Q(this.injected,i);r&&(this.injected=i);const s=t.value!==e;if(!r&&!s)return;const n=this.readCount();this.update({count:n,filled:o(this.resolveValue()),errors:this.composeErrors(n)})}setCharacterCount(t){if((this.characterCount?.maxLength??null)===(t?.maxLength??null)&&(this.characterCount?.threshold??0)===(t?.threshold??0))return;this.characterCount=t;const e=this.readCount();this.update({count:e,errors:this.composeErrors(e)})}readCount(){const t=this.resolveValue();return typeof t=="string"?t.length:0}countMessage(t){return(this.props.getCharacterCountMessage??D)(t)}isOverLimit(t){return this.characterCount!==null&&t>this.characterCount.maxLength}composeErrors(t=this.snapshot.count){const e=[...this.injected,...this.custom];return this.characterCount&&this.isOverLimit(t)&&e.push(this.countMessage(this.characterCount.maxLength-t)),e}scheduleCountAnnouncement(t,e){const i=this.characterCount;if(!i)return;if(clearTimeout(this.announceTimer),this.isOverLimit(t)){e||this.options.announce(this.countMessage(i.maxLength-t),"assertive");return}if(!F(t,i.maxLength,i.threshold))return;const r=i.maxLength-t;this.announceTimer=setTimeout(()=>{this.options.announce(this.countMessage(r),"polite")},S)}connect(t){this.root=t,t.setAttribute(l,""),Object.defineProperty(t,p,{value:()=>this.validate(),configurable:!0,enumerable:!1,writable:!0}),Object.defineProperty(t,T,{value:()=>this.reset(),configurable:!0,enumerable:!1,writable:!0}),t.addEventListener("input",this.handleInput,!0),t.addEventListener("change",this.handleInput,!0),t.addEventListener("focusout",this.handleFocusOut,!0),this.form=t.closest("form"),this.form&&t.ownerDocument.addEventListener("submit",this.handleSubmit,!0),this.sync();const e=this.readCount();this.update({filled:o(this.resolveValue()),count:e,errors:this.composeErrors(e)})}disconnect(){clearTimeout(this.announceTimer),clearTimeout(this.validationTimer),this.validationTimer=void 0,this.awaitingSubmit=!1;const t=this.root;t&&(t.removeEventListener("input",this.handleInput,!0),t.removeEventListener("change",this.handleInput,!0),t.removeEventListener("focusout",this.handleFocusOut,!0),this.form&&t.ownerDocument.removeEventListener("submit",this.handleSubmit,!0),delete t[p],delete t[T],this.root=null,this.form=null,this.control=null)}sync(){const t=this.root;if(!t)return;const e=A(t);e!==this.control&&(this.control=e,this.baseDescribedBy=e?.getAttribute("aria-describedby")??"",this.baseLabelledBy=e?.getAttribute("aria-labelledby")??"",this.wroteLabelledBy=!1,this.wroteRequired=!1,this.wroteDisabled=!1,this.wroteGroupDisabled=!1);const{name:i}=this.props;i?t.setAttribute(d,i):t.removeAttribute(d);const r=this.snapshot.errors.join(" ");r?t.setAttribute(h,r):t.removeAttribute(h),this.applyStateAttributes(t),e&&(e.id||(e.id=this.options.controlId),e.id!==this.snapshot.controlId&&(this.snapshot={...this.snapshot,controlId:e.id,validity:this.readValidity()},this.options.onSnapshotChange(this.snapshot)),this.applyDescribedBy(t,e),this.snapshot.errors.length>0?e.setAttribute("aria-invalid","true"):e.removeAttribute("aria-invalid"),this.applyLabelledBy(t,e),this.applyConstraintState(e),this.applyStateAttributes(e))}applyDescribedBy(t,e){const i=m(t,`[${R}]`)!==null,r=m(t,`[${_}]`)!==null,s=g(this.baseDescribedBy,i?this.options.descriptionId:void 0,r?this.options.errorId:void 0);s?e.setAttribute("aria-describedby",s):e.removeAttribute("aria-describedby")}applyLabelledBy(t,e){const i=t.ownerDocument.getElementById(this.options.labelId)!==null;this.options.grouped&&i?(e.setAttribute("aria-labelledby",g(this.baseLabelledBy,this.options.labelId)),this.wroteLabelledBy=!0):this.wroteLabelledBy&&(this.baseLabelledBy?e.setAttribute("aria-labelledby",this.baseLabelledBy):e.removeAttribute("aria-labelledby"),this.wroteLabelledBy=!1)}applyConstraintState(t){const e=w.has(t.tagName),i=this.props.required===!0,r=this.props.disabled===!0;i?(e?t.setAttribute("required",""):t.setAttribute("aria-required","true"),this.wroteRequired=!0):this.wroteRequired&&(t.removeAttribute(e?"required":"aria-required"),this.wroteRequired=!1),r?(e?t.setAttribute("disabled",""):t.setAttribute("aria-disabled","true"),this.wroteDisabled=!0):this.wroteDisabled&&(t.removeAttribute(e?"disabled":"aria-disabled"),this.wroteDisabled=!1),e||this.applyGroupDisabled(t,r)}applyGroupDisabled(t,e){const i=t.getAttribute("role");if(!(!(t.tagName==="FIELDSET"||i!==null&&O.has(i))||!e&&!this.wroteGroupDisabled)){for(const r of t.querySelectorAll("input, select, textarea, button"))e?r.setAttribute("disabled",""):r.removeAttribute("disabled");this.wroteGroupDisabled=e}}validate(){return Promise.resolve(this.runValidation()).then(t=>t.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);const t=this.readCount();this.update({touched:!1,dirty:!1,count:t,filled:o(this.resolveValue()),errors:this.composeErrors(t)}),this.sync()}markTouched(){this.snapshot.touched||this.update({touched:!0})}applyStateAttributes(t){const{errors:e,touched:i,dirty:r,filled:s,count:n}=this.snapshot;a(t,"data-invalid",e.length>0),a(t,"data-valid",e.length===0),a(t,"data-touched",i),a(t,"data-dirty",r),a(t,"data-filled",s),a(t,"data-over-limit",this.isOverLimit(n)),a(t,"data-disabled",this.props.disabled===!0)}resolveValue(){return this.props.value!==void 0?this.props.value:x(this.control)}readValidity(){return this.control?.validity??null}markPending(t){this.root&&a(this.root,L,t)}nativeMessage(){const t=this.control;return!t?.validity||t.validity.valid?null:t.validationMessage||this.props.invalidMessage||"This field is invalid."}runValidation(t={}){const e=++this.runToken,i=this.props.validate?.(this.resolveValue());return y(i)?(this.pending=!0,this.markPending(!0),Promise.resolve(i).then(r=>e!==this.runToken?this.snapshot.errors:(this.pending=!1,this.markPending(!1),this.commit(r,t)))):this.commit(i,t)}commit(t,e){if(this.custom=f(t),this.custom.length===0){const u=this.nativeMessage();u&&!this.injected.includes(u)&&(this.custom=[u])}const i=this.readCount(),r=this.composeErrors(i),s=this.snapshot.errors.length===0;this.update({errors:r,count:i,filled:o(this.resolveValue())});const n=r[0];return n&&s&&!e.silent&&this.options.announce(n,"assertive"),r}update(t){const e={...this.snapshot,...t,valid:!0,validity:this.readValidity()};e.valid=e.errors.length===0,!X(this.snapshot,e)&&(this.snapshot=e,this.sync(),this.options.onSnapshotChange(e),this.root?.dispatchEvent(new CustomEvent(I,{bubbles:!0,composed:!0,detail:{valid:e.valid,errors:e.errors,touched:e.touched,dirty:e.dirty,filled:e.filled,count:e.count,validity:e.validity}})))}scheduleValidation(){clearTimeout(this.validationTimer),this.validationTimer=void 0;const t=this.props.mode==="change"?this.props.validationDebounceTime??0:0;if(t<=0){this.runValidation();return}this.validationTimer=setTimeout(()=>{this.validationTimer=void 0,this.runValidation()},t)}hasErrorSummary(){return this.form?.querySelector(`[${C}]`)!=null}isEngineResubmit(t){return this.form?.hasAttribute("data-skdx-field-resubmit")?(this.snapshot.errors.length>0&&t.preventDefault(),!0):!1}resubmitIfSettled(){const t=this.form;if(!(!t||typeof t.requestSubmit!="function")&&!t.querySelector("[data-skdx-field-pending]")&&!t.querySelector("[data-skdx-field][data-invalid]")){t.setAttribute(c,"");try{t.requestSubmit()}finally{t.removeAttribute(c)}}}};function y(t){return typeof t?.then=="function"}function Q(t,e){return t.length===e.length&&t.every((i,r)=>i===e[r])}function X(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((i,r)=>i===e.errors[r])}exports.CHARACTER_COUNT_ANNOUNCE_DELAY_MS=S;exports.ERROR_SUMMARY_RESCAN_EVENTS=U;exports.FIELD_CHARACTER_COUNT_ATTRIBUTE=k;exports.FIELD_CONTROL_ATTRIBUTE=B;exports.FIELD_CONTROL_SELECTOR=v;exports.FIELD_DESCRIPTION_ATTRIBUTE=R;exports.FIELD_ERROR_ATTRIBUTE=_;exports.FIELD_ERROR_SUMMARY_ATTRIBUTE=C;exports.FIELD_MESSAGE_ATTRIBUTE=h;exports.FIELD_NAME_ATTRIBUTE=d;exports.FIELD_PENDING_ATTRIBUTE=L;exports.FIELD_REQUIRED_INDICATOR_ATTRIBUTE=V;exports.FIELD_RESUBMIT_ATTRIBUTE=c;exports.FIELD_ROOT_ATTRIBUTE=l;exports.FIELD_VALIDITY_CHANGE_EVENT=I;exports.FORM_FIELD_ATTRIBUTE=b;exports.FORM_MESSAGE_ATTRIBUTE=N;exports.FieldController=K;exports.NATIVE_INVALID_FALLBACK_MESSAGE=M;exports.characterCountMessage=D;exports.characterCountVisible=F;exports.collectFieldErrors=j;exports.errorSummaryScope=P;exports.findFieldControl=A;exports.focusFieldTarget=z;exports.isFilled=o;exports.normalizeMessages=f;exports.readControlValue=x;exports.resetFields=H;exports.validateFields=Y;

package/dist/utils/field-core.d.cts ADDED Viewed

@@ -0,0 +1,248 @@
+/** When a Field first runs its validator. See {@link FieldControllerProps.mode}. */
+export type FieldMode = 'change' | 'blur' | 'submit';
+/** What a validator may return: one message, several, or nothing when the value is acceptable. */
+export type FieldValidationResult = string | string[] | null | undefined | void;
+/** A Field's validator, sync or async. */
+export type FieldValidator = (value: unknown) => FieldValidationResult | Promise<FieldValidationResult>;
+/** The bubbling DOM event a Field fires whenever its snapshot changes; a Form's ErrorSummary listens for it. */
+export declare const FIELD_VALIDITY_CHANGE_EVENT = "validity-change";
+/** Marks a Field root, so the error summary can find failing fields without a registry. */
+export declare const FIELD_ROOT_ATTRIBUTE = "data-skdx-field";
+/** Marks a Field's name, used as the error-summary link text when nothing else supplies one. */
+export declare const FIELD_NAME_ATTRIBUTE = "data-skdx-field-name";
+/** The Field's current messages, written to the root on validity changes. */
+export declare const FIELD_MESSAGE_ATTRIBUTE = "data-skdx-field-message";
+/** Marks a Field's description element, so its id can be added to the control's `aria-describedby`. */
+export declare const FIELD_DESCRIPTION_ATTRIBUTE = "data-skdx-field-description";
+/** Marks a Field's error element, so its id can be added to `aria-describedby` and its text read by the summary. */
+export declare const FIELD_ERROR_ATTRIBUTE = "data-skdx-field-error";
+/** Marks a Field's character-count element, so it can be styled and found without a framework ref. */
+export declare const FIELD_CHARACTER_COUNT_ATTRIBUTE = "data-skdx-field-character-count";
+/** Marks a Field whose async validator is still running. */
+export declare const FIELD_PENDING_ATTRIBUTE = "data-skdx-field-pending";
+/** Marks the re-dispatched submit after async validators have settled. */
+export declare const FIELD_RESUBMIT_ATTRIBUTE = "data-skdx-field-resubmit";
+/** Marks a FormField root, allowing error summary to list both Field and FormField failures. */
+export declare const FORM_FIELD_ATTRIBUTE = "data-skdx-form-field";
+/** Marks a rendered FormMessage so the error summary shows the user's displayed message. */
+export declare const FORM_MESSAGE_ATTRIBUTE = "data-skdx-form-message";
+/** Events a Form ErrorSummary should re-scan on. */
+export declare const ERROR_SUMMARY_RESCAN_EVENTS: readonly ["validity-change", "invalid", "change", "blur"];
+/** Marks a Form's ErrorSummary so the engine knows whether to suppress the Field's own announcement. */
+export declare const FIELD_ERROR_SUMMARY_ATTRIBUTE = "data-skdx-error-summary";
+/** Delay in milliseconds before character count announces remaining count. */
+export declare const CHARACTER_COUNT_ANNOUNCE_DELAY_MS = 1000;
+/** What a Field's character count is configured with. */
+export interface FieldCharacterCountOptions {
+    /** The soft limit, not the native `maxlength` which truncates silently. */
+    maxLength: number;
+    /**
+     * Percentage of `maxLength` before the count appears; `0` shows it immediately.
+     * @default 0
+     */
+    threshold?: number | undefined;
+}
+/** Default count message; negative means over-limit. */
+export declare function characterCountMessage(remaining: number): string;
+/** Whether a count has passed its threshold and should be rendered/announced. */
+export declare function characterCountVisible(count: number, maxLength: number, threshold?: number): boolean;
+/** Fallback message when native constraint validation has no `validationMessage`. */
+export declare const NATIVE_INVALID_FALLBACK_MESSAGE = "This field is invalid.";
+/** Marks an element as this Field's control, an escape hatch for composites in shadow DOM. */
+export declare const FIELD_CONTROL_ATTRIBUTE = "data-skdx-field-control";
+/** Selector to find a Field's control, matching first in document order. */
+export declare const FIELD_CONTROL_SELECTOR: string;
+/** Marks a Field's required indicator for styling and assertion verification. */
+export declare const FIELD_REQUIRED_INDICATOR_ATTRIBUTE = "data-skdx-field-required-indicator";
+/** The public state of one Field, handed to the framework layer and to `validity-change` listeners. */
+export interface FieldSnapshot {
+    /** The id of the discovered control — the Label's `for`, and the error summary's link target. */
+    controlId: string;
+    /** Every current message, server-injected first. Empty means valid. */
+    errors: string[];
+    /** `errors.length === 0`. */
+    valid: boolean;
+    /** The control has been blurred at least once. */
+    touched: boolean;
+    /** The value has been edited at least once. */
+    dirty: boolean;
+    /** The control currently holds a value. */
+    filled: boolean;
+    /** Length of the control's value, tracked only while a character count is configured. */
+    count: number;
+    /** The discovered control's live `ValidityState`, or `null` when none; compared by identity to detect swaps. */
+    validity: ValidityState | null;
+}
+/** The props the framework layer forwards into the controller on every render. */
+export interface FieldControllerProps {
+    /** See {@link FieldValidator}. */
+    validate?: FieldValidator | undefined;
+    /**
+     * When validation first runs; re-validates on input after any failure.
+     * @default 'blur'
+     */
+    mode?: FieldMode | undefined;
+    /** Server-injected errors, always shown, listed before anything `validate` produces. */
+    errors?: string | string[] | undefined;
+    /** Value handed to `validate`; `undefined` reads it off the control instead. */
+    value?: unknown;
+    /** Field name, used as the error-summary link text when no error element is rendered. */
+    name?: string | undefined;
+    /**
+     * Whether an answer is mandatory, reflected as native `required` or `aria-required="true"`.
+     * @default undefined — not required.
+     */
+    required?: boolean | undefined;
+    /**
+     * Whether the field is unavailable, applied as native `disabled` or `aria-disabled="true"`.
+     * @default undefined — not disabled.
+     */
+    disabled?: boolean | undefined;
+    /**
+     * Formats the character-count message; negative `remaining` means over-limit.
+     * @default undefined — {@link characterCountMessage}'s English wording.
+     */
+    getCharacterCountMessage?: ((remaining: number) => string) | undefined;
+    /**
+     * Fallback message when native constraint validation fails without a message.
+     * @default undefined — 'This field is invalid.'
+     */
+    invalidMessage?: string | undefined;
+    /**
+     * Delay in milliseconds before `change` mode validates; `0` validates every keystroke.
+     * @default 0 — no debounce.
+     */
+    validationDebounceTime?: number | undefined;
+}
+/** Everything the controller needs that the framework layer owns. */
+export interface FieldControllerOptions {
+    /** Id of the Label element, used for a group's `aria-labelledby`. */
+    labelId: string;
+    /** Id of the Description element. */
+    descriptionId: string;
+    /** Id of the Error element. */
+    errorId: string;
+    /** Fallback id assigned to a control that has none of its own. */
+    controlId: string;
+    /** True for fieldsets where Label is legend and control uses aria-labelledby. */
+    grouped: boolean;
+    /** Called whenever the snapshot changes, so the framework layer can re-render. */
+    onSnapshotChange: (snapshot: FieldSnapshot) => void;
+    /** Announces messages to the live region with politeness picked per message. */
+    announce: (message: string, politeness: 'polite' | 'assertive') => void;
+}
+/** Coerces whatever a validator (or the `errors` prop) returned into a message list. */
+export declare function normalizeMessages(result: FieldValidationResult | string | string[]): string[];
+/** The first control inside `root` that belongs to *this* Field rather than to a nested one. */
+export declare function findFieldControl(root: Element): HTMLElement | null;
+/** Reads the current value from a control, checking checked state, value property, or hidden input. */
+export declare function readControlValue(control: HTMLElement | null): unknown;
+/** Whether a value counts as entered, for `data-filled`. */
+export declare function isFilled(value: unknown): boolean;
+/** One failing field, as listed by a Form's ErrorSummary. */
+export interface FieldErrorEntry {
+    /** The control's id — the link's `href` target. */
+    id: string;
+    /** The message shown as the link text. */
+    message: string;
+}
+/** Returns the form or skdx-form a summary should scan, falling back to its parent. */
+export declare function errorSummaryScope(root: Element): Element;
+/** Returns all currently-failing fields in scope, in document order. */
+export declare function collectFieldErrors(scope: ParentNode): FieldErrorEntry[];
+/** Runs all Fields in scope without short-circuiting, so all errors appear in ErrorSummary. */
+export declare function validateFields(scope: ParentNode): Promise<boolean>;
+/** Resets every Field's state when the form is reset, clearing messages and interaction flags. */
+export declare function resetFields(scope: ParentNode): void;
+/** Sends focus to a failing field, or to the first control inside a group. */
+export declare function focusFieldTarget(id: string, doc?: Document): void;
+/** Owns one Field's state machine, connected to its root element and re-synced on every render. */
+export declare class FieldController {
+    private readonly options;
+    private props;
+    private root;
+    private form;
+    private control;
+    /** The `aria-describedby` the consumer put on the control themselves, preserved across rewrites. */
+    private baseDescribedBy;
+    /** The `aria-labelledby` the consumer put on the control themselves, preserved across rewrites. */
+    private baseLabelledBy;
+    /** Whether this controller wrote aria-labelledby; only we may withdraw it. */
+    private wroteLabelledBy;
+    /** Whether this controller wrote required/disabled; only we may withdraw them. */
+    private wroteRequired;
+    private wroteDisabled;
+    private wroteGroupDisabled;
+    /** Bumped on every validation run; a resolution from a superseded run is discarded. */
+    private runToken;
+    private pending;
+    /** Messages from the `errors` prop, always listed first. */
+    private injected;
+    /** Messages from the last `validate` run, or the native constraint-validation fallback. */
+    private custom;
+    /** Set by a mounted character-count part; `null` while the Field has none. */
+    private characterCount;
+    private announceTimer;
+    /** Pending {@link FieldControllerProps.validationDebounceTime} run, cancelled by the next keystroke or a blur. */
+    private validationTimer;
+    /** Whether a submit is waiting on this Field's async validator to settle. */
+    private awaitingSubmit;
+    private snapshot;
+    constructor(options: FieldControllerOptions);
+    /** The current state. Read by the framework layer to render the parts. */
+    get state(): FieldSnapshot;
+    /** Replaces the forwarded props; safe to call on every render. */
+    setProps(props: FieldControllerProps): void;
+    /** Registers or clears the character count configuration. */
+    setCharacterCount(options: FieldCharacterCountOptions | null): void;
+    /** Length of the control's current value; `0` when it holds something that is not text. */
+    private readCount;
+    /** The count copy, in the consumer's wording when they supplied one. */
+    private countMessage;
+    /** True once the value is longer than the configured soft limit. */
+    private isOverLimit;
+    /** Composes errors: server errors, validation results, then over-limit message. */
+    private composeErrors;
+    /** Announces the count politely one pause after the last keystroke, or assertively on over-limit. */
+    private scheduleCountAnnouncement;
+    /** Attaches the controller to its rendered root element. */
+    connect(root: HTMLElement): void;
+    /** Detaches every listener. */
+    disconnect(): void;
+    /** Re-discovers the control and re-applies injected attributes. */
+    sync(): void;
+    private applyDescribedBy;
+    private applyLabelledBy;
+    /** Sets required and disabled on control using native attributes or ARIA as appropriate. */
+    private applyConstraintState;
+    /** A group container needs its radios disabled individually; only undo what this controller set. */
+    private applyGroupDisabled;
+    /** Runs validation now, resolving to whether the field is valid. */
+    validate(): Promise<boolean>;
+    /** Resets the field to mount state and bumps the token to cancel any async validation run. */
+    reset(): void;
+    /** Marks the field touched without validating (used by a submit pass before it validates). */
+    private markTouched;
+    private applyStateAttributes;
+    private resolveValue;
+    /** The discovered control's live `ValidityState`, when it has one. */
+    private readValidity;
+    /** Publishes (or withdraws) the "a validator is still running here" marker. */
+    private markPending;
+    private nativeMessage;
+    /** Runs validation, returning messages synchronously for sync validators. */
+    private runValidation;
+    private commit;
+    private update;
+    private readonly handleInput;
+    /** Runs validator with debounce in change mode, immediately in blur/submit mode. */
+    private scheduleValidation;
+    /** Whether this Field's form has an ErrorSummary; queried per submit since it renders conditionally. */
+    private hasErrorSummary;
+    private readonly handleFocusOut;
+    /** Whether this submit is the re-dispatch from {@link resubmitIfSettled}, which must not re-run validators. */
+    private isEngineResubmit;
+    private readonly handleSubmit;
+    /** Re-dispatches submit once all async validators have settled, avoiding loops via FIELD_RESUBMIT_ATTRIBUTE. */
+    private resubmitIfSettled;
+}

package/dist/utils/field-core.d.ts ADDED Viewed

@@ -0,0 +1,248 @@
+/** When a Field first runs its validator. See {@link FieldControllerProps.mode}. */
+export type FieldMode = 'change' | 'blur' | 'submit';
+/** What a validator may return: one message, several, or nothing when the value is acceptable. */
+export type FieldValidationResult = string | string[] | null | undefined | void;
+/** A Field's validator, sync or async. */
+export type FieldValidator = (value: unknown) => FieldValidationResult | Promise<FieldValidationResult>;
+/** The bubbling DOM event a Field fires whenever its snapshot changes; a Form's ErrorSummary listens for it. */
+export declare const FIELD_VALIDITY_CHANGE_EVENT = "validity-change";
+/** Marks a Field root, so the error summary can find failing fields without a registry. */
+export declare const FIELD_ROOT_ATTRIBUTE = "data-skdx-field";
+/** Marks a Field's name, used as the error-summary link text when nothing else supplies one. */
+export declare const FIELD_NAME_ATTRIBUTE = "data-skdx-field-name";
+/** The Field's current messages, written to the root on validity changes. */
+export declare const FIELD_MESSAGE_ATTRIBUTE = "data-skdx-field-message";
+/** Marks a Field's description element, so its id can be added to the control's `aria-describedby`. */
+export declare const FIELD_DESCRIPTION_ATTRIBUTE = "data-skdx-field-description";
+/** Marks a Field's error element, so its id can be added to `aria-describedby` and its text read by the summary. */
+export declare const FIELD_ERROR_ATTRIBUTE = "data-skdx-field-error";
+/** Marks a Field's character-count element, so it can be styled and found without a framework ref. */
+export declare const FIELD_CHARACTER_COUNT_ATTRIBUTE = "data-skdx-field-character-count";
+/** Marks a Field whose async validator is still running. */
+export declare const FIELD_PENDING_ATTRIBUTE = "data-skdx-field-pending";
+/** Marks the re-dispatched submit after async validators have settled. */
+export declare const FIELD_RESUBMIT_ATTRIBUTE = "data-skdx-field-resubmit";
+/** Marks a FormField root, allowing error summary to list both Field and FormField failures. */
+export declare const FORM_FIELD_ATTRIBUTE = "data-skdx-form-field";
+/** Marks a rendered FormMessage so the error summary shows the user's displayed message. */
+export declare const FORM_MESSAGE_ATTRIBUTE = "data-skdx-form-message";
+/** Events a Form ErrorSummary should re-scan on. */
+export declare const ERROR_SUMMARY_RESCAN_EVENTS: readonly ["validity-change", "invalid", "change", "blur"];
+/** Marks a Form's ErrorSummary so the engine knows whether to suppress the Field's own announcement. */
+export declare const FIELD_ERROR_SUMMARY_ATTRIBUTE = "data-skdx-error-summary";
+/** Delay in milliseconds before character count announces remaining count. */
+export declare const CHARACTER_COUNT_ANNOUNCE_DELAY_MS = 1000;
+/** What a Field's character count is configured with. */
+export interface FieldCharacterCountOptions {
+    /** The soft limit, not the native `maxlength` which truncates silently. */
+    maxLength: number;
+    /**
+     * Percentage of `maxLength` before the count appears; `0` shows it immediately.
+     * @default 0
+     */
+    threshold?: number | undefined;
+}
+/** Default count message; negative means over-limit. */
+export declare function characterCountMessage(remaining: number): string;
+/** Whether a count has passed its threshold and should be rendered/announced. */
+export declare function characterCountVisible(count: number, maxLength: number, threshold?: number): boolean;
+/** Fallback message when native constraint validation has no `validationMessage`. */
+export declare const NATIVE_INVALID_FALLBACK_MESSAGE = "This field is invalid.";
+/** Marks an element as this Field's control, an escape hatch for composites in shadow DOM. */
+export declare const FIELD_CONTROL_ATTRIBUTE = "data-skdx-field-control";
+/** Selector to find a Field's control, matching first in document order. */
+export declare const FIELD_CONTROL_SELECTOR: string;
+/** Marks a Field's required indicator for styling and assertion verification. */
+export declare const FIELD_REQUIRED_INDICATOR_ATTRIBUTE = "data-skdx-field-required-indicator";
+/** The public state of one Field, handed to the framework layer and to `validity-change` listeners. */
+export interface FieldSnapshot {
+    /** The id of the discovered control — the Label's `for`, and the error summary's link target. */
+    controlId: string;
+    /** Every current message, server-injected first. Empty means valid. */
+    errors: string[];
+    /** `errors.length === 0`. */
+    valid: boolean;
+    /** The control has been blurred at least once. */
+    touched: boolean;
+    /** The value has been edited at least once. */
+    dirty: boolean;
+    /** The control currently holds a value. */
+    filled: boolean;
+    /** Length of the control's value, tracked only while a character count is configured. */
+    count: number;
+    /** The discovered control's live `ValidityState`, or `null` when none; compared by identity to detect swaps. */
+    validity: ValidityState | null;
+}
+/** The props the framework layer forwards into the controller on every render. */
+export interface FieldControllerProps {
+    /** See {@link FieldValidator}. */
+    validate?: FieldValidator | undefined;
+    /**
+     * When validation first runs; re-validates on input after any failure.
+     * @default 'blur'
+     */
+    mode?: FieldMode | undefined;
+    /** Server-injected errors, always shown, listed before anything `validate` produces. */
+    errors?: string | string[] | undefined;
+    /** Value handed to `validate`; `undefined` reads it off the control instead. */
+    value?: unknown;
+    /** Field name, used as the error-summary link text when no error element is rendered. */
+    name?: string | undefined;
+    /**
+     * Whether an answer is mandatory, reflected as native `required` or `aria-required="true"`.
+     * @default undefined — not required.
+     */
+    required?: boolean | undefined;
+    /**
+     * Whether the field is unavailable, applied as native `disabled` or `aria-disabled="true"`.
+     * @default undefined — not disabled.
+     */
+    disabled?: boolean | undefined;
+    /**
+     * Formats the character-count message; negative `remaining` means over-limit.
+     * @default undefined — {@link characterCountMessage}'s English wording.
+     */
+    getCharacterCountMessage?: ((remaining: number) => string) | undefined;
+    /**
+     * Fallback message when native constraint validation fails without a message.
+     * @default undefined — 'This field is invalid.'
+     */
+    invalidMessage?: string | undefined;
+    /**
+     * Delay in milliseconds before `change` mode validates; `0` validates every keystroke.
+     * @default 0 — no debounce.
+     */
+    validationDebounceTime?: number | undefined;
+}
+/** Everything the controller needs that the framework layer owns. */
+export interface FieldControllerOptions {
+    /** Id of the Label element, used for a group's `aria-labelledby`. */
+    labelId: string;
+    /** Id of the Description element. */
+    descriptionId: string;
+    /** Id of the Error element. */
+    errorId: string;
+    /** Fallback id assigned to a control that has none of its own. */
+    controlId: string;
+    /** True for fieldsets where Label is legend and control uses aria-labelledby. */
+    grouped: boolean;
+    /** Called whenever the snapshot changes, so the framework layer can re-render. */
+    onSnapshotChange: (snapshot: FieldSnapshot) => void;
+    /** Announces messages to the live region with politeness picked per message. */
+    announce: (message: string, politeness: 'polite' | 'assertive') => void;
+}
+/** Coerces whatever a validator (or the `errors` prop) returned into a message list. */
+export declare function normalizeMessages(result: FieldValidationResult | string | string[]): string[];
+/** The first control inside `root` that belongs to *this* Field rather than to a nested one. */
+export declare function findFieldControl(root: Element): HTMLElement | null;
+/** Reads the current value from a control, checking checked state, value property, or hidden input. */
+export declare function readControlValue(control: HTMLElement | null): unknown;
+/** Whether a value counts as entered, for `data-filled`. */
+export declare function isFilled(value: unknown): boolean;
+/** One failing field, as listed by a Form's ErrorSummary. */
+export interface FieldErrorEntry {
+    /** The control's id — the link's `href` target. */
+    id: string;
+    /** The message shown as the link text. */
+    message: string;
+}
+/** Returns the form or skdx-form a summary should scan, falling back to its parent. */
+export declare function errorSummaryScope(root: Element): Element;
+/** Returns all currently-failing fields in scope, in document order. */
+export declare function collectFieldErrors(scope: ParentNode): FieldErrorEntry[];
+/** Runs all Fields in scope without short-circuiting, so all errors appear in ErrorSummary. */
+export declare function validateFields(scope: ParentNode): Promise<boolean>;
+/** Resets every Field's state when the form is reset, clearing messages and interaction flags. */
+export declare function resetFields(scope: ParentNode): void;
+/** Sends focus to a failing field, or to the first control inside a group. */
+export declare function focusFieldTarget(id: string, doc?: Document): void;
+/** Owns one Field's state machine, connected to its root element and re-synced on every render. */
+export declare class FieldController {
+    private readonly options;
+    private props;
+    private root;
+    private form;
+    private control;
+    /** The `aria-describedby` the consumer put on the control themselves, preserved across rewrites. */
+    private baseDescribedBy;
+    /** The `aria-labelledby` the consumer put on the control themselves, preserved across rewrites. */
+    private baseLabelledBy;
+    /** Whether this controller wrote aria-labelledby; only we may withdraw it. */
+    private wroteLabelledBy;
+    /** Whether this controller wrote required/disabled; only we may withdraw them. */
+    private wroteRequired;
+    private wroteDisabled;
+    private wroteGroupDisabled;
+    /** Bumped on every validation run; a resolution from a superseded run is discarded. */
+    private runToken;
+    private pending;
+    /** Messages from the `errors` prop, always listed first. */
+    private injected;
+    /** Messages from the last `validate` run, or the native constraint-validation fallback. */
+    private custom;
+    /** Set by a mounted character-count part; `null` while the Field has none. */
+    private characterCount;
+    private announceTimer;
+    /** Pending {@link FieldControllerProps.validationDebounceTime} run, cancelled by the next keystroke or a blur. */
+    private validationTimer;
+    /** Whether a submit is waiting on this Field's async validator to settle. */
+    private awaitingSubmit;
+    private snapshot;
+    constructor(options: FieldControllerOptions);
+    /** The current state. Read by the framework layer to render the parts. */
+    get state(): FieldSnapshot;
+    /** Replaces the forwarded props; safe to call on every render. */
+    setProps(props: FieldControllerProps): void;
+    /** Registers or clears the character count configuration. */
+    setCharacterCount(options: FieldCharacterCountOptions | null): void;
+    /** Length of the control's current value; `0` when it holds something that is not text. */
+    private readCount;
+    /** The count copy, in the consumer's wording when they supplied one. */
+    private countMessage;
+    /** True once the value is longer than the configured soft limit. */
+    private isOverLimit;
+    /** Composes errors: server errors, validation results, then over-limit message. */
+    private composeErrors;
+    /** Announces the count politely one pause after the last keystroke, or assertively on over-limit. */
+    private scheduleCountAnnouncement;
+    /** Attaches the controller to its rendered root element. */
+    connect(root: HTMLElement): void;
+    /** Detaches every listener. */
+    disconnect(): void;
+    /** Re-discovers the control and re-applies injected attributes. */
+    sync(): void;
+    private applyDescribedBy;
+    private applyLabelledBy;
+    /** Sets required and disabled on control using native attributes or ARIA as appropriate. */
+    private applyConstraintState;
+    /** A group container needs its radios disabled individually; only undo what this controller set. */
+    private applyGroupDisabled;
+    /** Runs validation now, resolving to whether the field is valid. */
+    validate(): Promise<boolean>;
+    /** Resets the field to mount state and bumps the token to cancel any async validation run. */
+    reset(): void;
+    /** Marks the field touched without validating (used by a submit pass before it validates). */
+    private markTouched;
+    private applyStateAttributes;
+    private resolveValue;
+    /** The discovered control's live `ValidityState`, when it has one. */
+    private readValidity;
+    /** Publishes (or withdraws) the "a validator is still running here" marker. */
+    private markPending;
+    private nativeMessage;
+    /** Runs validation, returning messages synchronously for sync validators. */
+    private runValidation;
+    private commit;
+    private update;
+    private readonly handleInput;
+    /** Runs validator with debounce in change mode, immediately in blur/submit mode. */
+    private scheduleValidation;
+    /** Whether this Field's form has an ErrorSummary; queried per submit since it renders conditionally. */
+    private hasErrorSummary;
+    private readonly handleFocusOut;
+    /** Whether this submit is the re-dispatch from {@link resubmitIfSettled}, which must not re-run validators. */
+    private isEngineResubmit;
+    private readonly handleSubmit;
+    /** Re-dispatches submit once all async validators have settled, avoiding loops via FIELD_RESUBMIT_ATTRIBUTE. */
+    private resubmitIfSettled;
+}