@skdx/web-components 0.28.0 → 0.29.0

package/dist/field/field-core.d.cts

@@ -1,242 +0,0 @@
-/** The framework-free Field engine: discovers the control, injects ARIA, runs validation, mirrors state. */
-/** When a Field first runs its validator. See {@link FieldControllerProps.mode}. */
-export type FieldMode = 'change' | 'blur' | 'submit';
-/** Validator result: one message, several, or nothing (meaning valid). */
-export type FieldValidationResult = string | string[] | null | undefined | void;
-/** A Field's validator, sync or async. */
-export type FieldValidator = (value: unknown) => FieldValidationResult | Promise<FieldValidationResult>;
-/** Bubbling event fired whenever the Field's snapshot changes. */
-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 when 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; its id is added to `aria-describedby`. */
-export declare const FIELD_ERROR_ATTRIBUTE = "data-skdx-field-error";
-/** Marks a Field's character-count element for styling and discovery. */
-export declare const FIELD_CHARACTER_COUNT_ATTRIBUTE = "data-skdx-field-character-count";
-/** Marks a Field whose validator is still running. */
-export declare const FIELD_PENDING_ATTRIBUTE = "data-skdx-field-pending";
-/** Marks the submit the engine re-dispatches once all pending Fields settle. */
-export declare const FIELD_RESUBMIT_ATTRIBUTE = "data-skdx-field-resubmit";
-/** Marks a FormField root, the native-validation pair to Field. */
-export declare const FORM_FIELD_ATTRIBUTE = "data-skdx-form-field";
-/** Marks a rendered FormMessage so the error summary can find link text. */
-export declare const FORM_MESSAGE_ATTRIBUTE = "data-skdx-form-message";
-/** Events the error summary monitors to re-scan failing fields. */
-export declare const ERROR_SUMMARY_RESCAN_EVENTS: readonly ["validity-change", "invalid", "change", "blur"];
-/** Marks a Form's ErrorSummary. */
-export declare const FIELD_ERROR_SUMMARY_ATTRIBUTE = "data-skdx-error-summary";
-/** Delay (ms) before announcing remaining character count after typing stops. */
-export declare const CHARACTER_COUNT_ANNOUNCE_DELAY_MS = 1000;
-/** Configures a Field's character count. */
-export interface FieldCharacterCountOptions {
-    /** Soft limit, not a hard truncation like maxlength. */
-    maxLength: number;
-    /**
-     * Percentage of maxLength before the count displays and announces.
-     * @default 0
-     */
-    threshold?: number;
-}
-/** Default character-count message; negative remaining 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 validation fails with no validationMessage. */
-export declare const NATIVE_INVALID_FALLBACK_MESSAGE = "This field is invalid.";
-/** Marks an element as its Field's control, for composites with shadow roots. */
-export declare const FIELD_CONTROL_ATTRIBUTE = "data-skdx-field-control";
-/** Selector finding the control a Field wraps; first match wins. */
-export declare const FIELD_CONTROL_SELECTOR: string;
-/** Marks a Field's required indicator for styling and assertion checks. */
-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[];
-    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 control's live ValidityState, or null if not applicable. */
-    validity: ValidityState | null;
-}
-/** Props forwarded to the controller on each render. */
-export interface FieldControllerProps {
-    /** The validator function. See {@link FieldValidator}. */
-    validate?: FieldValidator;
-    /**
-     * When validation first runs; after failure, re-validates on every change.
-     * @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;
-    /**
-     * Whether an answer is mandatory, reflected as required or aria-required.
-     * @default undefined — not required.
-     */
-    required?: boolean;
-    /**
-     * Whether the field is unavailable, reflected as disabled or aria-disabled.
-     * @default undefined — not disabled.
-     */
-    disabled?: boolean;
-    /**
-     * Words the character-count message; negative remaining means over limit.
-     * @default undefined — {@link characterCountMessage}'s English wording.
-     */
-    getCharacterCountMessage?: (remaining: number) => string;
-    /**
-     * Fallback message when native validation fails with no validationMessage.
-     * @default undefined — 'This field is invalid.'
-     */
-    invalidMessage?: string;
-    /**
-     * Milliseconds to wait after the last keystroke in change mode before validating.
-     * @default 0 — no debounce.
-     */
-    validationDebounceTime?: number;
-}
-/** Data the controller needs from the framework layer. */
-export interface FieldControllerOptions {
-    /** Label element id, used for group aria-labelledby. */
-    labelId: string;
-    /** Description element id. */
-    descriptionId: string;
-    /** Error element id. */
-    errorId: string;
-    /** Fallback id for controls with none. */
-    controlId: string;
-    /** True for Fieldset: Legend label with aria-labelledby. */
-    grouped: boolean;
-    /** Called when snapshot changes, to trigger framework re-render. */
-    onSnapshotChange: (snapshot: FieldSnapshot) => void;
-    /** Live-region announce with politeness level (polite or assertive). */
-    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[];
-/** First control inside root belonging to this Field, not a nested one. */
-export declare function findFieldControl(root: Element): HTMLElement | null;
-/** Value a validator sees when none provided: checked for radio/checkbox, value property otherwise. */
-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;
-/** All currently-failing fields in scope, in document order. */
-export declare function collectFieldErrors(scope: ParentNode): FieldErrorEntry[];
-/** Runs every Field in scope; resolves to whether all passed. */
-export declare function validateFields(scope: ParentNode): Promise<boolean>;
-/** Resets every Field in scope when the form fires reset. */
-export declare function resetFields(scope: ParentNode): void;
-/** Focuses a failing field; for groups, focuses the first control inside. */
-export declare function focusFieldTarget(id: string, doc?: Document): void;
-/** State machine for one Field; created and driven by the framework layer. */
-export declare class FieldController {
-    private readonly options;
-    private props;
-    private root;
-    private form;
-    private control;
-    private baseDescribedBy;
-    private baseLabelledBy;
-    /** Whether this controller wrote the control's aria-labelledby. */
-    private wroteLabelledBy;
-    /** Whether this controller wrote the control's required/disabled state. */
-    private wroteRequired;
-    private wroteDisabled;
-    private runToken;
-    private pending;
-    private injected;
-    private custom;
-    private characterCount;
-    private announceTimer;
-    private validationTimer;
-    private awaitingSubmit;
-    private snapshot;
-    constructor(options: FieldControllerOptions);
-    /** The current state. Read by the framework layer to render the parts. */
-    get state(): FieldSnapshot;
-    /** Replaces forwarded props; safe to call on every render. */
-    setProps(props: FieldControllerProps): void;
-    /** Registers or clears the character count (called on mount/prop change/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;
-    /** Announces the character count sparsely: politely under limit, assertively crossing it. */
-    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;
-    /** Applies required/disabled in the vocabulary the control understands. */
-    private applyConstraintState;
-    /** Runs validation now; imperative entry point published as checkValidity(). */
-    validate(): Promise<boolean>;
-    /** Resets the field to mount state: clears messages/touched/dirty, re-derives filled/count. */
-    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;
-    /** Returns message list: sync for sync validators, promise for async. */
-    private runValidation;
-    private commit;
-    private update;
-    private readonly handleInput;
-    /** Runs validator after debounce in change mode, immediately otherwise. */
-    private scheduleValidation;
-    /** Whether this Field's form renders an ErrorSummary (queried per submit). */
-    private hasErrorSummary;
-    private readonly handleFocusOut;
-    /** Whether this submit is the one the engine re-dispatched. */
-    private isEngineResubmit;
-    private readonly handleSubmit;
-    /** Re-dispatches submit once all Fields settle, using requestSubmit() for trust. */
-    private resubmitIfSettled;
-}

package/dist/field/field-core.d.ts

@@ -1,242 +0,0 @@
-/** The framework-free Field engine: discovers the control, injects ARIA, runs validation, mirrors state. */
-/** When a Field first runs its validator. See {@link FieldControllerProps.mode}. */
-export type FieldMode = 'change' | 'blur' | 'submit';
-/** Validator result: one message, several, or nothing (meaning valid). */
-export type FieldValidationResult = string | string[] | null | undefined | void;
-/** A Field's validator, sync or async. */
-export type FieldValidator = (value: unknown) => FieldValidationResult | Promise<FieldValidationResult>;
-/** Bubbling event fired whenever the Field's snapshot changes. */
-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 when 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; its id is added to `aria-describedby`. */
-export declare const FIELD_ERROR_ATTRIBUTE = "data-skdx-field-error";
-/** Marks a Field's character-count element for styling and discovery. */
-export declare const FIELD_CHARACTER_COUNT_ATTRIBUTE = "data-skdx-field-character-count";
-/** Marks a Field whose validator is still running. */
-export declare const FIELD_PENDING_ATTRIBUTE = "data-skdx-field-pending";
-/** Marks the submit the engine re-dispatches once all pending Fields settle. */
-export declare const FIELD_RESUBMIT_ATTRIBUTE = "data-skdx-field-resubmit";
-/** Marks a FormField root, the native-validation pair to Field. */
-export declare const FORM_FIELD_ATTRIBUTE = "data-skdx-form-field";
-/** Marks a rendered FormMessage so the error summary can find link text. */
-export declare const FORM_MESSAGE_ATTRIBUTE = "data-skdx-form-message";
-/** Events the error summary monitors to re-scan failing fields. */
-export declare const ERROR_SUMMARY_RESCAN_EVENTS: readonly ["validity-change", "invalid", "change", "blur"];
-/** Marks a Form's ErrorSummary. */
-export declare const FIELD_ERROR_SUMMARY_ATTRIBUTE = "data-skdx-error-summary";
-/** Delay (ms) before announcing remaining character count after typing stops. */
-export declare const CHARACTER_COUNT_ANNOUNCE_DELAY_MS = 1000;
-/** Configures a Field's character count. */
-export interface FieldCharacterCountOptions {
-    /** Soft limit, not a hard truncation like maxlength. */
-    maxLength: number;
-    /**
-     * Percentage of maxLength before the count displays and announces.
-     * @default 0
-     */
-    threshold?: number;
-}
-/** Default character-count message; negative remaining 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 validation fails with no validationMessage. */
-export declare const NATIVE_INVALID_FALLBACK_MESSAGE = "This field is invalid.";
-/** Marks an element as its Field's control, for composites with shadow roots. */
-export declare const FIELD_CONTROL_ATTRIBUTE = "data-skdx-field-control";
-/** Selector finding the control a Field wraps; first match wins. */
-export declare const FIELD_CONTROL_SELECTOR: string;
-/** Marks a Field's required indicator for styling and assertion checks. */
-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[];
-    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 control's live ValidityState, or null if not applicable. */
-    validity: ValidityState | null;
-}
-/** Props forwarded to the controller on each render. */
-export interface FieldControllerProps {
-    /** The validator function. See {@link FieldValidator}. */
-    validate?: FieldValidator;
-    /**
-     * When validation first runs; after failure, re-validates on every change.
-     * @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;
-    /**
-     * Whether an answer is mandatory, reflected as required or aria-required.
-     * @default undefined — not required.
-     */
-    required?: boolean;
-    /**
-     * Whether the field is unavailable, reflected as disabled or aria-disabled.
-     * @default undefined — not disabled.
-     */
-    disabled?: boolean;
-    /**
-     * Words the character-count message; negative remaining means over limit.
-     * @default undefined — {@link characterCountMessage}'s English wording.
-     */
-    getCharacterCountMessage?: (remaining: number) => string;
-    /**
-     * Fallback message when native validation fails with no validationMessage.
-     * @default undefined — 'This field is invalid.'
-     */
-    invalidMessage?: string;
-    /**
-     * Milliseconds to wait after the last keystroke in change mode before validating.
-     * @default 0 — no debounce.
-     */
-    validationDebounceTime?: number;
-}
-/** Data the controller needs from the framework layer. */
-export interface FieldControllerOptions {
-    /** Label element id, used for group aria-labelledby. */
-    labelId: string;
-    /** Description element id. */
-    descriptionId: string;
-    /** Error element id. */
-    errorId: string;
-    /** Fallback id for controls with none. */
-    controlId: string;
-    /** True for Fieldset: Legend label with aria-labelledby. */
-    grouped: boolean;
-    /** Called when snapshot changes, to trigger framework re-render. */
-    onSnapshotChange: (snapshot: FieldSnapshot) => void;
-    /** Live-region announce with politeness level (polite or assertive). */
-    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[];
-/** First control inside root belonging to this Field, not a nested one. */
-export declare function findFieldControl(root: Element): HTMLElement | null;
-/** Value a validator sees when none provided: checked for radio/checkbox, value property otherwise. */
-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;
-/** All currently-failing fields in scope, in document order. */
-export declare function collectFieldErrors(scope: ParentNode): FieldErrorEntry[];
-/** Runs every Field in scope; resolves to whether all passed. */
-export declare function validateFields(scope: ParentNode): Promise<boolean>;
-/** Resets every Field in scope when the form fires reset. */
-export declare function resetFields(scope: ParentNode): void;
-/** Focuses a failing field; for groups, focuses the first control inside. */
-export declare function focusFieldTarget(id: string, doc?: Document): void;
-/** State machine for one Field; created and driven by the framework layer. */
-export declare class FieldController {
-    private readonly options;
-    private props;
-    private root;
-    private form;
-    private control;
-    private baseDescribedBy;
-    private baseLabelledBy;
-    /** Whether this controller wrote the control's aria-labelledby. */
-    private wroteLabelledBy;
-    /** Whether this controller wrote the control's required/disabled state. */
-    private wroteRequired;
-    private wroteDisabled;
-    private runToken;
-    private pending;
-    private injected;
-    private custom;
-    private characterCount;
-    private announceTimer;
-    private validationTimer;
-    private awaitingSubmit;
-    private snapshot;
-    constructor(options: FieldControllerOptions);
-    /** The current state. Read by the framework layer to render the parts. */
-    get state(): FieldSnapshot;
-    /** Replaces forwarded props; safe to call on every render. */
-    setProps(props: FieldControllerProps): void;
-    /** Registers or clears the character count (called on mount/prop change/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;
-    /** Announces the character count sparsely: politely under limit, assertively crossing it. */
-    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;
-    /** Applies required/disabled in the vocabulary the control understands. */
-    private applyConstraintState;
-    /** Runs validation now; imperative entry point published as checkValidity(). */
-    validate(): Promise<boolean>;
-    /** Resets the field to mount state: clears messages/touched/dirty, re-derives filled/count. */
-    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;
-    /** Returns message list: sync for sync validators, promise for async. */
-    private runValidation;
-    private commit;
-    private update;
-    private readonly handleInput;
-    /** Runs validator after debounce in change mode, immediately otherwise. */
-    private scheduleValidation;
-    /** Whether this Field's form renders an ErrorSummary (queried per submit). */
-    private hasErrorSummary;
-    private readonly handleFocusOut;
-    /** Whether this submit is the one the engine re-dispatched. */
-    private isEngineResubmit;
-    private readonly handleSubmit;
-    /** Re-dispatches submit once all Fields settle, using requestSubmit() for trust. */
-    private resubmitIfSettled;
-}

package/dist/field/field-core.js

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

package/dist/hover-card/HoverCard.cjs

@@ -1 +0,0 @@
-"use strict";var m=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var w=(r,t)=>{for(var e in t)m(r,e,{get:t[e],enumerable:!0})},v=(r,t,e,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of g(t))!u.call(r,o)&&o!==e&&m(r,o,{get:()=>t[o],enumerable:!(n=h(t,o))||n.enumerable});return r};var E=r=>v(m({},"__esModule",{value:!0}),r),a=(r,t,e,n)=>{for(var o=n>1?void 0:n?h(t,e):t,p=r.length-1,d;p>=0;p--)(d=r[p])&&(o=(n?d(t,e,o):d(o))||o);return n&&o&&m(t,e,o),o};var F={};w(F,{SkdxHoverCard:()=>i});module.exports=E(F);var c=require("lit"),s=require("lit/decorators.js"),f=require("../internal/authored.cjs"),y=require("../internal/define.cjs"),l=require("./HoverCardAnatomy.cjs"),A=require("./HoverCardRoot.cjs");var i=class extends A.SkdxHoverCardRoot{constructor(){super(...arguments);this.side="bottom";this.align="center";this.showArrow=!1;this._anatomyFilledFor="";this.fillAnatomy=()=>{let e=String(this.showArrow);e!==this._anatomyFilledFor||!(0,f.hasGeneratedContent)(this,l.HOVER_CARD_ANATOMY_GENERATED)?(this._anatomyFilledFor=e,(0,l.fillHoverCardAnatomy)(this)):(0,l.refreshHoverCardAnatomy)(this)}}connectedCallback(){super.connectedCallback(),queueMicrotask(this.fillAnatomy)}updated(e){this.fillAnatomy(),super.updated(e)}render(){return c.html`<slot @slotchange=${this.fillAnatomy}></slot>`}};a([(0,s.property)({type:String})],i.prototype,"href",2),a([(0,s.property)({type:String})],i.prototype,"side",2),a([(0,s.property)({type:String})],i.prototype,"align",2),a([(0,s.property)({type:Boolean,attribute:"show-arrow"})],i.prototype,"showArrow",2),i=a([(0,y.customElement)("skdx-hover-card")],i);0&&(module.exports={SkdxHoverCard});

package/dist/hover-card/HoverCard.d.cts

@@ -1,58 +0,0 @@
-import type { Align, Side } from '../internal/positioning.cjs';
-import { SkdxHoverCardRoot } from './HoverCardRoot.cjs';
-/**
- * Renders canonical hover card anatomy: trigger from `slot="trigger"`
- * children with optional link target, and content card holding remaining
- * children with optional arrow. Children are always card body, never parts.
- *
- * For hand composition, use `<skdx-hover-card-root>` from
- * `@skdx/web-components/primitives/hover-card`.
- *
- * @example
- * ```html
- * <skdx-hover-card href="/users/kent">
- *   <span slot="trigger">@kentcdodds</span>
- *   Kent C. Dodds
- * </skdx-hover-card>
- * ```
- *
- * @fires open-change - Fired with the new open state whenever it changes, controlled or not.
- * @fires open-change-complete - Fired once the content's enter or exit animation finishes, or as soon as it settles when it declares none; not cancelable.
- */
-export declare class SkdxHoverCard extends SkdxHoverCardRoot {
-    /**
-     * Link target for the derived trigger, and a keyboard or touch user's only route to what the card previews.
-     * @default undefined — a plain, non-navigating trigger.
-     */
-    href?: string;
-    /**
-     * Preferred edge of the trigger the derived content card is placed against.
-     * @default 'bottom'
-     */
-    side: Side;
-    /**
-     * Preferred alignment along the `side` edge; the floating layer may shift it to keep the card in the viewport.
-     * @default 'center'
-     */
-    align: Align;
-    /**
-     * Whether the derived content includes an arrow pointing back at the trigger.
-     * @default false
-     */
-    showArrow: boolean;
-    private _anatomyFilledFor;
-    connectedCallback(): void;
-    /**
-     * Draws the canonical anatomy into the light DOM. Rebuilding tears down
-     * positioning state, so it's gated on the key that changes the anatomy's
-     * shape; `href`/`side`/`align` refresh in place instead.
-     */
-    private readonly fillAnatomy;
-    protected updated(changed: Map<string, unknown>): void;
-    render(): import("lit").TemplateResult<1>;
-}
-declare global {
-    interface HTMLElementTagNameMap {
-        'skdx-hover-card': SkdxHoverCard;
-    }
-}

package/dist/hover-card/HoverCard.d.ts

@@ -1,58 +0,0 @@
-import type { Align, Side } from '../internal/positioning.js';
-import { SkdxHoverCardRoot } from './HoverCardRoot.js';
-/**
- * Renders canonical hover card anatomy: trigger from `slot="trigger"`
- * children with optional link target, and content card holding remaining
- * children with optional arrow. Children are always card body, never parts.
- *
- * For hand composition, use `<skdx-hover-card-root>` from
- * `@skdx/web-components/primitives/hover-card`.
- *
- * @example
- * ```html
- * <skdx-hover-card href="/users/kent">
- *   <span slot="trigger">@kentcdodds</span>
- *   Kent C. Dodds
- * </skdx-hover-card>
- * ```
- *
- * @fires open-change - Fired with the new open state whenever it changes, controlled or not.
- * @fires open-change-complete - Fired once the content's enter or exit animation finishes, or as soon as it settles when it declares none; not cancelable.
- */
-export declare class SkdxHoverCard extends SkdxHoverCardRoot {
-    /**
-     * Link target for the derived trigger, and a keyboard or touch user's only route to what the card previews.
-     * @default undefined — a plain, non-navigating trigger.
-     */
-    href?: string;
-    /**
-     * Preferred edge of the trigger the derived content card is placed against.
-     * @default 'bottom'
-     */
-    side: Side;
-    /**
-     * Preferred alignment along the `side` edge; the floating layer may shift it to keep the card in the viewport.
-     * @default 'center'
-     */
-    align: Align;
-    /**
-     * Whether the derived content includes an arrow pointing back at the trigger.
-     * @default false
-     */
-    showArrow: boolean;
-    private _anatomyFilledFor;
-    connectedCallback(): void;
-    /**
-     * Draws the canonical anatomy into the light DOM. Rebuilding tears down
-     * positioning state, so it's gated on the key that changes the anatomy's
-     * shape; `href`/`side`/`align` refresh in place instead.
-     */
-    private readonly fillAnatomy;
-    protected updated(changed: Map<string, unknown>): void;
-    render(): import("lit").TemplateResult<1>;
-}
-declare global {
-    interface HTMLElementTagNameMap {
-        'skdx-hover-card': SkdxHoverCard;
-    }
-}

package/dist/hover-card/HoverCard.js

@@ -1 +0,0 @@
-var p=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var r=(l,i,t,n)=>{for(var o=n>1?void 0:n?d(i,t):i,s=l.length-1,m;s>=0;s--)(m=l[s])&&(o=(n?m(i,t,o):m(o))||o);return n&&o&&p(i,t,o),o};import{html as h}from"lit";import{property as a}from"lit/decorators.js";import{hasGeneratedContent as c}from"../internal/authored.js";import{customElement as f}from"../internal/define.js";import{fillHoverCardAnatomy as y,HOVER_CARD_ANATOMY_GENERATED as A,refreshHoverCardAnatomy as g}from"./HoverCardAnatomy.js";import{SkdxHoverCardRoot as u}from"./HoverCardRoot.js";var e=class extends u{constructor(){super(...arguments);this.side="bottom";this.align="center";this.showArrow=!1;this._anatomyFilledFor="";this.fillAnatomy=()=>{let t=String(this.showArrow);t!==this._anatomyFilledFor||!c(this,A)?(this._anatomyFilledFor=t,y(this)):g(this)}}connectedCallback(){super.connectedCallback(),queueMicrotask(this.fillAnatomy)}updated(t){this.fillAnatomy(),super.updated(t)}render(){return h`<slot @slotchange=${this.fillAnatomy}></slot>`}};r([a({type:String})],e.prototype,"href",2),r([a({type:String})],e.prototype,"side",2),r([a({type:String})],e.prototype,"align",2),r([a({type:Boolean,attribute:"show-arrow"})],e.prototype,"showArrow",2),e=r([f("skdx-hover-card")],e);export{e as SkdxHoverCard};

package/dist/hover-card/HoverCardAnatomy.cjs

@@ -1 +0,0 @@
-"use strict";var c=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var h=(e,r)=>{for(var t in r)c(e,t,{get:r[t],enumerable:!0})},g=(e,r,t,n)=>{if(r&&typeof r=="object"||typeof r=="function")for(let o of f(r))!m.call(e,o)&&o!==t&&c(e,o,{get:()=>r[o],enumerable:!(n=p(r,o))||n.enumerable});return e};var v=e=>g(c({},"__esModule",{value:!0}),e);var N={};h(N,{HOVER_CARD_ANATOMY_GENERATED:()=>a,fillHoverCardAnatomy:()=>C,refreshHoverCardAnatomy:()=>u});module.exports=v(N);var l=require("../internal/host-attributes.cjs"),A=require("./HoverCardTrigger.cjs"),k=require("./HoverCardContent.cjs"),y=require("./HoverCardArrow.cjs"),a="data-skdx-hover-card-generated",E=new Set(["skdx-hover-card-arrow"]);function C(e){let r=e.querySelector(`:scope > skdx-hover-card-trigger[${a}]`),t=e.querySelector(`:scope > skdx-hover-card-content[${a}]`),n,o;if(r||t)n=r?Array.from(r.childNodes):[],o=t?Array.from(t.childNodes).filter(d=>d.nodeType!==Node.ELEMENT_NODE||!E.has(d.tagName.toLowerCase())):[];else{n=[],o=[];for(let d of Array.from(e.childNodes))d.nodeType===Node.ELEMENT_NODE&&d.getAttribute("slot")==="trigger"?(d.removeAttribute("slot"),n.push(d)):o.push(d)}let i=document.createElement("skdx-hover-card-trigger");i.setAttribute(a,""),e.href&&(i.href=e.href),i.append(...n);let s=document.createElement("skdx-hover-card-content");s.setAttribute(a,""),(0,l.forwardHostAttributesToContent)(e,s),s.side=e.side,s.align=e.align,s.append(...o),e.showArrow&&s.append(document.createElement("skdx-hover-card-arrow")),e.replaceChildren(i,s)}function u(e){let r=e.querySelector(`:scope > skdx-hover-card-trigger[${a}]`);r&&e.href&&(r.href=e.href);let t=e.querySelector(`:scope > skdx-hover-card-content[${a}]`);t&&(t.side=e.side,t.align=e.align)}0&&(module.exports={HOVER_CARD_ANATOMY_GENERATED,fillHoverCardAnatomy,refreshHoverCardAnatomy});