@aceshooting/lyra-ui 8.1.0 → 8.2.1

package/dist/internal/form-associated.js

@@ -1 +1 @@
-import{LYRA_DEFAULT_fieldRequired}from"./default-strings.generated.js";import{resolveLyraString}from"./localization-runtime.js";import{AnchoredValidityController,SET_ANCHORED_VALIDITY,VALIDITY_ANCHOR}from"./anchored-validity.js";import{syncValidityStates}from"./custom-states.js";import{installInvalidEventAlias}from"./invalid-event-alias.js";import{omittedEmptyStringConverter}from"./converters.js";const FORM_ASSOCIATED_DEFAULT_STRINGS=Object.freeze({fieldRequired:LYRA_DEFAULT_fieldRequired});function setFormOwner(host,owner){const id=typeof owner==="string"?owner:owner?.id??"";if(id)host.setAttribute("form",id);else host.removeAttribute("form")}function getFormOwner(internals){return internals.form}function createStringArrayFormDataState(name,values){const state=new FormData;const key=name||"value";for(const value of values)state.append(key,value);return state}function readStringArrayFormDataState(state){if(typeof FormData!=="function")return[];let entries;try{entries=[...FormData.prototype.values.call(state)]}catch{return[]}if(entries.some(entry=>typeof entry!=="string"))return[];return entries}function isEmptyFormValue(value){if(value==null)return true;if(typeof value==="string")return value==="";if(Array.isArray(value))return value.length===0;if(typeof value==="object"){const prototype=Object.getPrototypeOf(value);if(prototype===null)return Object.keys(value).length===0;if(Object.getPrototypeOf(prototype)===null){const constructor=Object.getOwnPropertyDescriptor(prototype,"constructor")?.value;if(typeof constructor==="function"&&constructor.name==="Object"&&constructor.prototype===prototype){return Object.keys(value).length===0}}}return false}const stringFormValueAdapter={empty:"",toFormValue:value=>value,isEmpty:value=>value==="",fromAttribute:attribute=>attribute,toAttribute:value=>value,fromFormState:state=>typeof state==="string"?state:""};function resolveFormValueAdapter(adapter){if(adapter===void 0){return stringFormValueAdapter}return{empty:adapter.empty,toFormValue:value=>adapter.toFormValue(value),...adapter.toFormState?{toFormState:value=>adapter.toFormState(value)}:{},isEmpty:adapter.isEmpty?value=>adapter.isEmpty(value):isEmptyFormValue,fromAttribute:adapter.fromAttribute?attribute=>adapter.fromAttribute(attribute):attribute=>attribute,toAttribute:adapter.toAttribute?value=>adapter.toAttribute(value):value=>value==null?null:String(value),fromFormState:adapter.fromFormState?state=>adapter.fromFormState(state):state=>typeof state==="string"?state:adapter.empty}}function isBarredFromValidation(host,internals){if(host.effectiveDisabled??host.disabled)return true;if(host.readonly)return true;if(internals){const willValidate=readNativeWillValidate(internals);if(willValidate!==void 0)return!willValidate}return false}function readNativeWillValidate(internals){if(typeof ElementInternals!=="function")return void 0;const getter=Object.getOwnPropertyDescriptor(ElementInternals.prototype,"willValidate")?.get;if(typeof getter!=="function")return void 0;try{const value=getter.call(internals);return typeof value==="boolean"?value:void 0}catch{return void 0}}function installCustomErrorProperty(host,getCustomValidityMessage){if(Object.prototype.hasOwnProperty.call(host,"customError"))return;let reflecting=false;Object.defineProperty(host,"customError",{configurable:true,enumerable:true,get:()=>getCustomValidityMessage()||null,set:next=>{if(reflecting)return;const old=getCustomValidityMessage()||null;const message=next??"";reflecting=true;try{if(next==null){if(host.hasAttribute("custom-error"))host.removeAttribute("custom-error")}else if(host.getAttribute("custom-error")!==message){host.setAttribute("custom-error",message)}}finally{reflecting=false}host.setCustomValidity(message);host.requestUpdate("customError",old)}})}function createFallbackInternals(){let flags={};let message="";const validity={};const validityKeys=["badInput","customError","patternMismatch","rangeOverflow","rangeUnderflow","stepMismatch","tooLong","tooShort","typeMismatch","valueMissing"];for(const key of validityKeys){Object.defineProperty(validity,key,{enumerable:true,get:()=>Boolean(flags[key])})}Object.defineProperty(validity,"valid",{enumerable:true,get:()=>validityKeys.every(key=>!flags[key])});const states=new Set;return{form:null,labels:[],validity,get validationMessage(){return message},willValidate:false,states,setFormValue(){},setValidity(next={},nextMessage=""){flags={...next};message=nextMessage},checkValidity(){return validity.valid},reportValidity(){return validity.valid}}}function attachInternalsSafely(host){if(typeof host.attachInternals!=="function")return createFallbackInternals();try{return host.attachInternals()??createFallbackInternals()}catch{return createFallbackInternals()}}function FormAssociated(Base,valueAdapter){const adapter=resolveFormValueAdapter(valueAdapter);const defaultValueConverter={fromAttribute:attribute=>attribute===null?null:adapter.fromAttribute(attribute),toAttribute:value=>value==null?null:adapter.toAttribute(value)};class FormAssociatedElement extends Base{static{this.formAssociated=true}static{this.properties={name:{reflect:true,noAccessor:true,converter:omittedEmptyStringConverter},value:{attribute:false,noAccessor:true},defaultValue:{attribute:"value",reflect:true,useDefault:true,noAccessor:true,...valueAdapter?{converter:defaultValueConverter}:{}},customError:{attribute:"custom-error",reflect:true,noAccessor:true},form:{noAccessor:true},disabled:{type:Boolean,reflect:true,noAccessor:true},required:{type:Boolean,reflect:true,noAccessor:true}}}constructor(...args){super(...args);this._fieldsetDisabled=false;this._disabled=false;this._name="";this._value=adapter.empty;this._defaultValue=adapter.empty;this._valueDirty=false;this.settingDefaultValue=false;this.reflectingDefaultValue=false;this.reflectingCustomError=false;this.reflectingFormOwner=false;this._required=false;this._hasInteracted=false;this.internals=attachInternalsSafely(this);this.validityController=new AnchoredValidityController(this,this.internals,()=>this[VALIDITY_ANCHOR]());this.commitFormValue(this._value);installInvalidEventAlias(this,init=>this.emit("lr-invalid",void 0,init));const markInteracted=()=>{if(this._hasInteracted)return;this._hasInteracted=true;this.syncValidityStates()};this.addEventListener("input",markInteracted);this.addEventListener("change",markInteracted);this.addEventListener("focusout",markInteracted);this.syncValidityStates()}get form(){return getFormOwner(this.internals)}set form(owner){if(this.reflectingFormOwner)return;this.reflectingFormOwner=true;try{setFormOwner(this,owner)}finally{this.reflectingFormOwner=false}}getForm(){return getFormOwner(this.internals)}get labels(){return this.internals.labels}get validity(){return this.internals.validity}get validationMessage(){return this.internals.validationMessage}get willValidate(){return this.internals.willValidate}[VALIDITY_ANCHOR](){return this.renderRoot?.querySelector("input:not([type='hidden']), textarea, select, button, [tabindex]:not([tabindex='-1'])")??null}[SET_ANCHORED_VALIDITY](flags,message=""){this.validityController.setValidity(flags,message);this.syncValidityStates()}setCustomValidity(message){this.validityController.setCustomValidity(message??"");this.syncValidityStates()}resetValidity(){this.validityController.setCustomValidity("");this.updateValidity();this.syncValidityStates()}syncValidityStates(){syncValidityStates(this.internals,{required:this.required,hasInteracted:this._hasInteracted,barred:this.isBarredFromValidation()})}isBarredFromValidation(){return isBarredFromValidation(this,this.internals)}get name(){return this._name}set name(next){const old=this._name;this._name=next??"";if(this._name){this.setAttribute("name",this._name)}else{this.removeAttribute("name")}this.requestUpdate("name",old)}commitFormValue(value){const submitted=adapter.toFormValue(value);if(adapter.toFormState)this.internals.setFormValue(submitted,adapter.toFormState(value));else this.internals.setFormValue(submitted)}get value(){return this._value}set value(next){const old=this._value;this._value=next??adapter.empty;if(!this.settingDefaultValue)this._valueDirty=true;this.commitFormValue(this._value);this.updateValidity();this.requestUpdate("value",old)}get defaultValue(){return this._defaultValue}set defaultValue(next){if(this.reflectingDefaultValue)return;const old=this._defaultValue;this._defaultValue=next??adapter.empty;this.reflectingDefaultValue=true;try{const attribute=next==null?null:adapter.toAttribute(this._defaultValue);if(attribute==null)this.removeAttribute("value");else this.setAttribute("value",attribute)}finally{this.reflectingDefaultValue=false}if(!this._valueDirty)this.restoreLiveValueFromDefault();this.requestUpdate("defaultValue",old)}get customError(){return this.validityController.customValidityMessage||null}set customError(next){if(this.reflectingCustomError)return;const old=this.customError;const message=next??"";this.reflectingCustomError=true;try{if(next==null)this.removeAttribute("custom-error");else this.setAttribute("custom-error",message)}finally{this.reflectingCustomError=false}this.setCustomValidity(message);this.requestUpdate("customError",old)}get disabled(){return this._disabled}set disabled(next){const old=this._disabled;this._disabled=Boolean(next);this.toggleAttribute("disabled",this._disabled);this.updateValidity();this.syncValidityStates();this.requestUpdate("disabled",old)}get required(){return this._required}set required(next){const old=this._required;this._required=next;this.toggleAttribute("required",next);this.updateValidity();this.syncValidityStates();this.requestUpdate("required",old)}get effectiveDisabled(){return this.disabled||this._fieldsetDisabled}setFormValue(next){this.value=next}updateValidity(){if(this.isBarredFromValidation()){this[SET_ANCHORED_VALIDITY]({});return}if(this.required&&adapter.isEmpty(this._value)){const overrides=this.strings;const message=resolveLyraString(this,"fieldRequired",overrides,void 0,void 0,FORM_ASSOCIATED_DEFAULT_STRINGS);this[SET_ANCHORED_VALIDITY]({valueMissing:true},message)}else{this[SET_ANCHORED_VALIDITY]({})}}syncConstraintsToNative(){const host=this;if(!host.hasUpdated)return;host.performUpdate()}checkValidity(){this.syncConstraintsToNative();this.updateValidity();return this.internals.checkValidity()}reportValidity(){this.syncConstraintsToNative();this.updateValidity();this._hasInteracted=true;this.syncValidityStates();return this.internals.reportValidity()}formResetCallback(){this._valueDirty=false;this.restoreLiveValueFromDefault();this._hasInteracted=false;this.syncValidityStates()}restoreLiveValueFromDefault(){this.settingDefaultValue=true;try{this.value=this._defaultValue}finally{this.settingDefaultValue=false}this._valueDirty=false}formStateRestoreCallback(state,reason){void reason;this.value=adapter.fromFormState(state)}formDisabledCallback(fieldsetDisabled){this._fieldsetDisabled=fieldsetDisabled;this.updateValidity();this.syncValidityStates();this.requestUpdate()}updated(changed){super.updated(changed);if(!changed.has("readonly")&&!changed.has("disabled"))return;this.updateValidity();this.syncValidityStates()}connectedCallback(){super.connectedCallback();this.updateValidity();this.syncValidityStates()}}return FormAssociatedElement}export{FormAssociated,attachInternalsSafely,createFallbackInternals,createStringArrayFormDataState,getFormOwner,installCustomErrorProperty,isBarredFromValidation,isEmptyFormValue,readStringArrayFormDataState,setFormOwner,stringFormValueAdapter};
+import{LYRA_DEFAULT_fieldRequired}from"./default-strings.generated.js";import{resolveLyraString}from"./localization-runtime.js";import{AnchoredValidityController,SET_ANCHORED_VALIDITY,VALIDITY_ANCHOR}from"./anchored-validity.js";import{syncValidityStates}from"./custom-states.js";import{installInvalidEventAlias}from"./invalid-event-alias.js";import{omittedEmptyStringConverter}from"./converters.js";const FORM_ASSOCIATED_DEFAULT_STRINGS=Object.freeze({fieldRequired:LYRA_DEFAULT_fieldRequired});function setFormOwner(host,owner){const id=typeof owner==="string"?owner:owner?.id??"";if(id)host.setAttribute("form",id);else host.removeAttribute("form")}function getFormOwner(internals){return internals.form}function createStringArrayFormDataState(name,values){const state=new FormData;const key=name||"value";for(const value of values)state.append(key,value);return state}function readStringArrayFormDataState(state){if(typeof FormData!=="function")return[];let entries;try{entries=[...FormData.prototype.values.call(state)]}catch{return[]}if(entries.some(entry=>typeof entry!=="string"))return[];return entries}function isEmptyFormValue(value){if(value==null)return true;if(typeof value==="string")return value==="";if(Array.isArray(value))return value.length===0;if(typeof value==="object"){const prototype=Object.getPrototypeOf(value);if(prototype===null)return Object.keys(value).length===0;if(Object.getPrototypeOf(prototype)===null){const constructor=Object.getOwnPropertyDescriptor(prototype,"constructor")?.value;if(typeof constructor==="function"&&constructor.name==="Object"&&constructor.prototype===prototype){return Object.keys(value).length===0}}}return false}const stringFormValueAdapter={empty:"",toFormValue:value=>value,isEmpty:value=>value==="",fromAttribute:attribute=>attribute,toAttribute:value=>value,fromFormState:state=>typeof state==="string"?state:""};function resolveFormValueAdapter(adapter){if(adapter===void 0){return stringFormValueAdapter}return{empty:adapter.empty,toFormValue:value=>adapter.toFormValue(value),...adapter.toFormState?{toFormState:value=>adapter.toFormState(value)}:{},isEmpty:adapter.isEmpty?value=>adapter.isEmpty(value):isEmptyFormValue,fromAttribute:adapter.fromAttribute?attribute=>adapter.fromAttribute(attribute):attribute=>attribute,toAttribute:adapter.toAttribute?value=>adapter.toAttribute(value):value=>value==null?null:String(value),fromFormState:adapter.fromFormState?state=>adapter.fromFormState(state):state=>typeof state==="string"?state:adapter.empty}}function isBarredFromValidation(host,internals){if(host.effectiveDisabled??host.disabled)return true;if(host.readonly)return true;if(internals){const willValidate=readNativeWillValidate(internals);if(willValidate!==void 0)return!willValidate}return false}function readNativeWillValidate(internals){if(typeof ElementInternals!=="function")return void 0;const getter=Object.getOwnPropertyDescriptor(ElementInternals.prototype,"willValidate")?.get;if(typeof getter!=="function")return void 0;try{const value=getter.call(internals);return typeof value==="boolean"?value:void 0}catch{return void 0}}function installCustomErrorProperty(host,getCustomValidityMessage){if(Object.prototype.hasOwnProperty.call(host,"customError"))return;let reflecting=false;Object.defineProperty(host,"customError",{configurable:true,enumerable:true,get:()=>getCustomValidityMessage()||null,set:next=>{if(reflecting)return;const old=getCustomValidityMessage()||null;const message=next??"";reflecting=true;try{if(next==null){if(host.hasAttribute("custom-error"))host.removeAttribute("custom-error")}else if(host.getAttribute("custom-error")!==message){host.setAttribute("custom-error",message)}}finally{reflecting=false}host.setCustomValidity(message);host.requestUpdate("customError",old)}})}function createFallbackInternals(){let flags={};let message="";const validity={};const validityKeys=["badInput","customError","patternMismatch","rangeOverflow","rangeUnderflow","stepMismatch","tooLong","tooShort","typeMismatch","valueMissing"];for(const key of validityKeys){Object.defineProperty(validity,key,{enumerable:true,get:()=>Boolean(flags[key])})}Object.defineProperty(validity,"valid",{enumerable:true,get:()=>validityKeys.every(key=>!flags[key])});const states=new Set;return{form:null,labels:[],validity,get validationMessage(){return message},willValidate:false,states,setFormValue(){},setValidity(next={},nextMessage=""){flags={...next};message=nextMessage},checkValidity(){return validity.valid},reportValidity(){return validity.valid}}}function attachInternalsSafely(host){if(typeof host.attachInternals!=="function")return createFallbackInternals();try{return host.attachInternals()??createFallbackInternals()}catch{return createFallbackInternals()}}function FormAssociated(Base,valueAdapter){const adapter=resolveFormValueAdapter(valueAdapter);const defaultValueConverter={fromAttribute:attribute=>attribute===null?null:adapter.fromAttribute(attribute),toAttribute:value=>value==null?null:adapter.toAttribute(value)};class FormAssociatedElement extends Base{static{this.formAssociated=true}static{this.properties={name:{reflect:true,noAccessor:true,converter:omittedEmptyStringConverter},value:{attribute:false,noAccessor:true},defaultValue:{attribute:"value",reflect:true,useDefault:true,noAccessor:true,...valueAdapter?{converter:defaultValueConverter}:{}},customError:{attribute:"custom-error",reflect:true,noAccessor:true},form:{noAccessor:true},disabled:{type:Boolean,reflect:true,noAccessor:true},required:{type:Boolean,reflect:true,noAccessor:true}}}constructor(...args){super(...args);this._fieldsetDisabled=false;this._disabled=false;this._reflectingDisabledAttribute=false;this._name="";this._value=adapter.empty;this._defaultValue=adapter.empty;this._valueDirty=false;this.settingDefaultValue=false;this.reflectingDefaultValue=false;this.reflectingCustomError=false;this.reflectingFormOwner=false;this._required=false;this._hasInteracted=false;this.internals=attachInternalsSafely(this);this.validityController=new AnchoredValidityController(this,this.internals,()=>this[VALIDITY_ANCHOR]());this.commitFormValue(this._value);installInvalidEventAlias(this,init=>this.emit("lr-invalid",void 0,init));const markInteracted=()=>{if(this._hasInteracted)return;this._hasInteracted=true;this.syncValidityStates()};this.addEventListener("input",markInteracted);this.addEventListener("change",markInteracted);this.addEventListener("focusout",markInteracted);this.syncValidityStates()}get form(){return getFormOwner(this.internals)}set form(owner){if(this.reflectingFormOwner)return;this.reflectingFormOwner=true;try{setFormOwner(this,owner)}finally{this.reflectingFormOwner=false}}getForm(){return getFormOwner(this.internals)}get labels(){return this.internals.labels}get validity(){return this.internals.validity}get validationMessage(){return this.internals.validationMessage}get willValidate(){return this.internals.willValidate}[VALIDITY_ANCHOR](){return this.renderRoot?.querySelector("input:not([type='hidden']), textarea, select, button, [tabindex]:not([tabindex='-1'])")??null}[SET_ANCHORED_VALIDITY](flags,message=""){this.validityController.setValidity(flags,message);this.syncValidityStates()}setCustomValidity(message){this.validityController.setCustomValidity(message??"");this.syncValidityStates()}resetValidity(){this.validityController.setCustomValidity("");this.updateValidity();this.syncValidityStates()}syncValidityStates(){syncValidityStates(this.internals,{required:this.required,hasInteracted:this._hasInteracted,barred:this.isBarredFromValidation()})}isBarredFromValidation(){return isBarredFromValidation(this,this.internals)}get name(){return this._name}set name(next){const old=this._name;this._name=next??"";if(this._name){this.setAttribute("name",this._name)}else{this.removeAttribute("name")}this.requestUpdate("name",old)}commitFormValue(value){const submitted=adapter.toFormValue(value);if(adapter.toFormState)this.internals.setFormValue(submitted,adapter.toFormState(value));else this.internals.setFormValue(submitted)}get value(){return this._value}set value(next){const old=this._value;this._value=next??adapter.empty;if(!this.settingDefaultValue)this._valueDirty=true;this.commitFormValue(this._value);this.updateValidity();this.requestUpdate("value",old)}get defaultValue(){return this._defaultValue}set defaultValue(next){if(this.reflectingDefaultValue)return;const old=this._defaultValue;this._defaultValue=next??adapter.empty;this.reflectingDefaultValue=true;try{const attribute=next==null?null:adapter.toAttribute(this._defaultValue);if(attribute==null)this.removeAttribute("value");else this.setAttribute("value",attribute)}finally{this.reflectingDefaultValue=false}if(!this._valueDirty)this.restoreLiveValueFromDefault();this.requestUpdate("defaultValue",old)}get customError(){return this.validityController.customValidityMessage||null}set customError(next){if(this.reflectingCustomError)return;const old=this.customError;const message=next??"";this.reflectingCustomError=true;try{if(next==null)this.removeAttribute("custom-error");else this.setAttribute("custom-error",message)}finally{this.reflectingCustomError=false}this.setCustomValidity(message);this.requestUpdate("customError",old)}get disabled(){return this._disabled}set disabled(next){const old=this._disabled;this._disabled=Boolean(next);this.toggleAttribute("disabled",this._disabled);this.updateValidity();this.syncValidityStates();this.requestUpdate("disabled",old)}toggleAttribute(qualifiedName,force){if(qualifiedName!=="disabled")return super.toggleAttribute(qualifiedName,force);this._reflectingDisabledAttribute=true;try{return super.toggleAttribute(qualifiedName,force)}finally{queueMicrotask(()=>{this._reflectingDisabledAttribute=false})}}setAttribute(qualifiedName,value){if(qualifiedName!=="disabled"){super.setAttribute(qualifiedName,value);return}this._reflectingDisabledAttribute=true;try{super.setAttribute(qualifiedName,value)}finally{queueMicrotask(()=>{this._reflectingDisabledAttribute=false})}}removeAttribute(qualifiedName){if(qualifiedName!=="disabled"){super.removeAttribute(qualifiedName);return}this._reflectingDisabledAttribute=true;try{super.removeAttribute(qualifiedName)}finally{queueMicrotask(()=>{this._reflectingDisabledAttribute=false})}}get required(){return this._required}set required(next){const old=this._required;this._required=next;this.toggleAttribute("required",next);this.updateValidity();this.syncValidityStates();this.requestUpdate("required",old)}get effectiveDisabled(){return this.disabled||this._fieldsetDisabled}setFormValue(next){this.value=next}updateValidity(){if(this.isBarredFromValidation()){this[SET_ANCHORED_VALIDITY]({});return}if(this.required&&adapter.isEmpty(this._value)){const overrides=this.strings;const message=resolveLyraString(this,"fieldRequired",overrides,void 0,void 0,FORM_ASSOCIATED_DEFAULT_STRINGS);this[SET_ANCHORED_VALIDITY]({valueMissing:true},message)}else{this[SET_ANCHORED_VALIDITY]({})}}syncConstraintsToNative(){const host=this;if(!host.hasUpdated)return;host.performUpdate()}checkValidity(){this.syncConstraintsToNative();this.updateValidity();return this.internals.checkValidity()}reportValidity(){this.syncConstraintsToNative();this.updateValidity();this._hasInteracted=true;this.syncValidityStates();return this.internals.reportValidity()}formResetCallback(){this._valueDirty=false;this.restoreLiveValueFromDefault();this._hasInteracted=false;this.syncValidityStates()}restoreLiveValueFromDefault(){this.settingDefaultValue=true;try{this.value=this._defaultValue}finally{this.settingDefaultValue=false}this._valueDirty=false}formStateRestoreCallback(state,reason){void reason;this.value=adapter.fromFormState(state)}formDisabledCallback(fieldsetDisabled){if(this._reflectingDisabledAttribute)return;const before=this.effectiveDisabled;this._fieldsetDisabled=fieldsetDisabled;if(this.effectiveDisabled===before)return;this.updateValidity();this.syncValidityStates();this.requestUpdate()}updated(changed){super.updated(changed);if(!changed.has("readonly")&&!changed.has("disabled"))return;this.updateValidity();this.syncValidityStates()}connectedCallback(){super.connectedCallback();this.updateValidity();this.syncValidityStates()}}return FormAssociatedElement}export{FormAssociated,attachInternalsSafely,createFallbackInternals,createStringArrayFormDataState,getFormOwner,installCustomErrorProperty,isBarredFromValidation,isEmptyFormValue,readStringArrayFormDataState,setFormOwner,stringFormValueAdapter};

package/dist/internal/localization-runtime.d.ts

@@ -47,6 +47,19 @@ export declare function invalidateLyraLocaleCache(host: Element): void;
 export declare function resolveLyraLocale(host: Element): string;
 /** Resolve the direction inherited by a component host. */
 export declare function resolveLyraDirection(host: Element): 'ltr' | 'rtl';
+/**
+ * Reads a host's already-memoized locale/direction without resolving anything -- in particular,
+ * without `resolveLyraDirection()`'s `getComputedStyle()` call. `undefined` when the host was
+ * never opted into caching, or opted in but never actually read `effectiveLocale`/
+ * `effectiveDirection` (so its own render never populated the memo). Lets a caller establish a
+ * "what's currently rendered" baseline for free, piggybacking on whatever the host's own last
+ * render already computed, instead of forcing a fresh (potentially expensive or, for
+ * `getComputedStyle()` specifically, disruptive -- see `observeInheritedContext()`) resolution
+ * purely to seed a comparison.
+ */
+export declare function peekLyraLocale(host: Element): string | undefined;
+/** @see peekLyraLocale */
+export declare function peekLyraDirection(host: Element): 'ltr' | 'rtl' | undefined;
 /**
  * Resolve a message for a component. An explicit per-component override wins,
  * followed by a non-empty component property fallback, registered locale

package/dist/internal/localization-runtime.js

@@ -1 +1 @@
-import{getPluralRules}from"./intl-cache.js";const locales=new Map;const localeMeta=new Map;const exactOnlyLocales=new Set;const listeners=new Set;const registryListeners=new Set;let activeLocale="";function normalizeLocale(locale){return locale.trim().replace(/_/g,"-").toLowerCase()}function regionalFallbacks(subtags){const language=subtags[0];if(!language)return[];const requested=new Set(subtags);const score=key=>key.split("-").filter(subtag=>requested.has(subtag)).length;return[...locales.keys()].filter(key=>!exactOnlyLocales.has(key)&&key.split("-")[0]===language&&!isPrefixOf(key,subtags)).sort((a,b)=>score(b)-score(a)||(a<b?-1:a>b?1:0))}function isPrefixOf(key,subtags){const parts=key.split("-");return parts.length<=subtags.length&&parts.every((part,index)=>part===subtags[index])}function localeCandidates(locale){const normalized=normalizeLocale(locale);const subtags=normalized.split("-").filter(Boolean);const candidates=[];for(let length=subtags.length;length>0;length--){candidates.push(subtags.slice(0,length).join("-"))}candidates.push(...regionalFallbacks(subtags));if(!candidates.includes("en"))candidates.push("en");return candidates}function notify(){for(const listener of[...listeners])listener()}function getRegisteredLyraLocales(){const keys=new Set(["en",...locales.keys()]);return[...keys].sort()}function subscribeLyraLocaleRegistry(listener){registryListeners.add(listener);return()=>registryListeners.delete(listener)}function registerLocale(locale,strings,meta,exactOnly){const key=normalizeLocale(locale);if(!key)throw new TypeError("A locale is required.");if(exactOnly)exactOnlyLocales.add(key);locales.set(key,{...locales.get(key)??{},...strings});if(meta)localeMeta.set(key,{...localeMeta.get(key)??{},...meta});pluralLocaleCache.clear();notify();for(const listener of[...registryListeners])listener()}function registerLyraLocale(locale,strings,meta){registerLocale(locale,strings,meta,false)}function registerLyraExactLocale(locale,strings,meta){registerLocale(locale,strings,meta,true)}function getLyraLocaleDirection(locale){const normalized=normalizeLocale(locale);if(!normalized)return"ltr";for(const candidate of localeCandidates(normalized)){const declared=localeMeta.get(candidate)?.dir;if(declared)return declared}try{const resolved=new Intl.Locale(normalized);const direction=resolved.textInfo?.direction??resolved.getTextInfo?.().direction;return direction==="rtl"?"rtl":"ltr"}catch{return"ltr"}}function setLyraLocale(locale){const next=locale.trim();if(activeLocale===next)return;activeLocale=next;notify()}function getLyraLocale(){return activeLocale}function subscribeLyraLocale(listener){listeners.add(listener);return()=>listeners.delete(listener)}function inheritedLocale(host){const explicit=host.getAttribute("locale")||host.getAttribute("lang");if(explicit)return explicit;const composedParent=element=>{if(element.parentElement)return element.parentElement;const root=element.getRootNode();const candidate=root.host;return root.nodeType===11&&candidate!==null&&typeof candidate==="object"&&typeof candidate.getAttribute==="function"?candidate:null};let parent=composedParent(host);while(parent){const locale=parent.getAttribute("locale")||parent.getAttribute("lang");if(locale)return locale;parent=composedParent(parent)}const documentLocale=host.ownerDocument?.documentElement?.getAttribute("lang");if(documentLocale)return documentLocale;return activeLocale||"en"}const cacheableLocaleHosts=new WeakSet;const resolvedLocaleCache=new WeakMap;const resolvedDirectionCache=new WeakMap;function enableLyraLocaleCache(host){cacheableLocaleHosts.add(host)}function invalidateLyraLocaleCache(host){resolvedLocaleCache.delete(host);resolvedDirectionCache.delete(host)}function resolveLyraLocale(host){if(!cacheableLocaleHosts.has(host))return inheritedLocale(host);let locale=resolvedLocaleCache.get(host);if(locale===void 0){locale=inheritedLocale(host);resolvedLocaleCache.set(host,locale)}return locale}function inheritedDirection(host){const explicit=host.getAttribute("dir");if(explicit==="rtl"||explicit==="ltr")return explicit;const view=host.ownerDocument?.defaultView;if(view)return view.getComputedStyle(host).direction==="rtl"?"rtl":"ltr";return"ltr"}function resolveLyraDirection(host){if(!cacheableLocaleHosts.has(host))return inheritedDirection(host);let direction=resolvedDirectionCache.get(host);if(direction===void 0){direction=inheritedDirection(host);resolvedDirectionCache.set(host,direction)}return direction}const PLURAL_CATEGORY_FALLBACKS={zero:["zero","other"],one:["one","other"],two:["two","few","many","other"],few:["few","many","other"],many:["many","few","other"],other:["other"]};function isPluralMessage(message){return typeof message==="object"}function pluralSelector(values){const raw=values["pluralCount"]??values["count"];return typeof raw==="number"&&Number.isFinite(raw)?raw:void 0}const pluralLocaleCache=new Map;const MAX_PLURAL_LOCALE_ENTRIES=64;function pluralLocale(locale){const cached=pluralLocaleCache.get(locale);if(cached!==void 0||pluralLocaleCache.has(locale))return cached;let resolved;for(const candidate of localeCandidates(locale)){try{getPluralRules(candidate);resolved=candidate;break}catch{}}if(pluralLocaleCache.size>=MAX_PLURAL_LOCALE_ENTRIES)pluralLocaleCache.clear();pluralLocaleCache.set(locale,resolved);return resolved}function selectPluralMessage(message,locale,count){if(count===void 0)return message.other;const tag=pluralLocale(locale);if(tag===void 0)return message.other;const category=getPluralRules(tag).select(count);for(const candidate of PLURAL_CATEGORY_FALLBACKS[category]??PLURAL_CATEGORY_FALLBACKS.other){const text=message[candidate];if(text!==void 0)return text}return message.other}function resolveLyraString(host,key,overrides,fallback,values,defaults){const own=overrides?.[key];let message=own??fallback;let locale;if(message===void 0){locale=resolveLyraLocale(host);for(const candidate of localeCandidates(locale)){const registered=locales.get(candidate)?.[key];if(registered!==void 0){message=registered;break}}}message??=defaults?.[key]??key;let text;if(isPluralMessage(message)){locale??=resolveLyraLocale(host);text=selectPluralMessage(message,locale,values?pluralSelector(values):void 0)}else{text=message}if(!values)return text;return text.replace(/\{(\w+)\}/g,(_match,name)=>String(values[name]??`{${name}}`))}function resolveLocalizedParts(template,interpolate){let marker="\uE000";while(template.includes(marker))marker+="\uE001";return interpolate(marker).split(marker)}export{enableLyraLocaleCache,getLyraLocale,getLyraLocaleDirection,getRegisteredLyraLocales,invalidateLyraLocaleCache,registerLyraExactLocale,registerLyraLocale,resolveLocalizedParts,resolveLyraDirection,resolveLyraLocale,resolveLyraString,setLyraLocale,subscribeLyraLocale,subscribeLyraLocaleRegistry};
+import{getPluralRules}from"./intl-cache.js";const locales=new Map;const localeMeta=new Map;const exactOnlyLocales=new Set;const listeners=new Set;const registryListeners=new Set;let activeLocale="";function normalizeLocale(locale){return locale.trim().replace(/_/g,"-").toLowerCase()}function regionalFallbacks(subtags){const language=subtags[0];if(!language)return[];const requested=new Set(subtags);const score=key=>key.split("-").filter(subtag=>requested.has(subtag)).length;return[...locales.keys()].filter(key=>!exactOnlyLocales.has(key)&&key.split("-")[0]===language&&!isPrefixOf(key,subtags)).sort((a,b)=>score(b)-score(a)||(a<b?-1:a>b?1:0))}function isPrefixOf(key,subtags){const parts=key.split("-");return parts.length<=subtags.length&&parts.every((part,index)=>part===subtags[index])}function localeCandidates(locale){const normalized=normalizeLocale(locale);const subtags=normalized.split("-").filter(Boolean);const candidates=[];for(let length=subtags.length;length>0;length--){candidates.push(subtags.slice(0,length).join("-"))}candidates.push(...regionalFallbacks(subtags));if(!candidates.includes("en"))candidates.push("en");return candidates}function notify(){for(const listener of[...listeners])listener()}function getRegisteredLyraLocales(){const keys=new Set(["en",...locales.keys()]);return[...keys].sort()}function subscribeLyraLocaleRegistry(listener){registryListeners.add(listener);return()=>registryListeners.delete(listener)}function registerLocale(locale,strings,meta,exactOnly){const key=normalizeLocale(locale);if(!key)throw new TypeError("A locale is required.");if(exactOnly)exactOnlyLocales.add(key);locales.set(key,{...locales.get(key)??{},...strings});if(meta)localeMeta.set(key,{...localeMeta.get(key)??{},...meta});pluralLocaleCache.clear();notify();for(const listener of[...registryListeners])listener()}function registerLyraLocale(locale,strings,meta){registerLocale(locale,strings,meta,false)}function registerLyraExactLocale(locale,strings,meta){registerLocale(locale,strings,meta,true)}function getLyraLocaleDirection(locale){const normalized=normalizeLocale(locale);if(!normalized)return"ltr";for(const candidate of localeCandidates(normalized)){const declared=localeMeta.get(candidate)?.dir;if(declared)return declared}try{const resolved=new Intl.Locale(normalized);const direction=resolved.textInfo?.direction??resolved.getTextInfo?.().direction;return direction==="rtl"?"rtl":"ltr"}catch{return"ltr"}}function setLyraLocale(locale){const next=locale.trim();if(activeLocale===next)return;activeLocale=next;notify()}function getLyraLocale(){return activeLocale}function subscribeLyraLocale(listener){listeners.add(listener);return()=>listeners.delete(listener)}function inheritedLocale(host){const explicit=host.getAttribute("locale")||host.getAttribute("lang");if(explicit)return explicit;const composedParent=element=>{if(element.parentElement)return element.parentElement;const root=element.getRootNode();const candidate=root.host;return root.nodeType===11&&candidate!==null&&typeof candidate==="object"&&typeof candidate.getAttribute==="function"?candidate:null};let parent=composedParent(host);while(parent){const locale=parent.getAttribute("locale")||parent.getAttribute("lang");if(locale)return locale;parent=composedParent(parent)}const documentLocale=host.ownerDocument?.documentElement?.getAttribute("lang");if(documentLocale)return documentLocale;return activeLocale||"en"}const cacheableLocaleHosts=new WeakSet;const resolvedLocaleCache=new WeakMap;const resolvedDirectionCache=new WeakMap;function enableLyraLocaleCache(host){cacheableLocaleHosts.add(host)}function invalidateLyraLocaleCache(host){resolvedLocaleCache.delete(host);resolvedDirectionCache.delete(host)}function resolveLyraLocale(host){if(!cacheableLocaleHosts.has(host))return inheritedLocale(host);let locale=resolvedLocaleCache.get(host);if(locale===void 0){locale=inheritedLocale(host);resolvedLocaleCache.set(host,locale)}return locale}function inheritedDirection(host){const explicit=host.getAttribute("dir");if(explicit==="rtl"||explicit==="ltr")return explicit;const view=host.ownerDocument?.defaultView;if(view)return view.getComputedStyle(host).direction==="rtl"?"rtl":"ltr";return"ltr"}function resolveLyraDirection(host){if(!cacheableLocaleHosts.has(host))return inheritedDirection(host);let direction=resolvedDirectionCache.get(host);if(direction===void 0){direction=inheritedDirection(host);resolvedDirectionCache.set(host,direction)}return direction}function peekLyraLocale(host){return resolvedLocaleCache.get(host)}function peekLyraDirection(host){return resolvedDirectionCache.get(host)}const PLURAL_CATEGORY_FALLBACKS={zero:["zero","other"],one:["one","other"],two:["two","few","many","other"],few:["few","many","other"],many:["many","few","other"],other:["other"]};function isPluralMessage(message){return typeof message==="object"}function pluralSelector(values){const raw=values["pluralCount"]??values["count"];return typeof raw==="number"&&Number.isFinite(raw)?raw:void 0}const pluralLocaleCache=new Map;const MAX_PLURAL_LOCALE_ENTRIES=64;function pluralLocale(locale){const cached=pluralLocaleCache.get(locale);if(cached!==void 0||pluralLocaleCache.has(locale))return cached;let resolved;for(const candidate of localeCandidates(locale)){try{getPluralRules(candidate);resolved=candidate;break}catch{}}if(pluralLocaleCache.size>=MAX_PLURAL_LOCALE_ENTRIES)pluralLocaleCache.clear();pluralLocaleCache.set(locale,resolved);return resolved}function selectPluralMessage(message,locale,count){if(count===void 0)return message.other;const tag=pluralLocale(locale);if(tag===void 0)return message.other;const category=getPluralRules(tag).select(count);for(const candidate of PLURAL_CATEGORY_FALLBACKS[category]??PLURAL_CATEGORY_FALLBACKS.other){const text=message[candidate];if(text!==void 0)return text}return message.other}function resolveLyraString(host,key,overrides,fallback,values,defaults){const own=overrides?.[key];let message=own??fallback;let locale;if(message===void 0){locale=resolveLyraLocale(host);for(const candidate of localeCandidates(locale)){const registered=locales.get(candidate)?.[key];if(registered!==void 0){message=registered;break}}}message??=defaults?.[key]??key;let text;if(isPluralMessage(message)){locale??=resolveLyraLocale(host);text=selectPluralMessage(message,locale,values?pluralSelector(values):void 0)}else{text=message}if(!values)return text;return text.replace(/\{(\w+)\}/g,(_match,name)=>String(values[name]??`{${name}}`))}function resolveLocalizedParts(template,interpolate){let marker="\uE000";while(template.includes(marker))marker+="\uE001";return interpolate(marker).split(marker)}export{enableLyraLocaleCache,getLyraLocale,getLyraLocaleDirection,getRegisteredLyraLocales,invalidateLyraLocaleCache,peekLyraDirection,peekLyraLocale,registerLyraExactLocale,registerLyraLocale,resolveLocalizedParts,resolveLyraDirection,resolveLyraLocale,resolveLyraString,setLyraLocale,subscribeLyraLocale,subscribeLyraLocaleRegistry};

package/dist/internal/lyra-element.d.ts

@@ -68,6 +68,21 @@ export declare class LyraElement<Events = LyraEventMap> extends LitElement {
      */
     requestUpdate(name?: PropertyKey, oldValue?: unknown, options?: PropertyDeclaration): void;
     attributeChangedCallback(name: string, oldValue: string | null, value: string | null): void;
+    /**
+     * `class`/`style` sit in {@link INHERITED_CONTEXT_ATTRIBUTES} so a CSS-only ancestor direction
+     * change (`.rtl-context { direction: rtl }`, an inline `style="direction: rtl"`) is still
+     * picked up with no `dir` attribute anywhere — see the "reads computed direction live after
+     * ancestor style and class changes" test. But `class`/`style` also cover every OTHER reason an
+     * ancestor's inline style or class list might change, most of which have nothing to do with
+     * direction or locale (an overlay's own `--lr-overlay-stack-index` custom property, a consumer's
+     * unrelated theming class, …). A MutationObserver callback is its own microtask, scheduled
+     * independently of Lit's update batching, so an unconditional `requestUpdate()` here could land
+     * inside another in-flight update's `updated()`/`hostUpdated()` window purely because of a
+     * direction-irrelevant style write on some unrelated ancestor — Lit's dev-mode "scheduled an
+     * update after an update completed" warning, for a re-render that was never actually warranted
+     * (fr_asxOgk4UhNB07xevCWwFVQ). Comparing the freshly resolved direction/locale against the last
+     * observed pair keeps the feature intact while dropping every spurious trigger.
+     */
     private observeInheritedContext;
     /**
      * Runs `seed` before the first render — except while hydrating a server-rendered shadow root,

package/dist/internal/lyra-element.js

@@ -1 +1 @@
-var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect==="object"&&typeof Reflect.decorate==="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)if(d=decorators[i])r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r;return c>3&&r&&Object.defineProperty(target,key,r),r};import{LitElement}from"lit";import{property}from"lit/decorators.js";import{captureFormInternals,ExternalLabelController}from"./form-control-labels.js";import{tokens}from"./tokens.styles.js";import{palette}from"./tokens/palette.styles.js";import{resolveIntlLocale}from"./intl-cache.js";import{enableLyraLocaleCache,invalidateLyraLocaleCache,resolveLyraDirection,resolveLyraString,resolveLyraLocale,subscribeLyraLocale}from"./localization-runtime.js";const REACTIVE_HOST_ATTRIBUTES=["aria-label","aria-describedby","lang","dir"];const DIRECTION_HOST_ATTRIBUTES=["class","style"];const INHERITED_CONTEXT_ATTRIBUTES=["locale","lang","dir","class","style"];function composedParentElement(element){if(element.parentElement)return element.parentElement;const root=element.getRootNode();const candidate=root.host;return root.nodeType===11&&candidate!==null&&typeof candidate==="object"&&typeof candidate.getAttribute==="function"?candidate:null}class LyraElement extends LitElement{static{this.styles=[palette,tokens]}static{this.defaultStrings=Object.freeze({})}static get observedAttributes(){return[...new Set([...super.observedAttributes,...REACTIVE_HOST_ATTRIBUTES,...DIRECTION_HOST_ATTRIBUTES])]}constructor(){super();this.locale="";this.strings={};if(this.constructor.formAssociated){this.addController(new ExternalLabelController(this))}}attachInternals(){const internals=super.attachInternals();captureFormInternals(this,internals);return internals}connectedCallback(){this.hydratingServerShadow??=!this.hasUpdated&&this.shadowRoot!==null;super.connectedCallback();enableLyraLocaleCache(this);invalidateLyraLocaleCache(this);this.observeInheritedContext();this.stopLocaleSubscription=subscribeLyraLocale(()=>this.requestUpdate());const deferred=this.deferredAfterUpdate;if(deferred){this.deferredAfterUpdate=void 0;for(const[key,callback]of deferred)this.scheduleAfterUpdate(callback,key)}}disconnectedCallback(){this.pendingLoadController?.abort();this.pendingLoadController=void 0;this.stopLocaleSubscription?.();this.stopLocaleSubscription=void 0;this.inheritedContextObserver?.disconnect();this.inheritedContextObserver=void 0;invalidateLyraLocaleCache(this);super.disconnectedCallback()}requestUpdate(name,oldValue,options){invalidateLyraLocaleCache(this);super.requestUpdate(name,oldValue,options)}attributeChangedCallback(name,oldValue,value){super.attributeChangedCallback(name,oldValue,value);if(oldValue!==value&&REACTIVE_HOST_ATTRIBUTES.includes(name)){this.requestUpdate()}else if(oldValue!==value&&DIRECTION_HOST_ATTRIBUTES.includes(name)){invalidateLyraLocaleCache(this)}}observeInheritedContext(){this.inheritedContextObserver?.disconnect();const Observer=this.ownerDocument?.defaultView?.MutationObserver;if(!Observer)return;const observer=new Observer(()=>this.requestUpdate());let ancestor=composedParentElement(this);while(ancestor){observer.observe(ancestor,{attributes:true,attributeFilter:[...INHERITED_CONTEXT_ATTRIBUTES]});ancestor=composedParentElement(ancestor)}this.inheritedContextObserver=observer}seedFirstRenderState(seed){if(this.hasUpdated)return;if(!this.hydratingServerShadow){seed();return}void this.updateComplete.then(()=>{this.hydratingServerShadow=false;seed()},()=>{this.hydratingServerShadow=false})}beginAbortableLoad(){this.pendingLoadController?.abort();this.pendingLoadController=void 0;const AbortControllerCtor=this.ownerDocument.defaultView?.AbortController;if(!AbortControllerCtor)return void 0;this.pendingLoadController=new AbortControllerCtor;return this.pendingLoadController.signal}scheduleAfterUpdate(callback,key="load"){const pending=this.afterUpdateCallbacks??=new Map;if(pending.has(key))return;pending.set(key,callback);if(pending.size>1)return;queueMicrotask(()=>{const due=this.afterUpdateCallbacks;this.afterUpdateCallbacks=void 0;if(!due)return;if(this.isConnected){for(const due_callback of due.values())due_callback();return}const held=this.deferredAfterUpdate??=new Map;for(const[heldKey,heldCallback]of due)if(!held.has(heldKey))held.set(heldKey,heldCallback)})}localize(key,fallback,values){return resolveLyraString(this,key,this.strings,fallback,values,this.constructor.defaultStrings)}get effectiveMessageLocale(){return this.locale||resolveLyraLocale(this)}get effectiveLocale(){return resolveIntlLocale(this.effectiveMessageLocale)}get effectiveIntlLocale(){return this.effectiveLocale}get effectiveDirection(){return resolveLyraDirection(this)}addEventListener(type,listener,options){super.addEventListener(type,listener,options)}removeEventListener(type,listener,options){super.removeEventListener(type,listener,options)}emit(name,...args){const[detail,options]=args;const ownerDocument=this.ownerDocument;let CustomEventCtor=ownerDocument?.defaultView?.CustomEvent;if(!CustomEventCtor&&ownerDocument){try{const candidate=ownerDocument.createEvent("CustomEvent").constructor;if(typeof candidate==="function"){CustomEventCtor=candidate}}catch{}}CustomEventCtor??=globalThis.CustomEvent;const event=new CustomEventCtor(name,{detail,bubbles:true,composed:true,cancelable:options?.cancelable??false});this.dispatchEvent(event);return event}}__decorate([property({reflect:true})],LyraElement.prototype,"locale",void 0);__decorate([property({attribute:false})],LyraElement.prototype,"strings",void 0);export{LyraElement};
+var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect==="object"&&typeof Reflect.decorate==="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)if(d=decorators[i])r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r;return c>3&&r&&Object.defineProperty(target,key,r),r};import{LitElement}from"lit";import{property}from"lit/decorators.js";import{captureFormInternals,ExternalLabelController}from"./form-control-labels.js";import{tokens}from"./tokens.styles.js";import{palette}from"./tokens/palette.styles.js";import{resolveIntlLocale}from"./intl-cache.js";import{enableLyraLocaleCache,invalidateLyraLocaleCache,peekLyraDirection,peekLyraLocale,resolveLyraDirection,resolveLyraString,resolveLyraLocale,subscribeLyraLocale}from"./localization-runtime.js";const REACTIVE_HOST_ATTRIBUTES=["aria-label","aria-describedby","lang","dir"];const DIRECTION_HOST_ATTRIBUTES=["class","style"];const INHERITED_CONTEXT_ATTRIBUTES=["locale","lang","dir","class","style"];function composedParentElement(element){if(element.parentElement)return element.parentElement;const root=element.getRootNode();const candidate=root.host;return root.nodeType===11&&candidate!==null&&typeof candidate==="object"&&typeof candidate.getAttribute==="function"?candidate:null}const STYLE_DIRECTION_PATTERN=/(?:^|[;\s])direction\s*:\s*([^;]+)/i;function styleDirectionDeclaration(styleText){return STYLE_DIRECTION_PATTERN.exec(styleText)?.[1]?.trim()}class LyraElement extends LitElement{static{this.styles=[palette,tokens]}static{this.defaultStrings=Object.freeze({})}static get observedAttributes(){return[...new Set([...super.observedAttributes,...REACTIVE_HOST_ATTRIBUTES,...DIRECTION_HOST_ATTRIBUTES])]}constructor(){super();this.locale="";this.strings={};if(this.constructor.formAssociated){this.addController(new ExternalLabelController(this))}}attachInternals(){const internals=super.attachInternals();captureFormInternals(this,internals);return internals}connectedCallback(){this.hydratingServerShadow??=!this.hasUpdated&&this.shadowRoot!==null;super.connectedCallback();enableLyraLocaleCache(this);invalidateLyraLocaleCache(this);this.observeInheritedContext();this.stopLocaleSubscription=subscribeLyraLocale(()=>this.requestUpdate());const deferred=this.deferredAfterUpdate;if(deferred){this.deferredAfterUpdate=void 0;for(const[key,callback]of deferred)this.scheduleAfterUpdate(callback,key)}}disconnectedCallback(){this.pendingLoadController?.abort();this.pendingLoadController=void 0;this.stopLocaleSubscription?.();this.stopLocaleSubscription=void 0;this.inheritedContextObserver?.disconnect();this.inheritedContextObserver=void 0;invalidateLyraLocaleCache(this);super.disconnectedCallback()}requestUpdate(name,oldValue,options){invalidateLyraLocaleCache(this);super.requestUpdate(name,oldValue,options)}attributeChangedCallback(name,oldValue,value){super.attributeChangedCallback(name,oldValue,value);if(oldValue!==value&&REACTIVE_HOST_ATTRIBUTES.includes(name)){this.requestUpdate()}else if(oldValue!==value&&DIRECTION_HOST_ATTRIBUTES.includes(name)){invalidateLyraLocaleCache(this)}}observeInheritedContext(){this.inheritedContextObserver?.disconnect();const Observer=this.ownerDocument?.defaultView?.MutationObserver;if(!Observer)return;let lastLocale;let lastDirection;let checkQueued=false;let recheckDirection=false;const check=()=>{checkQueued=false;const resolveDirection=recheckDirection;recheckDirection=false;lastLocale??=peekLyraLocale(this);if(resolveDirection)lastDirection??=peekLyraDirection(this);const priorLocale=lastLocale;const priorDirection=lastDirection;invalidateLyraLocaleCache(this);const locale=resolveLyraLocale(this);lastLocale=locale;const localeChanged=priorLocale!==void 0&&locale!==priorLocale;let directionChanged=false;if(resolveDirection){const direction=resolveLyraDirection(this);directionChanged=priorDirection!==void 0&&direction!==priorDirection;lastDirection=direction}if(localeChanged||directionChanged)this.requestUpdate()};const observer=new Observer(records=>{for(const record of records){if(record.attributeName==="dir"||record.attributeName==="class"){recheckDirection=true;break}if(record.attributeName==="style"){const target=record.target;const before=record.oldValue??"";const after=target.getAttribute("style")??"";if(styleDirectionDeclaration(before)!==styleDirectionDeclaration(after)){recheckDirection=true;break}}}if(checkQueued)return;checkQueued=true;queueMicrotask(check)});let ancestor=composedParentElement(this);while(ancestor){observer.observe(ancestor,{attributes:true,attributeOldValue:true,attributeFilter:[...INHERITED_CONTEXT_ATTRIBUTES]});ancestor=composedParentElement(ancestor)}this.inheritedContextObserver=observer}seedFirstRenderState(seed){if(this.hasUpdated)return;if(!this.hydratingServerShadow){seed();return}void this.updateComplete.then(()=>{this.hydratingServerShadow=false;seed()},()=>{this.hydratingServerShadow=false})}beginAbortableLoad(){this.pendingLoadController?.abort();this.pendingLoadController=void 0;const AbortControllerCtor=this.ownerDocument.defaultView?.AbortController;if(!AbortControllerCtor)return void 0;this.pendingLoadController=new AbortControllerCtor;return this.pendingLoadController.signal}scheduleAfterUpdate(callback,key="load"){const pending=this.afterUpdateCallbacks??=new Map;if(pending.has(key))return;pending.set(key,callback);if(pending.size>1)return;queueMicrotask(()=>{const due=this.afterUpdateCallbacks;this.afterUpdateCallbacks=void 0;if(!due)return;if(this.isConnected){for(const due_callback of due.values())due_callback();return}const held=this.deferredAfterUpdate??=new Map;for(const[heldKey,heldCallback]of due)if(!held.has(heldKey))held.set(heldKey,heldCallback)})}localize(key,fallback,values){return resolveLyraString(this,key,this.strings,fallback,values,this.constructor.defaultStrings)}get effectiveMessageLocale(){return this.locale||resolveLyraLocale(this)}get effectiveLocale(){return resolveIntlLocale(this.effectiveMessageLocale)}get effectiveIntlLocale(){return this.effectiveLocale}get effectiveDirection(){return resolveLyraDirection(this)}addEventListener(type,listener,options){super.addEventListener(type,listener,options)}removeEventListener(type,listener,options){super.removeEventListener(type,listener,options)}emit(name,...args){const[detail,options]=args;const ownerDocument=this.ownerDocument;let CustomEventCtor=ownerDocument?.defaultView?.CustomEvent;if(!CustomEventCtor&&ownerDocument){try{const candidate=ownerDocument.createEvent("CustomEvent").constructor;if(typeof candidate==="function"){CustomEventCtor=candidate}}catch{}}CustomEventCtor??=globalThis.CustomEvent;const event=new CustomEventCtor(name,{detail,bubbles:true,composed:true,cancelable:options?.cancelable??false});this.dispatchEvent(event);return event}}__decorate([property({reflect:true})],LyraElement.prototype,"locale",void 0);__decorate([property({attribute:false})],LyraElement.prototype,"strings",void 0);export{LyraElement};

package/dist/internal/package-metadata.d.ts

@@ -3,4 +3,4 @@
  * Run `pnpm package-metadata` after changing package identity or version.
  */
 export declare const LYRA_PACKAGE_NAME: "@aceshooting/lyra-ui";
-export declare const LYRA_PACKAGE_VERSION: "8.1.0";
+export declare const LYRA_PACKAGE_VERSION: "8.2.1";

package/dist/internal/package-metadata.js

@@ -1 +1 @@
-const LYRA_PACKAGE_NAME="@aceshooting/lyra-ui";const LYRA_PACKAGE_VERSION="8.1.0";export{LYRA_PACKAGE_NAME,LYRA_PACKAGE_VERSION};
+const LYRA_PACKAGE_NAME="@aceshooting/lyra-ui";const LYRA_PACKAGE_VERSION="8.2.1";export{LYRA_PACKAGE_NAME,LYRA_PACKAGE_VERSION};

package/dist/testing/happy-dom-shims.d.ts

@@ -45,5 +45,5 @@ export declare function installHappyDomFormAssociatedShims(): void;
 /** Test-only: returns a fresh stub `ElementInternals`-shaped object, independent of whether
  *  `attachInternals` already exists natively -- exists purely so this module's own test can
  *  verify the stub's call-shape coverage without needing to run under happy-dom itself. */
-export declare function installStubInternalsForTest(_host: Element): StubElementInternals;
+export declare function installStubInternalsForTest(host: Element): StubElementInternals;
 export {};

package/dist/testing/happy-dom-shims.js

@@ -1 +1 @@
-function createStubInternals(){return{form:null,labels:document.createDocumentFragment().querySelectorAll("label"),states:new Set,validity:{valid:true},validationMessage:"",willValidate:true,setFormValue(){},checkValidity(){return true},reportValidity(){return true},setValidity(){}}}function installHappyDomFormAssociatedShims(){if(typeof HTMLElement==="undefined")return;if(typeof HTMLElement.prototype.attachInternals==="function")return;HTMLElement.prototype.attachInternals=function attachInternals(){return createStubInternals()}}function installStubInternalsForTest(_host){return createStubInternals()}export{installHappyDomFormAssociatedShims,installStubInternalsForTest};
+function createStubInternals(host){return{get form(){return host.closest("form")},labels:document.createDocumentFragment().querySelectorAll("label"),states:new Set,validity:{valid:true},validationMessage:"",willValidate:true,setFormValue(){},checkValidity(){return true},reportValidity(){return true},setValidity(){}}}function installHappyDomFormAssociatedShims(){if(typeof HTMLElement==="undefined")return;if(typeof HTMLElement.prototype.attachInternals==="function")return;HTMLElement.prototype.attachInternals=function attachInternals(){return createStubInternals(this)}}function installStubInternalsForTest(host){return createStubInternals(host)}export{installHappyDomFormAssociatedShims,installStubInternalsForTest};

package/llms/components/lr-checkbox-group.md

@@ -40,6 +40,8 @@ goes back to `valueMissing`. It survives every child toggle, slot change and for
 Session restore uses a `FormData` state containing the repeated selected strings; it is independent
 of the control's current `name`, preserves duplicate-value cardinality, waits for early-arriving
 option children, and falls back to an empty selection for malformed state. Restoration is silent.
+`click()` forwards focus to the first enabled checkbox, so the host behaves like a single control
+rather than a no-op under a `<label>`-driven or programmatic click.
 **CSS parts:** `form-control`, `form-control-label`, `options` / `form-control-input`, `hint`,
 `error`.
 **The required marker.** `required` with a non-empty group `label` paints the library's shared

package/llms/components/lr-graph-query-builder.md

@@ -33,7 +33,9 @@ restores the control's own computed validity rather than forcing it valid — a
 field edit) and `form.reset()`, exactly like a native control, where only another
 `setCustomValidity('')` clears it. The message is caller-supplied and is used verbatim, never
 localized, and it is whole-control state: it does not land in `errors`, which is keyed by the
-csspart of the field a message belongs to.
+csspart of the field a message belongs to. `click()` forwards focus to the first rendered field
+(start/end/hop-limit/direction/save-name, in that order), so the host behaves like a single
+control rather than a no-op under a `<label>`-driven or programmatic click.
 
 **Events:** `lr-input`, `lr-validity-change`, `lr-invalid` (no detail; one bubbling/composed alias
 when the complete builder fails a native validity check),

package/llms/components/lr-radio-group.md

@@ -71,4 +71,6 @@ options and its messages, scaled by `size` through the shared control ladder.
 **Methods:** `setCustomValidity(message = '')` sets or clears a group-level consumer error. A
 non-empty message raises `customError` and blocks submission; `setCustomValidity('')` and
 `resetValidity()` restore the group's computed validity, including `valueMissing` when a required
-group has no selected radio.
+group has no selected radio. `focus()` moves focus to the selected (or first enabled) radio;
+`click()` mirrors it by activating that same radio, so the group behaves like a single control
+under both APIs rather than leaving `click()` a no-op.

package/llms/components/lr-rubric-form.md

@@ -46,6 +46,8 @@ express ("this item was already annotated by someone else"): a non-empty message
 required keys, and any key with an unsupported `type`, still hold it invalid. It is independent of
 the per-key `errors` map, which stays a read-out of this rubric's own field rules, so a message set
 here is never attributed to one key. It survives every `value`/`keys` write and a form reset.
+`click()` forwards to the active field (the same one a submit-and-next transition auto-focuses),
+so the host behaves like a single control under both a `<label>`-driven and a programmatic click.
 
 **CSS parts:** `base` (the outer `role="group"` wrapper), `field` (one key's wrapper), `label`, `description`,
 `scale` (the rendered score/category/comment control's wrapper), `error` (a field-level validation

package/llms/components/lr-tool-param-form.md

@@ -87,6 +87,9 @@ and makes the form invalid instead of being silently accepted.
   re-runs the validity sync) and a `form.reset()`, matching a native control. The message is
   whole-control state, so it is deliberately absent from `errors`, which is keyed by schema
   property; it is caller-supplied content and is used verbatim, never localized.
+- `click(): void` — forwards a host click to the first generated field's control, so the form
+  behaves like a single control under both a `<label>`-driven and a programmatic click; a no-op
+  while `disabled`.
 
 **Events:** `lr-input` (`detail: { value: Record<string, unknown> }` — the full current value
 object, every property with defaults resolved, not just the field that changed), `lr-validity-change`

package/llms/peers.md

@@ -53,7 +53,7 @@ changes the component library version without installing a supported SheetJS rel
 | `postal-mime` | `^2.7.5` | `lr-email-viewer` |
 | `qrcode` | `^1.5.4` | `lr-qr-code` |
 | `react` | `>=19 <20` | type-only `@aceshooting/lyra-ui/custom-elements-jsx` entry (no runtime import) |
-| `shiki` | `^4.4.1` | `lr-code-block`, `lr-code-block-core`, `lr-diff-view`, `lr-document-compare`, `lr-markdown`, `lr-markdown-core`, `lr-message-parts`, `lr-widget-renderer` |
+| `shiki` | `^4.4.2` | `lr-code-block`, `lr-code-block-core`, `lr-diff-view`, `lr-document-compare`, `lr-markdown`, `lr-markdown-core`, `lr-message-parts`, `lr-widget-renderer` |
 | `svelte` | `>=5 <6` | type-only `@aceshooting/lyra-ui/svelte` entry (no runtime import) |
 | `vue` | `>=3.5 <4` | type-only `@aceshooting/lyra-ui/vue` entry (no runtime import) |
 | `xlsx` | `>=0.20.3 <0.21.0` | `lr-spreadsheet-viewer` |

package/llms-full.txt

@@ -5277,7 +5277,9 @@ options and its messages, scaled by `size` through the shared control ladder.
 **Methods:** `setCustomValidity(message = '')` sets or clears a group-level consumer error. A
 non-empty message raises `customError` and blocks submission; `setCustomValidity('')` and
 `resetValidity()` restore the group's computed validity, including `valueMissing` when a required
-group has no selected radio.
+group has no selected radio. `focus()` moves focus to the selected (or first enabled) radio;
+`click()` mirrors it by activating that same radio, so the group behaves like a single control
+under both APIs rather than leaving `click()` a no-op.
 
 ## `lr-checkbox-group`
 
@@ -5306,6 +5308,8 @@ goes back to `valueMissing`. It survives every child toggle, slot change and for
 Session restore uses a `FormData` state containing the repeated selected strings; it is independent
 of the control's current `name`, preserves duplicate-value cardinality, waits for early-arriving
 option children, and falls back to an empty selection for malformed state. Restoration is silent.
+`click()` forwards focus to the first enabled checkbox, so the host behaves like a single control
+rather than a no-op under a `<label>`-driven or programmatic click.
 **CSS parts:** `form-control`, `form-control-label`, `options` / `form-control-input`, `hint`,
 `error`.
 **The required marker.** `required` with a non-empty group `label` paints the library's shared
@@ -5932,6 +5936,8 @@ express ("this item was already annotated by someone else"): a non-empty message
 required keys, and any key with an unsupported `type`, still hold it invalid. It is independent of
 the per-key `errors` map, which stays a read-out of this rubric's own field rules, so a message set
 here is never attributed to one key. It survives every `value`/`keys` write and a form reset.
+`click()` forwards to the active field (the same one a submit-and-next transition auto-focuses),
+so the host behaves like a single control under both a `<label>`-driven and a programmatic click.
 
 **CSS parts:** `base` (the outer `role="group"` wrapper), `field` (one key's wrapper), `label`, `description`,
 `scale` (the rendered score/category/comment control's wrapper), `error` (a field-level validation
@@ -8532,7 +8538,9 @@ restores the control's own computed validity rather than forcing it valid — a
 field edit) and `form.reset()`, exactly like a native control, where only another
 `setCustomValidity('')` clears it. The message is caller-supplied and is used verbatim, never
 localized, and it is whole-control state: it does not land in `errors`, which is keyed by the
-csspart of the field a message belongs to.
+csspart of the field a message belongs to. `click()` forwards focus to the first rendered field
+(start/end/hop-limit/direction/save-name, in that order), so the host behaves like a single
+control rather than a no-op under a `<label>`-driven or programmatic click.
 
 **Events:** `lr-input`, `lr-validity-change`, `lr-invalid` (no detail; one bubbling/composed alias
 when the complete builder fails a native validity check),
@@ -22936,6 +22944,9 @@ and makes the form invalid instead of being silently accepted.
   re-runs the validity sync) and a `form.reset()`, matching a native control. The message is
   whole-control state, so it is deliberately absent from `errors`, which is keyed by schema
   property; it is caller-supplied content and is used verbatim, never localized.
+- `click(): void` — forwards a host click to the first generated field's control, so the form
+  behaves like a single control under both a `<label>`-driven and a programmatic click; a no-op
+  while `disabled`.
 
 **Events:** `lr-input` (`detail: { value: Record<string, unknown> }` — the full current value
 object, every property with defaults resolved, not just the field that changed), `lr-validity-change`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aceshooting/lyra-ui",
-  "version": "8.1.0",
+  "version": "8.2.1",
   "description": "Free, independent Lit web components: an open-source alternative to Shoelace and Web Awesome with accessible forms, dashboards, charts, and agent UI.",
   "keywords": [
     "web-components",
@@ -1379,7 +1379,7 @@
     "postal-mime": "^2.7.5",
     "qrcode": "^1.5.4",
     "react": ">=19 <20",
-    "shiki": "^4.4.1",
+    "shiki": "^4.4.2",
     "svelte": ">=5 <6",
     "vue": ">=3.5 <4",
     "xlsx": ">=0.20.3 <0.21.0"
@@ -1521,10 +1521,10 @@
     "postal-mime": "^2.7.5",
     "qrcode": "^1.5.4",
     "react": "^19.2.8",
-    "shiki": "^4.4.1",
+    "shiki": "^4.4.2",
     "svelte": "^5.56.8",
     "typescript": "^7.0.2",
-    "vue": "^3.5.40",
+    "vue": "^3.5.41",
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz"
   },
   "customElements": "custom-elements.json",

package/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@aceshooting/lyra-ui",
-  "version": "8.1.0",
+  "version": "8.2.1",
   "description-markup": "markdown",
   "contributions": {
     "html": {