@aceshooting/lyra-ui 19.0.1 → 20.0.1

package/dist/components/data/graph-query-builder/graph-query-builder.class.d.ts

@@ -48,7 +48,27 @@ export interface GraphQuerySaveDetail{readonly name:string;readonly query:GraphQ
 /** Frozen payload shared by the load request and accepted notification. */
 export interface GraphQueryLoadDetail{readonly queryId:string;readonly query:GraphQuery;}
 /** Frozen payload shared by the delete request and accepted notification. */
-export interface GraphQueryDeleteDetail{readonly queryId:string;}export interface LyraGraphQueryBuilderEventMap{'lr-invalid':CustomEvent<null>;'lr-input':CustomEvent<LyraEventDetailSnapshot<{readonly value:GraphQuery;}>>;'lr-validity-change':CustomEvent<{readonly valid:boolean;readonly errors:Readonly<Record<string,string>>;}>;'lr-before-query-run':CustomEvent<LyraEventDetailSnapshot<GraphQueryRunDetail>>;'lr-query-run':CustomEvent<LyraEventDetailSnapshot<GraphQueryRunDetail>>;'lr-before-query-save':CustomEvent<LyraEventDetailSnapshot<GraphQuerySaveDetail>>;'lr-query-save':CustomEvent<LyraEventDetailSnapshot<GraphQuerySaveDetail>>;'lr-before-query-load':CustomEvent<LyraEventDetailSnapshot<GraphQueryLoadDetail>>;'lr-query-load':CustomEvent<LyraEventDetailSnapshot<GraphQueryLoadDetail>>;'lr-before-query-delete':CustomEvent<GraphQueryDeleteDetail>;'lr-query-delete':CustomEvent<GraphQueryDeleteDetail>;}
+export interface GraphQueryDeleteDetail{readonly queryId:string;}export interface LyraGraphQueryBuilderEventMap{'lr-invalid':CustomEvent<null>;'lr-input':CustomEvent<LyraEventDetailSnapshot<{readonly value:GraphQuery;}>>;'lr-validity-change':CustomEvent<{readonly valid:boolean;readonly errors:Readonly<Record<string,string>>;}>;
+/** Canonical name for the run veto point. */
+'lr-query-run-request':CustomEvent<LyraEventDetailSnapshot<GraphQueryRunDetail>>;
+/** Deprecated alias of `lr-query-run-request`, kept firing unchanged for back-compat; slated
+*  for removal in 21.0.0. */
+'lr-before-query-run':CustomEvent<LyraEventDetailSnapshot<GraphQueryRunDetail>>;'lr-query-run':CustomEvent<LyraEventDetailSnapshot<GraphQueryRunDetail>>;
+/** Canonical name for the save veto point. */
+'lr-query-save-request':CustomEvent<LyraEventDetailSnapshot<GraphQuerySaveDetail>>;
+/** Deprecated alias of `lr-query-save-request`, kept firing unchanged for back-compat; slated
+*  for removal in 21.0.0. */
+'lr-before-query-save':CustomEvent<LyraEventDetailSnapshot<GraphQuerySaveDetail>>;'lr-query-save':CustomEvent<LyraEventDetailSnapshot<GraphQuerySaveDetail>>;
+/** Canonical name for the load veto point. */
+'lr-query-load-request':CustomEvent<LyraEventDetailSnapshot<GraphQueryLoadDetail>>;
+/** Deprecated alias of `lr-query-load-request`, kept firing unchanged for back-compat; slated
+*  for removal in 21.0.0. */
+'lr-before-query-load':CustomEvent<LyraEventDetailSnapshot<GraphQueryLoadDetail>>;'lr-query-load':CustomEvent<LyraEventDetailSnapshot<GraphQueryLoadDetail>>;
+/** Canonical name for the delete veto point. */
+'lr-query-delete-request':CustomEvent<GraphQueryDeleteDetail>;
+/** Deprecated alias of `lr-query-delete-request`, kept firing unchanged for back-compat; slated
+*  for removal in 21.0.0. */
+'lr-before-query-delete':CustomEvent<GraphQueryDeleteDetail>;'lr-query-delete':CustomEvent<GraphQueryDeleteDetail>;}
 /**
 * `<lr-graph-query-builder>` — an editor for a single typed relationship/path filter
 * (`GraphQuery`) over a knowledge graph: start/end entity anchors, relationship-type and
@@ -96,9 +116,12 @@ export interface GraphQueryDeleteDetail{readonly queryId:string;}export interfac
 * updates. Ordinary focused removal still follows the adjacent control and leaves outside focus alone.
 *
 * Run, save, load, and delete use the same two-phase action contract: a cancelable
-* `lr-before-query-*` request precedes any local effect, followed by a non-cancelable
-* `lr-query-*` accepted notification. Vetoing a request suppresses its accepted notification;
-* for save it also preserves the draft name, and for load it preserves the current `value`.
+* `lr-query-*-request` request precedes any local effect, followed by a non-cancelable
+* `lr-query-*` accepted notification. The deprecated `lr-before-query-*` alias of each request
+* fires immediately after its canonical `lr-query-*-request` counterpart, from the same gesture,
+* with the same detail; either one vetoes the action. Vetoing a request suppresses its accepted
+* notification; for save it also preserves the draft name, and for load it preserves the current
+* `value`.
 *
 * **Accessible name:** a host-level `aria-label` wins. Otherwise the region (`role="group"`) is
 * labelled by the same visible label element that renders the `label` slot/property/localized
@@ -114,25 +137,39 @@ export interface GraphQueryDeleteDetail{readonly queryId:string;}export interfac
 *   choices emit it once; child native/prefixed value and listbox lifecycle aliases are contained.
 * @event lr-validity-change - Frozen `detail: { valid, errors }` from effective native validity,
 *   including custom errors and validation barring; fired only on an actual change.
-* @event lr-before-query-run - Cancelable request emitted after `reportValidity()` passes, before
-*   accepting Run. Frozen `detail: { query }`; vetoing it suppresses `lr-query-run`.
+* @event lr-query-run-request - Cancelable request emitted after `reportValidity()` passes, before
+*   accepting Run. Frozen `detail: { query }`; vetoing it suppresses `lr-query-run`. Fires before
+*   `lr-before-query-run`, from the same gesture; either event may veto.
+* @event lr-before-query-run - Deprecated cancelable alias of `lr-query-run-request`, kept firing unchanged
+*   for back-compat; slated for removal in 21.0.0. Same frozen detail.
 * @event lr-query-run - Non-cancelable accepted Run notification. Frozen `detail: { query }`.
-* @event lr-before-query-save - Cancelable save request with frozen `detail: { name, query }`.
-*   Vetoing it preserves the draft name and suppresses `lr-query-save`.
+* @event lr-query-save-request - Cancelable save request with frozen `detail: { name, query }`.
+*   Vetoing it preserves the draft name and suppresses `lr-query-save`. Fires before
+*   `lr-before-query-save`, from the same gesture; either event may veto.
+* @event lr-before-query-save - Deprecated cancelable alias of `lr-query-save-request`, kept firing unchanged
+*   for back-compat; slated for removal in 21.0.0. Same frozen detail.
 * @event lr-query-save - Non-cancelable accepted Save notification. Frozen
 *   `detail: { name, query }`; the host assigns an id and appends to `savedQueries`.
-* @event lr-before-query-load - Cancelable load request with frozen `detail: { queryId, query }`,
-*   emitted before `value` changes. Vetoing it preserves the current query.
+* @event lr-query-load-request - Cancelable load request with frozen `detail: { queryId, query }`,
+*   emitted before `value` changes. Vetoing it preserves the current query. Fires before
+*   `lr-before-query-load`, from the same gesture; either event may veto.
+* @event lr-before-query-load - Deprecated cancelable alias of `lr-query-load-request`, kept firing unchanged
+*   for back-compat; slated for removal in 21.0.0. Same frozen detail.
 * @event lr-query-load - Non-cancelable accepted Load notification emitted after `value` changes.
 *   Frozen `detail: { queryId, query }` contains the accepted query.
-* @event lr-before-query-delete - Cancelable delete request with frozen `detail: { queryId }`.
-*   Vetoing it suppresses `lr-query-delete`.
+* @event lr-query-delete-request - Cancelable delete request with frozen `detail: { queryId }`.
+*   Vetoing it suppresses `lr-query-delete`. Fires before `lr-before-query-delete`, from the same
+*   gesture; either event may veto.
+* @event lr-before-query-delete - Deprecated cancelable alias of `lr-query-delete-request`, kept firing
+*   unchanged for back-compat; slated for removal in 21.0.0. Same frozen detail.
 * @event lr-query-delete - Non-cancelable accepted Delete notification. Frozen
 *   `detail: { queryId }`; the host removes the matching entry from `savedQueries`.
 * @event lr-invalid - Cancelable alias when the complete builder fails native validity; vetoing it
 *   also suppresses the native invalid default.
 * @csspart base - The outer wrapper around every section.
-* @csspart label - Visible label for the complete form control.
+* @csspart form-control-label - Visible label for the complete form control; shares the same
+*   node as the `label` compatibility alias.
+* @csspart label - Compatibility alias for `form-control-label`.
 * @csspart hint - Supporting text for the complete form control.
 * @csspart error - Error text for the complete form control.
 * @csspart path-fields - The row wrapping the start/end entity inputs and hop-count selects.

package/dist/components/data/graph-query-builder/graph-query-builder.class.js

@@ -1,4 +1,4 @@
-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--)(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{html,nothing}from"lit";import{property,query,state}from"lit/decorators.js";import{LyraElement}from"../../../internal/lyra-element.js";import{installFormControlLabelSupport}from"../../../internal/form-control-labels.js";installFormControlLabelSupport();import{closeIcon}from"../../../internal/icons.js";import{collectInitialSlotAssignment}from"../../../internal/initial-slot-collection.js";import{AnchoredValidityController,VALIDITY_ANCHOR}from"../../../internal/anchored-validity.js";import{syncValidityStates}from"../../../internal/custom-states.js";import{finiteInteger}from"../../../internal/numbers.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{nextId}from"../../../internal/a11y.js";import{activeElementIn,deepActiveElementIn}from"../../../internal/active-element.js";import{styles}from"./graph-query-builder.styles.js";import{attachInternalsSafely}from"../../../internal/element-internals.js";import{getFormOwner,installCustomErrorProperty,isBarredFromValidation,setFormOwner}from"../../../internal/form-associated.js";import{installInteractionOnInvalid,installInvalidEventAlias,withStaticValidityCheck}from"../../../internal/invalid-event-alias.js";import{acquireResolvedAriaRelationship}from"../../../internal/aria-controls.js";import{LYRA_DEFAULT_fieldRequired,LYRA_DEFAULT_graphQueryBuilderLabel,LYRA_DEFAULT_graphQueryDeleteWithContext,LYRA_DEFAULT_graphQueryDirectionLabel,LYRA_DEFAULT_graphQueryEndLabel,LYRA_DEFAULT_graphQueryHopRangeInvalid,LYRA_DEFAULT_graphQueryLoadWithContext,LYRA_DEFAULT_graphQueryMaxHopsLabel,LYRA_DEFAULT_graphQueryMinHopsLabel,LYRA_DEFAULT_graphQueryNodeTypeLabel,LYRA_DEFAULT_graphQueryRelationshipTypeLabel,LYRA_DEFAULT_graphQueryRun,LYRA_DEFAULT_graphQuerySaveButton,LYRA_DEFAULT_graphQuerySaveNameLabel,LYRA_DEFAULT_graphQuerySavedQueriesLabel,LYRA_DEFAULT_graphQueryStartLabel,LYRA_DEFAULT_neighborDirectionBoth,LYRA_DEFAULT_neighborDirectionIn,LYRA_DEFAULT_neighborDirectionOut,LYRA_DEFAULT_noData,LYRA_DEFAULT_select}from"../../../internal/default-strings.generated.js";const MAX_TYPES=500,MAX_SAVED_QUERIES=200,MAX_TEXT=256,EMPTY_STRINGS=Object.freeze([]),EMPTY_VALUE=Object.freeze({startId:"",endId:"",relationshipTypes:EMPTY_STRINGS,nodeTypes:EMPTY_STRINGS,direction:"both",minHops:1,maxHops:1}),EMPTY_OPTIONS=Object.freeze([]),EMPTY_SAVED=Object.freeze([]);function ownValue(record,key){try{const descriptor=Object.getOwnPropertyDescriptor(record,key);return descriptor&&"value"in descriptor?descriptor.value:void 0}catch{return}}function boundedString(value){return typeof value=="string"?value.slice(0,MAX_TEXT):""}function stringArray(value){return Array.isArray(value)?Object.freeze([...new Set(value.slice(0,MAX_TYPES).filter(entry=>typeof entry=="string").map(entry=>boundedString(entry)).filter(Boolean))]):EMPTY_STRINGS}function normalizeGraphQuery(value){const record=value!==null&&typeof value=="object"&&!Array.isArray(value)?value:EMPTY_VALUE,direction=ownValue(record,"direction");return Object.freeze({startId:boundedString(ownValue(record,"startId")),endId:boundedString(ownValue(record,"endId")),relationshipTypes:stringArray(ownValue(record,"relationshipTypes")),nodeTypes:stringArray(ownValue(record,"nodeTypes")),direction:direction==="out"||direction==="in"||direction==="both"?direction:"both",minHops:finiteInteger(typeof ownValue(record,"minHops")=="number"?ownValue(record,"minHops"):EMPTY_VALUE.minHops,EMPTY_VALUE.minHops,1,20),maxHops:finiteInteger(typeof ownValue(record,"maxHops")=="number"?ownValue(record,"maxHops"):EMPTY_VALUE.maxHops,EMPTY_VALUE.maxHops,1,20)})}function normalizeTypeOptions(value){if(!Array.isArray(value))return EMPTY_OPTIONS;const values=new Set,result=[];for(const candidate of value.slice(0,MAX_TYPES)){if(candidate===null||typeof candidate!="object"||Array.isArray(candidate))continue;const optionValue=boundedString(ownValue(candidate,"value"));if(optionValue.trim().length===0||values.has(optionValue))continue;values.add(optionValue);const label=boundedString(ownValue(candidate,"label"));result.push(Object.freeze({value:optionValue,...label?{label}:{}}))}return Object.freeze(result)}function normalizeSavedQueries(value){if(!Array.isArray(value))return EMPTY_SAVED;const ids=new Set,result=[];for(const candidate of value.slice(0,MAX_SAVED_QUERIES)){if(candidate===null||typeof candidate!="object"||Array.isArray(candidate))continue;const id=boundedString(ownValue(candidate,"id"));id.trim().length===0||ids.has(id)||(ids.add(id),result.push(Object.freeze({id,name:boundedString(ownValue(candidate,"name")),query:normalizeGraphQuery(ownValue(candidate,"query"))})))}return Object.freeze(result)}class LyraGraphQueryBuilder extends LyraElement{static{this.defaultStrings={...super.defaultStrings,fieldRequired:LYRA_DEFAULT_fieldRequired,graphQueryBuilderLabel:LYRA_DEFAULT_graphQueryBuilderLabel,graphQueryDeleteWithContext:LYRA_DEFAULT_graphQueryDeleteWithContext,graphQueryDirectionLabel:LYRA_DEFAULT_graphQueryDirectionLabel,graphQueryEndLabel:LYRA_DEFAULT_graphQueryEndLabel,graphQueryHopRangeInvalid:LYRA_DEFAULT_graphQueryHopRangeInvalid,graphQueryLoadWithContext:LYRA_DEFAULT_graphQueryLoadWithContext,graphQueryMaxHopsLabel:LYRA_DEFAULT_graphQueryMaxHopsLabel,graphQueryMinHopsLabel:LYRA_DEFAULT_graphQueryMinHopsLabel,graphQueryNodeTypeLabel:LYRA_DEFAULT_graphQueryNodeTypeLabel,graphQueryRelationshipTypeLabel:LYRA_DEFAULT_graphQueryRelationshipTypeLabel,graphQueryRun:LYRA_DEFAULT_graphQueryRun,graphQuerySaveButton:LYRA_DEFAULT_graphQuerySaveButton,graphQuerySaveNameLabel:LYRA_DEFAULT_graphQuerySaveNameLabel,graphQuerySavedQueriesLabel:LYRA_DEFAULT_graphQuerySavedQueriesLabel,graphQueryStartLabel:LYRA_DEFAULT_graphQueryStartLabel,neighborDirectionBoth:LYRA_DEFAULT_neighborDirectionBoth,neighborDirectionIn:LYRA_DEFAULT_neighborDirectionIn,neighborDirectionOut:LYRA_DEFAULT_neighborDirectionOut,noData:LYRA_DEFAULT_noData,select:LYRA_DEFAULT_select}}static{this.formAssociated=!0}static{this.styles=[LyraElement.styles,styles]}static{this.immutableEventDetails=Object.freeze(["lr-input","lr-before-query-run","lr-query-run","lr-before-query-save","lr-query-save","lr-before-query-load","lr-query-load"])}static{this.properties={customError:{attribute:"custom-error",reflect:!0,noAccessor:!0},name:{reflect:!0,noAccessor:!0},value:{attribute:!1,noAccessor:!0},disabled:{type:Boolean,reflect:!0,noAccessor:!0}}}get relationshipTypeOptions(){return this._relationshipTypeOptions}set relationshipTypeOptions(value){const previous=this._relationshipTypeOptions;this._relationshipTypeOptions=normalizeTypeOptions(value),this.requestUpdate("relationshipTypeOptions",previous)}get nodeTypeOptions(){return this._nodeTypeOptions}set nodeTypeOptions(value){const previous=this._nodeTypeOptions;this._nodeTypeOptions=normalizeTypeOptions(value),this.requestUpdate("nodeTypeOptions",previous)}get savedQueries(){return this._savedQueries}set savedQueries(value){const previous=this._savedQueries;this._savedQueries=normalizeSavedQueries(value),this.requestUpdate("savedQueries",previous)}constructor(){super(),this._relationshipTypeOptions=EMPTY_OPTIONS,this._nodeTypeOptions=EMPTY_OPTIONS,this._savedQueries=EMPTY_SAVED,this.hopLimit=6,this.label="",this.hint="",this.errorText="",this._errors={},this.touchedFields=new Set,this.saveName="",this.hasHintSlot=!1,this.hasErrorSlot=!1,this.labelId=nextId("graph-query-builder-label"),this.hintId=nextId("graph-query-builder-hint"),this.errorId=nextId("graph-query-builder-error"),this._fieldsetDisabled=!1,this._name="",this._value=EMPTY_VALUE,this.defaultValue=normalizeGraphQuery(EMPTY_VALUE),this.defaultValueCaptured=!1,this._disabled=!1,this.hasInteracted=!1,this.removalFocusGeneration=0,this.markInteracted=()=>{this.hasInteracted||(this.hasInteracted=!0,this.syncValidityCustomStates())},this.onChromeSlotChange=event=>{this.collectChromeSlotAssignment(event.currentTarget)},this.internals=attachInternalsSafely(this),this.validityController=new AnchoredValidityController(this,this.internals,()=>this[VALIDITY_ANCHOR]()),installCustomErrorProperty(this,()=>this.validityController.customValidityMessage),installInvalidEventAlias(this,init=>this.emit("lr-invalid",null,init)),installInteractionOnInvalid(this,this.markInteracted),this.syncFormState()}connectedCallback(){super.connectedCallback(),this.hasUpdated&&this.syncExternalDescription()}disconnectedCallback(){this.removalFocusGeneration++,this.pendingRemovalFocus=void 0,this.releaseExternalDescription(),super.disconnectedCallback()}syncExternalDescription(){const target=this.isConnected?this.renderRoot.querySelector('[part="base"]')??null:null;if(!target){this.releaseExternalDescription();return}this.externalDescriptionLease?this.externalDescriptionLease.update(target):this.externalDescriptionLease=acquireResolvedAriaRelationship(this,target,"aria-describedby")}releaseExternalDescription(){this.externalDescriptionLease?.release(),this.externalDescriptionLease=void 0}get form(){return getFormOwner(this.internals)}set form(owner){setFormOwner(this,owner)}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}get value(){return this._value}set value(next){const old=this._value;this._value=normalizeGraphQuery(next),this.syncFormState(),this.requestUpdate("value",old)}get name(){return this._name}set name(next){const old=this._name;this._name=next??"",this._name?this.setAttribute("name",this._name):this.removeAttribute("name"),this.requestUpdate("name",old)}get disabled(){return this._disabled}set disabled(next){const old=this._disabled;this._disabled=!!next,this.toggleAttribute("disabled",this._disabled),this.validityController&&this.syncFormState(),this.requestUpdate("disabled",old)}get effectiveDisabled(){return this.disabled||this._fieldsetDisabled}get errors(){return this.publicValidityErrors()}publicValidityErrors(){const errors={...this._errors};return this.willValidate&&this.validity.customError&&(errors.base=this.validationMessage),Object.freeze(errors)}publishValiditySnapshot(){if(!this.isConnected)return;const valid=!this.willValidate||this.validity.valid,errors=valid?Object.freeze({}):this.publicValidityErrors(),key=JSON.stringify({valid,errors});key!==this.lastValidityKey&&(this.lastValidityKey=key,this.emit("lr-validity-change",Object.freeze({valid,errors})))}[VALIDITY_ANCHOR](){const firstInvalidPart=Object.keys(this._errors)[0];if(!(!firstInvalidPart||!this.renderRoot))return this.renderRoot.querySelector(`[part="${firstInvalidPart}"]`)??void 0}computeValidation(){const errors={},flags={};return this._value.startId.trim()||(errors["start-input"]=this.localize("fieldRequired"),flags.valueMissing=!0),this._value.minHops>this._value.maxHops&&(errors["max-hops"]=this.localize("graphQueryHopRangeInvalid"),flags.rangeUnderflow=!0),{errors,flags}}syncFormState(){const{errors,flags}=this.computeValidation();this._errors=errors;let formValue=null;try{formValue=JSON.stringify(this._value)}catch{formValue=null}if(this.internals.setFormValue(formValue,formValue),this.barredFromValidation||Object.keys(flags).length===0)this.validityController.setValidity({});else{const message=Object.values(errors)[0]??"";this.validityController.setValidity(flags,message)}this.syncValidityCustomStates(),this.publishValiditySnapshot()}get barredFromValidation(){return isBarredFromValidation(this,this.internals)}syncValidityCustomStates(){syncValidityStates(this.internals,{required:!0,hasInteracted:this.hasInteracted,barred:this.barredFromValidation})}checkValidity(){return this.syncFormState(),withStaticValidityCheck(this,()=>this.internals.checkValidity())}reportValidity(){return this.hasInteracted=!0,this.syncFormState(),Object.keys(this._errors).length>0&&(this.touchedFields=new Set([...this.touchedFields,...Object.keys(this._errors)])),this.internals.reportValidity()}setCustomValidity(message){this.validityController.setCustomValidity(message??""),this.syncValidityCustomStates(),this.publishValiditySnapshot(),this.requestUpdate()}formResetCallback(){this.hasInteracted=!1,this.captureDefaultValue(),this.value=this.defaultValue,this.touchedFields=new Set,this.saveName=""}captureDefaultValue(){this.defaultValueCaptured||(this.defaultValue=normalizeGraphQuery(this._value),this.defaultValueCaptured=!0)}formStateRestoreCallback(state2,_mode){let restored=EMPTY_VALUE;if(typeof state2=="string")try{const parsed=JSON.parse(state2);parsed!==null&&typeof parsed=="object"&&!Array.isArray(parsed)&&(restored=normalizeGraphQuery(parsed))}catch{}this.value=restored}formDisabledCallback(disabled){this._fieldsetDisabled=disabled,this.syncFormState(),this.requestUpdate()}get liveDisabled(){return this.effectiveDisabled||this.matches(":disabled")}focusFirstControl(options){if(!this.renderRoot||this.liveDisabled)return;(this.renderRoot.querySelector('[part="start-input"]')||this.renderRoot.querySelector('[part="end-input"]')||this.renderRoot.querySelector('[part="min-hops"]')||this.renderRoot.querySelector('[part="max-hops"]')||this.renderRoot.querySelector('[part="direction"]')||this.renderRoot.querySelector('[part="save-name-input"]'))?.focus(options)}focus(options){this.focusFirstControl(options)}blur(){const active=deepActiveElementIn(this.shadowRoot);active&&typeof active.blur=="function"&&active.blur()}click(){this.focusFirstControl()}setValue(next){this.effectiveDisabled||(this.hasInteracted=!0,this.value=next,this.emit("lr-input",Object.freeze({value:this._value})))}addRelationshipType(type){!type||this._value.relationshipTypes.includes(type)||this.setValue({...this._value,relationshipTypes:[...this._value.relationshipTypes,type]})}removeRelationshipType(type){this.captureChipRemovalFocus("relationship",type,this._value.relationshipTypes),this.setValue({...this._value,relationshipTypes:this._value.relationshipTypes.filter(t=>t!==type)})}addNodeType(type){!type||this._value.nodeTypes.includes(type)||this.setValue({...this._value,nodeTypes:[...this._value.nodeTypes,type]})}removeNodeType(type){this.captureChipRemovalFocus("node-type",type,this._value.nodeTypes),this.setValue({...this._value,nodeTypes:this._value.nodeTypes.filter(t=>t!==type)})}captureChipRemovalFocus(group,value,selected){const active=activeElementIn(this.shadowRoot),expectedPart=group==="relationship"?"relationship-chips":"node-type-chips";if(active?.localName!=="lr-chip"||active.getAttribute("value")!==value||active.closest("lr-chip-group")?.getAttribute("part")!==expectedPart)return;const index=selected.indexOf(value),survivors=selected.filter(candidate=>candidate!==value),targetValue=survivors[Math.min(Math.max(index,0),survivors.length-1)];this.pendingRemovalFocus={kind:"chip",group,targetValue},this.removalFocusGeneration++}markTouched(part){this.hasInteracted=!0,this.syncValidityCustomStates(),!this.touchedFields.has(part)&&(this.touchedFields=new Set(this.touchedFields).add(part))}runQuery(){if(this.effectiveDisabled||!this.reportValidity())return;const detail=()=>Object.freeze({query:normalizeGraphQuery(this._value)});this.emit("lr-before-query-run",detail(),{cancelable:!0}).defaultPrevented||this.emit("lr-query-run",detail())}saveQuery(){if(this.effectiveDisabled)return;const name=this.saveName.trim();if(!name)return;const detail=()=>Object.freeze({name,query:normalizeGraphQuery(this._value)});this.emit("lr-before-query-save",detail(),{cancelable:!0}).defaultPrevented||(this.saveName="",this.emit("lr-query-save",detail()))}loadQuery(item){if(this.effectiveDisabled)return;const detail=()=>Object.freeze({queryId:item.id,query:normalizeGraphQuery(item.query)});this.emit("lr-before-query-load",detail(),{cancelable:!0}).defaultPrevented||(this.setValue({...EMPTY_VALUE,...item.query}),this.emit("lr-query-load",detail()))}deleteQuery(item){if(this.effectiveDisabled)return;const detail=()=>Object.freeze({queryId:item.id});this.emit("lr-before-query-delete",detail(),{cancelable:!0}).defaultPrevented||this.emit("lr-query-delete",detail())}willUpdate(changed){if(super.willUpdate(changed),this.hasUpdated||this.captureDefaultValue(),!changed.has("savedQueries"))return;const active=activeElementIn(this.shadowRoot);if(active?.getAttribute("part")!=="saved-delete-button")return;const focusedId=active.closest("[data-query-id]")?.dataset.queryId;if(!focusedId||this.savedQueries.some(item=>item.id===focusedId))return;const index=(changed.get("savedQueries")??[]).findIndex(item=>item.id===focusedId),target=this.savedQueries[Math.min(Math.max(index,0),this.savedQueries.length-1)];this.pendingRemovalFocus={kind:"saved",targetId:target?.id},this.removalFocusGeneration++}updated(changed){super.updated(changed),this.publishValiditySnapshot(),this.syncExternalDescription();const pending=this.pendingRemovalFocus;if(!pending)return;this.pendingRemovalFocus=void 0;const generation=this.removalFocusGeneration;this.scheduleAfterUpdate(()=>{if(!(generation!==this.removalFocusGeneration||!this.isConnected)){if(pending.kind==="chip"){if(pending.targetValue){const part=pending.group==="relationship"?"relationship-chips":"node-type-chips",chip=[...this.shadowRoot?.querySelectorAll(`[part="${part}"] lr-chip`)??[]].find(candidate=>candidate.getAttribute("value")===pending.targetValue);if(chip){chip.focus();return}}const pickerPart=pending.group==="relationship"?"relationship-picker":"node-type-picker";this.shadowRoot?.querySelector(`[part="${pickerPart}"]`)?.focus();return}if(pending.targetId){const action=[...this.shadowRoot?.querySelectorAll("[data-query-id]")??[]].find(candidate=>candidate.dataset.queryId===pending.targetId)?.querySelector('[part="saved-delete-button"]');if(action){action.focus();return}}this.shadowRoot?.querySelector('[part="save-name-input"]')?.focus()}},"graph-query-removal-focus")}hopOptions(){const limit=finiteInteger(this.hopLimit,6,1,20),options=new Set(Array.from({length:limit},(_,i)=>i+1));return options.add(this._value.minHops),options.add(this._value.maxHops),[...options].sort((a,b)=>a-b)}collectChromeSlotAssignment(slot){const hasContent=slot.assignedNodes({flatten:!0}).some(node=>node.nodeType===Node.TEXT_NODE?!!node.textContent?.trim():!0);slot.name==="hint"?this.hasHintSlot=hasContent:slot.name==="error"&&(this.hasErrorSlot=hasContent)}firstUpdated(changed){super.firstUpdated(changed);const hintSlot=this.hintSlotEl,errorSlot=this.errorSlotEl;queueMicrotask(()=>{collectInitialSlotAssignment(hintSlot,s=>this.collectChromeSlotAssignment(s)),collectInitialSlotAssignment(errorSlot,s=>this.collectChromeSlotAssignment(s))})}labelForType(options,value){return options.find(o=>o.value===value)?.label??value}containSelectEvent(event){event.stopPropagation()}renderTypeFilter(kind,options,selected,add,remove,disabled){const pickerPart=kind==="relationship"?"relationship-picker":"node-type-picker",chipsPart=kind==="relationship"?"relationship-chips":"node-type-chips",pickerLabel=kind==="relationship"?this.localize("graphQueryRelationshipTypeLabel"):this.localize("graphQueryNodeTypeLabel"),available=options.filter(o=>!selected.includes(o.value));return html`
+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--)(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{html,nothing}from"lit";import{property,query,state}from"lit/decorators.js";import{LyraElement}from"../../../internal/lyra-element.js";import{installFormControlLabelSupport}from"../../../internal/form-control-labels.js";installFormControlLabelSupport();import{closeIcon}from"../../../internal/icons.js";import{collectInitialSlotAssignment}from"../../../internal/initial-slot-collection.js";import{AnchoredValidityController,VALIDITY_ANCHOR}from"../../../internal/anchored-validity.js";import{syncValidityStates}from"../../../internal/custom-states.js";import{finiteInteger}from"../../../internal/numbers.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{nextId}from"../../../internal/a11y.js";import{activeElementIn,deepActiveElementIn}from"../../../internal/active-element.js";import{styles}from"./graph-query-builder.styles.js";import{attachInternalsSafely}from"../../../internal/element-internals.js";import{getFormOwner,installCustomErrorProperty,isBarredFromValidation,setFormOwner}from"../../../internal/form-associated.js";import{installInteractionOnInvalid,installInvalidEventAlias,withStaticValidityCheck}from"../../../internal/invalid-event-alias.js";import{acquireResolvedAriaRelationship}from"../../../internal/aria-controls.js";import{LYRA_DEFAULT_fieldRequired,LYRA_DEFAULT_graphQueryBuilderLabel,LYRA_DEFAULT_graphQueryDeleteWithContext,LYRA_DEFAULT_graphQueryDirectionLabel,LYRA_DEFAULT_graphQueryEndLabel,LYRA_DEFAULT_graphQueryHopRangeInvalid,LYRA_DEFAULT_graphQueryLoadWithContext,LYRA_DEFAULT_graphQueryMaxHopsLabel,LYRA_DEFAULT_graphQueryMinHopsLabel,LYRA_DEFAULT_graphQueryNodeTypeLabel,LYRA_DEFAULT_graphQueryRelationshipTypeLabel,LYRA_DEFAULT_graphQueryRun,LYRA_DEFAULT_graphQuerySaveButton,LYRA_DEFAULT_graphQuerySaveNameLabel,LYRA_DEFAULT_graphQuerySavedQueriesLabel,LYRA_DEFAULT_graphQueryStartLabel,LYRA_DEFAULT_neighborDirectionBoth,LYRA_DEFAULT_neighborDirectionIn,LYRA_DEFAULT_neighborDirectionOut,LYRA_DEFAULT_noData,LYRA_DEFAULT_select}from"../../../internal/default-strings.generated.js";const MAX_TYPES=500,MAX_SAVED_QUERIES=200,MAX_TEXT=256,EMPTY_STRINGS=Object.freeze([]),EMPTY_VALUE=Object.freeze({startId:"",endId:"",relationshipTypes:EMPTY_STRINGS,nodeTypes:EMPTY_STRINGS,direction:"both",minHops:1,maxHops:1}),EMPTY_OPTIONS=Object.freeze([]),EMPTY_SAVED=Object.freeze([]);function ownValue(record,key){try{const descriptor=Object.getOwnPropertyDescriptor(record,key);return descriptor&&"value"in descriptor?descriptor.value:void 0}catch{return}}function boundedString(value){return typeof value=="string"?value.slice(0,MAX_TEXT):""}function stringArray(value){return Array.isArray(value)?Object.freeze([...new Set(value.slice(0,MAX_TYPES).filter(entry=>typeof entry=="string").map(entry=>boundedString(entry)).filter(Boolean))]):EMPTY_STRINGS}function normalizeGraphQuery(value){const record=value!==null&&typeof value=="object"&&!Array.isArray(value)?value:EMPTY_VALUE,direction=ownValue(record,"direction");return Object.freeze({startId:boundedString(ownValue(record,"startId")),endId:boundedString(ownValue(record,"endId")),relationshipTypes:stringArray(ownValue(record,"relationshipTypes")),nodeTypes:stringArray(ownValue(record,"nodeTypes")),direction:direction==="out"||direction==="in"||direction==="both"?direction:"both",minHops:finiteInteger(typeof ownValue(record,"minHops")=="number"?ownValue(record,"minHops"):EMPTY_VALUE.minHops,EMPTY_VALUE.minHops,1,20),maxHops:finiteInteger(typeof ownValue(record,"maxHops")=="number"?ownValue(record,"maxHops"):EMPTY_VALUE.maxHops,EMPTY_VALUE.maxHops,1,20)})}function normalizeTypeOptions(value){if(!Array.isArray(value))return EMPTY_OPTIONS;const values=new Set,result=[];for(const candidate of value.slice(0,MAX_TYPES)){if(candidate===null||typeof candidate!="object"||Array.isArray(candidate))continue;const optionValue=boundedString(ownValue(candidate,"value"));if(optionValue.trim().length===0||values.has(optionValue))continue;values.add(optionValue);const label=boundedString(ownValue(candidate,"label"));result.push(Object.freeze({value:optionValue,...label?{label}:{}}))}return Object.freeze(result)}function normalizeSavedQueries(value){if(!Array.isArray(value))return EMPTY_SAVED;const ids=new Set,result=[];for(const candidate of value.slice(0,MAX_SAVED_QUERIES)){if(candidate===null||typeof candidate!="object"||Array.isArray(candidate))continue;const id=boundedString(ownValue(candidate,"id"));id.trim().length===0||ids.has(id)||(ids.add(id),result.push(Object.freeze({id,name:boundedString(ownValue(candidate,"name")),query:normalizeGraphQuery(ownValue(candidate,"query"))})))}return Object.freeze(result)}class LyraGraphQueryBuilder extends LyraElement{static{this.defaultStrings={...super.defaultStrings,fieldRequired:LYRA_DEFAULT_fieldRequired,graphQueryBuilderLabel:LYRA_DEFAULT_graphQueryBuilderLabel,graphQueryDeleteWithContext:LYRA_DEFAULT_graphQueryDeleteWithContext,graphQueryDirectionLabel:LYRA_DEFAULT_graphQueryDirectionLabel,graphQueryEndLabel:LYRA_DEFAULT_graphQueryEndLabel,graphQueryHopRangeInvalid:LYRA_DEFAULT_graphQueryHopRangeInvalid,graphQueryLoadWithContext:LYRA_DEFAULT_graphQueryLoadWithContext,graphQueryMaxHopsLabel:LYRA_DEFAULT_graphQueryMaxHopsLabel,graphQueryMinHopsLabel:LYRA_DEFAULT_graphQueryMinHopsLabel,graphQueryNodeTypeLabel:LYRA_DEFAULT_graphQueryNodeTypeLabel,graphQueryRelationshipTypeLabel:LYRA_DEFAULT_graphQueryRelationshipTypeLabel,graphQueryRun:LYRA_DEFAULT_graphQueryRun,graphQuerySaveButton:LYRA_DEFAULT_graphQuerySaveButton,graphQuerySaveNameLabel:LYRA_DEFAULT_graphQuerySaveNameLabel,graphQuerySavedQueriesLabel:LYRA_DEFAULT_graphQuerySavedQueriesLabel,graphQueryStartLabel:LYRA_DEFAULT_graphQueryStartLabel,neighborDirectionBoth:LYRA_DEFAULT_neighborDirectionBoth,neighborDirectionIn:LYRA_DEFAULT_neighborDirectionIn,neighborDirectionOut:LYRA_DEFAULT_neighborDirectionOut,noData:LYRA_DEFAULT_noData,select:LYRA_DEFAULT_select}}static{this.formAssociated=!0}static{this.styles=[LyraElement.styles,styles]}static{this.immutableEventDetails=Object.freeze(["lr-input","lr-query-run-request","lr-before-query-run","lr-query-run","lr-query-save-request","lr-before-query-save","lr-query-save","lr-query-load-request","lr-before-query-load","lr-query-load"])}static{this.properties={customError:{attribute:"custom-error",reflect:!0,noAccessor:!0},name:{reflect:!0,noAccessor:!0},value:{attribute:!1,noAccessor:!0},disabled:{type:Boolean,reflect:!0,noAccessor:!0}}}get relationshipTypeOptions(){return this._relationshipTypeOptions}set relationshipTypeOptions(value){const previous=this._relationshipTypeOptions;this._relationshipTypeOptions=normalizeTypeOptions(value),this.requestUpdate("relationshipTypeOptions",previous)}get nodeTypeOptions(){return this._nodeTypeOptions}set nodeTypeOptions(value){const previous=this._nodeTypeOptions;this._nodeTypeOptions=normalizeTypeOptions(value),this.requestUpdate("nodeTypeOptions",previous)}get savedQueries(){return this._savedQueries}set savedQueries(value){const previous=this._savedQueries;this._savedQueries=normalizeSavedQueries(value),this.requestUpdate("savedQueries",previous)}constructor(){super(),this._relationshipTypeOptions=EMPTY_OPTIONS,this._nodeTypeOptions=EMPTY_OPTIONS,this._savedQueries=EMPTY_SAVED,this.hopLimit=6,this.label="",this.hint="",this.errorText="",this._errors={},this.touchedFields=new Set,this.saveName="",this.hasHintSlot=!1,this.hasErrorSlot=!1,this.labelId=nextId("graph-query-builder-label"),this.hintId=nextId("graph-query-builder-hint"),this.errorId=nextId("graph-query-builder-error"),this._fieldsetDisabled=!1,this._name="",this._value=EMPTY_VALUE,this.defaultValue=normalizeGraphQuery(EMPTY_VALUE),this.defaultValueCaptured=!1,this._disabled=!1,this.hasInteracted=!1,this.removalFocusGeneration=0,this.markInteracted=()=>{this.hasInteracted||(this.hasInteracted=!0,this.syncValidityCustomStates())},this.onChromeSlotChange=event=>{this.collectChromeSlotAssignment(event.currentTarget)},this.internals=attachInternalsSafely(this),this.validityController=new AnchoredValidityController(this,this.internals,()=>this[VALIDITY_ANCHOR]()),installCustomErrorProperty(this,()=>this.validityController.customValidityMessage),installInvalidEventAlias(this,init=>this.emit("lr-invalid",null,init)),installInteractionOnInvalid(this,this.markInteracted),this.syncFormState()}connectedCallback(){super.connectedCallback(),this.hasUpdated&&this.syncExternalDescription()}disconnectedCallback(){this.removalFocusGeneration++,this.pendingRemovalFocus=void 0,this.releaseExternalDescription(),super.disconnectedCallback()}syncExternalDescription(){const target=this.isConnected?this.renderRoot.querySelector('[part="base"]')??null:null;if(!target){this.releaseExternalDescription();return}this.externalDescriptionLease?this.externalDescriptionLease.update(target):this.externalDescriptionLease=acquireResolvedAriaRelationship(this,target,"aria-describedby")}releaseExternalDescription(){this.externalDescriptionLease?.release(),this.externalDescriptionLease=void 0}get form(){return getFormOwner(this.internals)}set form(owner){setFormOwner(this,owner)}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}get value(){return this._value}set value(next){const old=this._value;this._value=normalizeGraphQuery(next),this.syncFormState(),this.requestUpdate("value",old)}get name(){return this._name}set name(next){const old=this._name;this._name=next??"",this._name?this.setAttribute("name",this._name):this.removeAttribute("name"),this.requestUpdate("name",old)}get disabled(){return this._disabled}set disabled(next){const old=this._disabled;this._disabled=!!next,this.toggleAttribute("disabled",this._disabled),this.validityController&&this.syncFormState(),this.requestUpdate("disabled",old)}get effectiveDisabled(){return this.disabled||this._fieldsetDisabled}get errors(){return this.publicValidityErrors()}publicValidityErrors(){const errors={...this._errors};return this.willValidate&&this.validity.customError&&(errors.base=this.validationMessage),Object.freeze(errors)}publishValiditySnapshot(){if(!this.isConnected)return;const valid=!this.willValidate||this.validity.valid,errors=valid?Object.freeze({}):this.publicValidityErrors(),key=JSON.stringify({valid,errors});key!==this.lastValidityKey&&(this.lastValidityKey=key,this.emit("lr-validity-change",Object.freeze({valid,errors})))}[VALIDITY_ANCHOR](){const firstInvalidPart=Object.keys(this._errors)[0];if(!(!firstInvalidPart||!this.renderRoot))return this.renderRoot.querySelector(`[part="${firstInvalidPart}"]`)??void 0}computeValidation(){const errors={},flags={};return this._value.startId.trim()||(errors["start-input"]=this.localize("fieldRequired"),flags.valueMissing=!0),this._value.minHops>this._value.maxHops&&(errors["max-hops"]=this.localize("graphQueryHopRangeInvalid"),flags.rangeUnderflow=!0),{errors,flags}}syncFormState(){const{errors,flags}=this.computeValidation();this._errors=errors;let formValue=null;try{formValue=JSON.stringify(this._value)}catch{formValue=null}if(this.internals.setFormValue(formValue,formValue),this.barredFromValidation||Object.keys(flags).length===0)this.validityController.setValidity({});else{const message=Object.values(errors)[0]??"";this.validityController.setValidity(flags,message)}this.syncValidityCustomStates(),this.publishValiditySnapshot()}get barredFromValidation(){return isBarredFromValidation(this,this.internals)}syncValidityCustomStates(){syncValidityStates(this.internals,{required:!0,hasInteracted:this.hasInteracted,barred:this.barredFromValidation})}checkValidity(){return this.syncFormState(),withStaticValidityCheck(this,()=>this.internals.checkValidity())}reportValidity(){return this.hasInteracted=!0,this.syncFormState(),Object.keys(this._errors).length>0&&(this.touchedFields=new Set([...this.touchedFields,...Object.keys(this._errors)])),this.internals.reportValidity()}setCustomValidity(message){this.validityController.setCustomValidity(message??""),this.syncValidityCustomStates(),this.publishValiditySnapshot(),this.requestUpdate()}formResetCallback(){this.hasInteracted=!1,this.captureDefaultValue(),this.value=this.defaultValue,this.touchedFields=new Set,this.saveName=""}captureDefaultValue(){this.defaultValueCaptured||(this.defaultValue=normalizeGraphQuery(this._value),this.defaultValueCaptured=!0)}formStateRestoreCallback(state2,_mode){let restored=EMPTY_VALUE;if(typeof state2=="string")try{const parsed=JSON.parse(state2);parsed!==null&&typeof parsed=="object"&&!Array.isArray(parsed)&&(restored=normalizeGraphQuery(parsed))}catch{}this.value=restored}formDisabledCallback(disabled){this._fieldsetDisabled=disabled,this.syncFormState(),this.requestUpdate()}get liveDisabled(){return this.effectiveDisabled||this.matches(":disabled")}focusFirstControl(options){if(!this.renderRoot||this.liveDisabled)return;(this.renderRoot.querySelector('[part="start-input"]')||this.renderRoot.querySelector('[part="end-input"]')||this.renderRoot.querySelector('[part="min-hops"]')||this.renderRoot.querySelector('[part="max-hops"]')||this.renderRoot.querySelector('[part="direction"]')||this.renderRoot.querySelector('[part="save-name-input"]'))?.focus(options)}focus(options){this.focusFirstControl(options)}blur(){const active=deepActiveElementIn(this.shadowRoot);active&&typeof active.blur=="function"&&active.blur()}click(){this.focusFirstControl()}setValue(next){this.effectiveDisabled||(this.hasInteracted=!0,this.value=next,this.emit("lr-input",Object.freeze({value:this._value})))}addRelationshipType(type){!type||this._value.relationshipTypes.includes(type)||this.setValue({...this._value,relationshipTypes:[...this._value.relationshipTypes,type]})}removeRelationshipType(type){this.captureChipRemovalFocus("relationship",type,this._value.relationshipTypes),this.setValue({...this._value,relationshipTypes:this._value.relationshipTypes.filter(t=>t!==type)})}addNodeType(type){!type||this._value.nodeTypes.includes(type)||this.setValue({...this._value,nodeTypes:[...this._value.nodeTypes,type]})}removeNodeType(type){this.captureChipRemovalFocus("node-type",type,this._value.nodeTypes),this.setValue({...this._value,nodeTypes:this._value.nodeTypes.filter(t=>t!==type)})}captureChipRemovalFocus(group,value,selected){const active=activeElementIn(this.shadowRoot),expectedPart=group==="relationship"?"relationship-chips":"node-type-chips";if(active?.localName!=="lr-chip"||active.getAttribute("value")!==value||active.closest("lr-chip-group")?.getAttribute("part")!==expectedPart)return;const index=selected.indexOf(value),survivors=selected.filter(candidate=>candidate!==value),targetValue=survivors[Math.min(Math.max(index,0),survivors.length-1)];this.pendingRemovalFocus={kind:"chip",group,targetValue},this.removalFocusGeneration++}markTouched(part){this.hasInteracted=!0,this.syncValidityCustomStates(),!this.touchedFields.has(part)&&(this.touchedFields=new Set(this.touchedFields).add(part))}runQuery(){if(this.effectiveDisabled||!this.reportValidity())return;const detail=()=>Object.freeze({query:normalizeGraphQuery(this._value)}),request=this.emit("lr-query-run-request",detail(),{cancelable:!0}),deprecatedAlias=this.emit("lr-before-query-run",detail(),{cancelable:!0});request.defaultPrevented||deprecatedAlias.defaultPrevented||this.emit("lr-query-run",detail())}saveQuery(){if(this.effectiveDisabled)return;const name=this.saveName.trim();if(!name)return;const detail=()=>Object.freeze({name,query:normalizeGraphQuery(this._value)}),request=this.emit("lr-query-save-request",detail(),{cancelable:!0}),deprecatedAlias=this.emit("lr-before-query-save",detail(),{cancelable:!0});request.defaultPrevented||deprecatedAlias.defaultPrevented||(this.saveName="",this.emit("lr-query-save",detail()))}loadQuery(item){if(this.effectiveDisabled)return;const detail=()=>Object.freeze({queryId:item.id,query:normalizeGraphQuery(item.query)}),request=this.emit("lr-query-load-request",detail(),{cancelable:!0}),deprecatedAlias=this.emit("lr-before-query-load",detail(),{cancelable:!0});request.defaultPrevented||deprecatedAlias.defaultPrevented||(this.setValue({...EMPTY_VALUE,...item.query}),this.emit("lr-query-load",detail()))}deleteQuery(item){if(this.effectiveDisabled)return;const detail=()=>Object.freeze({queryId:item.id}),request=this.emit("lr-query-delete-request",detail(),{cancelable:!0}),deprecatedAlias=this.emit("lr-before-query-delete",detail(),{cancelable:!0});request.defaultPrevented||deprecatedAlias.defaultPrevented||this.emit("lr-query-delete",detail())}willUpdate(changed){if(super.willUpdate(changed),this.hasUpdated||this.captureDefaultValue(),!changed.has("savedQueries"))return;const active=activeElementIn(this.shadowRoot);if(active?.getAttribute("part")!=="saved-delete-button")return;const focusedId=active.closest("[data-query-id]")?.dataset.queryId;if(!focusedId||this.savedQueries.some(item=>item.id===focusedId))return;const index=(changed.get("savedQueries")??[]).findIndex(item=>item.id===focusedId),target=this.savedQueries[Math.min(Math.max(index,0),this.savedQueries.length-1)];this.pendingRemovalFocus={kind:"saved",targetId:target?.id},this.removalFocusGeneration++}updated(changed){super.updated(changed),this.publishValiditySnapshot(),this.syncExternalDescription();const pending=this.pendingRemovalFocus;if(!pending)return;this.pendingRemovalFocus=void 0;const generation=this.removalFocusGeneration;this.scheduleAfterUpdate(()=>{if(!(generation!==this.removalFocusGeneration||!this.isConnected)){if(pending.kind==="chip"){if(pending.targetValue){const part=pending.group==="relationship"?"relationship-chips":"node-type-chips",chip=[...this.shadowRoot?.querySelectorAll(`[part="${part}"] lr-chip`)??[]].find(candidate=>candidate.getAttribute("value")===pending.targetValue);if(chip){chip.focus();return}}const pickerPart=pending.group==="relationship"?"relationship-picker":"node-type-picker";this.shadowRoot?.querySelector(`[part="${pickerPart}"]`)?.focus();return}if(pending.targetId){const action=[...this.shadowRoot?.querySelectorAll("[data-query-id]")??[]].find(candidate=>candidate.dataset.queryId===pending.targetId)?.querySelector('[part="saved-delete-button"]');if(action){action.focus();return}}this.shadowRoot?.querySelector('[part="save-name-input"]')?.focus()}},"graph-query-removal-focus")}hopOptions(){const limit=finiteInteger(this.hopLimit,6,1,20),options=new Set(Array.from({length:limit},(_,i)=>i+1));return options.add(this._value.minHops),options.add(this._value.maxHops),[...options].sort((a,b)=>a-b)}collectChromeSlotAssignment(slot){const hasContent=slot.assignedNodes({flatten:!0}).some(node=>node.nodeType===Node.TEXT_NODE?!!node.textContent?.trim():!0);slot.name==="hint"?this.hasHintSlot=hasContent:slot.name==="error"&&(this.hasErrorSlot=hasContent)}firstUpdated(changed){super.firstUpdated(changed);const hintSlot=this.hintSlotEl,errorSlot=this.errorSlotEl;queueMicrotask(()=>{collectInitialSlotAssignment(hintSlot,s=>this.collectChromeSlotAssignment(s)),collectInitialSlotAssignment(errorSlot,s=>this.collectChromeSlotAssignment(s))})}labelForType(options,value){return options.find(o=>o.value===value)?.label??value}containSelectEvent(event){event.stopPropagation()}renderTypeFilter(kind,options,selected,add,remove,disabled){const pickerPart=kind==="relationship"?"relationship-picker":"node-type-picker",chipsPart=kind==="relationship"?"relationship-chips":"node-type-chips",pickerLabel=kind==="relationship"?this.localize("graphQueryRelationshipTypeLabel"):this.localize("graphQueryNodeTypeLabel"),available=options.filter(o=>!selected.includes(o.value));return html`
       <div part="filter-group" data-kind=${kind}>
         <lr-select
           @lr-activate=${this.containSelectEvent}
@@ -29,7 +29,7 @@ var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3
         aria-describedby=${describedBy||nothing}
         aria-invalid=${this.internals.validity.valid?"false":"true"}
       >
-        <div part="label" id=${this.labelId}>
+        <div part="form-control-label label" id=${this.labelId}>
           <slot name="label" @slotchange=${this.onChromeSlotChange}
             >${this.label||this.localize("graphQueryBuilderLabel")}</slot
           >

package/dist/components/data/graph-query-builder/graph-query-builder.styles.js

@@ -1 +1 @@
-import{css}from"lit";const styles=css`:host{display:block}[part=base]{gap:var(--lr-space-l);color:var(--lr-color-text);font-size:var(--lr-font-size-sm);flex-direction:column;display:flex}[part=label]{font-weight:var(--lr-font-weight-semibold)}[part=hint],[part=error]{font-size:var(--lr-font-size-sm);margin-block-start:calc(var(--lr-space-m) * -1)}[part=hint]{color:var(--lr-color-text-quiet)}[part=error]{color:var(--lr-color-danger)}[part=hint][hidden],[part=error][hidden]{display:none}[part=path-fields]{align-items:flex-end;gap:var(--lr-space-m);flex-wrap:wrap;display:flex}[part=path-fields]>*{flex:1 1 var(--lr-size-10rem);min-inline-size:0}[part=min-hops],[part=max-hops]{flex-basis:var(--lr-size-7rem)}[part=filter-group]{gap:var(--lr-space-xs);flex-direction:column;display:flex}[part=relationship-picker],[part=node-type-picker],[part=direction]{max-inline-size:var(--lr-size-24rem)}[part=relationship-chips],[part=node-type-chips]{min-block-size:0}[part=footer]{justify-content:flex-end;align-items:center;gap:var(--lr-space-s);flex-wrap:wrap;display:flex}[part=run-button],[part=save-button]{font:inherit;border-radius:var(--lr-radius);padding:var(--lr-space-xs) var(--lr-space-m);cursor:pointer;border:var(--lr-border-width-thin) solid;min-inline-size:var(--lr-icon-button-size);min-block-size:var(--lr-icon-button-size)}[part=run-button]{background:var(--lr-graph-query-builder-run-bg,var(--lr-color-brand));border-color:var(--lr-graph-query-builder-run-border-color,var(--lr-color-brand));color:var(--lr-graph-query-builder-run-color,var(--lr-color-on-brand));transition:background-color var(--lr-transition-fast)}[part=save-button]{background:var(--lr-graph-query-builder-save-bg,var(--lr-color-surface));border-color:var(--lr-graph-query-builder-save-border-color,var(--lr-color-border));color:var(--lr-graph-query-builder-save-color,var(--lr-color-text));transition:background-color var(--lr-transition-fast)}[part=run-button]:hover{background:var(--lr-graph-query-builder-run-hover-bg,color-mix(in oklab, var(--lr-color-brand), var(--lr-color-mix-partner) var(--lr-color-mix-hover)))}[part=run-button]:active{background:var(--lr-graph-query-builder-run-active-bg,color-mix(in oklab, var(--lr-color-brand), var(--lr-color-mix-partner) var(--lr-color-mix-active)))}[part=save-button]:hover{background:var(--lr-graph-query-builder-save-hover-bg,var(--lr-color-brand-quiet))}[part=save-button]:active{background:var(--lr-graph-query-builder-save-active-bg,color-mix(in oklab, var(--lr-color-brand-quiet), var(--lr-color-mix-partner) var(--lr-color-mix-active)))}[part=run-button]:disabled,[part=save-button]:disabled,[part=saved-load-button]:disabled,[part=saved-delete-button]:disabled{opacity:var(--lr-opacity-disabled);cursor:not-allowed}[part=run-button]:focus-visible,[part=save-button]:focus-visible,[part=saved-load-button]:focus-visible,[part=saved-delete-button]:focus-visible{outline:var(--lr-focus-ring-width) solid var(--lr-focus-ring-color);outline-offset:var(--lr-focus-ring-offset)}[part=saved-queries]{gap:var(--lr-space-s);border-block-start:var(--lr-border-width-thin) solid var(--lr-color-border);flex-direction:column;padding-block-start:var(--lr-space-m);display:flex}[part=saved-queries-label]{font-size:var(--lr-font-size-sm);font-weight:var(--lr-font-weight-semibold);color:var(--lr-color-text);margin:0}[part=save-row]{align-items:flex-end;gap:var(--lr-space-s);flex-wrap:wrap;display:flex}[part=save-row]>[part=save-name-input]{flex:1 1 var(--lr-size-12rem);min-inline-size:0}[part=saved-list]{gap:var(--lr-space-2xs);flex-direction:column;margin:0;padding:0;list-style:none;display:flex}[part=saved-item]{justify-content:space-between;align-items:center;gap:var(--lr-space-s);padding:var(--lr-space-2xs) var(--lr-space-xs);border-radius:var(--lr-radius);border:var(--lr-border-width-thin) solid var(--lr-color-border);background:var(--lr-color-surface);display:flex}[part=saved-load-button]{text-overflow:ellipsis;white-space:nowrap;text-align:start;min-inline-size:0;font:inherit;color:var(--lr-graph-query-builder-saved-load-color,var(--lr-color-text));padding:var(--lr-space-2xs);cursor:pointer;border-radius:var(--lr-radius-xs);min-block-size:var(--lr-icon-button-size);transition:background-color var(--lr-transition-fast);background:0 0;border:none;flex:auto;overflow:hidden}[part=saved-load-button]:hover{text-decoration:underline}[part=saved-load-button]:active{background:var(--lr-graph-query-builder-saved-load-active-bg,color-mix(in oklab, var(--lr-color-surface), var(--lr-color-mix-partner) var(--lr-color-mix-active)));text-decoration:underline}[part=saved-delete-button]{font:inherit;inline-size:var(--lr-space-2xl);block-size:var(--lr-space-2xl);min-inline-size:var(--lr-icon-button-size);min-block-size:var(--lr-icon-button-size);color:var(--lr-graph-query-builder-saved-delete-color,var(--lr-color-text-quiet));border-radius:var(--lr-radius-xs);cursor:pointer;transition:background-color var(--lr-transition-fast), color var(--lr-transition-fast);background:0 0;border:none;flex:none;justify-content:center;align-items:center;padding:0;display:inline-flex}[part=saved-delete-button] svg{inline-size:var(--lr-size-1em);block-size:var(--lr-size-1em)}[part=saved-delete-button]:hover{color:var(--lr-graph-query-builder-saved-delete-hover-color,var(--lr-color-danger))}[part=saved-delete-button]:active{color:var(--lr-graph-query-builder-saved-delete-active-color,color-mix(in oklab, var(--lr-color-danger), var(--lr-color-mix-partner) var(--lr-color-mix-active)));background:var(--lr-graph-query-builder-saved-delete-active-bg,var(--lr-color-danger-quiet))}[part=saved-empty]{color:var(--lr-color-text-quiet);margin:0}`;export{styles};
+import{css}from"lit";const styles=css`:host{display:block}[part=base]{gap:var(--lr-space-l);color:var(--lr-color-text);font-size:var(--lr-font-size-sm);flex-direction:column;display:flex}[part~=label]{font-weight:var(--lr-font-weight-semibold)}[part=hint],[part=error]{font-size:var(--lr-font-size-sm);margin-block-start:calc(var(--lr-space-m) * -1)}[part=hint]{color:var(--lr-color-text-quiet)}[part=error]{color:var(--lr-color-danger)}[part=hint][hidden],[part=error][hidden]{display:none}[part=path-fields]{align-items:flex-end;gap:var(--lr-space-m);flex-wrap:wrap;display:flex}[part=path-fields]>*{flex:1 1 var(--lr-size-10rem);min-inline-size:0}[part=min-hops],[part=max-hops]{flex-basis:var(--lr-size-7rem)}[part=filter-group]{gap:var(--lr-space-xs);flex-direction:column;display:flex}[part=relationship-picker],[part=node-type-picker],[part=direction]{max-inline-size:var(--lr-size-24rem)}[part=relationship-chips],[part=node-type-chips]{min-block-size:0}[part=footer]{justify-content:flex-end;align-items:center;gap:var(--lr-space-s);flex-wrap:wrap;display:flex}[part=run-button],[part=save-button]{font:inherit;border-radius:var(--lr-radius);padding:var(--lr-space-xs) var(--lr-space-m);cursor:pointer;border:var(--lr-border-width-thin) solid;min-inline-size:var(--lr-icon-button-size);min-block-size:var(--lr-icon-button-size)}[part=run-button]{background:var(--lr-graph-query-builder-run-bg,var(--lr-color-brand));border-color:var(--lr-graph-query-builder-run-border-color,var(--lr-color-brand));color:var(--lr-graph-query-builder-run-color,var(--lr-color-on-brand));transition:background-color var(--lr-transition-fast)}[part=save-button]{background:var(--lr-graph-query-builder-save-bg,var(--lr-color-surface));border-color:var(--lr-graph-query-builder-save-border-color,var(--lr-color-border));color:var(--lr-graph-query-builder-save-color,var(--lr-color-text));transition:background-color var(--lr-transition-fast)}[part=run-button]:hover{background:var(--lr-graph-query-builder-run-hover-bg,color-mix(in oklab, var(--lr-color-brand), var(--lr-color-mix-partner) var(--lr-color-mix-hover)))}[part=run-button]:active{background:var(--lr-graph-query-builder-run-active-bg,color-mix(in oklab, var(--lr-color-brand), var(--lr-color-mix-partner) var(--lr-color-mix-active)))}[part=save-button]:hover{background:var(--lr-graph-query-builder-save-hover-bg,var(--lr-color-brand-quiet))}[part=save-button]:active{background:var(--lr-graph-query-builder-save-active-bg,color-mix(in oklab, var(--lr-color-brand-quiet), var(--lr-color-mix-partner) var(--lr-color-mix-active)))}[part=run-button]:disabled,[part=save-button]:disabled,[part=saved-load-button]:disabled,[part=saved-delete-button]:disabled{opacity:var(--lr-opacity-disabled);cursor:not-allowed}[part=run-button]:focus-visible,[part=save-button]:focus-visible,[part=saved-load-button]:focus-visible,[part=saved-delete-button]:focus-visible{outline:var(--lr-focus-ring-width) solid var(--lr-focus-ring-color);outline-offset:var(--lr-focus-ring-offset)}[part=saved-queries]{gap:var(--lr-space-s);border-block-start:var(--lr-border-width-thin) solid var(--lr-color-border);flex-direction:column;padding-block-start:var(--lr-space-m);display:flex}[part=saved-queries-label]{font-size:var(--lr-font-size-sm);font-weight:var(--lr-font-weight-semibold);color:var(--lr-color-text);margin:0}[part=save-row]{align-items:flex-end;gap:var(--lr-space-s);flex-wrap:wrap;display:flex}[part=save-row]>[part=save-name-input]{flex:1 1 var(--lr-size-12rem);min-inline-size:0}[part=saved-list]{gap:var(--lr-space-2xs);flex-direction:column;margin:0;padding:0;list-style:none;display:flex}[part=saved-item]{justify-content:space-between;align-items:center;gap:var(--lr-space-s);padding:var(--lr-space-2xs) var(--lr-space-xs);border-radius:var(--lr-radius);border:var(--lr-border-width-thin) solid var(--lr-color-border);background:var(--lr-color-surface);display:flex}[part=saved-load-button]{text-overflow:ellipsis;white-space:nowrap;text-align:start;min-inline-size:0;font:inherit;color:var(--lr-graph-query-builder-saved-load-color,var(--lr-color-text));padding:var(--lr-space-2xs);cursor:pointer;border-radius:var(--lr-radius-xs);min-block-size:var(--lr-icon-button-size);transition:background-color var(--lr-transition-fast);background:0 0;border:none;flex:auto;overflow:hidden}[part=saved-load-button]:hover{text-decoration:underline}[part=saved-load-button]:active{background:var(--lr-graph-query-builder-saved-load-active-bg,color-mix(in oklab, var(--lr-color-surface), var(--lr-color-mix-partner) var(--lr-color-mix-active)));text-decoration:underline}[part=saved-delete-button]{font:inherit;inline-size:var(--lr-space-2xl);block-size:var(--lr-space-2xl);min-inline-size:var(--lr-icon-button-size);min-block-size:var(--lr-icon-button-size);color:var(--lr-graph-query-builder-saved-delete-color,var(--lr-color-text-quiet));border-radius:var(--lr-radius-xs);cursor:pointer;transition:background-color var(--lr-transition-fast), color var(--lr-transition-fast);background:0 0;border:none;flex:none;justify-content:center;align-items:center;padding:0;display:inline-flex}[part=saved-delete-button] svg{inline-size:var(--lr-size-1em);block-size:var(--lr-size-1em)}[part=saved-delete-button]:hover{color:var(--lr-graph-query-builder-saved-delete-hover-color,var(--lr-color-danger))}[part=saved-delete-button]:active{color:var(--lr-graph-query-builder-saved-delete-active-color,color-mix(in oklab, var(--lr-color-danger), var(--lr-color-mix-partner) var(--lr-color-mix-active)));background:var(--lr-graph-query-builder-saved-delete-active-bg,var(--lr-color-danger-quiet))}[part=saved-empty]{color:var(--lr-color-text-quiet);margin:0}`;export{styles};

package/dist/components/data/heatmap/heatmap.class.d.ts

@@ -129,8 +129,10 @@ export declare function normalizeBucketCount(bucketCount:number):number;
 export declare function resolveRgb(color:string,fallbackHex:string,ownerDocument?:Document):[number,number,number,number];export type LyraHeatmapCellClickDetail={date:string;value:number;}|{row:number;col:number;value:number;};export type LyraHeatmapMatrixGeometryChangeDetail={padLeft:number;padTop:number;cellSize:number;
 /** Custom painted bounds; omitted for the default one-pixel separators and square corners. */
 cellWidth?:number;cellHeight?:number;cellRadius?:number;};export interface LyraHeatmapEventMap{'lr-cell-click':CustomEvent<LyraHeatmapCellClickDetail>;'lr-matrix-geometry-change':CustomEvent<LyraHeatmapMatrixGeometryChangeDetail>;'lr-selection-change':CustomEvent<HeatmapSelectionChangeDetail>;}
-/** The raster snapshot format returned by `LyraHeatmap.exportData()`. */
-export type LyraHeatmapExportFormat='png';
+/** The snapshot format returned by `LyraHeatmap.exportData()`: `'png'` for the raster canvas
+*  snapshot, `'csv'` for the underlying matrix/calendar values, matching every other
+*  visualization sibling's `exportData(format)` shape. */
+export type LyraHeatmapExportFormat='csv'|'png';
 /**
 * `<lr-heatmap>` — a Canvas heatmap with a DPR-aware, resize-aware redraw
 * loop. Its discriminated `data` property selects one of two projections:
@@ -427,14 +429,27 @@ private resolvedRowLabelWidth;private get matrixPadLeft();
 * construction rather than by coincidence.
 */
 get matrixGeometry():Readonly<LyraHeatmapMatrixGeometryChangeDetail> |undefined;
+/** Intentionally inert -- `matrixGeometry` always mirrors the last matrix draw's own painted
+*  geometry. A getter with no setter throws (in strict-mode module code, which every consumer
+*  runs) the moment anything assigns to it, including a stray `.matrixGeometry=${x}` template
+*  binding; this no-op keeps that assignment harmless instead of throwing from inside framework
+*  internals. */
+set matrixGeometry(_value:Readonly<LyraHeatmapMatrixGeometryChangeDetail> |undefined);
 /**
-* Returns a PNG data URL for the most recently completed canvas paint. The snapshot includes the
-* painted axes, cells, and canvas overlays, plus frozen label bands when `stickyLabels` is in
-* use; DOM-only legend, tooltip, and accessible-cell overlays are intentionally omitted. An
-* empty string means the component has not completed a paint yet, its canvas has no dimensions,
-* it is waiting for deferred visibility, or the browser could not encode the snapshot.
+* Returns a spreadsheet-safe CSV snapshot (`format: 'csv'`) of the underlying matrix/calendar
+* values, or a PNG data URL (`format: 'png'`) for the most recently completed canvas paint. The
+* PNG snapshot includes the painted axes, cells, and canvas overlays, plus frozen label bands
+* when `stickyLabels` is in use; DOM-only legend, tooltip, and accessible-cell overlays are
+* intentionally omitted. An empty PNG string means the component has not completed a paint yet,
+* its canvas has no dimensions, it is waiting for deferred visibility, or the browser could not
+* encode the snapshot. The CSV snapshot reads `data` directly (unbounded by the render cap) and
+* omits no-data cells (the `-1`/non-finite sentinel `isNoData()` already honors for painting),
+* the same way the canvas draw path skips them.
 */
 exportData(format:LyraHeatmapExportFormat):string;
+/** `exportData('csv')`'s worker: one header row plus one data row per real (non-no-data) cell,
+*  reading `data` directly rather than any bounded render cache. */
+private exportCsv;
 /** The geometry the last `drawMatrix()` pass painted with, frozen and shared with the
 *  `lr-matrix-geometry-change` detail. `undefined` until the first draw, which is what gates
 *  `matrixGeometry` returning a real value only once there is a draw to describe. Also backs the
@@ -791,7 +806,10 @@ private hoverCell;
 *  canvas-drawn focus ring, aria-hidden mirror, and light-DOM announcement. */
 private focusedCell;
 /** Text mirrored in `[part="live-region"]`, refreshed on every focus move. */
-private liveText;private accessibleTargetSizePx;private pendingAccessibleFocus;private pendingAccessibleFocusOrigin;private restoringAccessibleFocus;private accessibleFocusGeneration;private announcementSink?;private authorRole;private authorAriaLabel;private generatedAriaLabel;private syncingGeneratedSemantics;attributeChangedCallback(name:string,oldValue:string|null,value:string|null):void;connectedCallback():void;disconnectedCallback():void;private releaseAnnouncementSink;private syncAnnouncementSink;private watchDpr;private clearDprWatcher;private onDprChange;protected willUpdate(changed:PropertyValues):void;private rebuildBoundedDecorations;private get projectionTruncated();private get cellProjectionTruncated();private projectedCellCount;private projectionDescription;
+private liveText;private accessibleTargetSizePx;private pendingAccessibleFocus;private pendingAccessibleFocusOrigin;private restoringAccessibleFocus;private accessibleFocusGeneration;private announcementSink?;private authorRole;private authorAriaLabel;private generatedAriaLabel;private syncingGeneratedSemantics;
+/** Whether a host `aria-describedby` was last reflected onto the active role owner -- see
+*  `checkbox.class.ts`'s identically-named field for why the sync call must stay guarded. */
+private hasSyncedDescribedByElements;attributeChangedCallback(name:string,oldValue:string|null,value:string|null):void;connectedCallback():void;disconnectedCallback():void;private releaseAnnouncementSink;private syncAnnouncementSink;private watchDpr;private clearDprWatcher;private onDprChange;protected willUpdate(changed:PropertyValues):void;private rebuildBoundedDecorations;private get projectionTruncated();private get cellProjectionTruncated();private projectedCellCount;private projectionDescription;
 /** Snapshots one bounded rectangular matrix projection. Invisible ragged outliers never reach
 * scale/rank/count semantics, and later caller mutation cannot split paint from accessibility. */
 private rebuildCanonicalMatrixData;
@@ -807,7 +825,7 @@ private selectedCellDescription;
 * cycle against the same `values`/`days`, so a single scan per cycle
 * suffices instead of one per consumer.
 */
-private computeValueRange;private localizedValueLabel;private formatNumericValue;protected updated(changed:PropertyValues):void;
+private computeValueRange;private localizedValueLabel;private formatNumericValue;private syncExternalDescription;protected updated(changed:PropertyValues):void;
 /** Redraws canvas content after an upstream token or theme change. */
 refreshTheme():void;private refreshAccessibleTargetSize;
 /** Reads the customizable ramp endpoints off the host's computed style. */