@skdx/vue 0.27.0 → 0.29.0

package/dist/dropdown-menu/context.d.cts

@@ -1,24 +0,0 @@
-import type { InjectionKey, Ref } from 'vue';
-/** @internal CSS selector matching enabled menu-item elements (role menuitem/checkbox/radio, not disabled) for keyboard navigation. */
-export declare const ITEM_SELECTOR = "[role^=\"menuitem\"]:not([data-disabled])";
-/** @internal Injection key a DropdownMenu provides so its parts can read/drive shared state. */
-export interface DropdownMenuContext {
-    triggerRef: Ref<HTMLElement | null>;
-    contentRef: Ref<HTMLElement | null>;
-    contentId: string;
-    open: Readonly<Ref<boolean>>;
-    setOpen(open: boolean): void;
-}
-/** @internal Injection key the DropdownMenu root provides so its Trigger and Content share open state and element refs. */
-export declare const DROPDOWN_MENU_CONTEXT: InjectionKey<DropdownMenuContext>;
-/** @internal Generates a unique id for a DropdownMenu's content. */
-export declare function nextDropdownMenuContentId(): string;
-/** @internal Shared selected-value state distributed from DropdownMenuRadioGroup to its DropdownMenuRadioItems. */
-export interface MenuRadioGroupContext {
-    value: Ref<string | undefined>;
-    onValueChange?(value: string): void;
-}
-/** @internal Injection key a DropdownMenuRadioGroup provides so its RadioItems share the selected value and change handler. */
-export declare const DROPDOWN_MENU_RADIO_GROUP_CONTEXT: InjectionKey<MenuRadioGroupContext>;
-/** @internal Whether the enclosing checkbox/radio item is checked, read by a nested DropdownMenuItemIndicator. Defaults to false (unlike other context here, not required to be nested — matches React's plain, non-throwing context). */
-export declare const DROPDOWN_MENU_ITEM_INDICATOR_CONTEXT: InjectionKey<Ref<boolean>>;

package/dist/dropdown-menu/context.d.ts

@@ -1,24 +0,0 @@
-import type { InjectionKey, Ref } from 'vue';
-/** @internal CSS selector matching enabled menu-item elements (role menuitem/checkbox/radio, not disabled) for keyboard navigation. */
-export declare const ITEM_SELECTOR = "[role^=\"menuitem\"]:not([data-disabled])";
-/** @internal Injection key a DropdownMenu provides so its parts can read/drive shared state. */
-export interface DropdownMenuContext {
-    triggerRef: Ref<HTMLElement | null>;
-    contentRef: Ref<HTMLElement | null>;
-    contentId: string;
-    open: Readonly<Ref<boolean>>;
-    setOpen(open: boolean): void;
-}
-/** @internal Injection key the DropdownMenu root provides so its Trigger and Content share open state and element refs. */
-export declare const DROPDOWN_MENU_CONTEXT: InjectionKey<DropdownMenuContext>;
-/** @internal Generates a unique id for a DropdownMenu's content. */
-export declare function nextDropdownMenuContentId(): string;
-/** @internal Shared selected-value state distributed from DropdownMenuRadioGroup to its DropdownMenuRadioItems. */
-export interface MenuRadioGroupContext {
-    value: Ref<string | undefined>;
-    onValueChange?(value: string): void;
-}
-/** @internal Injection key a DropdownMenuRadioGroup provides so its RadioItems share the selected value and change handler. */
-export declare const DROPDOWN_MENU_RADIO_GROUP_CONTEXT: InjectionKey<MenuRadioGroupContext>;
-/** @internal Whether the enclosing checkbox/radio item is checked, read by a nested DropdownMenuItemIndicator. Defaults to false (unlike other context here, not required to be nested — matches React's plain, non-throwing context). */
-export declare const DROPDOWN_MENU_ITEM_INDICATOR_CONTEXT: InjectionKey<Ref<boolean>>;

package/dist/dropdown-menu/context.js

@@ -1 +0,0 @@
-import{nextId as o}from"../utils/id.js";var n='[role^="menuitem"]:not([data-disabled])',t=/* @__PURE__ */Symbol("skdx-dropdown-menu-context");function d(){return o("dropdown-menu-content")}var e=/* @__PURE__ */Symbol("skdx-dropdown-menu-radio-group-context"),r=/* @__PURE__ */Symbol("skdx-dropdown-menu-item-indicator-context");export{t as DROPDOWN_MENU_CONTEXT,r as DROPDOWN_MENU_ITEM_INDICATOR_CONTEXT,e as DROPDOWN_MENU_RADIO_GROUP_CONTEXT,n as ITEM_SELECTOR,d as nextDropdownMenuContentId};

package/dist/dropdown-menu/index.cjs

@@ -1 +0,0 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./DropdownMenu.vue.cjs"),r=require("./DropdownMenuArrow.vue.cjs"),o=require("./DropdownMenuCheckboxItem.vue.cjs"),u=require("./DropdownMenuContent.vue.cjs"),n=require("./DropdownMenuGroup.vue.cjs"),d=require("./DropdownMenuItem.vue.cjs"),t=require("./DropdownMenuItemIndicator.vue.cjs"),i=require("./DropdownMenuLabel.vue.cjs"),p=require("./DropdownMenuPortal.vue.cjs"),M=require("./DropdownMenuRadioGroup.vue.cjs"),a=require("./DropdownMenuRadioItem.vue.cjs"),q=require("./DropdownMenuSeparator.vue.cjs"),w=require("./DropdownMenuSub.vue.cjs"),D=require("../utils/MenuSubContent.vue.cjs"),S=require("../utils/MenuSubTrigger.vue.cjs"),l=require("./DropdownMenuTrigger.vue.cjs");exports.SkdxDropdownMenu=e.default;exports.SkdxDropdownMenuArrow=r.default;exports.SkdxDropdownMenuCheckboxItem=o.default;exports.SkdxDropdownMenuContent=u.default;exports.SkdxDropdownMenuGroup=n.default;exports.SkdxDropdownMenuItem=d.default;exports.SkdxDropdownMenuItemIndicator=t.default;exports.SkdxDropdownMenuLabel=i.default;exports.SkdxDropdownMenuPortal=p.default;exports.SkdxDropdownMenuRadioGroup=M.default;exports.SkdxDropdownMenuRadioItem=a.default;exports.SkdxDropdownMenuSeparator=q.default;exports.SkdxDropdownMenuSub=w.default;exports.SkdxDropdownMenuSubContent=D.default;exports.SkdxDropdownMenuSubTrigger=S.default;exports.SkdxDropdownMenuTrigger=l.default;

package/dist/dropdown-menu/index.d.cts

@@ -1,16 +0,0 @@
-export { default as SkdxDropdownMenu } from './DropdownMenu.vue.cjs';
-export { default as SkdxDropdownMenuArrow } from './DropdownMenuArrow.vue.cjs';
-export { default as SkdxDropdownMenuCheckboxItem } from './DropdownMenuCheckboxItem.vue.cjs';
-export { default as SkdxDropdownMenuContent } from './DropdownMenuContent.vue.cjs';
-export { default as SkdxDropdownMenuGroup } from './DropdownMenuGroup.vue.cjs';
-export { default as SkdxDropdownMenuItem } from './DropdownMenuItem.vue.cjs';
-export { default as SkdxDropdownMenuItemIndicator } from './DropdownMenuItemIndicator.vue.cjs';
-export { default as SkdxDropdownMenuLabel } from './DropdownMenuLabel.vue.cjs';
-export { default as SkdxDropdownMenuPortal } from './DropdownMenuPortal.vue.cjs';
-export { default as SkdxDropdownMenuRadioGroup } from './DropdownMenuRadioGroup.vue.cjs';
-export { default as SkdxDropdownMenuRadioItem } from './DropdownMenuRadioItem.vue.cjs';
-export { default as SkdxDropdownMenuSeparator } from './DropdownMenuSeparator.vue.cjs';
-export { default as SkdxDropdownMenuSub } from './DropdownMenuSub.vue.cjs';
-export { default as SkdxDropdownMenuSubContent } from '../utils/MenuSubContent.vue.cjs';
-export { default as SkdxDropdownMenuSubTrigger } from '../utils/MenuSubTrigger.vue.cjs';
-export { default as SkdxDropdownMenuTrigger } from './DropdownMenuTrigger.vue.cjs';

package/dist/dropdown-menu/index.d.ts

@@ -1,16 +0,0 @@
-export { default as SkdxDropdownMenu } from './DropdownMenu.vue.js';
-export { default as SkdxDropdownMenuArrow } from './DropdownMenuArrow.vue.js';
-export { default as SkdxDropdownMenuCheckboxItem } from './DropdownMenuCheckboxItem.vue.js';
-export { default as SkdxDropdownMenuContent } from './DropdownMenuContent.vue.js';
-export { default as SkdxDropdownMenuGroup } from './DropdownMenuGroup.vue.js';
-export { default as SkdxDropdownMenuItem } from './DropdownMenuItem.vue.js';
-export { default as SkdxDropdownMenuItemIndicator } from './DropdownMenuItemIndicator.vue.js';
-export { default as SkdxDropdownMenuLabel } from './DropdownMenuLabel.vue.js';
-export { default as SkdxDropdownMenuPortal } from './DropdownMenuPortal.vue.js';
-export { default as SkdxDropdownMenuRadioGroup } from './DropdownMenuRadioGroup.vue.js';
-export { default as SkdxDropdownMenuRadioItem } from './DropdownMenuRadioItem.vue.js';
-export { default as SkdxDropdownMenuSeparator } from './DropdownMenuSeparator.vue.js';
-export { default as SkdxDropdownMenuSub } from './DropdownMenuSub.vue.js';
-export { default as SkdxDropdownMenuSubContent } from '../utils/MenuSubContent.vue.js';
-export { default as SkdxDropdownMenuSubTrigger } from '../utils/MenuSubTrigger.vue.js';
-export { default as SkdxDropdownMenuTrigger } from './DropdownMenuTrigger.vue.js';

package/dist/dropdown-menu/index.js

@@ -1 +0,0 @@
-import o from"./DropdownMenu.vue.js";import r from"./DropdownMenuArrow.vue.js";import n from"./DropdownMenuCheckboxItem.vue.js";import e from"./DropdownMenuContent.vue.js";import u from"./DropdownMenuGroup.vue.js";import p from"./DropdownMenuItem.vue.js";import d from"./DropdownMenuItemIndicator.vue.js";import t from"./DropdownMenuLabel.vue.js";import m from"./DropdownMenuPortal.vue.js";import s from"./DropdownMenuRadioGroup.vue.js";import w from"./DropdownMenuRadioItem.vue.js";import M from"./DropdownMenuSeparator.vue.js";import a from"./DropdownMenuSub.vue.js";import D from"../utils/MenuSubContent.vue.js";import i from"../utils/MenuSubTrigger.vue.js";import S from"./DropdownMenuTrigger.vue.js";export{o as SkdxDropdownMenu,r as SkdxDropdownMenuArrow,n as SkdxDropdownMenuCheckboxItem,e as SkdxDropdownMenuContent,u as SkdxDropdownMenuGroup,p as SkdxDropdownMenuItem,d as SkdxDropdownMenuItemIndicator,t as SkdxDropdownMenuLabel,m as SkdxDropdownMenuPortal,s as SkdxDropdownMenuRadioGroup,w as SkdxDropdownMenuRadioItem,M as SkdxDropdownMenuSeparator,a as SkdxDropdownMenuSub,D as SkdxDropdownMenuSubContent,i as SkdxDropdownMenuSubTrigger,S as SkdxDropdownMenuTrigger};

package/dist/field/fieldCore.cjs

@@ -1 +0,0 @@
-var E="validity-change",f="data-skdx-field",u="data-skdx-field-name",h="data-skdx-field-message",v="data-skdx-field-description",T="data-skdx-field-error",y="data-skdx-field-character-count",A=1e3;function g(t){const e=Math.abs(t),r=e===1?"character":"characters";return t<0?`You have ${e} ${r} too many`:`You have ${e} ${r} remaining`}function b(t,e,r=0){return r<=0?!0:t>=e*r/100}var R="This field is invalid.",I="data-skdx-field-control",C=[`[${I}]`,'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(", "),O=new Set(["radiogroup","group"]),S=['input:not([disabled]):not([type="hidden"])',"select:not([disabled])","textarea:not([disabled])","button:not([disabled])",'[tabindex]:not([tabindex="-1"])'].join(", ");function d(t){return t==null?[]:(Array.isArray(t)?t:[t]).filter(e=>typeof e=="string"&&e.trim()!=="")}function p(t){for(const e of Array.from(t.querySelectorAll(C)))if(e.getAttribute("aria-hidden")!=="true"&&e.closest("[data-skdx-field]")===t)return e;return null}function c(t,e){for(const r of Array.from(t.querySelectorAll(e)))if(r.closest("[data-skdx-field]")===t)return r;return null}function L(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 l(t){return t==null||t===!1||t===""?!1:!(Array.isArray(t)&&t.length===0)}function o(t,e,r){r?t.setAttribute(e,""):t.removeAttribute(e)}function D(t,...e){const r=t.split(/\s+/).filter(Boolean);for(const i of e)i&&!r.includes(i)&&r.push(i);return r.join(" ")}function F(t){return t.closest("form, skdx-form")??t.parentElement??t}function x(t){return Array.from(t.querySelectorAll(`[${f}][data-invalid]`)).flatMap(e=>{const r=p(e),i=c(e,"[data-skdx-field-error]")?.textContent?.trim()||e.getAttribute("data-skdx-field-message")||e.getAttribute("data-skdx-field-name")||"";return!r?.id||!i?[]:[{id:r.id,message:i}]})}function N(t,e=document){const r=e.getElementById(t);if(!r)return;const i=r.getAttribute("role"),s=(r.tagName==="FIELDSET"||i!==null&&O.has(i)?r.querySelector(S):null)??r;s.focus(),s.scrollIntoView?.({block:"center"})}var V=class{constructor(t){this.options=t,this.props={},this.root=null,this.form=null,this.control=null,this.baseDescribedBy="",this.runToken=0,this.pending=!1,this.injected=[],this.custom=[],this.characterCount=null,this.handleInput=()=>{const e=this.isOverLimit(this.snapshot.count),r=this.readCount();this.update({dirty:!0,filled:l(this.resolveValue()),count:r,errors:this.composeErrors(r)}),this.scheduleCountAnnouncement(r,e),(this.props.mode==="change"||this.snapshot.errors.length>0)&&this.runValidation()},this.handleFocusOut=()=>{const e=this.readCount();this.update({touched:!0,filled:l(this.resolveValue()),count:e,errors:this.composeErrors(e)}),((this.props.mode??"blur")==="blur"||this.snapshot.errors.length>0)&&this.runValidation()},this.handleSubmit=e=>{if(e.target?.closest?.("form")!==this.form)return;this.markTouched();const r=this.runValidation({silent:!0});if(m(r)){e.preventDefault();return}(r.length>0||this.pending)&&e.preventDefault()},this.snapshot={controlId:t.controlId,errors:[],valid:!0,touched:!1,dirty:!1,filled:!1,count:0}}get state(){return this.snapshot}setProps(t){this.props=t;const e=d(t.errors??null);B(this.injected,e)||(this.injected=e,this.update({errors:this.composeErrors()}))}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??g)(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 r=this.characterCount;if(!r)return;if(clearTimeout(this.announceTimer),this.isOverLimit(t)){e||this.options.announce(this.countMessage(r.maxLength-t),"assertive");return}if(!b(t,r.maxLength,r.threshold))return;const i=r.maxLength-t;this.announceTimer=setTimeout(()=>{this.options.announce(this.countMessage(i),"polite")},A)}connect(t){this.root=t,t.setAttribute(f,""),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:l(this.resolveValue()),count:e,errors:this.composeErrors(e)})}disconnect(){clearTimeout(this.announceTimer);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),this.root=null,this.form=null,this.control=null)}sync(){const t=this.root;if(!t)return;const e=p(t);e!==this.control&&(this.control=e,this.baseDescribedBy=e?.getAttribute("aria-describedby")??"");const{name:r}=this.props;r?t.setAttribute(u,r):t.removeAttribute(u);const i=this.snapshot.errors.join(" ");if(i?t.setAttribute(h,i):t.removeAttribute(h),this.applyStateAttributes(t),!e)return;e.id||(e.id=this.options.controlId),e.id!==this.snapshot.controlId&&(this.snapshot={...this.snapshot,controlId:e.id},this.options.onSnapshotChange(this.snapshot));const s=c(t,`[${v}]`)!==null,n=c(t,`[${T}]`)!==null,a=D(this.baseDescribedBy,s?this.options.descriptionId:void 0,n?this.options.errorId:void 0);a?e.setAttribute("aria-describedby",a):e.removeAttribute("aria-describedby"),this.snapshot.errors.length>0?e.setAttribute("aria-invalid","true"):e.removeAttribute("aria-invalid");const _=t.ownerDocument.getElementById(this.options.labelId)!==null;this.options.grouped&&_?e.setAttribute("aria-labelledby",this.options.labelId):e.getAttribute("aria-labelledby")===this.options.labelId&&e.removeAttribute("aria-labelledby"),this.applyStateAttributes(e)}validate(){return Promise.resolve(this.runValidation()).then(t=>t.length===0)}markTouched(){this.snapshot.touched||this.update({touched:!0})}applyStateAttributes(t){const{errors:e,touched:r,dirty:i,filled:s,count:n}=this.snapshot;o(t,"data-invalid",e.length>0),o(t,"data-valid",e.length===0),o(t,"data-touched",r),o(t,"data-dirty",i),o(t,"data-filled",s),o(t,"data-over-limit",this.isOverLimit(n))}resolveValue(){return this.props.value!==void 0?this.props.value:L(this.control)}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,r=this.props.validate?.(this.resolveValue());return m(r)?(this.pending=!0,Promise.resolve(r).then(i=>e!==this.runToken?this.snapshot.errors:(this.pending=!1,this.commit(i,t)))):this.commit(r,t)}commit(t,e){if(this.custom=d(t),this.custom.length===0&&this.injected.length===0){const a=this.nativeMessage();a&&(this.custom=[a])}const r=this.readCount(),i=this.composeErrors(r),s=this.snapshot.errors.length===0;this.update({errors:i,count:r,filled:l(this.resolveValue())});const n=i[0];return n&&s&&!e.silent&&this.options.announce(n,"assertive"),i}update(t){const e={...this.snapshot,...t,valid:!0};e.valid=e.errors.length===0,!M(this.snapshot,e)&&(this.snapshot=e,this.sync(),this.options.onSnapshotChange(e),this.root?.dispatchEvent(new CustomEvent(E,{bubbles:!0,composed:!0,detail:{valid:e.valid,errors:e.errors,touched:e.touched,dirty:e.dirty,filled:e.filled,count:e.count}})))}};function m(t){return typeof t?.then=="function"}function B(t,e){return t.length===e.length&&t.every((r,i)=>r===e[i])}function M(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.errors.length===e.errors.length&&t.errors.every((r,i)=>r===e.errors[i])}exports.CHARACTER_COUNT_ANNOUNCE_DELAY_MS=A;exports.FIELD_CHARACTER_COUNT_ATTRIBUTE=y;exports.FIELD_CONTROL_ATTRIBUTE=I;exports.FIELD_CONTROL_SELECTOR=C;exports.FIELD_DESCRIPTION_ATTRIBUTE=v;exports.FIELD_ERROR_ATTRIBUTE=T;exports.FIELD_MESSAGE_ATTRIBUTE=h;exports.FIELD_NAME_ATTRIBUTE=u;exports.FIELD_ROOT_ATTRIBUTE=f;exports.FIELD_VALIDITY_CHANGE_EVENT=E;exports.FieldController=V;exports.NATIVE_INVALID_FALLBACK_MESSAGE=R;exports.characterCountMessage=g;exports.characterCountVisible=b;exports.collectFieldErrors=x;exports.errorSummaryScope=F;exports.findFieldControl=p;exports.focusFieldTarget=N;exports.isFilled=l;exports.normalizeMessages=d;exports.readControlValue=L;

package/dist/field/fieldCore.d.cts

@@ -1,284 +0,0 @@
-/**
- * The framework-free engine behind `Field`. Everything here is plain DOM
- * work — discovering the control inside a Field, injecting the ARIA wiring
- * onto it, running the validation model, and mirroring the interaction state
- * as `data-*` — so all five framework packages run the *same* algorithm and
- * the shared `assertFieldContract` assertions mean the same thing everywhere.
- *
- * The framework layer above this only ever: creates a controller, hands it
- * props, calls `sync()` after each render, and re-renders when the controller
- * says its snapshot changed.
- *
- * See `reports/design-system-competitive-audit/14-rfc-field-fieldset-validation.md`.
- */
-/** 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 straight onto the root the moment
- * validity changes.
- *
- * This exists so the error summary never depends on a framework's render
- * timing: a Field dispatches `validity-change` synchronously from its own DOM
- * listener, *before* React/Vue/Angular/Lit have rendered the Error element, so
- * a summary that could only read that element's text would scan a field that
- * is already `data-invalid` and find nothing to link to.
- */
-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";
-/**
- * How long the character count waits after the last keystroke before it
- * announces the remaining count.
- *
- * GOV.UK's number, and the reason it exists: a live region that fires on every
- * keystroke reads a running commentary over the character the user just typed.
- * One announcement per typing pause is the whole point of the pattern.
- */
-export declare const CHARACTER_COUNT_ANNOUNCE_DELAY_MS = 1000;
-/** What a Field's character count is configured with. */
-export interface FieldCharacterCountOptions {
-    /** The soft limit. Deliberately *not* the control's native `maxlength`, which truncates silently. */
-    maxLength: number;
-    /**
-     * Percentage of `maxLength` that must be typed before the count is shown and
-     * announced at all. `0` shows it from the first render.
-     * @default 0
-     */
-    threshold?: number;
-}
-/** The default count copy, in GOV.UK's wording. Negative `remaining` means over the 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;
-/**
- * Used when a control fails native constraint validation but the engine
- * reports no message of its own (jsdom and some browsers leave
- * `validationMessage` empty). A Field is never invalid without something to
- * say, because an error with no message is unannounceable.
- */
-export declare const NATIVE_INVALID_FALLBACK_MESSAGE = "This field is invalid.";
-/**
- * Opt-in marker saying "I am my Field's control". Discovery's escape hatch for
- * a composite whose role element the Field cannot reach: `<skdx-date-field>`
- * keeps its `role="group"` in a shadow root, so only the host is findable from
- * the Field's light DOM.
- */
-export declare const FIELD_CONTROL_ATTRIBUTE = "data-skdx-field-control";
-/**
- * How a Field recognises the control it wraps. First match in document order
- * wins, which is why group roles work: a `[role="radiogroup"]` precedes the
- * radios inside it.
- */
-export declare const FIELD_CONTROL_SELECTOR: string;
-/** 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 props the framework layer forwards into the controller on every render. */
-export interface FieldControllerProps {
-    /** See {@link FieldValidator}. */
-    validate?: FieldValidator;
-    /**
-     * When validation first runs. After a failure the field re-validates on
-     * every input regardless, so an error clears as soon as it is fixed.
-     * @default 'blur'
-     */
-    mode?: FieldMode;
-    /** Server-injected errors, always shown, listed before anything `validate` produces. */
-    errors?: string | string[];
-    /** 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;
-    /**
-     * Words the character-count copy — the text `SkdxFieldCharacterCount` renders,
-     * the message announced one typing pause later, and the error raised once
-     * the value goes over the soft limit. A negative `remaining` means over the
-     * limit.
-     * @default undefined — {@link characterCountMessage}'s English wording.
-     */
-    getCharacterCountMessage?: (remaining: number) => string;
-    /**
-     * Replaces {@link NATIVE_INVALID_FALLBACK_MESSAGE}: what the Field says when
-     * the wrapped control fails native constraint validation but the engine
-     * reports no message of its own.
-     * @default undefined — 'This field is invalid.'
-     */
-    invalidMessage?: string;
-}
-/** 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 a `Fieldset`: the Label is a `<legend>` and the control is labelled by `aria-labelledby`. */
-    grouped: boolean;
-    /** Called whenever the snapshot changes, so the framework layer can re-render. */
-    onSnapshotChange: (snapshot: FieldSnapshot) => void;
-    /**
-     * The live-region `announce`. The engine picks the politeness per message, because
-     * the two things it says want different ones: an error the user has already
-     * moved past interrupts, a running character count must not.
-     */
-    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;
-/**
- * The value a validator sees when the consumer passed none: a checkbox or
- * radio reports `checked`, everything else reports its `value` property, and a
- * composite root that has no `value` of its own (a `role="group"` segmented
- * field, a `role="radiogroup"`) reports whatever its form-participation input
- * would submit.
- *
- * ponytail: a composite control that keeps its value only in framework state
- * and mirrors it nowhere — no `value` property, and no `name` so no hidden
- * input either — needs the explicit `value` prop. Pass it if you build one.
- */
-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;
-}
-/**
- * The form (or `<skdx-form>`) a summary should scan and listen on, falling
- * back to the summary's own parent when it is used standalone.
- */
-export declare function errorSummaryScope(root: Element): Element;
-/** Every currently-failing Field in `scope`, in document order — the summary's list. */
-export declare function collectFieldErrors(scope: ParentNode): FieldErrorEntry[];
-/**
- * Sends focus to a failing field the GOV.UK way: straight to the control,
- * unless the target is a group — then to the first control inside it, because
- * focusing a `<fieldset>`/`[role="radiogroup"]` announces the group but leaves
- * the user with nothing to operate.
- */
-export declare function focusFieldTarget(id: string, doc?: Document): void;
-/**
- * Owns one Field's state machine. Created by the framework layer, given the
- * Field's root element on `connect()`, and told about re-renders via `sync()`.
- */
-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;
-    /** 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;
-    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. Called by the count part on
-     * mount, on prop change, and on unmount.
-     */
-    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;
-    /**
-     * Server errors first, then whatever the last validation run produced, then
-     * the over-limit message — so going over the limit makes the Field invalid
-     * through exactly the same path as any other error, and blocks submit.
-     */
-    private composeErrors;
-    /**
-     * Says the count, sparingly. Under the limit it is queued politely, one
-     * typing pause after the last keystroke, so a burst of typing produces one
-     * number instead of a running commentary. Crossing the limit interrupts —
-     * once, on the transition, not on every keystroke past it.
-     *
-     * The over-limit message cannot ride on `commit()`'s error announcement: by
-     * the time validation runs, `update()` has already put the message into
-     * `errors`, so `commit()` no longer sees the field as newly-invalid.
-     */
-    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 every injected attribute. The
-     * framework layer calls this after each render, because a render may have
-     * swapped the control or mounted/unmounted the Description or Error.
-     */
-    sync(): void;
-    /**
-     * Runs validation now. Resolves to whether the field is valid — the
-     * imperative entry point `<skdx-field>.validate()` and Angular's
-     * `SkdxFieldComponent.validate()` expose directly.
-     */
-    validate(): Promise<boolean>;
-    /** Marks the field touched without validating (used by a submit pass before it validates). */
-    private markTouched;
-    private applyStateAttributes;
-    private resolveValue;
-    private nativeMessage;
-    /**
-     * Returns the new message list — synchronously for a sync validator, which
-     * is what lets the submit handler decide whether to `preventDefault()`
-     * before the browser submits.
-     */
-    private runValidation;
-    private commit;
-    private update;
-    private readonly handleInput;
-    private readonly handleFocusOut;
-    private readonly handleSubmit;
-}