@skdx/web-components 0.28.0 → 0.30.0

package/dist/form/FormAnatomy.d.cts

@@ -3,8 +3,4 @@ import './FormErrorSummary.cjs';
 import './FormSubmit.cjs';
 /** @internal Marks a direct child of `<skdx-form>` this module generated. */
 export declare const FORM_ANATOMY_GENERATED = "data-skdx-form-generated";
-/**
- * @internal Draws an error summary above the form's children and submit button below.
- * Derived parts stand down where the consumer authored one of its kind.
- */
 export declare function fillFormAnatomy(root: SkdxForm): void;

package/dist/form/FormAnatomy.d.ts

@@ -3,8 +3,4 @@ import './FormErrorSummary.js';
 import './FormSubmit.js';
 /** @internal Marks a direct child of `<skdx-form>` this module generated. */
 export declare const FORM_ANATOMY_GENERATED = "data-skdx-form-generated";
-/**
- * @internal Draws an error summary above the form's children and submit button below.
- * Derived parts stand down where the consumer authored one of its kind.
- */
 export declare function fillFormAnatomy(root: SkdxForm): void;

package/dist/form/FormAnatomy.js

@@ -1 +1 @@
-import{applyChildren as u,generatedPart as a,hasAuthoredPart as l}from"../internal/derive.js";import"./FormErrorSummary.js";import"./FormSubmit.js";var s="data-skdx-form-generated";function i(e,r,t){if(!t||l(e,r,s))return null;let m=a(e,r,s)??document.createElement(r);return m.setAttribute(s,""),m}function d(e){let r=i(e,"skdx-form-error-summary",e.errorSummary);if(!r)return null;let t=r.querySelector(":scope > h2")??document.createElement("h2");return t.className="skdx-form__error-summary-title",t.textContent!==e.errorSummary&&(t.textContent=e.errorSummary??""),t.parentNode!==r&&r.prepend(t),r}function y(e){let r=d(e),t=i(e,"skdx-form-submit",e.submitLabel);t&&t.textContent!==e.submitLabel&&(t.textContent=e.submitLabel??"");let m=new Set([r,t].filter(n=>n!==null)),o=Array.from(e.childNodes).filter(n=>!m.has(n)&&!(n.nodeType===Node.ELEMENT_NODE&&n.hasAttribute(s)));u(e,[...r?[r]:[],...o,...t?[t]:[]])}export{s as FORM_ANATOMY_GENERATED,y as fillFormAnatomy};
+import{applyChildren as l,generatedPart as u,hasAuthoredPart as i}from"../internal/derive.js";import"./FormErrorSummary.js";import"./FormSubmit.js";var n="data-skdx-form-generated";function a(e,t,r,m){if(!m||i(e,r,n)||i(t,r,n))return null;let s=u(t,r,n)??u(e,r,n)??document.createElement(r);return s.setAttribute(n,""),s}function f(e,t){let r=a(e,t,"skdx-form-error-summary",e.errorSummary);if(!r)return null;e.errorSummary&&r.setAttribute("aria-label",e.errorSummary);let m=r.querySelector(":scope > h2")??document.createElement("h2");return m.className="skdx-form__error-summary-title",m.textContent!==e.errorSummary&&(m.textContent=e.errorSummary??""),m.parentNode!==r&&r.prepend(m),r}function y(e){let t=e.querySelector(`:scope > form:not([${n}])`);if(t)return t;let r=u(e,"form",n)??document.createElement("form");return r.setAttribute(n,""),r}function b(e){let t=y(e),r=f(e,t),m=a(e,t,"skdx-form-submit",e.submitLabel);m&&m.textContent!==e.submitLabel&&(m.textContent=e.submitLabel??"");let s=new Set([r,m].filter(o=>o!==null)),d=o=>o!==t&&!s.has(o)&&!(o.nodeType===Node.ELEMENT_NODE&&o.hasAttribute(n)),c=[...Array.from(t.childNodes),...Array.from(e.childNodes)].filter(d);l(t,[...r?[r]:[],...c,...m?[m]:[]]),l(e,[t])}export{n as FORM_ANATOMY_GENERATED,b as fillFormAnatomy};

package/dist/form/FormControl.cjs

@@ -1,5 +1,5 @@
-"use strict";var o=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var V=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var k=(l,r)=>{for(var i in r)o(l,i,{get:r[i],enumerable:!0})},A=(l,r,i,e)=>{if(r&&typeof r=="object"||typeof r=="function")for(let t of V(r))!g.call(l,t)&&t!==i&&o(l,t,{get:()=>r[t],enumerable:!(e=m(r,t))||e.enumerable});return l};var _=l=>A(o({},"__esModule",{value:!0}),l),v=(l,r,i,e)=>{for(var t=e>1?void 0:e?m(r,i):r,s=l.length-1,n;s>=0;s--)(n=l[s])&&(t=(e?n(r,i,t):n(t))||t);return e&&t&&o(r,i,t),t};var x={};k(x,{SkdxFormControl:()=>d});module.exports=_(x);var a=require("lit"),b=require("../internal/define.cjs"),u=require("../internal/ids.cjs"),f=require("../internal/part.cjs"),y=require("./described-by.cjs"),E=require("./validity.cjs");var d=class extends a.LitElement{constructor(){super(...arguments);this.fieldEl=null;this.controlEl=null;this.baseDescribedBy=null;this._syncControlAttributes=()=>{let i=this.fieldEl,e=this.firstElementChild;if(!i||!e)return;e!==this.controlEl&&(this.baseDescribedBy=e.getAttribute("aria-describedby")),this.controlEl=e,(0,f.applyHostPart)(e,"form","control"),e.id||e.setAttribute("id",i.fieldId),i.name&&e.setAttribute("name",i.name);let t=i.querySelector("skdx-form-label");t&&e.setAttribute("aria-labelledby",(0,u.ensureId)(t,"skdx-form-label","label"))};this._handleValidityEvent=i=>{let e=this.controlEl,t=this.fieldEl;if(!e?.validity||!t)return;let s=this.closest("skdx-form")?.validationMode??"change";if(i?.type==="blur"&&s==="submit"||i?.type==="change"&&s!=="change")return;let n=(0,E.snapshotValidity)(e.validity);t.setValidity(n);let p=this.closest("skdx-form")?.serverErrors(t.name)??[],c=n.valid&&p.length===0;c?e.removeAttribute("aria-invalid"):e.setAttribute("aria-invalid","true");let h=(0,y.mergeDescribedBy)(this.baseDescribedBy,c?void 0:t.messageId);h?e.setAttribute("aria-describedby",h):e.removeAttribute("aria-describedby")}}connectedCallback(){if(super.connectedCallback(),this.fieldEl=this.closest("skdx-form-field"),!this.fieldEl)throw new Error("<skdx-form-control> must be used inside <skdx-form-field>.");this.addEventListener("invalid",this._handleValidityEvent,!0),this.addEventListener("blur",this._handleValidityEvent,!0),this.addEventListener("change",this._handleValidityEvent,!0)}disconnectedCallback(){this.removeEventListener("invalid",this._handleValidityEvent,!0),this.removeEventListener("blur",this._handleValidityEvent,!0),this.removeEventListener("change",this._handleValidityEvent,!0),super.disconnectedCallback()}firstUpdated(){this._syncControlAttributes()}validate(){return this.controlEl?.checkValidity?.()??!0}get control(){return this.controlEl}refreshValidityAttributes(){this._handleValidityEvent()}render(){return a.html`<slot @slotchange=${this._syncControlAttributes}></slot>`}};d.styles=a.css`
+"use strict";var o=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var C=Object.getOwnPropertyNames;var _=Object.prototype.hasOwnProperty;var k=(l,r)=>{for(var e in r)o(l,e,{get:r[e],enumerable:!0})},L=(l,r,e,i)=>{if(r&&typeof r=="object"||typeof r=="function")for(let t of C(r))!_.call(l,t)&&t!==e&&o(l,t,{get:()=>r[t],enumerable:!(i=y(r,t))||i.enumerable});return l};var x=l=>L(o({},"__esModule",{value:!0}),l),v=(l,r,e,i)=>{for(var t=i>1?void 0:i?y(r,e):r,s=l.length-1,n;s>=0;s--)(n=l[s])&&(t=(i?n(r,e,t):n(t))||t);return i&&t&&o(r,e,t),t};var B={};k(B,{SkdxFormControl:()=>a});module.exports=x(B);var d=require("lit"),f=require("../internal/define.cjs"),c=require("../internal/field-core.cjs"),E=require("../internal/ids.cjs"),p=require("../internal/part.cjs"),g=require("./described-by.cjs"),V=require("./validity.cjs");var a=class extends d.LitElement{constructor(){super(...arguments);this.fieldEl=null;this.controlEl=null;this.baseDescribedBy=null;this.controlWatcher=new MutationObserver(()=>this._syncControlAttributes());this._syncControlAttributes=()=>{let e=this.fieldEl,i=this.firstElementChild;if(!e||!i)return;let t=i.matches(c.FIELD_CONTROL_SELECTOR)?i:i.querySelector(c.FIELD_CONTROL_SELECTOR)??i;t!==this.controlEl&&(this.controlEl&&this.unwire(this.controlEl,e.fieldId,t),this.baseDescribedBy=t.getAttribute("aria-describedby")),this.controlEl=t,(0,p.applyHostPart)(i,"form","control"),t.setAttribute("id",e.fieldId),e.name&&i.setAttribute("name",e.name);let s=e.querySelector("skdx-form-label");s&&t.setAttribute("aria-labelledby",(0,E.ensureId)(s,"skdx-form-label","label"))};this._handleValidityEvent=e=>{let i=this.controlEl,t=this.fieldEl;if(!i?.validity||!t)return;let s=this.closest("skdx-form")?.validationMode??"change";if(this.gatedByMode(e,s))return;let n=(0,V.snapshotValidity)(i.validity);t.setValidity(n);let A=this.closest("skdx-form")?.serverErrors(t.name)??[],h=n.valid&&A.length===0;h?i.removeAttribute("aria-invalid"):i.setAttribute("aria-invalid","true");let b=t.messageIds,m;h||(m=b.length?b.join(" "):t.messageId);let u=(0,g.mergeDescribedBy)(this.baseDescribedBy,m);u?i.setAttribute("aria-describedby",u):i.removeAttribute("aria-describedby")}}connectedCallback(){if(super.connectedCallback(),this.fieldEl=this.closest("skdx-form-field"),!this.fieldEl)throw new Error("<skdx-form-control> must be used inside <skdx-form-field>.");this._syncControlAttributes(),this.controlWatcher.observe(this,{childList:!0,subtree:!0}),this.addEventListener("invalid",this._handleValidityEvent,!0),this.addEventListener("blur",this._handleValidityEvent,!0),this.addEventListener("change",this._handleValidityEvent,!0)}disconnectedCallback(){this.removeEventListener("invalid",this._handleValidityEvent,!0),this.removeEventListener("blur",this._handleValidityEvent,!0),this.removeEventListener("change",this._handleValidityEvent,!0),this.controlWatcher.disconnect(),super.disconnectedCallback()}firstUpdated(){this._syncControlAttributes()}unwire(e,i,t){e.id===i&&e.removeAttribute("id"),e.contains(t)||e.removeAttribute("aria-labelledby"),e.removeAttribute("aria-invalid"),this.baseDescribedBy?e.setAttribute("aria-describedby",this.baseDescribedBy):e.removeAttribute("aria-describedby")}validate(){return this.controlEl?.checkValidity?.()??!0}get control(){return this.controlEl}refreshValidityAttributes(){this._handleValidityEvent()}gatedByMode(e,i){return e?.type==="blur"&&i==="submit"?!0:e?.type==="change"&&i!=="change"}render(){return d.html`<slot @slotchange=${this._syncControlAttributes}></slot>`}};a.styles=d.css`
     :host {
       display: contents;
     }
-  `,d=v([(0,b.customElement)("skdx-form-control")],d);0&&(module.exports={SkdxFormControl});
+  `,a=v([(0,f.customElement)("skdx-form-control")],a);0&&(module.exports={SkdxFormControl});

package/dist/form/FormControl.d.cts

@@ -1,8 +1,6 @@
-import { LitElement } from 'lit';
+import { LitElement, type TemplateResult } from 'lit';
 /**
- * Wires `id`, `name`, and `aria-labelledby` to its light-DOM child input,
- * snapshots validation state, and sets `aria-invalid` / `aria-describedby`.
- * Must be used inside `<skdx-form-field>`.
+ * Wires `id`, `name`, `aria-labelledby`, `aria-invalid`, and `aria-describedby` on its light-DOM child input; must be used inside `<skdx-form-field>`.
  *
  * @example
  * ```html
@@ -15,30 +13,22 @@ export declare class SkdxFormControl extends LitElement {
     static styles: import("lit").CSSResult;
     private fieldEl;
     private controlEl;
-    /** Consumer's original `aria-describedby`; merged with validation message. */
     private baseDescribedBy;
     connectedCallback(): void;
     disconnectedCallback(): void;
     protected firstUpdated(): void;
+    private readonly controlWatcher;
+    private unwire;
     private _syncControlAttributes;
-    /**
-     * @internal Called by `<skdx-form>`'s `trySubmit()` to run native
-     * constraint validation on this field's control.
-     */
+    /** @internal Called by `<skdx-form>`'s `trySubmit()` to run native constraint validation on this field's control. */
     validate(): boolean;
-    /**
-     * @internal The consumer's own control element, so `<skdx-form>` can send
-     * focus to the first one that failed. Nothing else may reach past this
-     * wrapper into the light-DOM child.
-     */
+    /** @internal The consumer's own control element, exposed so `<skdx-form>` can focus the first one that failed. */
     get control(): HTMLElement | null;
-    /**
-     * @internal Re-applies `aria-invalid` / `aria-describedby` when server errors
-     * arrive outside the browser's validation pass.
-     */
+    /** @internal Re-applies `aria-invalid` / `aria-describedby` when server errors arrive outside the browser's validation pass. */
     refreshValidityAttributes(): void;
+    private gatedByMode;
     private readonly _handleValidityEvent;
-    render(): import("lit").TemplateResult<1>;
+    render(): TemplateResult;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/dist/form/FormControl.d.ts

@@ -1,8 +1,6 @@
-import { LitElement } from 'lit';
+import { LitElement, type TemplateResult } from 'lit';
 /**
- * Wires `id`, `name`, and `aria-labelledby` to its light-DOM child input,
- * snapshots validation state, and sets `aria-invalid` / `aria-describedby`.
- * Must be used inside `<skdx-form-field>`.
+ * Wires `id`, `name`, `aria-labelledby`, `aria-invalid`, and `aria-describedby` on its light-DOM child input; must be used inside `<skdx-form-field>`.
  *
  * @example
  * ```html
@@ -15,30 +13,22 @@ export declare class SkdxFormControl extends LitElement {
     static styles: import("lit").CSSResult;
     private fieldEl;
     private controlEl;
-    /** Consumer's original `aria-describedby`; merged with validation message. */
     private baseDescribedBy;
     connectedCallback(): void;
     disconnectedCallback(): void;
     protected firstUpdated(): void;
+    private readonly controlWatcher;
+    private unwire;
     private _syncControlAttributes;
-    /**
-     * @internal Called by `<skdx-form>`'s `trySubmit()` to run native
-     * constraint validation on this field's control.
-     */
+    /** @internal Called by `<skdx-form>`'s `trySubmit()` to run native constraint validation on this field's control. */
     validate(): boolean;
-    /**
-     * @internal The consumer's own control element, so `<skdx-form>` can send
-     * focus to the first one that failed. Nothing else may reach past this
-     * wrapper into the light-DOM child.
-     */
+    /** @internal The consumer's own control element, exposed so `<skdx-form>` can focus the first one that failed. */
     get control(): HTMLElement | null;
-    /**
-     * @internal Re-applies `aria-invalid` / `aria-describedby` when server errors
-     * arrive outside the browser's validation pass.
-     */
+    /** @internal Re-applies `aria-invalid` / `aria-describedby` when server errors arrive outside the browser's validation pass. */
     refreshValidityAttributes(): void;
+    private gatedByMode;
     private readonly _handleValidityEvent;
-    render(): import("lit").TemplateResult<1>;
+    render(): TemplateResult;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/dist/form/FormControl.js

@@ -1,5 +1,5 @@
-var m=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var c=(d,s,i,e)=>{for(var t=e>1?void 0:e?v(s,i):s,r=d.length-1,l;r>=0;r--)(l=d[r])&&(t=(e?l(s,i,t):l(t))||t);return e&&t&&m(s,i,t),t};import{css as b,html as u,LitElement as f}from"lit";import{customElement as y}from"../internal/define.js";import{ensureId as E}from"../internal/ids.js";import{applyHostPart as p}from"../internal/part.js";import{mergeDescribedBy as V}from"./described-by.js";import{snapshotValidity as g}from"./validity.js";var n=class extends f{constructor(){super(...arguments);this.fieldEl=null;this.controlEl=null;this.baseDescribedBy=null;this._syncControlAttributes=()=>{let i=this.fieldEl,e=this.firstElementChild;if(!i||!e)return;e!==this.controlEl&&(this.baseDescribedBy=e.getAttribute("aria-describedby")),this.controlEl=e,p(e,"form","control"),e.id||e.setAttribute("id",i.fieldId),i.name&&e.setAttribute("name",i.name);let t=i.querySelector("skdx-form-label");t&&e.setAttribute("aria-labelledby",E(t,"skdx-form-label","label"))};this._handleValidityEvent=i=>{let e=this.controlEl,t=this.fieldEl;if(!e?.validity||!t)return;let r=this.closest("skdx-form")?.validationMode??"change";if(i?.type==="blur"&&r==="submit"||i?.type==="change"&&r!=="change")return;let l=g(e.validity);t.setValidity(l);let h=this.closest("skdx-form")?.serverErrors(t.name)??[],a=l.valid&&h.length===0;a?e.removeAttribute("aria-invalid"):e.setAttribute("aria-invalid","true");let o=V(this.baseDescribedBy,a?void 0:t.messageId);o?e.setAttribute("aria-describedby",o):e.removeAttribute("aria-describedby")}}connectedCallback(){if(super.connectedCallback(),this.fieldEl=this.closest("skdx-form-field"),!this.fieldEl)throw new Error("<skdx-form-control> must be used inside <skdx-form-field>.");this.addEventListener("invalid",this._handleValidityEvent,!0),this.addEventListener("blur",this._handleValidityEvent,!0),this.addEventListener("change",this._handleValidityEvent,!0)}disconnectedCallback(){this.removeEventListener("invalid",this._handleValidityEvent,!0),this.removeEventListener("blur",this._handleValidityEvent,!0),this.removeEventListener("change",this._handleValidityEvent,!0),super.disconnectedCallback()}firstUpdated(){this._syncControlAttributes()}validate(){return this.controlEl?.checkValidity?.()??!0}get control(){return this.controlEl}refreshValidityAttributes(){this._handleValidityEvent()}render(){return u`<slot @slotchange=${this._syncControlAttributes}></slot>`}};n.styles=b`
+var y=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var b=(a,s,t,e)=>{for(var i=e>1?void 0:e?v(s,t):s,r=a.length-1,l;r>=0;r--)(l=a[r])&&(i=(e?l(s,t,i):l(i))||i);return e&&i&&y(s,t,i),i};import{css as f,html as E,LitElement as p}from"lit";import{customElement as g}from"../internal/define.js";import{FIELD_CONTROL_SELECTOR as m}from"../internal/field-core.js";import{ensureId as V}from"../internal/ids.js";import{applyHostPart as A}from"../internal/part.js";import{mergeDescribedBy as C}from"./described-by.js";import{snapshotValidity as _}from"./validity.js";var n=class extends p{constructor(){super(...arguments);this.fieldEl=null;this.controlEl=null;this.baseDescribedBy=null;this.controlWatcher=new MutationObserver(()=>this._syncControlAttributes());this._syncControlAttributes=()=>{let t=this.fieldEl,e=this.firstElementChild;if(!t||!e)return;let i=e.matches(m)?e:e.querySelector(m)??e;i!==this.controlEl&&(this.controlEl&&this.unwire(this.controlEl,t.fieldId,i),this.baseDescribedBy=i.getAttribute("aria-describedby")),this.controlEl=i,A(e,"form","control"),i.setAttribute("id",t.fieldId),t.name&&e.setAttribute("name",t.name);let r=t.querySelector("skdx-form-label");r&&i.setAttribute("aria-labelledby",V(r,"skdx-form-label","label"))};this._handleValidityEvent=t=>{let e=this.controlEl,i=this.fieldEl;if(!e?.validity||!i)return;let r=this.closest("skdx-form")?.validationMode??"change";if(this.gatedByMode(t,r))return;let l=_(e.validity);i.setValidity(l);let u=this.closest("skdx-form")?.serverErrors(i.name)??[],d=l.valid&&u.length===0;d?e.removeAttribute("aria-invalid"):e.setAttribute("aria-invalid","true");let o=i.messageIds,c;d||(c=o.length?o.join(" "):i.messageId);let h=C(this.baseDescribedBy,c);h?e.setAttribute("aria-describedby",h):e.removeAttribute("aria-describedby")}}connectedCallback(){if(super.connectedCallback(),this.fieldEl=this.closest("skdx-form-field"),!this.fieldEl)throw new Error("<skdx-form-control> must be used inside <skdx-form-field>.");this._syncControlAttributes(),this.controlWatcher.observe(this,{childList:!0,subtree:!0}),this.addEventListener("invalid",this._handleValidityEvent,!0),this.addEventListener("blur",this._handleValidityEvent,!0),this.addEventListener("change",this._handleValidityEvent,!0)}disconnectedCallback(){this.removeEventListener("invalid",this._handleValidityEvent,!0),this.removeEventListener("blur",this._handleValidityEvent,!0),this.removeEventListener("change",this._handleValidityEvent,!0),this.controlWatcher.disconnect(),super.disconnectedCallback()}firstUpdated(){this._syncControlAttributes()}unwire(t,e,i){t.id===e&&t.removeAttribute("id"),t.contains(i)||t.removeAttribute("aria-labelledby"),t.removeAttribute("aria-invalid"),this.baseDescribedBy?t.setAttribute("aria-describedby",this.baseDescribedBy):t.removeAttribute("aria-describedby")}validate(){return this.controlEl?.checkValidity?.()??!0}get control(){return this.controlEl}refreshValidityAttributes(){this._handleValidityEvent()}gatedByMode(t,e){return t?.type==="blur"&&e==="submit"?!0:t?.type==="change"&&e!=="change"}render(){return E`<slot @slotchange=${this._syncControlAttributes}></slot>`}};n.styles=f`
     :host {
       display: contents;
     }
-  `,n=c([y("skdx-form-control")],n);export{n as SkdxFormControl};
+  `,n=b([g("skdx-form-control")],n);export{n as SkdxFormControl};

package/dist/form/FormErrorSummary.cjs

@@ -1,5 +1,8 @@
-"use strict";var l=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var R=Object.getOwnPropertyNames;var b=Object.prototype.hasOwnProperty;var g=(s,t)=>{for(var e in t)l(s,e,{get:t[e],enumerable:!0})},y=(s,t,e,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of R(t))!b.call(s,r)&&r!==e&&l(s,r,{get:()=>t[r],enumerable:!(i=h(t,r))||i.enumerable});return s};var E=s=>y(l({},"__esModule",{value:!0}),s),u=(s,t,e,i)=>{for(var r=i>1?void 0:i?h(t,e):t,d=s.length-1,p;d>=0;d--)(p=s[d])&&(r=(i?p(t,e,r):p(r))||r);return i&&r&&l(t,e,r),r};var k={};g(k,{SkdxFormErrorSummary:()=>a});module.exports=E(k);var n=require("lit"),c=require("lit/decorators.js"),o=require("../field/field-core.cjs"),f=require("../internal/define.cjs"),m=require("../internal/part.cjs"),v=require("../internal/styles.cjs");var a=class extends n.LitElement{constructor(){super(...arguments);this.noAutoFocus=!1;this.entries=[];this.wasReporting=!1;this.scope=null;this.rescanQueued=!1;this.requestRescan=()=>{this.rescanQueued||(this.rescanQueued=!0,queueMicrotask(()=>{this.rescanQueued=!1,this.rescan()}))};this.rescan=()=>{this.scope&&(this.entries=(0,o.collectFieldErrors)(this.scope))};this.handleLinkClick=(e,i)=>{e.preventDefault(),(0,o.focusFieldTarget)(i)}}createRenderRoot(){return this}get autoFocus(){return!this.noAutoFocus}set autoFocus(e){this.noAutoFocus=!e}connectedCallback(){super.connectedCallback(),this.setAttribute("role","alert"),this.setAttribute("tabindex","-1"),this.setAttribute("data-skdx-error-summary",""),this.setAttribute("part","summary"),(0,v.installLightDomStyles)(),this.scope=(0,o.errorSummaryScope)(this);for(let e of o.ERROR_SUMMARY_RESCAN_EVENTS)this.scope.addEventListener(e,this.requestRescan,!0);this.rescan()}disconnectedCallback(){for(let e of o.ERROR_SUMMARY_RESCAN_EVENTS)this.scope?.removeEventListener(e,this.requestRescan,!0);this.scope=null,super.disconnectedCallback()}updated(){if((0,m.reflectHostState)(this,{hidden:this.entries.length===0?"":null}),this.entries.length===0){this.wasReporting=!1;return}this.wasReporting||(this.wasReporting=!0,this.autoFocus&&this.focus())}render(){return n.html`
-      <ul class="skdx-form__error-summary-list" role="list">
+"use strict";var l=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var R=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var b=(s,t)=>{for(var e in t)l(s,e,{get:t[e],enumerable:!0})},g=(s,t,e,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of R(t))!y.call(s,r)&&r!==e&&l(s,r,{get:()=>t[r],enumerable:!(i=h(t,r))||i.enumerable});return s};var k=s=>g(l({},"__esModule",{value:!0}),s),u=(s,t,e,i)=>{for(var r=i>1?void 0:i?h(t,e):t,d=s.length-1,p;d>=0;d--)(p=s[d])&&(r=(i?p(t,e,r):p(r))||r);return i&&r&&l(t,e,r),r};var E={};b(E,{SkdxFormErrorSummary:()=>a});module.exports=k(E);var n=require("lit"),c=require("lit/decorators.js"),m=require("../internal/define.cjs"),o=require("../internal/field-core.cjs"),f=require("../internal/light-dom-styles.cjs"),v=require("../internal/part.cjs");var a=class extends n.LitElement{constructor(){super(...arguments);this.noAutoFocus=!1;this.entries=[];this.wasReporting=!1;this.scope=null;this.rescanQueued=!1;this.requestRescan=()=>{this.rescanQueued||(this.rescanQueued=!0,queueMicrotask(()=>{this.rescanQueued=!1,this.rescan()}))};this.rescan=()=>{this.scope&&(this.entries=(0,o.collectFieldErrors)(this.scope))};this.handleLinkClick=(e,i)=>{e.preventDefault(),(0,o.focusFieldTarget)(i)}}createRenderRoot(){return this}get autoFocus(){return!this.noAutoFocus}set autoFocus(e){this.noAutoFocus=!e}connectedCallback(){super.connectedCallback(),this.setAttribute("role","alert"),this.setAttribute("tabindex","-1"),this.setAttribute("data-skdx-error-summary",""),this.setAttribute("part","error-summary"),(0,f.installLightDomStyles)(),this.scope=this.closest("skdx-form")??(0,o.errorSummaryScope)(this);for(let e of o.ERROR_SUMMARY_RESCAN_EVENTS)this.scope.addEventListener(e,this.requestRescan,!0);this.rescan()}disconnectedCallback(){for(let e of o.ERROR_SUMMARY_RESCAN_EVENTS)this.scope?.removeEventListener(e,this.requestRescan,!0);this.scope=null,super.disconnectedCallback()}updated(){if((0,v.reflectHostState)(this,{hidden:this.entries.length===0?"":null}),this.entries.length===0){this.wasReporting=!1;return}this.wasReporting||(this.wasReporting=!0,this.autoFocus&&this.focus())}render(){return n.html`
+      <ul
+        class="skdx-form__error-summary-list"
+        role="list"
+      >
         ${this.entries.map(e=>n.html`
             <li>
               <a
@@ -12,4 +15,4 @@
             </li>
           `)}
       </ul>
-    `}};u([(0,c.property)({type:Boolean,attribute:"no-auto-focus"})],a.prototype,"noAutoFocus",2),u([(0,c.state)()],a.prototype,"entries",2),a=u([(0,f.customElement)("skdx-form-error-summary","form","error-summary")],a);0&&(module.exports={SkdxFormErrorSummary});
+    `}};u([(0,c.property)({type:Boolean,attribute:"no-auto-focus"})],a.prototype,"noAutoFocus",2),u([(0,c.state)()],a.prototype,"entries",2),a=u([(0,m.customElement)("skdx-form-error-summary","form","error-summary")],a);0&&(module.exports={SkdxFormErrorSummary});

package/dist/form/FormErrorSummary.d.cts

@@ -1,10 +1,9 @@
-import { LitElement } from 'lit';
+import { LitElement, type TemplateResult } from 'lit';
 /**
- * GOV.UK error summary for a form. `role="alert"` container listing in-page links
- * to failing fields, scanned on validity-change. Renders into light DOM for CSS class styling.
+ * `role="alert"` container listing in-page links to failing fields, scanned on validity change and rendered into light DOM.
  *
  * @slot - Heading content placed before the generated error list.
- * @csspart summary - The `role="alert"` container (host element; rendered in light DOM).
+ * @csspart error-summary - The `role="alert"` container (host element; rendered in light DOM).
  *
  * @example
  * ```html
@@ -25,34 +24,22 @@ export declare class SkdxFormErrorSummary extends LitElement {
      */
     noAutoFocus: boolean;
     /**
-     * Whether the summary focuses itself on the transition into reporting. The
-     * contract's name for the same switch as `no-auto-focus`, inverted, so the
-     * attribute can keep the boolean-defaults-false shape HTML requires.
+     * Whether the summary focuses itself on the transition into reporting — the inverted, boolean-defaults-false form of `no-auto-focus`.
      * @default true
      */
     get autoFocus(): boolean;
     set autoFocus(on: boolean);
     private entries;
-    /** Whether the previous render listed anything, so focus moves only on the empty → non-empty edge. */
     private wasReporting;
     private scope;
     connectedCallback(): void;
     disconnectedCallback(): void;
-    /** Whether a deferred rescan is already queued, so a burst of events costs one scan. */
     private rescanQueued;
-    /**
-     * Deferred by a microtask, because capture-phase listeners run outer-first:
-     * this element's listener is on the `<skdx-form>` and
-     * `<skdx-form-control>`'s is on itself, so scanning from the event read the
-     * DOM *before* the control had been given its `aria-invalid` and the message
-     * its `hidden`. Every framework defers this scan for the same class of
-     * reason; this is the platform's version of it.
-     */
     private readonly requestRescan;
     private readonly rescan;
     protected updated(): void;
     private readonly handleLinkClick;
-    render(): import("lit").TemplateResult<1>;
+    render(): TemplateResult;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/dist/form/FormErrorSummary.d.ts

@@ -1,10 +1,9 @@
-import { LitElement } from 'lit';
+import { LitElement, type TemplateResult } from 'lit';
 /**
- * GOV.UK error summary for a form. `role="alert"` container listing in-page links
- * to failing fields, scanned on validity-change. Renders into light DOM for CSS class styling.
+ * `role="alert"` container listing in-page links to failing fields, scanned on validity change and rendered into light DOM.
  *
  * @slot - Heading content placed before the generated error list.
- * @csspart summary - The `role="alert"` container (host element; rendered in light DOM).
+ * @csspart error-summary - The `role="alert"` container (host element; rendered in light DOM).
  *
  * @example
  * ```html
@@ -25,34 +24,22 @@ export declare class SkdxFormErrorSummary extends LitElement {
      */
     noAutoFocus: boolean;
     /**
-     * Whether the summary focuses itself on the transition into reporting. The
-     * contract's name for the same switch as `no-auto-focus`, inverted, so the
-     * attribute can keep the boolean-defaults-false shape HTML requires.
+     * Whether the summary focuses itself on the transition into reporting — the inverted, boolean-defaults-false form of `no-auto-focus`.
      * @default true
      */
     get autoFocus(): boolean;
     set autoFocus(on: boolean);
     private entries;
-    /** Whether the previous render listed anything, so focus moves only on the empty → non-empty edge. */
     private wasReporting;
     private scope;
     connectedCallback(): void;
     disconnectedCallback(): void;
-    /** Whether a deferred rescan is already queued, so a burst of events costs one scan. */
     private rescanQueued;
-    /**
-     * Deferred by a microtask, because capture-phase listeners run outer-first:
-     * this element's listener is on the `<skdx-form>` and
-     * `<skdx-form-control>`'s is on itself, so scanning from the event read the
-     * DOM *before* the control had been given its `aria-invalid` and the message
-     * its `hidden`. Every framework defers this scan for the same class of
-     * reason; this is the platform's version of it.
-     */
     private readonly requestRescan;
     private readonly rescan;
     protected updated(): void;
     private readonly handleLinkClick;
-    render(): import("lit").TemplateResult<1>;
+    render(): TemplateResult;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/dist/form/FormErrorSummary.js

@@ -1,5 +1,8 @@
-var d=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var o=(a,i,e,t)=>{for(var r=t>1?void 0:t?p(i,e):i,n=a.length-1,l;n>=0;n--)(l=a[n])&&(r=(t?l(i,e,r):l(r))||r);return t&&r&&d(i,e,r),r};import{html as u,LitElement as h}from"lit";import{property as f,state as m}from"lit/decorators.js";import{collectFieldErrors as v,ERROR_SUMMARY_RESCAN_EVENTS as c,errorSummaryScope as R,focusFieldTarget as b}from"../field/field-core.js";import{customElement as g}from"../internal/define.js";import{reflectHostState as y}from"../internal/part.js";import{installLightDomStyles as E}from"../internal/styles.js";var s=class extends h{constructor(){super(...arguments);this.noAutoFocus=!1;this.entries=[];this.wasReporting=!1;this.scope=null;this.rescanQueued=!1;this.requestRescan=()=>{this.rescanQueued||(this.rescanQueued=!0,queueMicrotask(()=>{this.rescanQueued=!1,this.rescan()}))};this.rescan=()=>{this.scope&&(this.entries=v(this.scope))};this.handleLinkClick=(e,t)=>{e.preventDefault(),b(t)}}createRenderRoot(){return this}get autoFocus(){return!this.noAutoFocus}set autoFocus(e){this.noAutoFocus=!e}connectedCallback(){super.connectedCallback(),this.setAttribute("role","alert"),this.setAttribute("tabindex","-1"),this.setAttribute("data-skdx-error-summary",""),this.setAttribute("part","summary"),E(),this.scope=R(this);for(let e of c)this.scope.addEventListener(e,this.requestRescan,!0);this.rescan()}disconnectedCallback(){for(let e of c)this.scope?.removeEventListener(e,this.requestRescan,!0);this.scope=null,super.disconnectedCallback()}updated(){if(y(this,{hidden:this.entries.length===0?"":null}),this.entries.length===0){this.wasReporting=!1;return}this.wasReporting||(this.wasReporting=!0,this.autoFocus&&this.focus())}render(){return u`
-      <ul class="skdx-form__error-summary-list" role="list">
+var d=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var o=(a,i,e,t)=>{for(var r=t>1?void 0:t?p(i,e):i,n=a.length-1,l;n>=0;n--)(l=a[n])&&(r=(t?l(i,e,r):l(r))||r);return t&&r&&d(i,e,r),r};import{html as u,LitElement as h}from"lit";import{property as m,state as f}from"lit/decorators.js";import{customElement as v}from"../internal/define.js";import{collectFieldErrors as R,ERROR_SUMMARY_RESCAN_EVENTS as c,errorSummaryScope as y,focusFieldTarget as b}from"../internal/field-core.js";import{installLightDomStyles as g}from"../internal/light-dom-styles.js";import{reflectHostState as k}from"../internal/part.js";var s=class extends h{constructor(){super(...arguments);this.noAutoFocus=!1;this.entries=[];this.wasReporting=!1;this.scope=null;this.rescanQueued=!1;this.requestRescan=()=>{this.rescanQueued||(this.rescanQueued=!0,queueMicrotask(()=>{this.rescanQueued=!1,this.rescan()}))};this.rescan=()=>{this.scope&&(this.entries=R(this.scope))};this.handleLinkClick=(e,t)=>{e.preventDefault(),b(t)}}createRenderRoot(){return this}get autoFocus(){return!this.noAutoFocus}set autoFocus(e){this.noAutoFocus=!e}connectedCallback(){super.connectedCallback(),this.setAttribute("role","alert"),this.setAttribute("tabindex","-1"),this.setAttribute("data-skdx-error-summary",""),this.setAttribute("part","error-summary"),g(),this.scope=this.closest("skdx-form")??y(this);for(let e of c)this.scope.addEventListener(e,this.requestRescan,!0);this.rescan()}disconnectedCallback(){for(let e of c)this.scope?.removeEventListener(e,this.requestRescan,!0);this.scope=null,super.disconnectedCallback()}updated(){if(k(this,{hidden:this.entries.length===0?"":null}),this.entries.length===0){this.wasReporting=!1;return}this.wasReporting||(this.wasReporting=!0,this.autoFocus&&this.focus())}render(){return u`
+      <ul
+        class="skdx-form__error-summary-list"
+        role="list"
+      >
         ${this.entries.map(e=>u`
             <li>
               <a
@@ -12,4 +15,4 @@ var d=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var o=(a,i,e,t
             </li>
           `)}
       </ul>
-    `}};o([f({type:Boolean,attribute:"no-auto-focus"})],s.prototype,"noAutoFocus",2),o([m()],s.prototype,"entries",2),s=o([g("skdx-form-error-summary","form","error-summary")],s);export{s as SkdxFormErrorSummary};
+    `}};o([m({type:Boolean,attribute:"no-auto-focus"})],s.prototype,"noAutoFocus",2),o([f()],s.prototype,"entries",2),s=o([v("skdx-form-error-summary","form","error-summary")],s);export{s as SkdxFormErrorSummary};

package/dist/form/FormField.cjs

@@ -1,5 +1,5 @@
-"use strict";var m=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var b=(i,t)=>{for(var e in t)m(i,e,{get:t[e],enumerable:!0})},M=(i,t,e,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of c(t))!u.call(i,s)&&s!==e&&m(i,s,{get:()=>t[s],enumerable:!(r=p(t,s))||r.enumerable});return i};var _=i=>M(m({},"__esModule",{value:!0}),i),l=(i,t,e,r)=>{for(var s=r>1?void 0:r?p(t,e):t,f=i.length-1,h;f>=0;f--)(h=i[f])&&(s=(r?h(t,e,s):h(s))||s);return r&&s&&m(t,e,s),s};var A={};b(A,{SkdxFormField:()=>a});module.exports=_(A);var o=require("lit"),d=require("lit/decorators.js"),n=require("../field/field-core.cjs"),y=require("../internal/define.cjs"),g=require("../internal/ids.cjs"),v=require("./FormFieldAnatomy.cjs");var a=class extends o.LitElement{constructor(){super(...arguments);this.name="";this.fieldId=(0,g.nextId)("skdx-form-field");this.messageId=(0,g.nextId)("skdx-form-message");this._messages=new Set;this.fillAnatomy=()=>(0,v.fillFormFieldAnatomy)(this)}get validity(){return this._validity}setValidity(e){this._validity=e;for(let r of this._messages)r.refresh()}refresh(){for(let e of this._messages)e.refresh()}registerMessage(e){this._messages.add(e)}unregisterMessage(e){this._messages.delete(e)}connectedCallback(){super.connectedCallback(),this.setAttribute(n.FORM_FIELD_ATTRIBUTE,""),queueMicrotask(this.fillAnatomy)}updated(e){this.name?this.setAttribute(n.FIELD_NAME_ATTRIBUTE,this.name):this.removeAttribute(n.FIELD_NAME_ATTRIBUTE),(e.has("label")||e.has("message"))&&this.fillAnatomy()}render(){return o.html`<slot @slotchange=${this.fillAnatomy}></slot>`}};a.styles=o.css`
+"use strict";var d=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var v=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var M=(i,s)=>{for(var e in s)d(i,e,{get:s[e],enumerable:!0})},b=(i,s,e,a)=>{if(s&&typeof s=="object"||typeof s=="function")for(let t of v(s))!u.call(i,t)&&t!==e&&d(i,t,{get:()=>s[t],enumerable:!(a=p(s,t))||a.enumerable});return i};var _=i=>b(d({},"__esModule",{value:!0}),i),l=(i,s,e,a)=>{for(var t=a>1?void 0:a?p(s,e):s,f=i.length-1,g;f>=0;f--)(g=i[f])&&(t=(a?g(s,e,t):g(t))||t);return a&&t&&d(s,e,t),t};var I={};M(I,{SkdxFormField:()=>r});module.exports=_(I);var o=require("lit"),m=require("lit/decorators.js"),y=require("../internal/define.cjs"),n=require("../internal/field-core.cjs"),h=require("../internal/ids.cjs"),c=require("./FormFieldAnatomy.cjs");var r=class extends o.LitElement{constructor(){super(...arguments);this.name="";this.fieldId=(0,h.nextId)("skdx-form-field");this.messageId=(0,h.nextId)("skdx-form-message");this.claimedMessages=0;this._messages=new Set;this.fillAnatomy=()=>(0,c.fillFormFieldAnatomy)(this)}get messageIds(){return[...this._messages].filter(e=>!e.hidden).map(e=>e.id)}claimMessageId(){let e=this.claimedMessages++;return e===0?this.messageId:`${this.messageId}-${e}`}get validity(){return this._validity}setValidity(e){this._validity=e;for(let a of this._messages)a.refresh()}refresh(){for(let e of this._messages)e.refresh()}registerMessage(e){e.id||(e.id=this.claimMessageId()),this._messages.add(e)}unregisterMessage(e){this._messages.delete(e)}connectedCallback(){super.connectedCallback(),this.setAttribute(n.FORM_FIELD_ATTRIBUTE,""),queueMicrotask(this.fillAnatomy)}updated(e){this.name?this.setAttribute(n.FIELD_NAME_ATTRIBUTE,this.name):this.removeAttribute(n.FIELD_NAME_ATTRIBUTE),(e.has("label")||e.has("message"))&&this.fillAnatomy()}render(){return o.html`<slot @slotchange=${this.fillAnatomy}></slot>`}};r.styles=o.css`
     :host {
       display: block;
     }
-  `,l([(0,d.property)({type:String,reflect:!0})],a.prototype,"name",2),l([(0,d.property)({type:String})],a.prototype,"label",2),l([(0,d.property)({type:String})],a.prototype,"message",2),a=l([(0,y.customElement)("skdx-form-field","form","field")],a);0&&(module.exports={SkdxFormField});
+  `,l([(0,m.property)({type:String,reflect:!0})],r.prototype,"name",2),l([(0,m.property)({type:String})],r.prototype,"label",2),l([(0,m.property)({type:String})],r.prototype,"message",2),r=l([(0,y.customElement)("skdx-form-field","form","field")],r);0&&(module.exports={SkdxFormField});

package/dist/form/FormField.d.cts

@@ -1,18 +1,11 @@
-import { LitElement } from 'lit';
+import { LitElement, type TemplateResult } from 'lit';
 import type { ValiditySnapshot } from './validity.cjs';
 /** A registered message that can be told to re-sync against the field's latest validity. */
-export interface RefreshableFormMessage {
+export interface RefreshableFormMessage extends HTMLElement {
     refresh(): void;
 }
 /**
- * Groups one field's Label, Control, and Message(s). Generates shared
- * `fieldId`/`messageId` for descendants and holds the latest
- * `ValiditySnapshot` from its Control.
- *
- * The one Form family component on the main entry point (consumer decides
- * where it goes). `label` and `message` derive Label, Control, and catch-all
- * Message around the control. Derived parts stand down if consumer authored
- * them; all are primitives from `@skdx/web-components/primitives/form`.
+ * Groups a field's Label, Control, and Message(s), deriving them from `label`/`message` when not authored.
  *
  * @example
  * ```html
@@ -32,14 +25,19 @@ export declare class SkdxFormField extends LitElement {
      */
     label?: string;
     /**
-     * Message shown when the field is invalid, rendered into a derived
-     * catch-all `<skdx-form-message>` (no `match`, covers every `ValidityState`
-     * reason). For per-reason messages, use primitives.
+     * Message shown when the field is invalid, rendered into a derived catch-all `<skdx-form-message>`.
      * @default undefined — no message is derived.
      */
     message?: string;
+    /** @internal Generated control id, published as the for target of the label. */
     readonly fieldId: string;
+    /** @internal Generated message id, published as aria-describedby on the control. */
     readonly messageId: string;
+    private claimedMessages;
+    /** @internal Ids of the currently shown messages, in registration order. */
+    get messageIds(): string[];
+    /** @internal Returns the next message's own id: the bare `messageId` first, `${messageId}-n` after. */
+    claimMessageId(): string;
     private _validity?;
     private readonly _messages;
     /** The field's most recent validity snapshot, or `undefined` if not yet validated. */
@@ -55,7 +53,7 @@ export declare class SkdxFormField extends LitElement {
     connectedCallback(): void;
     private readonly fillAnatomy;
     protected updated(changed: Map<string, unknown>): void;
-    render(): import("lit").TemplateResult<1>;
+    render(): TemplateResult;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/dist/form/FormField.d.ts

@@ -1,18 +1,11 @@
-import { LitElement } from 'lit';
+import { LitElement, type TemplateResult } from 'lit';
 import type { ValiditySnapshot } from './validity.js';
 /** A registered message that can be told to re-sync against the field's latest validity. */
-export interface RefreshableFormMessage {
+export interface RefreshableFormMessage extends HTMLElement {
     refresh(): void;
 }
 /**
- * Groups one field's Label, Control, and Message(s). Generates shared
- * `fieldId`/`messageId` for descendants and holds the latest
- * `ValiditySnapshot` from its Control.
- *
- * The one Form family component on the main entry point (consumer decides
- * where it goes). `label` and `message` derive Label, Control, and catch-all
- * Message around the control. Derived parts stand down if consumer authored
- * them; all are primitives from `@skdx/web-components/primitives/form`.
+ * Groups a field's Label, Control, and Message(s), deriving them from `label`/`message` when not authored.
  *
  * @example
  * ```html
@@ -32,14 +25,19 @@ export declare class SkdxFormField extends LitElement {
      */
     label?: string;
     /**
-     * Message shown when the field is invalid, rendered into a derived
-     * catch-all `<skdx-form-message>` (no `match`, covers every `ValidityState`
-     * reason). For per-reason messages, use primitives.
+     * Message shown when the field is invalid, rendered into a derived catch-all `<skdx-form-message>`.
      * @default undefined — no message is derived.
      */
     message?: string;
+    /** @internal Generated control id, published as the for target of the label. */
     readonly fieldId: string;
+    /** @internal Generated message id, published as aria-describedby on the control. */
     readonly messageId: string;
+    private claimedMessages;
+    /** @internal Ids of the currently shown messages, in registration order. */
+    get messageIds(): string[];
+    /** @internal Returns the next message's own id: the bare `messageId` first, `${messageId}-n` after. */
+    claimMessageId(): string;
     private _validity?;
     private readonly _messages;
     /** The field's most recent validity snapshot, or `undefined` if not yet validated. */
@@ -55,7 +53,7 @@ export declare class SkdxFormField extends LitElement {
     connectedCallback(): void;
     private readonly fillAnatomy;
     protected updated(changed: Map<string, unknown>): void;
-    render(): import("lit").TemplateResult<1>;
+    render(): TemplateResult;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/dist/form/FormField.js

@@ -1,5 +1,5 @@
-var h=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var a=(o,r,e,i)=>{for(var s=i>1?void 0:i?g(r,e):r,l=o.length-1,n;l>=0;l--)(n=o[l])&&(s=(i?n(r,e,s):n(s))||s);return i&&s&&h(r,e,s),s};import{css as p,html as y,LitElement as v}from"lit";import{property as m}from"lit/decorators.js";import{FIELD_NAME_ATTRIBUTE as d,FORM_FIELD_ATTRIBUTE as c}from"../field/field-core.js";import{customElement as u}from"../internal/define.js";import{nextId as f}from"../internal/ids.js";import{fillFormFieldAnatomy as b}from"./FormFieldAnatomy.js";var t=class extends v{constructor(){super(...arguments);this.name="";this.fieldId=f("skdx-form-field");this.messageId=f("skdx-form-message");this._messages=new Set;this.fillAnatomy=()=>b(this)}get validity(){return this._validity}setValidity(e){this._validity=e;for(let i of this._messages)i.refresh()}refresh(){for(let e of this._messages)e.refresh()}registerMessage(e){this._messages.add(e)}unregisterMessage(e){this._messages.delete(e)}connectedCallback(){super.connectedCallback(),this.setAttribute(c,""),queueMicrotask(this.fillAnatomy)}updated(e){this.name?this.setAttribute(d,this.name):this.removeAttribute(d),(e.has("label")||e.has("message"))&&this.fillAnatomy()}render(){return y`<slot @slotchange=${this.fillAnatomy}></slot>`}};t.styles=p`
+var g=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var r=(o,a,e,i)=>{for(var t=i>1?void 0:i?h(a,e):a,l=o.length-1,n;l>=0;l--)(n=o[l])&&(t=(i?n(a,e,t):n(t))||t);return i&&t&&g(a,e,t),t};import{css as p,html as y,LitElement as c}from"lit";import{property as d}from"lit/decorators.js";import{customElement as v}from"../internal/define.js";import{FIELD_NAME_ATTRIBUTE as m,FORM_FIELD_ATTRIBUTE as u}from"../internal/field-core.js";import{nextId as f}from"../internal/ids.js";import{fillFormFieldAnatomy as M}from"./FormFieldAnatomy.js";var s=class extends c{constructor(){super(...arguments);this.name="";this.fieldId=f("skdx-form-field");this.messageId=f("skdx-form-message");this.claimedMessages=0;this._messages=new Set;this.fillAnatomy=()=>M(this)}get messageIds(){return[...this._messages].filter(e=>!e.hidden).map(e=>e.id)}claimMessageId(){let e=this.claimedMessages++;return e===0?this.messageId:`${this.messageId}-${e}`}get validity(){return this._validity}setValidity(e){this._validity=e;for(let i of this._messages)i.refresh()}refresh(){for(let e of this._messages)e.refresh()}registerMessage(e){e.id||(e.id=this.claimMessageId()),this._messages.add(e)}unregisterMessage(e){this._messages.delete(e)}connectedCallback(){super.connectedCallback(),this.setAttribute(u,""),queueMicrotask(this.fillAnatomy)}updated(e){this.name?this.setAttribute(m,this.name):this.removeAttribute(m),(e.has("label")||e.has("message"))&&this.fillAnatomy()}render(){return y`<slot @slotchange=${this.fillAnatomy}></slot>`}};s.styles=p`
     :host {
       display: block;
     }
-  `,a([m({type:String,reflect:!0})],t.prototype,"name",2),a([m({type:String})],t.prototype,"label",2),a([m({type:String})],t.prototype,"message",2),t=a([u("skdx-form-field","form","field")],t);export{t as SkdxFormField};
+  `,r([d({type:String,reflect:!0})],s.prototype,"name",2),r([d({type:String})],s.prototype,"label",2),r([d({type:String})],s.prototype,"message",2),s=r([v("skdx-form-field","form","field")],s);export{s as SkdxFormField};

package/dist/form/FormFieldAnatomy.cjs

@@ -1 +1 @@
-"use strict";var a=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var x=(e,t)=>{for(var o in t)a(e,o,{get:t[o],enumerable:!0})},p=(e,t,o,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of f(t))!u.call(e,r)&&r!==o&&a(e,r,{get:()=>t[r],enumerable:!(n=c(t,r))||n.enumerable});return e};var k=e=>p(a({},"__esModule",{value:!0}),e);var h={};x(h,{FORM_FIELD_ANATOMY_GENERATED:()=>d,fillFormFieldAnatomy:()=>E});module.exports=k(h);var l=require("../internal/derive.cjs"),N=require("./FormLabel.cjs"),b=require("./FormControl.cjs"),y=require("./FormMessage.cjs"),d="data-skdx-form-field-generated",F=new Set(["skdx-form-label","skdx-form-control","skdx-form-message"]);function A(e){let t=d;if((0,l.hasAuthoredPart)(e,"skdx-form-control",t))return null;let o=(0,l.generatedPart)(e,"skdx-form-control",t);if(o)return o;let n=Array.from(e.children).filter(m=>!m.hasAttribute(t)&&!F.has(m.tagName.toLowerCase()));if(n.length===0)return null;let r=document.createElement("skdx-form-control");return r.setAttribute(t,""),r.append(...n),r}function E(e){let t=d,o=(0,l.textPart)(e,"skdx-form-label",e.label,t),n=(0,l.textPart)(e,"skdx-form-message",e.message,t),r=A(e),m=new Set([o,r,n].filter(s=>s!==null)),i=Array.from(e.childNodes).filter(s=>!m.has(s)&&!(s.nodeType===Node.ELEMENT_NODE&&s.hasAttribute(t)));(0,l.applyChildren)(e,[...o?[o]:[],...i,...r?[r]:[],...n?[n]:[]])}0&&(module.exports={FORM_FIELD_ANATOMY_GENERATED,fillFormFieldAnatomy});
+"use strict";var d=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var x=(e,t)=>{for(var r in t)d(e,r,{get:t[r],enumerable:!0})},k=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of f(t))!u.call(e,n)&&n!==r&&d(e,n,{get:()=>t[n],enumerable:!(o=c(t,n))||o.enumerable});return e};var p=e=>k(d({},"__esModule",{value:!0}),e);var h={};x(h,{FORM_FIELD_ANATOMY_GENERATED:()=>a,fillFormFieldAnatomy:()=>g});module.exports=p(h);var s=require("../internal/derive.cjs"),N=require("./FormLabel.cjs"),S=require("./FormControl.cjs"),y=require("./FormMessage.cjs"),a="data-skdx-form-field-generated",F=new Set(["skdx-form-label","skdx-form-control","skdx-form-message"]);function E(e){let t=a;if((0,s.hasAuthoredPart)(e,"skdx-form-message",t))return null;let r=(0,s.generatedPart)(e,"skdx-form-message",t)??document.createElement("skdx-form-message");r.setAttribute(t,"");let o=e.message??"";return r.textContent!==o&&(r.textContent=o),r}function A(e){let t=a;if((0,s.hasAuthoredPart)(e,"skdx-form-control",t))return null;let r=(0,s.generatedPart)(e,"skdx-form-control",t);if(r)return r;let o=Array.from(e.children).filter(m=>!m.hasAttribute(t)&&!F.has(m.tagName.toLowerCase()));if(o.length===0)return null;let n=document.createElement("skdx-form-control");return n.setAttribute(t,""),n.append(...o),n}function g(e){let t=a,r=(0,s.textPart)(e,"skdx-form-label",e.label,t),o=E(e),n=A(e),m=new Set([r,n,o].filter(l=>l!==null)),i=Array.from(e.childNodes).filter(l=>!m.has(l)&&!(l.nodeType===Node.ELEMENT_NODE&&l.hasAttribute(t)));(0,s.applyChildren)(e,[...r?[r]:[],...i,...n?[n]:[],...o?[o]:[]])}0&&(module.exports={FORM_FIELD_ANATOMY_GENERATED,fillFormFieldAnatomy});

package/dist/form/FormFieldAnatomy.d.cts

@@ -5,9 +5,7 @@ import './FormMessage.cjs';
 /** @internal Marks a direct child of `<skdx-form-field>` this module generated. */
 export declare const FORM_FIELD_ANATOMY_GENERATED = "data-skdx-form-field-generated";
 /**
- * Draws Label, Control, and Message around consumer's control. No derive-or-compose switch
- * (child IS control). Each derived part stands down where consumer authored one, so both
- * patterns work in same element.
+ * Draws Label, Control, and Message around the consumer's control, standing down where one was authored.
  * @internal
  */
 export declare function fillFormFieldAnatomy(root: SkdxFormField): void;

package/dist/form/FormFieldAnatomy.d.ts

@@ -5,9 +5,7 @@ import './FormMessage.js';
 /** @internal Marks a direct child of `<skdx-form-field>` this module generated. */
 export declare const FORM_FIELD_ANATOMY_GENERATED = "data-skdx-form-field-generated";
 /**
- * Draws Label, Control, and Message around consumer's control. No derive-or-compose switch
- * (child IS control). Each derived part stands down where consumer authored one, so both
- * patterns work in same element.
+ * Draws Label, Control, and Message around the consumer's control, standing down where one was authored.
  * @internal
  */
 export declare function fillFormFieldAnatomy(root: SkdxFormField): void;

package/dist/form/FormFieldAnatomy.js

@@ -1 +1 @@
-import{applyChildren as i,generatedPart as c,hasAuthoredPart as f,textPart as m}from"../internal/derive.js";import"./FormLabel.js";import"./FormControl.js";import"./FormMessage.js";var a="data-skdx-form-field-generated",u=new Set(["skdx-form-label","skdx-form-control","skdx-form-message"]);function x(e){let t=a;if(f(e,"skdx-form-control",t))return null;let o=c(e,"skdx-form-control",t);if(o)return o;let n=Array.from(e.children).filter(s=>!s.hasAttribute(t)&&!u.has(s.tagName.toLowerCase()));if(n.length===0)return null;let r=document.createElement("skdx-form-control");return r.setAttribute(t,""),r.append(...n),r}function E(e){let t=a,o=m(e,"skdx-form-label",e.label,t),n=m(e,"skdx-form-message",e.message,t),r=x(e),s=new Set([o,r,n].filter(l=>l!==null)),d=Array.from(e.childNodes).filter(l=>!s.has(l)&&!(l.nodeType===Node.ELEMENT_NODE&&l.hasAttribute(t)));i(e,[...o?[o]:[],...d,...r?[r]:[],...n?[n]:[]])}export{a as FORM_FIELD_ANATOMY_GENERATED,E as fillFormFieldAnatomy};
+import{applyChildren as c,generatedPart as a,hasAuthoredPart as d,textPart as f}from"../internal/derive.js";import"./FormLabel.js";import"./FormControl.js";import"./FormMessage.js";var m="data-skdx-form-field-generated",u=new Set(["skdx-form-label","skdx-form-control","skdx-form-message"]);function x(e){let t=m;if(d(e,"skdx-form-message",t))return null;let r=a(e,"skdx-form-message",t)??document.createElement("skdx-form-message");r.setAttribute(t,"");let n=e.message??"";return r.textContent!==n&&(r.textContent=n),r}function k(e){let t=m;if(d(e,"skdx-form-control",t))return null;let r=a(e,"skdx-form-control",t);if(r)return r;let n=Array.from(e.children).filter(l=>!l.hasAttribute(t)&&!u.has(l.tagName.toLowerCase()));if(n.length===0)return null;let o=document.createElement("skdx-form-control");return o.setAttribute(t,""),o.append(...n),o}function g(e){let t=m,r=f(e,"skdx-form-label",e.label,t),n=x(e),o=k(e),l=new Set([r,o,n].filter(s=>s!==null)),i=Array.from(e.childNodes).filter(s=>!l.has(s)&&!(s.nodeType===Node.ELEMENT_NODE&&s.hasAttribute(t)));c(e,[...r?[r]:[],...i,...o?[o]:[],...n?[n]:[]])}export{m as FORM_FIELD_ANATOMY_GENERATED,g as fillFormFieldAnatomy};

package/dist/form/FormLabel.cjs

@@ -1,5 +1,9 @@
-"use strict";var d=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var k=Object.prototype.hasOwnProperty;var u=(o,e)=>{for(var r in e)d(o,r,{get:e[r],enumerable:!0})},v=(o,e,r,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let l of g(e))!k.call(o,l)&&l!==r&&d(o,l,{get:()=>e[l],enumerable:!(i=c(e,l))||i.enumerable});return o};var x=o=>v(d({},"__esModule",{value:!0}),o),f=(o,e,r,i)=>{for(var l=i>1?void 0:i?c(e,r):e,m=o.length-1,n;m>=0;m--)(n=o[m])&&(l=(i?n(e,r,l):n(l))||l);return i&&l&&d(e,r,l),l};var I={};u(I,{SkdxFormLabel:()=>s});module.exports=x(I);var t=require("lit"),p=require("lit/decorators.js"),a=require("../internal/define.cjs"),b=require("../internal/ids.cjs"),h=require("../internal/styles.cjs");var s=class extends t.LitElement{connectedCallback(){super.connectedCallback(),(0,b.ensureId)(this,"skdx-form-label","label");let e=this.closest("skdx-form-field");e&&(0,a.whenUpgraded)(e,()=>this.forId=e.fieldId)}render(){return t.html`<label part="label" for=${this.forId??t.nothing}><slot></slot></label>`}};s.styles=[t.css`
+"use strict";var a=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var v=(l,e)=>{for(var o in e)a(l,o,{get:e[o],enumerable:!0})},I=(l,e,o,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of u(e))!g.call(l,t)&&t!==o&&a(l,t,{get:()=>e[t],enumerable:!(s=c(e,t))||s.enumerable});return l};var E=l=>I(a({},"__esModule",{value:!0}),l),m=(l,e,o,s)=>{for(var t=s>1?void 0:s?c(e,o):e,d=l.length-1,f;d>=0;d--)(f=l[d])&&(t=(s?f(e,o,t):f(t))||t);return s&&t&&a(e,o,t),t};var T={};v(T,{SkdxFormLabel:()=>i});module.exports=E(T);var r=require("lit"),p=require("lit/decorators.js"),n=require("../internal/define.cjs"),b=require("../internal/ids.cjs"),h=require("../internal/styles.cjs");var i=class extends r.LitElement{connectedCallback(){super.connectedCallback(),(0,b.ensureId)(this,"skdx-form-label","label");let e=this.closest("skdx-form-field");e&&(0,n.whenUpgraded)(e,()=>this.forId=e.fieldId)}render(){return r.html`<label
+      part="label"
+      for=${this.forId??r.nothing}
+      ><slot></slot
+    ></label>`}};i.styles=[r.css`
       :host {
         display: inline-block;
       }
-    `,h.controlBoxOnHost],f([(0,p.state)()],s.prototype,"forId",2),s=f([(0,a.customElement)("skdx-form-label","form","label")],s);0&&(module.exports={SkdxFormLabel});
+    `,h.controlBoxOnHost],m([(0,p.state)()],i.prototype,"forId",2),i=m([(0,n.customElement)("skdx-form-label","form","label")],i);0&&(module.exports={SkdxFormLabel});

package/dist/form/FormLabel.d.cts

@@ -1,7 +1,6 @@
-import { LitElement } from 'lit';
+import { LitElement, type TemplateResult } from 'lit';
 /**
- * `<skdx-form-label>` — label for a field's control. Ensures itself a light-DOM `id` so `aria-labelledby` works
- * (IDREFs can't cross shadow boundaries), and sets `for` to the field's control id for native click-to-focus.
+ * Label for a field's control; ensures itself a light-DOM `id` and sets `for` to the control's id for native click-to-focus.
  *
  * @csspart label - The `<label>` element inside the shadow root.
  */
@@ -9,7 +8,7 @@ export declare class SkdxFormLabel extends LitElement {
     static styles: import("lit").CSSResult[];
     private forId?;
     connectedCallback(): void;
-    render(): import("lit").TemplateResult<1>;
+    render(): TemplateResult;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/dist/form/FormLabel.d.ts

@@ -1,7 +1,6 @@
-import { LitElement } from 'lit';
+import { LitElement, type TemplateResult } from 'lit';
 /**
- * `<skdx-form-label>` — label for a field's control. Ensures itself a light-DOM `id` so `aria-labelledby` works
- * (IDREFs can't cross shadow boundaries), and sets `for` to the field's control id for native click-to-focus.
+ * Label for a field's control; ensures itself a light-DOM `id` and sets `for` to the control's id for native click-to-focus.
  *
  * @csspart label - The `<label>` element inside the shadow root.
  */
@@ -9,7 +8,7 @@ export declare class SkdxFormLabel extends LitElement {
     static styles: import("lit").CSSResult[];
     private forId?;
     connectedCallback(): void;
-    render(): import("lit").TemplateResult<1>;
+    render(): TemplateResult;
 }
 declare global {
     interface HTMLElementTagNameMap {