@aceshooting/lyra-ui 29.0.2 → 29.1.0

package/dist/components/retrieval/knowledge-base-admin/knowledge-base-admin.class.js

@@ -1,5 +1,6 @@
-import{__decorate}from"tslib";import{resolveListMove,isRovingTargetAvailable}from"../../../internal/list-navigation.js";import{collectionSupport}from"../../../internal/collection-snapshot.js";import{html,nothing}from"lit";import{property}from"lit/decorators.js";import{LyraElement}from"../../../internal/lyra-element.js";import{styles}from"./knowledge-base-admin.styles.js";import{shadowFocusTarget}from"../../../internal/active-element.js";import{resolveHeadingLevel}from"../../../internal/heading-level.js";import{hostAriaLabel,nextId}from"../../../internal/a11y.js";import{LYRA_DEFAULT_knowledgeBaseAdminIngestionTab,LYRA_DEFAULT_knowledgeBaseAdminLabel,LYRA_DEFAULT_knowledgeBaseAdminSourcesTab}from"../../../internal/default-strings/retrieval.generated.js";class LyraKnowledgeBaseAdmin extends LyraElement{constructor(){super(...arguments),this.sources=[],this.ingestionItems=[],this.activeTab="sources",this.headingLevel="2",this.withoutIngestion=!1,this.idPrefix=nextId("knowledge-base-admin"),this.focusSourcesAfterUpdate=!1}static{this.defaultStrings={...super.defaultStrings,knowledgeBaseAdminIngestionTab:LYRA_DEFAULT_knowledgeBaseAdminIngestionTab,knowledgeBaseAdminLabel:LYRA_DEFAULT_knowledgeBaseAdminLabel,knowledgeBaseAdminSourcesTab:LYRA_DEFAULT_knowledgeBaseAdminSourcesTab}}static{this.collectionSupport=collectionSupport}static{this.ownedCollectionProperties=Object.freeze(["sources","ingestionItems"])}static{this.styles=[LyraElement.styles,styles]}tabId(tab){return`${this.idPrefix}-${tab}-tab`}panelId(tab){return`${this.idPrefix}-${tab}-panel`}setTab(tab){tab==="ingestion"&&this.withoutIngestion||(tab!==this.activeTab&&(this.activeTab=tab,this.emit("lr-tab-change",{activeTab:tab})),this.emit("lr-activate",{value:tab}))}willUpdate(changed){super.willUpdate(changed);const invalidTab=this.activeTab!=="sources"&&this.activeTab!=="ingestion",unavailableIngestion=this.withoutIngestion&&this.activeTab==="ingestion";!invalidTab&&!unavailableIngestion||(this.focusSourcesAfterUpdate=shadowFocusTarget(this)?.matches('[role="tab"]')??!1,this.activeTab="sources",this.emit("lr-tab-change",{activeTab:"sources"}))}updated(changed){super.updated(changed),this.focusSourcesAfterUpdate&&(this.focusSourcesAfterUpdate=!1,this.shadowRoot?.querySelector(`#${this.tabId("sources")}`)?.focus())}handleTabKeydown(event,current){const tabs=this.withoutIngestion?["sources"]:["sources","ingestion"],nextIndex=resolveListMove(event,{count:tabs.length,current:tabs.indexOf(current),orientation:"horizontal",direction:this.effectiveDirection,isAvailable:index=>{const target=this.shadowRoot?.getElementById(this.tabId(tabs[index]));return!!(target&&isRovingTargetAvailable(target))}});if(nextIndex===null)return;event.preventDefault();const next=tabs[nextIndex];this.setTab(next),this.updateComplete.then(()=>{this.shadowRoot?.querySelector(`#${this.tabId(next)}`)?.focus()})}forward(event,name,detail){event.stopPropagation(),this.emit(name,detail)}render(){const visibleLabel=this.label==null?this.localize("knowledgeBaseAdminLabel"):this.label,tablistLabel=hostAriaLabel(this)??(visibleLabel||this.localize("knowledgeBaseAdminLabel")),tab=this.activeTab==="ingestion"&&!this.withoutIngestion?"ingestion":"sources",level=resolveHeadingLevel(this.headingLevel),childLevel=level?String(Math.min(6,+level+1)):"none";return html`<section part="base">
+import{__decorate}from"tslib";import{AnnouncementSinkController}from"../../../internal/announcer.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{resolveListMove,isRovingTargetAvailable}from"../../../internal/list-navigation.js";import{collectionSupport,publicCollectionTruncation,snapshotEventDetail}from"../../../internal/collection-snapshot.js";import{html,nothing}from"lit";import{property}from"lit/decorators.js";import{live}from"lit/directives/live.js";import{ref}from"lit/directives/ref.js";import{setSourcePageScope}from"../../../internal/source-page-scope.js";import{tag}from"../../../internal/prefix.js";import{LyraElement}from"../../../internal/lyra-element.js";import{styles}from"./knowledge-base-admin.styles.js";import{shadowFocusTarget}from"../../../internal/active-element.js";import{resolveHeadingLevel}from"../../../internal/heading-level.js";import{hostAriaLabel,nextId}from"../../../internal/a11y.js";import{LYRA_DEFAULT_knowledgeBaseAdminIngestionTab,LYRA_DEFAULT_knowledgeBaseAdminInputLimit,LYRA_DEFAULT_knowledgeBaseAdminLabel,LYRA_DEFAULT_knowledgeBaseAdminSourcesTab}from"../../../internal/default-strings/retrieval.generated.js";const EMPTY_ROWS=Object.freeze([]);class LyraKnowledgeBaseAdmin extends LyraElement{constructor(){super(...arguments),this.forwardGeneration=0,this.bindSourcePageScope=child=>{child instanceof HTMLElement&&setSourcePageScope(child,this)},this.sources=[],this.ingestionItems=[],this.activeTab="sources",this.headingLevel="2",this.withoutIngestion=!1,this.idPrefix=nextId("knowledge-base-admin"),this.focusSourcesAfterUpdate=!1,this.lastInputNotice="",this.inputNoticeMounted=!1,this.inputAnnouncements=new AnnouncementSinkController(this)}static{this.defaultStrings={...super.defaultStrings,knowledgeBaseAdminIngestionTab:LYRA_DEFAULT_knowledgeBaseAdminIngestionTab,knowledgeBaseAdminInputLimit:LYRA_DEFAULT_knowledgeBaseAdminInputLimit,knowledgeBaseAdminLabel:LYRA_DEFAULT_knowledgeBaseAdminLabel,knowledgeBaseAdminSourcesTab:LYRA_DEFAULT_knowledgeBaseAdminSourcesTab}}static{this.collectionSupport=collectionSupport}static{this.ownedCollectionProperties=Object.freeze(["sources","ingestionItems"])}static{this.identityCollectionObjectProperties=Object.freeze(["dataSource","ingestionSource"])}static{this.styles=[LyraElement.styles,styles]}get dataSource(){return this._dataSource}set dataSource(value){const old=this._dataSource;if(this._dataSource=value,this.activeView==="sources"){this.forwardGeneration=(this.forwardGeneration??0)+1;const child=this.activeChild();child&&(child.dataSource=value)}this.requestUpdate("dataSource",old)}get ingestionSource(){return this._ingestionSource}set ingestionSource(value){const old=this._ingestionSource;if(this._ingestionSource=value,this.activeView==="ingestion"){this.forwardGeneration=(this.forwardGeneration??0)+1;const child=this.activeChild();child&&(child.dataSource=value)}this.requestUpdate("ingestionSource",old)}get activeView(){return this.activeTab==="ingestion"&&!this.withoutIngestion?"ingestion":"sources"}activeChild(){if(this.isConnected)return this.shadowRoot?.querySelector(tag(this.activeView==="sources"?"knowledge-base":"ingestion-queue"))??void 0}requestUpdate(...args){args[0]===void 0?(this.forwardGeneration=(this.forwardGeneration??0)+1,this.activeChild()?.requestUpdate()):(args[0]==="activeTab"&&this.activeTab!==args[1]||args[0]==="withoutIngestion"&&this.withoutIngestion!==args[1])&&(this.forwardGeneration=(this.forwardGeneration??0)+1),super.requestUpdate(...args)}tabId(tab){return`${this.idPrefix}-${tab}-tab`}panelId(tab){return`${this.idPrefix}-${tab}-panel`}setTab(tab){tab==="ingestion"&&this.withoutIngestion||(tab!==this.activeTab&&(this.activeTab=tab,this.emit("lr-tab-change",{activeTab:tab})),this.emit("lr-activate",{value:tab}))}willUpdate(changed){super.willUpdate(changed);const invalidTab=this.activeTab!=="sources"&&this.activeTab!=="ingestion",unavailableIngestion=this.withoutIngestion&&this.activeTab==="ingestion";!invalidTab&&!unavailableIngestion||(this.focusSourcesAfterUpdate=shadowFocusTarget(this)?.matches('[role="tab"]')??!1,this.activeTab="sources",this.emit("lr-tab-change",{activeTab:"sources"}))}connectedCallback(){super.connectedCallback(),this.hasUpdated&&super.requestUpdate()}disconnectedCallback(){this.forwardGeneration++,super.disconnectedCallback(),this.inputNoticeMounted=!1}adoptedCallback(){this.forwardGeneration++,super.adoptedCallback(),this.inputAnnouncements.adopted()}inputLimitMessage(){const property2=this.activeView==="ingestion"?"ingestionItems":"sources";if(property2==="sources"?this.dataSource!==void 0:this.ingestionSource!==void 0)return"";const loss=publicCollectionTruncation(this,property2),format=getNumberFormat(this.effectiveLocale);return loss?this.localize("knowledgeBaseAdminInputLimit",void 0,{collection:this.localize(property2==="sources"?"knowledgeBaseAdminSourcesTab":"knowledgeBaseAdminIngestionTab"),count:format.format(loss.retained),total:format.format(loss.source)}):""}updated(changed){super.updated(changed);const notice=this.inputLimitMessage();this.inputNoticeMounted&&notice&&notice!==this.lastInputNotice&&this.inputAnnouncements.announcePolite(notice),this.lastInputNotice=notice,this.inputNoticeMounted=!0,this.focusSourcesAfterUpdate&&(this.focusSourcesAfterUpdate=!1,this.shadowRoot?.querySelector(`#${this.tabId("sources")}`)?.focus())}handleTabKeydown(event,current){const tabs=this.withoutIngestion?["sources"]:["sources","ingestion"],nextIndex=resolveListMove(event,{count:tabs.length,current:tabs.indexOf(current),orientation:"horizontal",direction:this.effectiveDirection,isAvailable:index=>{const target=this.shadowRoot?.getElementById(this.tabId(tabs[index]));return!!(target&&isRovingTargetAvailable(target))}});if(nextIndex===null)return;event.preventDefault();const next=tabs[nextIndex];this.setTab(next),this.updateComplete.then(()=>{this.shadowRoot?.querySelector(`#${this.tabId(next)}`)?.focus()})}forward(event,name,current,readDetail){if(event.stopPropagation(),!current())return;const detail=readDetail();if(!current())return;const snapshot=snapshotEventDetail(detail,this.ownerDocument.defaultView);current()&&this.emit(name,snapshot)}render(){const visibleLabel=this.label==null?this.localize("knowledgeBaseAdminLabel"):this.label,tablistLabel=hostAriaLabel(this)??(visibleLabel||this.localize("knowledgeBaseAdminLabel")),tab=this.activeTab==="ingestion"&&!this.withoutIngestion?"ingestion":"sources",generation=this.forwardGeneration,owner=this.ownerDocument,current=event=>()=>this.isConnected&&this.ownerDocument===owner&&this.forwardGeneration===generation&&this.activeView===tab&&event.currentTarget===this.activeChild(),notice=this.inputLimitMessage(),level=resolveHeadingLevel(this.headingLevel),childLevel=level?String(Math.min(6,+level+1)):"none";return html`<section part="base">
       <div part="heading" role=${level?"heading":nothing} aria-level=${level??nothing}>${visibleLabel}</div>
+      ${notice?html`<p part="input-limit" role="note">${notice}</p>`:nothing}
       <div part="tabs" role="tablist" aria-label=${tablistLabel}>
         <button
           part="tab"
@@ -36,12 +37,14 @@ import{__decorate}from"tslib";import{resolveListMove,isRovingTargetAvailable}fro
         ?hidden=${tab!=="sources"}
       >
         ${tab==="sources"?html`<lr-knowledge-base
-              .sources=${this.sources}
+              ${ref(this.bindSourcePageScope)}
+              .dataSource=${live(this.dataSource)}
+              .sources=${this.dataSource===void 0?this.sources:EMPTY_ROWS}
               .headingLevel=${childLevel}
-              @lr-source-create=${event=>this.forward(event,"lr-source-create",void 0)}
-              @lr-source-sync=${event=>this.forward(event,"lr-source-sync",event.detail)}
-              @lr-source-pause=${event=>this.forward(event,"lr-source-pause",event.detail)}
-              @lr-source-delete=${event=>this.forward(event,"lr-source-delete",event.detail)}
+              @lr-source-create=${event=>this.forward(event,"lr-source-create",current(event),()=>{})}
+              @lr-source-sync=${event=>this.forward(event,"lr-source-sync",current(event),()=>event.detail)}
+              @lr-source-pause=${event=>this.forward(event,"lr-source-pause",current(event),()=>event.detail)}
+              @lr-source-delete=${event=>this.forward(event,"lr-source-delete",current(event),()=>event.detail)}
             ></lr-knowledge-base>`:nothing}
       </div>
       ${this.withoutIngestion?nothing:html`<div
@@ -52,10 +55,12 @@ import{__decorate}from"tslib";import{resolveListMove,isRovingTargetAvailable}fro
             ?hidden=${tab!=="ingestion"}
           >
             ${tab==="ingestion"?html`<lr-ingestion-queue
-                  .items=${this.ingestionItems}
-                  @lr-retry=${event=>this.forward(event,"lr-ingestion-retry",event.detail)}
-                  @lr-cancel=${event=>this.forward(event,"lr-ingestion-cancel",event.detail)}
+                  ${ref(this.bindSourcePageScope)}
+                  .dataSource=${live(this.ingestionSource)}
+                  .items=${this.ingestionSource===void 0?this.ingestionItems:EMPTY_ROWS}
+                  @lr-retry=${event=>this.forward(event,"lr-ingestion-retry",current(event),()=>event.detail)}
+                  @lr-cancel=${event=>this.forward(event,"lr-ingestion-cancel",current(event),()=>event.detail)}
                 ></lr-ingestion-queue>`:nothing}
           </div>`}
       <div part="settings"><slot name="settings"></slot></div>
-    </section>`}}__decorate([property({attribute:!1})],LyraKnowledgeBaseAdmin.prototype,"sources",void 0),__decorate([property({attribute:!1})],LyraKnowledgeBaseAdmin.prototype,"ingestionItems",void 0),__decorate([property({attribute:"active-tab",reflect:!0})],LyraKnowledgeBaseAdmin.prototype,"activeTab",void 0),__decorate([property()],LyraKnowledgeBaseAdmin.prototype,"label",void 0),__decorate([property({attribute:"heading-level"})],LyraKnowledgeBaseAdmin.prototype,"headingLevel",void 0),__decorate([property({type:Boolean,attribute:"without-ingestion"})],LyraKnowledgeBaseAdmin.prototype,"withoutIngestion",void 0);export{LyraKnowledgeBaseAdmin};
+    </section>`}}__decorate([property({attribute:!1,hasChanged:()=>!0})],LyraKnowledgeBaseAdmin.prototype,"dataSource",null),__decorate([property({attribute:!1,hasChanged:()=>!0})],LyraKnowledgeBaseAdmin.prototype,"ingestionSource",null),__decorate([property({attribute:!1})],LyraKnowledgeBaseAdmin.prototype,"sources",void 0),__decorate([property({attribute:!1})],LyraKnowledgeBaseAdmin.prototype,"ingestionItems",void 0),__decorate([property({attribute:"active-tab",reflect:!0})],LyraKnowledgeBaseAdmin.prototype,"activeTab",void 0),__decorate([property()],LyraKnowledgeBaseAdmin.prototype,"label",void 0),__decorate([property({attribute:"heading-level"})],LyraKnowledgeBaseAdmin.prototype,"headingLevel",void 0),__decorate([property({type:Boolean,attribute:"without-ingestion"})],LyraKnowledgeBaseAdmin.prototype,"withoutIngestion",void 0);export{LyraKnowledgeBaseAdmin};

package/dist/components/retrieval/knowledge-base-admin/knowledge-base-admin.styles.js

@@ -1 +1 @@
-import{iconHitTarget,focusRing}from"../../../internal/interactive-control.styles.js";import{css}from"lit";const styles=css` :host { display: block; container-type: inline-size; contain-intrinsic-inline-size: var(--lr-size-20rem); } [part='base'] { display: flex; flex-direction: column; gap: var(--lr-space-m); } [part='heading'] { margin: 0; font-size: var(--lr-font-size-lg); font-weight: var(--lr-font-weight-semibold); } [part='tabs'] { display: flex; flex-wrap: wrap; gap: var(--lr-space-2xs); border-block-end: var(--lr-border-width-thin) solid var(--lr-color-border-subtle); } [part='tab'] { box-sizing: border-box; ${iconHitTarget} padding: var(--lr-space-xs) var(--lr-space-s); border: none; border-block-end: var(--lr-border-width-medium) solid transparent; background: transparent; color: var(--lr-color-text-quiet); font: inherit; cursor: pointer; transition: background-color var(--lr-transition-fast), color var(--lr-transition-fast); } [part='tab']:hover { color: var(--lr-color-text); } [part='tab']:active { color: var(--lr-color-text); background: color-mix(in oklab, transparent, var(--lr-color-mix-partner) var(--lr-color-mix-active)); } [part='tab']:focus-visible { ${focusRing} } [part='tab']:where([aria-selected='true']) { border-block-end-color: var(--lr-knowledge-base-admin-tab-selected-border, var(--lr-color-brand)); color: var(--lr-knowledge-base-admin-tab-selected-color, var(--lr-color-text)); font-weight: var(--lr-font-weight-semibold); } [part='panel'] { min-inline-size: 0; } `;export{styles};
+import{iconHitTarget,focusRing}from"../../../internal/interactive-control.styles.js";import{css}from"lit";const styles=css` [part='input-limit'], [part='slices-limit'] { margin: 0; font-size: var(--lr-font-size-sm); color: var(--lr-color-text-quiet); overflow-wrap: anywhere; } :host { display: block; container-type: inline-size; contain-intrinsic-inline-size: var(--lr-size-20rem); } [part='base'] { display: flex; flex-direction: column; gap: var(--lr-space-m); } [part='heading'] { margin: 0; font-size: var(--lr-font-size-lg); font-weight: var(--lr-font-weight-semibold); } [part='tabs'] { display: flex; flex-wrap: wrap; gap: var(--lr-space-2xs); border-block-end: var(--lr-border-width-thin) solid var(--lr-color-border-subtle); } [part='tab'] { box-sizing: border-box; ${iconHitTarget} padding: var(--lr-space-xs) var(--lr-space-s); border: none; border-block-end: var(--lr-border-width-medium) solid transparent; background: transparent; color: var(--lr-color-text-quiet); font: inherit; cursor: pointer; transition: background-color var(--lr-transition-fast), color var(--lr-transition-fast); } [part='tab']:hover { color: var(--lr-color-text); } [part='tab']:active { color: var(--lr-color-text); background: color-mix(in oklab, transparent, var(--lr-color-mix-partner) var(--lr-color-mix-active)); } [part='tab']:focus-visible { ${focusRing} } [part='tab']:where([aria-selected='true']) { border-block-end-color: var(--lr-knowledge-base-admin-tab-selected-border, var(--lr-color-brand)); color: var(--lr-knowledge-base-admin-tab-selected-color, var(--lr-color-text)); font-weight: var(--lr-font-weight-semibold); } [part='panel'] { min-inline-size: 0; } `;export{styles};

package/dist/components/retrieval/knowledge-graph-explorer/knowledge-graph-explorer.class.d.ts

@@ -1,4 +1,4 @@
-import type{LyraSearchChangeDetail}from'../../../internal/text-viewer-target.js';import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraNodeTypeStyle}from'../../../internal/node-type-style.js';export type{LyraNodeTypeStyle}from'../../../internal/node-type-style.js';import type{LyraGraphCamera,LyraGraphView,LyraGraphCommunity,LyraGraphFit,LyraGraphNodeLabelsMode,LyraGraphRenderer,LyraGraphEdge,LyraGraphNode}from'../graph/graph.class.js';import type{LyraEntity}from'../entity-card/entity-card.class.js';import type{LyraPathElement}from'../path-strip/path-strip.class.js';export type{LyraPathElement}from'../path-strip/path-strip.class.js';import'../graph/graph.class.js';import'../graph-legend/graph-legend.class.js';import'../entity-card/entity-card.class.js';import'../neighbor-list/neighbor-list.class.js';import'../path-strip/path-strip.class.js';import'../../overlays/overlay/popover.class.js';import'../../forms/input/input.class.js';import'../../overlays/chip/chip.class.js';import'../../forms/button/button.class.js';
+import type{GraphSource}from'../graph/graph.class.js';export type KnowledgeGraphExplorerSource=GraphSource;import type{LyraSearchChangeDetail}from'../../../internal/text-viewer-target.js';import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraNodeTypeStyle}from'../../../internal/node-type-style.js';export type{LyraNodeTypeStyle}from'../../../internal/node-type-style.js';import type{LyraGraphCamera,LyraGraphView,LyraGraphCommunity,LyraGraphFit,LyraGraphNodeLabelsMode,LyraGraphRenderer,LyraGraphEdge,LyraGraphNode}from'../graph/graph.class.js';import type{LyraEntity}from'../entity-card/entity-card.class.js';import type{LyraPathElement}from'../path-strip/path-strip.class.js';export type{LyraPathElement}from'../path-strip/path-strip.class.js';import'../graph/graph.class.js';import'../graph-legend/graph-legend.class.js';import'../entity-card/entity-card.class.js';import'../neighbor-list/neighbor-list.class.js';import'../../overlays/overlay/popover.class.js';import'../../forms/input/input.class.js';import'../../forms/button/button.class.js';
 /** Extra `LyraEntity` fields a plain `LyraGraphNode` doesn't carry -- merged in by node id to build
 *  the entity shown in the details popover and neighbor rows. A node with no entry here still
 *  renders fine: `degree` falls back to a live count derived from `edges`, `description`/
@@ -142,11 +142,16 @@ export type KnowledgeGraphHighlight='selection'|'hover'|'none';export interface
 *   50 rows sharing one tab stop (ArrowUp/ArrowDown/Home/End); the announced count covers every match.
 * @csspart search-result - One search-match row (`role="listitem"`, wrapping a `<button>`).
 * @csspart search-empty - The "no matches" message, shown when `query` is non-empty but no node matches.
+* @csspart input-limit - Localized retained/source counts for nodes and links omitted at assignment.
 * @csspart details-limit - Localized shown/total notice when `entityDetails` holds more entries than the shared boundary keeps.
 * @csspart search-limit - Localized shown/total notice when search matches exceed the 50-row list.
 * @csspart pinned - The pinned-nodes row, only rendered while `pinnedNodeIds` is non-empty.
 * @csspart pinned-heading - The pinned-nodes row's leading label.
-* @csspart path - The composed `lr-path-strip`, only rendered while `path` is non-empty.
+* @csspart path - The composed `lr-path-strip`, or its loading/error status, while `path` is non-empty.
+*   Path registration loads on first use; `updateComplete` waits for registration and rendering.
+* @csspart source-status - Source filter error or all-types-hidden status.
+* @csspart source-clear - Restores unfiltered source navigation.
+* @csspart detail-neighbors - The details neighborhood, source-bound only while details are open.
 * @csspart graph - The composed `lr-graph`.
 * @csspart detail-popover - The composed `lr-popover` hosting the details overlay.
 * @csspart detail-card - The default-content `lr-entity-card`, only present while `selectedNodeId` resolves to a node.
@@ -158,7 +163,21 @@ export type KnowledgeGraphHighlight='selection'|'hover'|'none';export interface
 * @status stable
 * @since 4.1.0
 */
-export declare class LyraKnowledgeGraphExplorer extends LyraElement<LyraKnowledgeGraphExplorerEventMap>{protected static collectionSupport:import("../../../internal/lyra-element.js").LyraCollectionSupport;protected static readonly ownedCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];protected static readonly immutableEventDetails:readonly string[];
+export declare class LyraKnowledgeGraphExplorer extends LyraElement<LyraKnowledgeGraphExplorerEventMap>{protected static collectionSupport:import("../../../internal/lyra-element.js").LyraCollectionSupport;protected static readonly ownedCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];protected static readonly immutableEventDetails:readonly string[];private _graphSource?;private sourceEpoch;private sourceSearchVersion;private sourceSearchIntent?;private sourceAssigned;private sourceClosing;private sourceChildBinding?;private sourceChild?;private sourceInspect?;private sourceEntity?;private sourceDetailsOpen;private sourcePaint;
+/** Full graph provider, passed unchanged to the child graph. Same-source assignment and
+* requestUpdate() refresh it. Unset restores legacy arrays. Controlled source selection is
+* resolved without moving the page or opening details; user activation opens details.
+* When hiddenTypes is used, at most500 nodeTypes (2,000,000 total ID units) must declare the provider's complete type catalog.
+* Unfiltered navigation includes provider types outside that catalog. */
+get graphSource():KnowledgeGraphExplorerSource|undefined;set graphSource(value:KnowledgeGraphExplorerSource|undefined);private _sourcePage;
+/** Zero-based page of the sole child-owned global record navigator. */
+get sourcePage():number;set sourcePage(value:number);private _sourcePageSize;
+/** Records per page, default 100 and normalized 1–500 by the child. */
+get sourcePageSize():number;set sourcePageSize(value:number);
+/** Exact active filtered node/edge total, distinct from full-source graph totals. */
+get sourceTotal():number|null;private get sourceFilter();private sourceCurrent;private readonly sourceAccepted;private readonly bindSourceChild;private inspectSourceSelection;
+/** Reveals and focuses a global node or edge without activation. Clears toolbar filters. */
+revealSourceKey(key:string):Promise<boolean>;private closeSourceDetails;requestUpdate(...args:Parameters<LyraElement['requestUpdate']>):void;private activateSourceEntity;
 /** Nodes forwarded to the composed graph and search experience. */
 nodes:readonly LyraGraphNode[];
 /** Edges forwarded to the composed graph and path interactions. */
@@ -229,7 +248,7 @@ highlight:KnowledgeGraphHighlight;
 *  `''` (the default) renders no search-result list at all and applies no search dimming.
 *  Removing the attribute uses this empty-filter behavior while retaining null property
 *  readback. */
-query:string;private pinLiveText;private hoveredNodeId;private activeResult;private graphEl?;private popoverEl?;private pendingNodeId?;private activationGeneration;private internalSelectionAssignment?;private trackedNodeEl?;private nodeById;private linksByNodeId;private degreeByNodeId;private communityLabelById;private matchesMemo?;private normalizedGraphModel?;private normalizedGraphSources?;private readonly announcements;private activationFrameId?;private activationFrameOwner?;private activationFrameDocument?;private activationFrameResolve?;private activationFramePageHide?;private get graphModel();private get canonicalPinnedNodeIds();private get canonicalHiddenTypes();connectedCallback():void;protected willUpdate(changed:PropertyValues):void;protected updated(changed:PropertyValues):void;private reanchorAfterCameraUpdate;private activatePresetWhenGraphReady;private waitForActivationFrame;private clearActivationFrameRecord;private cancelActivationFrame;private invalidateActivation;private resumePresetActivation;private setInternalSelectedNodeId;disconnectedCallback():void;adoptedCallback():void;private rebuildDerivedCollections;private isVisibleGraphNode;private isVisibleNode;private canActivateNode;private nodeLabel;private degreeOf;private entityFor;private communityLabelFor;private neighborRowsFor;private searchableNamesOf;private matchingNodes;private searchResultAnnouncement;private neighborIdsOf;private linkKey;private get computedDimmedNodeIds();private get computedDimmedLinkIds();private togglePin;private requestPath;private onVisibilityChange;private onVisibilityChangeProposal;private onSearchInput;private onEntityActivate;
+query:string;private pinLiveText;private hoveredNodeId;private activeResult;private graphEl?;private popoverEl?;private pendingNodeId?;private activationGeneration;private internalSelectionAssignment?;private trackedNodeEl?;private nodeById;private linksByNodeId;private degreeByNodeId;private communityLabelById;private matchesMemo?;private normalizedGraphModel?;private normalizedGraphSources?;private readonly announcements;private activationFrameId?;private activationFrameOwner?;private activationFrameDocument?;private activationFrameResolve?;private activationFramePageHide?;private get graphModel();private get canonicalPinnedNodeIds();private get canonicalHiddenTypes();private optionalRequest;private optionalGeneration;private optionalPending?;private pathReady;private optionalFailed;private loadOptionalPath;private ensureOptionalChildren;protected getUpdateComplete():Promise<boolean>;connectedCallback():void;protected willUpdate(changed:PropertyValues):void;protected updated(changed:PropertyValues):void;private reanchorAfterCameraUpdate;private activatePresetWhenGraphReady;private waitForActivationFrame;private clearActivationFrameRecord;private cancelActivationFrame;private invalidateActivation;private resumePresetActivation;private setInternalSelectedNodeId;disconnectedCallback():void;adoptedCallback():void;private rebuildDerivedCollections;private isVisibleGraphNode;private isVisibleNode;private canActivateNode;private nodeLabel;private degreeOf;private entityFor;private communityLabelFor;private neighborRowsFor;private searchableNamesOf;private matchingNodes;private searchResultAnnouncement;private neighborIdsOf;private linkKey;private dimmingMemo?;private dimmingProjection;private get computedDimmedNodeIds();private get computedDimmedLinkIds();private togglePin;private requestPath;private onVisibilityChange;private onVisibilityChangeProposal;private onSearchInput;private onEntityActivate;
 /** Frames every visible node in the composed graph's viewport, forwarding to `lr-graph.fit()`.
 *  No-op before the graph has rendered or with no visible nodes. Selection is unaffected. */
 fit(options?:{padding?:number;}):void;
@@ -239,4 +258,4 @@ resetView():void;
 /** Centers the camera on node `id` through the composed graph's `focusNode()`, without selecting
 *  it or opening its details popover. Resolves `false` for an unknown or filtered-out node, or
 *  before the graph has rendered. */
-focusNode(id:string,options?:{zoom?:number;}):Promise<boolean>;private activateEntity;private openDetailAt;private resolveDirectClickAnchor;private onGraphNodeClick;private onGraphNativeClick;private onGraphViewportChange;private onGraphNodeEnter;private onGraphNodeLeave;private onResultKeyDown;private onPopoverHide;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-knowledge-graph-explorer':LyraKnowledgeGraphExplorer;}}
+focusNode(id:string,options?:{zoom?:number;}):Promise<boolean>;private activateEntity;private openDetailAt;private resolveDirectClickAnchor;private onGraphNodeClick;private onGraphNativeClick;private onGraphViewportChange;private onGraphNodeEnter;private onGraphNodeLeave;private onResultKeyDown;private onPopoverHide;private inputLimitMessages;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-knowledge-graph-explorer':LyraKnowledgeGraphExplorer;}}

package/dist/components/retrieval/knowledge-graph-explorer/knowledge-graph-explorer.class.js

@@ -1,4 +1,4 @@
-import{__decorate}from"tslib";import{collectionSupport,publicCollectionTruncation}from"../../../internal/collection-snapshot.js";import{tag}from"../../../internal/prefix.js";import{html,nothing}from"lit";import{property,state,query}from"lit/decorators.js";import{guard}from"lit/directives/guard.js";import{LyraElement}from"../../../internal/lyra-element.js";import{finiteRange}from"../../../internal/numbers.js";import{srOnly}from"../../../internal/a11y.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{styles}from"./knowledge-graph-explorer.styles.js";import{retrievalSemanticLabel,retrievalSemanticRole}from"../retrieval-semantic-owner.js";import{graphLengthConverter,graphLinkIdentity,normalizeGraphModel}from"../graph/graph-model.js";import{canonicalIdentityList,isNonBlankIdentity}from"../retrieval-identity.js";import"../graph/graph.class.js";import"../graph-legend/graph-legend.class.js";import"../entity-card/entity-card.class.js";import"../neighbor-list/neighbor-list.class.js";import"../path-strip/path-strip.class.js";import"../../overlays/overlay/popover.class.js";import"../../forms/input/input.class.js";import"../../overlays/chip/chip.class.js";import"../../forms/button/button.class.js";import{AnnouncementSinkController}from"../../../internal/announcer.js";import{LYRA_DEFAULT_graphDataListLimit,LYRA_DEFAULT_graphExplorerFindPath,LYRA_DEFAULT_graphExplorerLabel,LYRA_DEFAULT_graphExplorerPin,LYRA_DEFAULT_graphExplorerPinned,LYRA_DEFAULT_graphExplorerPinnedHeading,LYRA_DEFAULT_graphExplorerSearchLimit,LYRA_DEFAULT_graphExplorerSearchPlaceholder,LYRA_DEFAULT_graphExplorerSearchResultsLabel,LYRA_DEFAULT_graphExplorerUnpin,LYRA_DEFAULT_graphExplorerUnpinned}from"../../../internal/default-strings/retrieval.generated.js";import{LYRA_DEFAULT_fieldRequired,LYRA_DEFAULT_viewerSearchMatchCount,LYRA_DEFAULT_viewerSearchNoMatches}from"../../../internal/default-strings/shared.generated.js";const SEARCH_RESULT_LIMIT=50;function isElementNode(value){if(typeof value!="object"||value===null)return!1;const candidate=value;return candidate.nodeType===1&&typeof candidate.matches=="function"&&typeof candidate.getBoundingClientRect=="function"}class LyraKnowledgeGraphExplorer extends LyraElement{constructor(){super(...arguments),this.nodes=[],this.edges=[],this.nodeTypes=[],this.communities=[],this.entityDetails={},this.pinnedNodeIds=[],this.path=[],this.hiddenTypes=[],this.selectedNodeId=null,this.renderer="svg",this.view="2d",this.fitTo="none",this.width=800,this.height=600,this.highlight="selection",this.query="",this.pinLiveText="",this.hoveredNodeId=null,this.activeResult=0,this.activationGeneration=0,this.nodeById=new Map,this.linksByNodeId=new Map,this.degreeByNodeId=new Map,this.communityLabelById=new Map,this.announcements=new AnnouncementSinkController(this,{eager:["polite"]}),this.onVisibilityChange=event=>{event.stopPropagation(),this.hiddenTypes=event.detail.hiddenTypes,this.emit("lr-hidden-types-change",{hiddenTypes:this.hiddenTypes})},this.onVisibilityChangeProposal=event=>{event.stopPropagation()},this.onSearchInput=event=>{event.stopPropagation();const value=event.detail.value;this.query!==value&&(this.query=value,this.emit("lr-search-change",{query:value,matchCount:this.matchingNodes()?.length??0,matchCountExact:!0,activeIndex:-1}))},this.onEntityActivate=event=>{event.stopPropagation(),this.activateEntity(event.detail.entityId)},this.onGraphNodeClick=event=>{const id=event.detail.nodeId;if(!this.canActivateNode(id))return;const generation=this.invalidateActivation();if(this.setInternalSelectedNodeId(id),this.view==="3d"){const graph=this.graphEl,point=graph?.getNodeScreenPosition(id),bounds=graph?.getBoundingClientRect();if(point&&bounds){this.trackedNodeEl=void 0,this.openDetailAt(id,{x:bounds.left+point.x,y:bounds.top+point.y,width:0,height:0});return}}this.pendingNodeId=id;const ownerDocument=this.ownerDocument,ownerWindow=ownerDocument.defaultView;ownerWindow&&ownerWindow.queueMicrotask(()=>{generation===this.activationGeneration&&this.isConnected&&this.ownerDocument===ownerDocument&&this.pendingNodeId===id&&(this.pendingNodeId=void 0,this.selectedNodeId===id&&this.isVisibleNode(id)&&this.activateEntity(id))})},this.onGraphNativeClick=event=>{const id=this.pendingNodeId;id&&(this.pendingNodeId=void 0,this.openDetailAt(id,this.resolveDirectClickAnchor(event)))},this.onGraphViewportChange=()=>{const graph=this.graphEl;if(graph?.view==="3d"&&this.selectedNodeId&&this.popoverEl?.open){const point=graph.getNodeScreenPosition(this.selectedNodeId);if(point){const rect2=graph.getBoundingClientRect();this.popoverEl.showAt({x:rect2.left+point.x,y:rect2.top+point.y,width:0,height:0})}return}const el=this.trackedNodeEl,popover=this.popoverEl;if(!el?.isConnected||!popover?.open)return;const rect=el.getBoundingClientRect();popover.showAt({x:rect.left+rect.width/2,y:rect.top,width:rect.width,height:rect.height})},this.onGraphNodeEnter=event=>{this.highlight==="hover"&&(this.hoveredNodeId=event.detail.nodeId)},this.onGraphNodeLeave=event=>{this.highlight==="hover"&&this.hoveredNodeId===event.detail.nodeId&&(this.hoveredNodeId=null)},this.onResultKeyDown=event=>{const buttons=[...this.renderRoot.querySelectorAll('[part="search-result"] button')],index=buttons.indexOf(event.target),next={ArrowDown:index+1,ArrowUp:index-1,Home:0,End:buttons.length-1}[event.key];index<0||next===void 0||(event.preventDefault(),this.activeResult=Math.max(0,Math.min(buttons.length-1,next)),buttons[this.activeResult].focus())},this.onPopoverHide=()=>{this.invalidateActivation(),this.trackedNodeEl=void 0,this.setInternalSelectedNodeId(null)}}static{this.defaultStrings={...super.defaultStrings,fieldRequired:LYRA_DEFAULT_fieldRequired,graphDataListLimit:LYRA_DEFAULT_graphDataListLimit,graphExplorerFindPath:LYRA_DEFAULT_graphExplorerFindPath,graphExplorerLabel:LYRA_DEFAULT_graphExplorerLabel,graphExplorerPin:LYRA_DEFAULT_graphExplorerPin,graphExplorerPinned:LYRA_DEFAULT_graphExplorerPinned,graphExplorerPinnedHeading:LYRA_DEFAULT_graphExplorerPinnedHeading,graphExplorerSearchLimit:LYRA_DEFAULT_graphExplorerSearchLimit,graphExplorerSearchPlaceholder:LYRA_DEFAULT_graphExplorerSearchPlaceholder,graphExplorerSearchResultsLabel:LYRA_DEFAULT_graphExplorerSearchResultsLabel,graphExplorerUnpin:LYRA_DEFAULT_graphExplorerUnpin,graphExplorerUnpinned:LYRA_DEFAULT_graphExplorerUnpinned,viewerSearchMatchCount:LYRA_DEFAULT_viewerSearchMatchCount,viewerSearchNoMatches:LYRA_DEFAULT_viewerSearchNoMatches}}static{this.collectionSupport=collectionSupport}static{this.ownedCollectionProperties=Object.freeze(["nodes","edges","nodeTypes","communities","entityDetails","pinnedNodeIds","path","hiddenTypes"])}static{this.styles=[LyraElement.styles,styles,srOnly]}static{this.immutableEventDetails=Object.freeze(["lr-selection-change","lr-pin-change","lr-hidden-types-change"])}get graphModel(){const sources=this.normalizedGraphSources;return(!sources||sources[0]!==this.nodes||sources[1]!==this.edges||sources[2]!==this.nodeTypes||sources[3]!==this.communities)&&(this.normalizedGraphSources=[this.nodes,this.edges,this.nodeTypes,this.communities],this.normalizedGraphModel=normalizeGraphModel(this.nodes,this.edges,this.nodeTypes,this.communities)),this.normalizedGraphModel}get canonicalPinnedNodeIds(){return canonicalIdentityList(this.pinnedNodeIds)}get canonicalHiddenTypes(){return canonicalIdentityList(this.hiddenTypes)}connectedCallback(){super.connectedCallback(),this.hasUpdated&&this.resumePresetActivation()}willUpdate(changed){super.willUpdate(changed),(changed.has("nodes")||changed.has("edges")||changed.has("communities"))&&this.rebuildDerivedCollections(),this.hoveredNodeId&&!this.isVisibleNode(this.hoveredNodeId)&&(this.hoveredNodeId=null),(changed.has("nodes")||changed.has("hiddenTypes"))&&this.selectedNodeId&&!this.isVisibleNode(this.selectedNodeId)&&(this.invalidateActivation(),this.setInternalSelectedNodeId(null),this.popoverEl&&(this.popoverEl.open=!1)),this.hasUpdated&&(this.query??"").trim()&&(changed.has("query")||changed.has("nodes")||changed.has("hiddenTypes")||changed.has("locale")||changed.has("strings"))&&this.announcements.announcePolite(this.searchResultAnnouncement())}updated(changed){if(super.updated(changed),changed.has("camera")&&this.view==="3d"&&this.graphEl&&this.reanchorAfterCameraUpdate(this.graphEl,this.camera),!changed.has("selectedNodeId"))return;const internallyAssigned=this.internalSelectionAssignment!==void 0&&Object.is(this.internalSelectionAssignment.value,this.selectedNodeId);if(this.internalSelectionAssignment=void 0,internallyAssigned)return;const generation=this.invalidateActivation(),id=this.selectedNodeId;if(!isNonBlankIdentity(id)){id!==null&&(this.selectedNodeId=null),this.popoverEl&&(this.popoverEl.open=!1);return}const graph=this.graphEl;graph&&this.isVisibleNode(id)&&this.activatePresetWhenGraphReady(id,graph,generation)}async reanchorAfterCameraUpdate(graph,camera){await graph.updateComplete,this.isConnected&&this.graphEl===graph&&this.camera===camera&&this.view==="3d"&&this.onGraphViewportChange()}async activatePresetWhenGraphReady(id,graph,generation){for(await graph.updateComplete;generation===this.activationGeneration&&this.isConnected&&graph.isConnected&&this.selectedNodeId===id&&graph.shadowRoot?.querySelector(tag("skeleton"));)if(!await this.waitForActivationFrame(generation))return;generation===this.activationGeneration&&this.isConnected&&this.selectedNodeId===id&&this.isVisibleNode(id)&&await this.activateEntity(id)}waitForActivationFrame(generation){this.cancelActivationFrame();const ownerDocument=this.ownerDocument,ownerWindow=ownerDocument.defaultView;return!ownerWindow||!this.isConnected||generation!==this.activationGeneration?Promise.resolve(!1):new Promise(resolve=>{let settled=!1;const settle=ready=>{settled||(settled=!0,resolve(ready))};let handle;const onPageHide=()=>{this.activationFrameOwner===ownerWindow&&this.activationFrameDocument===ownerDocument&&this.activationFrameResolve===settle&&this.cancelActivationFrame()};try{handle=ownerWindow.requestAnimationFrame(()=>{const current=this.activationFrameId===handle&&this.activationFrameOwner===ownerWindow&&this.activationFrameDocument===ownerDocument&&this.activationFrameResolve===settle&&generation===this.activationGeneration&&this.isConnected&&this.ownerDocument===ownerDocument;current&&this.clearActivationFrameRecord(),settle(current)})}catch{settle(!1);return}this.activationFrameId=handle,this.activationFrameOwner=ownerWindow,this.activationFrameDocument=ownerDocument,this.activationFrameResolve=settle,this.activationFramePageHide=onPageHide,ownerWindow.addEventListener("pagehide",onPageHide,{once:!0})})}clearActivationFrameRecord(){this.activationFramePageHide&&this.activationFrameOwner?.removeEventListener("pagehide",this.activationFramePageHide),this.activationFrameId=void 0,this.activationFrameOwner=void 0,this.activationFrameDocument=void 0,this.activationFrameResolve=void 0,this.activationFramePageHide=void 0}cancelActivationFrame(){const handle=this.activationFrameId,ownerWindow=this.activationFrameOwner,settle=this.activationFrameResolve;this.clearActivationFrameRecord();try{handle!==void 0&&ownerWindow?.cancelAnimationFrame(handle)}finally{settle?.(!1)}}invalidateActivation(){return this.activationGeneration+=1,this.cancelActivationFrame(),this.activationGeneration}resumePresetActivation(){const id=this.selectedNodeId,graph=this.graphEl;if(!id||!graph||!this.isVisibleNode(id))return;const generation=this.invalidateActivation();this.activatePresetWhenGraphReady(id,graph,generation)}setInternalSelectedNodeId(value){Object.is(this.selectedNodeId,value)||(this.internalSelectionAssignment={value},this.selectedNodeId=value,this.emit("lr-selection-change",{selectedNodeId:value,selectedNodeIds:value?[value]:[],selectedEdgeIds:[]}))}disconnectedCallback(){this.invalidateActivation(),this.pendingNodeId=void 0,this.trackedNodeEl=void 0,this.hoveredNodeId=null,super.disconnectedCallback()}adoptedCallback(){super.adoptedCallback(),this.invalidateActivation(),this.announcements.adopted(),this.isConnected&&this.resumePresetActivation()}rebuildDerivedCollections(){const model=this.graphModel;this.nodeById=new Map(model.nodes.map(node=>[node.id,node])),this.communityLabelById=new Map(model.communities.map(community=>[community.id,community.label]));const linksByNodeId=new Map,degrees=new Map;for(const link of model.links)for(const id of new Set([link.source,link.target])){const adjacent=linksByNodeId.get(id);adjacent?adjacent.push(link):linksByNodeId.set(id,[link]),degrees.set(id,(degrees.get(id)??0)+1)}this.linksByNodeId=linksByNodeId,this.degreeByNodeId=degrees}isVisibleGraphNode(node){return node.type==null||!this.canonicalHiddenTypes.includes(node.type)}isVisibleNode(id){const node=this.nodeById.get(id);return!!node&&this.isVisibleGraphNode(node)}canActivateNode(id){const node=this.nodeById.get(id);return node?this.isVisibleGraphNode(node):!this.hasUpdated&&this.graphModel.nodes.length===0}nodeLabel(id){const node=this.nodeById.get(id);return node?.label||node?.accessibleLabel||id}degreeOf(id){return this.degreeByNodeId.get(id)??0}entityFor(id){const node=this.nodeById.get(id);if(!node)return;const details=this.entityDetails[id];return{id:node.id,label:node.label||node.accessibleLabel||node.id,type:node.type,communityId:node.communityId,description:details?.description,properties:details?.properties,degree:details?.degree??this.degreeOf(node.id)}}communityLabelFor(communityId){return communityId?this.communityLabelById.get(communityId)??communityId:""}neighborRowsFor(id){const rows=[];for(const link of this.linksByNodeId.get(id)??[])if(link.source===id){const node=this.entityFor(link.target);node&&this.isVisibleNode(link.target)&&rows.push({relation:link.label??"",direction:"out",node})}else if(link.target===id){const node=this.entityFor(link.source);node&&this.isVisibleNode(link.source)&&rows.push({relation:link.label??"",direction:"in",node})}return rows}searchableNamesOf(node){return[node.label,node.accessibleLabel,node.id].filter(name=>typeof name=="string"&&name!=="")}matchingNodes(){const query2=this.query??"",locale=this.effectiveLocale,model=this.graphModel,hidden=this.canonicalHiddenTypes,memo=this.matchesMemo;if(memo?.[0]===query2&&memo[1]===locale&&memo[2]===model&&memo[3]===hidden)return memo[4];const q=query2.trim().toLocaleLowerCase(locale);let matches;if(q){const hiddenTypes=new Set(hidden);matches=model.nodes.filter(node=>(node.type==null||!hiddenTypes.has(node.type))&&this.searchableNamesOf(node).some(name=>name.toLocaleLowerCase(locale).includes(q)))}return this.matchesMemo=[query2,locale,model,hidden,matches],matches}searchResultAnnouncement(matches=this.matchingNodes()){return matches?matches.length===0?this.localize("viewerSearchNoMatches"):this.localize("viewerSearchMatchCount",void 0,{count:getNumberFormat(this.effectiveLocale).format(matches.length),pluralCount:matches.length}):""}neighborIdsOf(id){const ids=new Set;for(const link of this.linksByNodeId.get(id)??[])link.source===id?ids.add(link.target):link.target===id&&ids.add(link.source);return ids}linkKey(link){return graphLinkIdentity(link)}get computedDimmedNodeIds(){if(this.highlight==="none")return[];const matches=this.matchingNodes();if(matches){const matchIds=new Set(matches.map(n=>n.id));return this.graphModel.nodes.filter(n=>!matchIds.has(n.id)).map(n=>n.id)}const focusNodeId=this.selectedNodeId??(this.highlight==="hover"?this.hoveredNodeId:null);if(focusNodeId){const keep=this.neighborIdsOf(focusNodeId);return keep.add(focusNodeId),this.graphModel.nodes.filter(n=>!keep.has(n.id)).map(n=>n.id)}return[]}get computedDimmedLinkIds(){const dimmedNodes=new Set(this.computedDimmedNodeIds);return dimmedNodes.size===0?[]:this.graphModel.links.filter(l=>dimmedNodes.has(l.source)||dimmedNodes.has(l.target)).map(l=>this.linkKey(l))}togglePin(id){if(!isNonBlankIdentity(id))return;const pinnedNodeIds=this.canonicalPinnedNodeIds,wasPinned=pinnedNodeIds.includes(id),next=wasPinned?pinnedNodeIds.filter(existing=>existing!==id):[...pinnedNodeIds,id];this.pinnedNodeIds=next,this.pinLiveText=this.localize(wasPinned?"graphExplorerUnpinned":"graphExplorerPinned",void 0,{label:this.nodeLabel(id)}),this.announcements.announcePolite(this.pinLiveText),this.emit("lr-pin-change",{pinnedNodeIds:next})}requestPath(){const pinnedNodeIds=this.canonicalPinnedNodeIds;if(pinnedNodeIds.length!==2)return;const[sourceNodeId,targetNodeId]=pinnedNodeIds;this.emit("lr-path-request",{sourceNodeId,targetNodeId})}fit(options){this.graphEl?.fit(options)}resetView(){this.graphEl?.fit()}async focusNode(id,options){return this.isVisibleNode(id)?await this.graphEl?.focusNode(id,options)??!1:!1}async activateEntity(id){if(!this.canActivateNode(id))return;const generation=this.invalidateActivation();this.setInternalSelectedNodeId(id),this.trackedNodeEl=void 0;const graph=this.graphEl,focused=graph?await graph.focusNode(id):!1;if(generation!==this.activationGeneration||!this.isConnected||this.selectedNodeId!==id||!this.isVisibleNode(id)||!focused)return;const rect=graph?.getBoundingClientRect();if(!rect)return;const projected=graph?.view==="3d"?graph.getNodeScreenPosition(id):void 0;this.openDetailAt(id,{x:rect.left+(projected?.x??rect.width/2),y:rect.top+(projected?.y??rect.height/2),width:0,height:0})}openDetailAt(id,rect){const popover=this.popoverEl;popover&&(popover.accessibleLabel=this.entityFor(id)?.label||"",popover.showAt(rect))}resolveDirectClickAnchor(event){if(this.view==="3d"){this.trackedNodeEl=void 0;const graph=this.graphEl,position=this.selectedNodeId?graph?.getNodeScreenPosition(this.selectedNodeId):void 0,rect2=graph?.getBoundingClientRect();if(position&&rect2)return{x:rect2.left+position.x,y:rect2.top+position.y,width:0,height:0}}if(this.renderer==="canvas")return this.trackedNodeEl=void 0,{x:event.clientX,y:event.clientY,width:0,height:0};const nodeEl=event.composedPath().find(el=>isElementNode(el)&&el.matches('[part="node"]'));if(!nodeEl)return this.trackedNodeEl=void 0,{x:event.clientX,y:event.clientY,width:0,height:0};this.trackedNodeEl=nodeEl;const rect=nodeEl.getBoundingClientRect();return{x:rect.left+rect.width/2,y:rect.top,width:rect.width,height:rect.height}}render(){const groupLabel=retrievalSemanticLabel(this,this.label==null?this.localize("graphExplorerLabel"):this.label),groupRole=retrievalSemanticRole(this,"group"),matches=this.matchingNodes(),detailsLimit=publicCollectionTruncation(this,"entityDetails"),model=this.graphModel,pinnedNodeIds=this.canonicalPinnedNodeIds,hiddenTypes=this.canonicalHiddenTypes,selectedEntity=this.selectedNodeId?this.entityFor(this.selectedNodeId)??null:null,isPinned=this.selectedNodeId!=null&&pinnedNodeIds.includes(this.selectedNodeId),dimmedDeps=[this.highlight,matches,this.selectedNodeId,this.hoveredNodeId,model],detailDeps=[this.selectedNodeId,model,hiddenTypes,this.entityDetails];return html`
+import{__decorate}from"tslib";import{ref}from"lit/directives/ref.js";import{setGraphSourceComposition,resolveGraphSourceComposition,focusGraphSourceComposition}from"../graph/graph-source-composition.js";const EMPTY_SOURCE_NODES=Object.freeze([]),EMPTY_SOURCE_EDGES=Object.freeze([]);import{collectionSupport,publicCollectionTruncation}from"../../../internal/collection-snapshot.js";import{tag}from"../../../internal/prefix.js";import{html,nothing}from"lit";import{property,state,query}from"lit/decorators.js";import{guard}from"lit/directives/guard.js";import{LyraElement}from"../../../internal/lyra-element.js";import{finiteInteger,finiteRange}from"../../../internal/numbers.js";import{srOnly}from"../../../internal/a11y.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{styles}from"./knowledge-graph-explorer.styles.js";import{retrievalSemanticLabel,retrievalSemanticRole}from"../retrieval-semantic-owner.js";import{graphLengthConverter,graphLinkIdentity,normalizeGraphModel}from"../graph/graph-model.js";import{canonicalIdentityList,isNonBlankIdentity}from"../retrieval-identity.js";import"../graph/graph.class.js";import"../graph-legend/graph-legend.class.js";import"../entity-card/entity-card.class.js";import"../neighbor-list/neighbor-list.class.js";import"../../overlays/overlay/popover.class.js";import"../../forms/input/input.class.js";import"../../forms/button/button.class.js";import{AnnouncementSinkController}from"../../../internal/announcer.js";import{LYRA_DEFAULT_graphDataListLimit,LYRA_DEFAULT_graphEdgeLimit,LYRA_DEFAULT_graphExplorerAllTypesHidden,LYRA_DEFAULT_graphExplorerClearTypes,LYRA_DEFAULT_graphExplorerFindPath,LYRA_DEFAULT_graphExplorerLabel,LYRA_DEFAULT_graphExplorerPin,LYRA_DEFAULT_graphExplorerPinned,LYRA_DEFAULT_graphExplorerPinnedHeading,LYRA_DEFAULT_graphExplorerSearchLimit,LYRA_DEFAULT_graphExplorerSearchPlaceholder,LYRA_DEFAULT_graphExplorerSearchResultsLabel,LYRA_DEFAULT_graphExplorerUnpin,LYRA_DEFAULT_graphExplorerUnpinned,LYRA_DEFAULT_graphNodeLimit}from"../../../internal/default-strings/retrieval.generated.js";import{LYRA_DEFAULT_fieldRequired,LYRA_DEFAULT_loading,LYRA_DEFAULT_statusError,LYRA_DEFAULT_viewerSearchMatchCount,LYRA_DEFAULT_viewerSearchNoMatches}from"../../../internal/default-strings/shared.generated.js";const SEARCH_RESULT_LIMIT=50;function isElementNode(value){if(typeof value!="object"||value===null)return!1;const candidate=value;return candidate.nodeType===1&&typeof candidate.matches=="function"&&typeof candidate.getBoundingClientRect=="function"}class LyraKnowledgeGraphExplorer extends LyraElement{constructor(){super(...arguments),this.sourceEpoch=0,this.sourceSearchVersion=0,this.sourceAssigned=!1,this.sourceClosing=!1,this.sourceDetailsOpen=!1,this.sourcePaint=0,this._sourcePage=0,this._sourcePageSize=100,this.sourceAccepted=snapshot=>{if(!snapshot.current()||this.graphSource===void 0||this.sourceChild?.graphSource!==this.graphSource)return;this.sourcePage!==snapshot.page&&(this.sourcePage=snapshot.page),this.sourcePaint++;const intent=this.sourceSearchIntent;if(!this.sourceFilter.invalid&&intent&&intent.epoch===this.sourceEpoch&&intent.version===this.sourceSearchVersion&&intent.query===this.query&&snapshot.query.kind==="nodes"&&snapshot.query.centerKey===null&&snapshot.query.search===intent.query&&snapshot.total!==null&&snapshot.current()){this.sourceSearchIntent=void 0;const detail={query:intent.query,matchCount:intent.query.trim()?snapshot.total:0,matchCountExact:!0,activeIndex:-1};snapshot.current()&&this.emit("lr-search-change",detail)}snapshot.current()&&this.inspectSourceSelection()},this.bindSourceChild=element=>{const graph=element;if(!graph){this.sourceChild&&setGraphSourceComposition(this.sourceChild,void 0),this.sourceChild=void 0,this.sourceChildBinding=void 0;return}this.sourceChild=graph;const size=finiteInteger(this.sourcePageSize,100,1,500),page=finiteInteger(this.sourcePage,0,0,Math.floor(Number.MAX_SAFE_INTEGER/size));if(graph.sourcePageSize!==size&&(graph.sourcePageSize=size),graph.sourcePage!==page&&(graph.sourcePage=page),this.graphSource===void 0){setGraphSourceComposition(graph,void 0),graph.graphSource!==void 0&&(graph.graphSource=void 0),this.sourceChildBinding=void 0;return}const filter=this.sourceFilter;setGraphSourceComposition(graph,{search:(this.query??"").slice(0,65536),nodeTypes:filter.nodeTypes,empty:filter.empty,accepted:this.sourceAccepted});const binding=[graph,this.graphSource,this.sourceEpoch];(!this.sourceChildBinding||binding.some((value,index)=>value!==this.sourceChildBinding[index]))&&(this.sourceChildBinding=binding,graph.graphSource=this.graphSource),this.inspectSourceSelection()},this.nodes=[],this.edges=[],this.nodeTypes=[],this.communities=[],this.entityDetails={},this.pinnedNodeIds=[],this.path=[],this.hiddenTypes=[],this.selectedNodeId=null,this.renderer="svg",this.view="2d",this.fitTo="none",this.width=800,this.height=600,this.highlight="selection",this.query="",this.pinLiveText="",this.hoveredNodeId=null,this.activeResult=0,this.activationGeneration=0,this.nodeById=new Map,this.linksByNodeId=new Map,this.degreeByNodeId=new Map,this.communityLabelById=new Map,this.announcements=new AnnouncementSinkController(this,{eager:["polite"]}),this.optionalRequest=!1,this.optionalGeneration=0,this.pathReady=!1,this.optionalFailed=!1,this.onVisibilityChange=event=>{event.stopPropagation(),this.hiddenTypes=event.detail.hiddenTypes,this.emit("lr-hidden-types-change",{hiddenTypes:this.hiddenTypes})},this.onVisibilityChangeProposal=event=>{event.stopPropagation()},this.onSearchInput=event=>{event.stopPropagation();const value=event.detail.value;if(this.query!==value){if(this.query=value,this.graphSource!==void 0){this.sourceSearchIntent={query:value,version:this.sourceSearchVersion,epoch:this.sourceEpoch};return}this.emit("lr-search-change",{query:value,matchCount:this.matchingNodes()?.length??0,matchCountExact:!0,activeIndex:-1})}},this.onEntityActivate=event=>{event.stopPropagation(),this.activateEntity(event.detail.entityId)},this.onGraphNodeClick=event=>{const id=event.detail.nodeId;if(this.graphSource!==void 0){this.activateSourceEntity(id);return}if(!this.canActivateNode(id))return;const generation=this.invalidateActivation();if(this.setInternalSelectedNodeId(id),this.view==="3d"){const graph=this.graphEl,point=graph?.getNodeScreenPosition(id),bounds=graph?.getBoundingClientRect();if(point&&bounds){this.trackedNodeEl=void 0,this.openDetailAt(id,{x:bounds.left+point.x,y:bounds.top+point.y,width:0,height:0});return}}this.pendingNodeId=id;const ownerDocument=this.ownerDocument,ownerWindow=ownerDocument.defaultView;ownerWindow&&ownerWindow.queueMicrotask(()=>{generation===this.activationGeneration&&this.isConnected&&this.ownerDocument===ownerDocument&&this.pendingNodeId===id&&(this.pendingNodeId=void 0,this.selectedNodeId===id&&this.isVisibleNode(id)&&this.activateEntity(id))})},this.onGraphNativeClick=event=>{const id=this.pendingNodeId;id&&(this.pendingNodeId=void 0,this.openDetailAt(id,this.resolveDirectClickAnchor(event)))},this.onGraphViewportChange=()=>{const graph=this.graphEl;if(graph?.view==="3d"&&this.selectedNodeId&&this.popoverEl?.open){const point=graph.getNodeScreenPosition(this.selectedNodeId);if(point){const rect2=graph.getBoundingClientRect();this.popoverEl.showAt({x:rect2.left+point.x,y:rect2.top+point.y,width:0,height:0})}return}const el=this.trackedNodeEl,popover=this.popoverEl;if(!el?.isConnected||!popover?.open)return;const rect=el.getBoundingClientRect();popover.showAt({x:rect.left+rect.width/2,y:rect.top,width:rect.width,height:rect.height})},this.onGraphNodeEnter=event=>{this.highlight==="hover"&&(this.hoveredNodeId=event.detail.nodeId)},this.onGraphNodeLeave=event=>{this.highlight==="hover"&&this.hoveredNodeId===event.detail.nodeId&&(this.hoveredNodeId=null)},this.onResultKeyDown=event=>{const buttons=[...this.renderRoot.querySelectorAll('[part="search-result"] button')],index=buttons.indexOf(event.target),next={ArrowDown:index+1,ArrowUp:index-1,Home:0,End:buttons.length-1}[event.key];index<0||next===void 0||(event.preventDefault(),this.activeResult=Math.max(0,Math.min(buttons.length-1,next)),buttons[this.activeResult].focus())},this.onPopoverHide=()=>{if(this.graphSource!==void 0?this.closeSourceDetails(!1):this.sourceDetailsOpen=!1,this.sourceClosing){this.sourceClosing=!1;return}this.invalidateActivation(),this.trackedNodeEl=void 0,this.setInternalSelectedNodeId(null)}}static{this.defaultStrings={...super.defaultStrings,fieldRequired:LYRA_DEFAULT_fieldRequired,graphDataListLimit:LYRA_DEFAULT_graphDataListLimit,graphEdgeLimit:LYRA_DEFAULT_graphEdgeLimit,graphExplorerAllTypesHidden:LYRA_DEFAULT_graphExplorerAllTypesHidden,graphExplorerClearTypes:LYRA_DEFAULT_graphExplorerClearTypes,graphExplorerFindPath:LYRA_DEFAULT_graphExplorerFindPath,graphExplorerLabel:LYRA_DEFAULT_graphExplorerLabel,graphExplorerPin:LYRA_DEFAULT_graphExplorerPin,graphExplorerPinned:LYRA_DEFAULT_graphExplorerPinned,graphExplorerPinnedHeading:LYRA_DEFAULT_graphExplorerPinnedHeading,graphExplorerSearchLimit:LYRA_DEFAULT_graphExplorerSearchLimit,graphExplorerSearchPlaceholder:LYRA_DEFAULT_graphExplorerSearchPlaceholder,graphExplorerSearchResultsLabel:LYRA_DEFAULT_graphExplorerSearchResultsLabel,graphExplorerUnpin:LYRA_DEFAULT_graphExplorerUnpin,graphExplorerUnpinned:LYRA_DEFAULT_graphExplorerUnpinned,graphNodeLimit:LYRA_DEFAULT_graphNodeLimit,loading:LYRA_DEFAULT_loading,statusError:LYRA_DEFAULT_statusError,viewerSearchMatchCount:LYRA_DEFAULT_viewerSearchMatchCount,viewerSearchNoMatches:LYRA_DEFAULT_viewerSearchNoMatches}}static{this.collectionSupport=collectionSupport}static{this.ownedCollectionProperties=Object.freeze(["nodes","edges","nodeTypes","communities","entityDetails","pinnedNodeIds","path","hiddenTypes"])}static{this.styles=[LyraElement.styles,styles,srOnly]}static{this.immutableEventDetails=Object.freeze(["lr-selection-change","lr-pin-change","lr-hidden-types-change"])}get graphSource(){return this._graphSource}set graphSource(value){const previous=this._graphSource;this._graphSource=value,this.requestUpdate("graphSource",previous)}get sourcePage(){return this._sourcePage}set sourcePage(value){const old=this._sourcePage;this._sourcePage=value;const size=finiteInteger(this.sourcePageSize,100,1,500),page=finiteInteger(value,0,0,Math.floor(Number.MAX_SAFE_INTEGER/size));this.sourceChild&&this.sourceChild.sourcePage!==page&&(this.sourceChild.sourcePage=page),this.requestUpdate("sourcePage",old)}get sourcePageSize(){return this._sourcePageSize}set sourcePageSize(value){const old=this._sourcePageSize;this._sourcePageSize=value,Object.is(old,value)||(this.sourcePage=0);const size=finiteInteger(value,100,1,500);this.sourceChild&&this.sourceChild.sourcePageSize!==size&&(this.sourceChild.sourcePageSize=size),this.requestUpdate("sourcePageSize",old)}get sourceTotal(){return this.graphSource===void 0||this.sourceFilter.invalid?null:this.sourceFilter.empty?0:this.sourceChild?.graphSource===this.graphSource?this.sourceChild.sourceTotal:null}get sourceFilter(){const hidden=this.canonicalHiddenTypes;if(!hidden.length)return{nodeTypes:[],empty:!1,invalid:!1};const catalog=canonicalIdentityList(this.nodeTypes.map(type=>type.id));let units=0;if(catalog.length>500||catalog.some(type=>type.length>65536||(units+=type.length)>2e6))return{nodeTypes:[],empty:!0,invalid:!0};const types=catalog.filter(type=>!hidden.includes(type));return{nodeTypes:types,empty:types.length===0,invalid:!1}}sourceCurrent(){const source=this.graphSource,epoch=this.sourceEpoch,generation=this.activationGeneration,owner=this.ownerDocument;let revision;try{revision=source?.revision}catch{return()=>!1}return()=>{try{return source?.revision===revision&&this.graphSource===source&&this.sourceEpoch===epoch&&this.activationGeneration===generation&&this.isConnected&&this.ownerDocument===owner}catch{return!1}}}inspectSourceSelection(){const graph=this.sourceChild,id=this.selectedNodeId;if(!graph||this.graphSource===void 0||this.sourceFilter.empty||!id)return;const signature=[graph,this.graphSource,this.sourceEpoch,id];if(this.sourceInspect&&signature.every((value,index)=>value===this.sourceInspect[index]))return;this.sourceInspect=signature;const current=this.sourceCurrent();resolveGraphSourceComposition(graph,[`node:${id}`]).then(result=>{if(!result||!result.current()||!current()||this.selectedNodeId!==id){this.sourceInspect===signature&&(this.sourceInspect=void 0);return}const record=result.records.find(row=>row.key===`node:${id}`);if(!record||record.value.kind!=="node"){this.selectedNodeId=null;return}this.sourceEntity=record.value.value})}async revealSourceKey(key){if(this.graphSource===void 0)return!1;this.query="",this.hiddenTypes=[];const current=this.sourceCurrent();if(await this.updateComplete,!current())return!1;const revealed=await this.sourceChild?.revealSourceKey(key);return current()&&revealed===!0}closeSourceDetails(closePopover=!0){this.sourceDetailsOpen=!1;const neighbors=this.renderRoot?.querySelector('[part="detail-neighbors"]');neighbors?.graphSource!==void 0&&(neighbors.graphSource=void 0),closePopover&&this.popoverEl?.open&&(this.sourceClosing=!0,this.popoverEl.open=!1)}requestUpdate(...args){const name=args[0];this.sourceEpoch!==void 0&&(name==="graphSource"||name===void 0)&&(this.sourceEpoch++,this.sourceInspect=void 0,this.sourceEntity=void 0,this.closeSourceDetails(),this.sourceSearchIntent=void 0,this.internalSelectionAssignment=void 0,this.invalidateActivation(),this.sourceChild?.graphSource!==void 0&&(this.sourceChild.graphSource=void 0)),name==="query"&&(this.sourceSearchVersion=(this.sourceSearchVersion??0)+1,this.sourceSearchIntent=void 0),this.graphSource!==void 0&&(name==="hiddenTypes"||name==="nodeTypes"||name==="selectedNodeId"&&!this.sourceAssigned)&&(this.invalidateActivation(),this.sourceInspect=void 0,this.closeSourceDetails(),name==="selectedNodeId"&&(this.sourceEntity=void 0,this.internalSelectionAssignment=void 0)),this.graphSource!==void 0&&this.sourceChild&&["query","hiddenTypes","nodeTypes"].includes(String(name))&&this.bindSourceChild(this.sourceChild),super.requestUpdate(...args)}async activateSourceEntity(id){if(!isNonBlankIdentity(id)||id.length+5>65536||this.sourceFilter.empty)return;const graph=this.sourceChild;if(!graph)return;const mounted=graph.view==="list"&&[...graph.renderRoot.querySelectorAll("[data-source-key]")].some(row=>row.dataset.sourceKey===`node:${id}`);graph.view==="list"&&!mounted&&(this.query="",this.hiddenTypes=[]),this.invalidateActivation();const current=this.sourceCurrent();if(await this.updateComplete,!current()||this.sourceChild!==graph)return;const result=await resolveGraphSourceComposition(graph,[`node:${id}`]);if(!current()||!result?.current())return;const record=result.records.find(row=>row.key===`node:${id}`);if(!record||record.value.kind!=="node"||(this.sourceEntity=record.value.value,this.sourceInspect=[graph,this.graphSource,this.sourceEpoch,id],this.setInternalSelectedNodeId(id),!current()||this.selectedNodeId!==id))return;const focused=await focusGraphSourceComposition(graph,`node:${id}`);if(await graph.updateComplete,!current()||!focused?.()||this.selectedNodeId!==id)return;const target=graph.view==="list"?[...graph.renderRoot.querySelectorAll("[data-source-key]")].find(row=>row.dataset.sourceKey===`node:${id}`):void 0,position=graph.view!=="list"?graph.getNodeScreenPosition(id):void 0,bounds=target?.getBoundingClientRect()??graph.getBoundingClientRect();!current()||!focused()||(graph.view==="list"?!target:!position)||(this.openDetailAt(id,{x:bounds.left+(position?.x??bounds.width/2),y:bounds.top+(position?.y??bounds.height/2),width:0,height:0}),current()&&focused()&&this.popoverEl?.open&&(this.sourceDetailsOpen=!0))}get graphModel(){const nodes=this.graphSource===void 0?this.nodes:EMPTY_SOURCE_NODES,edges=this.graphSource===void 0?this.edges:EMPTY_SOURCE_EDGES,sources=this.normalizedGraphSources;return(!sources||sources[0]!==nodes||sources[1]!==edges||sources[2]!==this.nodeTypes||sources[3]!==this.communities)&&(this.normalizedGraphSources=[nodes,edges,this.nodeTypes,this.communities],this.normalizedGraphModel=normalizeGraphModel(nodes,edges,this.nodeTypes,this.communities)),this.normalizedGraphModel}get canonicalPinnedNodeIds(){return canonicalIdentityList(this.pinnedNodeIds)}get canonicalHiddenTypes(){return canonicalIdentityList(this.hiddenTypes)}async loadOptionalPath(){await import("../path-strip/path-strip.js")}ensureOptionalChildren(){const path=this.path.length>0,request=path;if(request===this.optionalRequest)return;this.optionalRequest=request;const generation=++this.optionalGeneration;if(this.optionalPending=void 0,this.optionalFailed=!1,!path||this.pathReady)return;this.hasUpdated&&this.announcements.announcePolite(this.localize("loading"));const pending=this.loadOptionalPath().then(()=>{!this.isConnected||generation!==this.optionalGeneration||(this.pathReady||=path)},()=>{!this.isConnected||generation!==this.optionalGeneration||(this.optionalFailed=!0,this.announcements.announcePolite(this.localize("statusError")))}).then(()=>{!this.isConnected||generation!==this.optionalGeneration||(this.optionalPending=void 0,this.requestUpdate())});this.optionalPending=pending}async getUpdateComplete(){const complete=await super.getUpdateComplete(),pending=this.optionalPending;return pending?(await pending,this.getUpdateComplete()):complete}connectedCallback(){super.connectedCallback(),this.hasUpdated&&(this.resumePresetActivation(),this.requestUpdate())}willUpdate(changed){if(super.willUpdate(changed),this.hasUpdated&&(changed.has("nodes")||changed.has("edges"))){const messages=this.inputLimitMessages(["nodes","edges"].filter(property2=>changed.has(property2)));messages.length&&this.announcements.announcePolite(messages.join(" "))}this.ensureOptionalChildren(),this.graphSource===void 0&&((changed.has("nodes")||changed.has("edges")||changed.has("communities")||changed.has("graphSource"))&&this.rebuildDerivedCollections(),this.hoveredNodeId&&!this.isVisibleNode(this.hoveredNodeId)&&(this.hoveredNodeId=null),(changed.has("nodes")||changed.has("hiddenTypes")||changed.has("graphSource"))&&this.selectedNodeId&&!this.isVisibleNode(this.selectedNodeId)&&(this.invalidateActivation(),this.setInternalSelectedNodeId(null),this.popoverEl&&(this.popoverEl.open=!1)),this.hasUpdated&&(this.query??"").trim()&&(changed.has("query")||changed.has("nodes")||changed.has("hiddenTypes")||changed.has("locale")||changed.has("strings"))&&this.announcements.announcePolite(this.searchResultAnnouncement()))}updated(changed){if(super.updated(changed),this.graphSource!==void 0){this.bindSourceChild(this.graphEl);return}if(changed.has("camera")&&this.view==="3d"&&this.graphEl&&this.reanchorAfterCameraUpdate(this.graphEl,this.camera),!changed.has("selectedNodeId"))return;const internallyAssigned=this.internalSelectionAssignment!==void 0&&Object.is(this.internalSelectionAssignment.value,this.selectedNodeId);if(this.internalSelectionAssignment=void 0,internallyAssigned)return;const generation=this.invalidateActivation(),id=this.selectedNodeId;if(!isNonBlankIdentity(id)){id!==null&&(this.selectedNodeId=null),this.popoverEl&&(this.popoverEl.open=!1);return}const graph=this.graphEl;graph&&this.isVisibleNode(id)&&this.activatePresetWhenGraphReady(id,graph,generation)}async reanchorAfterCameraUpdate(graph,camera){await graph.updateComplete,this.isConnected&&this.graphEl===graph&&this.camera===camera&&this.view==="3d"&&this.onGraphViewportChange()}async activatePresetWhenGraphReady(id,graph,generation){for(await graph.updateComplete;generation===this.activationGeneration&&this.isConnected&&graph.isConnected&&this.selectedNodeId===id&&graph.shadowRoot?.querySelector(tag("skeleton"));)if(!await this.waitForActivationFrame(generation))return;generation===this.activationGeneration&&this.isConnected&&this.selectedNodeId===id&&this.isVisibleNode(id)&&await this.activateEntity(id)}waitForActivationFrame(generation){this.cancelActivationFrame();const ownerDocument=this.ownerDocument,ownerWindow=ownerDocument.defaultView;return!ownerWindow||!this.isConnected||generation!==this.activationGeneration?Promise.resolve(!1):new Promise(resolve=>{let settled=!1;const settle=ready=>{settled||(settled=!0,resolve(ready))};let handle;const onPageHide=()=>{this.activationFrameOwner===ownerWindow&&this.activationFrameDocument===ownerDocument&&this.activationFrameResolve===settle&&this.cancelActivationFrame()};try{handle=ownerWindow.requestAnimationFrame(()=>{const current=this.activationFrameId===handle&&this.activationFrameOwner===ownerWindow&&this.activationFrameDocument===ownerDocument&&this.activationFrameResolve===settle&&generation===this.activationGeneration&&this.isConnected&&this.ownerDocument===ownerDocument;current&&this.clearActivationFrameRecord(),settle(current)})}catch{settle(!1);return}this.activationFrameId=handle,this.activationFrameOwner=ownerWindow,this.activationFrameDocument=ownerDocument,this.activationFrameResolve=settle,this.activationFramePageHide=onPageHide,ownerWindow.addEventListener("pagehide",onPageHide,{once:!0})})}clearActivationFrameRecord(){this.activationFramePageHide&&this.activationFrameOwner?.removeEventListener("pagehide",this.activationFramePageHide),this.activationFrameId=void 0,this.activationFrameOwner=void 0,this.activationFrameDocument=void 0,this.activationFrameResolve=void 0,this.activationFramePageHide=void 0}cancelActivationFrame(){const handle=this.activationFrameId,ownerWindow=this.activationFrameOwner,settle=this.activationFrameResolve;this.clearActivationFrameRecord();try{handle!==void 0&&ownerWindow?.cancelAnimationFrame(handle)}finally{settle?.(!1)}}invalidateActivation(){return this.activationGeneration+=1,this.cancelActivationFrame(),this.activationGeneration}resumePresetActivation(){if(this.graphSource!==void 0){this.sourceInspect=void 0;return}const id=this.selectedNodeId,graph=this.graphEl;if(!id||!graph||!this.isVisibleNode(id))return;const generation=this.invalidateActivation();this.activatePresetWhenGraphReady(id,graph,generation)}setInternalSelectedNodeId(value){Object.is(this.selectedNodeId,value)||(this.internalSelectionAssignment={value},this.sourceAssigned=!0,this.selectedNodeId=value,this.sourceAssigned=!1,this.emit("lr-selection-change",{selectedNodeId:value,selectedNodeIds:value?[value]:[],selectedEdgeIds:[]}))}disconnectedCallback(){this.sourceEpoch++,this.sourceInspect=void 0,this.sourceDetailsOpen=!1,this.sourceSearchIntent=void 0,this.internalSelectionAssignment=void 0,this.sourceChild&&setGraphSourceComposition(this.sourceChild,void 0),this.sourceChildBinding=void 0,++this.optionalGeneration,this.optionalRequest=!1,this.optionalPending=void 0,this.invalidateActivation(),this.pendingNodeId=void 0,this.trackedNodeEl=void 0,this.hoveredNodeId=null,super.disconnectedCallback()}adoptedCallback(){super.adoptedCallback(),++this.optionalGeneration,this.optionalRequest=!1,this.optionalPending=void 0,this.invalidateActivation(),this.announcements.adopted(),this.sourceEpoch++,this.sourceInspect=void 0,this.sourceDetailsOpen=!1,this.sourceChildBinding=void 0,this.isConnected&&this.resumePresetActivation()}rebuildDerivedCollections(){const model=this.graphModel;this.nodeById=new Map(model.nodes.map(node=>[node.id,node])),this.communityLabelById=new Map(model.communities.map(community=>[community.id,community.label]));const linksByNodeId=new Map,degrees=new Map;for(const link of model.links)for(const id of new Set([link.source,link.target])){const adjacent=linksByNodeId.get(id);adjacent?adjacent.push(link):linksByNodeId.set(id,[link]),degrees.set(id,(degrees.get(id)??0)+1)}this.linksByNodeId=linksByNodeId,this.degreeByNodeId=degrees}isVisibleGraphNode(node){return node.type==null||!this.canonicalHiddenTypes.includes(node.type)}isVisibleNode(id){const node=this.nodeById.get(id);return!!node&&this.isVisibleGraphNode(node)}canActivateNode(id){const node=this.nodeById.get(id);return node?this.isVisibleGraphNode(node):!this.hasUpdated&&this.graphModel.nodes.length===0}nodeLabel(id){const node=this.graphSource!==void 0?this.sourceEntity?.id===id?this.sourceEntity:void 0:this.nodeById.get(id);return node?.label||node?.accessibleLabel||id}degreeOf(id){return this.degreeByNodeId.get(id)??0}entityFor(id){const node=this.graphSource!==void 0?this.sourceEntity?.id===id?this.sourceEntity:void 0:this.nodeById.get(id);if(!node)return;const details=this.entityDetails[id];return{id:node.id,label:node.label||node.accessibleLabel||node.id,type:node.type,communityId:node.communityId,description:details?.description,properties:details?.properties,degree:details?.degree??(this.graphSource===void 0?this.degreeOf(node.id):void 0)}}communityLabelFor(communityId){return communityId?this.communityLabelById.get(communityId)??communityId:""}neighborRowsFor(id){const rows=[];for(const link of this.linksByNodeId.get(id)??[])if(link.source===id){const node=this.entityFor(link.target);node&&this.isVisibleNode(link.target)&&rows.push({relation:link.label??"",direction:"out",node})}else if(link.target===id){const node=this.entityFor(link.source);node&&this.isVisibleNode(link.source)&&rows.push({relation:link.label??"",direction:"in",node})}return rows}searchableNamesOf(node){return[node.label,node.accessibleLabel,node.id].filter(name=>typeof name=="string"&&name!=="")}matchingNodes(){if(this.graphSource!==void 0)return;const query2=this.query??"",locale=this.effectiveLocale,model=this.graphModel,hidden=this.canonicalHiddenTypes,memo=this.matchesMemo;if(memo?.[0]===query2&&memo[1]===locale&&memo[2]===model&&memo[3]===hidden)return memo[4];const q=query2.trim().toLocaleLowerCase(locale);let matches;if(q){const hiddenTypes=new Set(hidden);matches=model.nodes.filter(node=>(node.type==null||!hiddenTypes.has(node.type))&&this.searchableNamesOf(node).some(name=>name.toLocaleLowerCase(locale).includes(q)))}return this.matchesMemo=[query2,locale,model,hidden,matches],matches}searchResultAnnouncement(matches=this.matchingNodes()){return matches?matches.length===0?this.localize("viewerSearchNoMatches"):this.localize("viewerSearchMatchCount",void 0,{count:getNumberFormat(this.effectiveLocale).format(matches.length),pluralCount:matches.length}):""}neighborIdsOf(id){const ids=new Set;for(const link of this.linksByNodeId.get(id)??[])link.source===id?ids.add(link.target):link.target===id&&ids.add(link.source);return ids}linkKey(link){return graphLinkIdentity(link)}dimmingProjection(){if(this.graphSource!==void 0)return{nodes:[],links:[]};const model=this.graphModel,matches=this.matchingNodes(),focus=matches?null:this.selectedNodeId??(this.highlight==="hover"?this.hoveredNodeId:null),key=[model,this.highlight,matches,focus];if(this.dimmingMemo&&key.every((value,index)=>value===this.dimmingMemo.key[index]))return this.dimmingMemo;let nodes=[];if(this.highlight!=="none"){const keep=matches?new Set(matches.map(node=>node.id)):focus?this.neighborIdsOf(focus):void 0;focus&&keep.add(focus),keep&&(nodes=model.nodes.filter(node=>!keep.has(node.id)).map(node=>node.id))}const dimmed=new Set(nodes),links=dimmed.size?model.links.filter(link=>dimmed.has(link.source)||dimmed.has(link.target)).map(link=>this.linkKey(link)):[];return this.dimmingMemo={key,nodes,links},this.dimmingMemo}get computedDimmedNodeIds(){return this.dimmingProjection().nodes}get computedDimmedLinkIds(){return this.dimmingProjection().links}togglePin(id){if(!isNonBlankIdentity(id))return;const pinnedNodeIds=this.canonicalPinnedNodeIds,wasPinned=pinnedNodeIds.includes(id),next=wasPinned?pinnedNodeIds.filter(existing=>existing!==id):[...pinnedNodeIds,id];this.pinnedNodeIds=next,this.pinLiveText=this.localize(wasPinned?"graphExplorerUnpinned":"graphExplorerPinned",void 0,{label:this.nodeLabel(id)}),this.announcements.announcePolite(this.pinLiveText),this.emit("lr-pin-change",{pinnedNodeIds:next})}requestPath(){const pinnedNodeIds=this.canonicalPinnedNodeIds;if(pinnedNodeIds.length!==2)return;const[sourceNodeId,targetNodeId]=pinnedNodeIds;this.emit("lr-path-request",{sourceNodeId,targetNodeId})}fit(options){this.graphEl?.fit(options)}resetView(){this.graphEl?.fit()}async focusNode(id,options){return this.graphSource===void 0&&!this.isVisibleNode(id)?!1:await this.graphEl?.focusNode(id,options)??!1}async activateEntity(id){if(this.graphSource!==void 0)return this.activateSourceEntity(id);if(!this.canActivateNode(id))return;const generation=this.invalidateActivation();this.setInternalSelectedNodeId(id),this.trackedNodeEl=void 0;const graph=this.graphEl,focused=graph?await graph.focusNode(id):!1;if(generation!==this.activationGeneration||!this.isConnected||this.selectedNodeId!==id||!this.isVisibleNode(id)||!focused)return;const rect=graph?.getBoundingClientRect();if(!rect)return;const projected=graph?.view==="3d"?graph.getNodeScreenPosition(id):void 0;this.openDetailAt(id,{x:rect.left+(projected?.x??rect.width/2),y:rect.top+(projected?.y??rect.height/2),width:0,height:0})}openDetailAt(id,rect){const popover=this.popoverEl;popover&&(popover.accessibleLabel=this.entityFor(id)?.label||"",popover.showAt(rect))}resolveDirectClickAnchor(event){if(this.view==="3d"){this.trackedNodeEl=void 0;const graph=this.graphEl,position=this.selectedNodeId?graph?.getNodeScreenPosition(this.selectedNodeId):void 0,rect2=graph?.getBoundingClientRect();if(position&&rect2)return{x:rect2.left+position.x,y:rect2.top+position.y,width:0,height:0}}if(this.renderer==="canvas")return this.trackedNodeEl=void 0,{x:event.clientX,y:event.clientY,width:0,height:0};const nodeEl=event.composedPath().find(el=>isElementNode(el)&&el.matches('[part="node"]'));if(!nodeEl)return this.trackedNodeEl=void 0,{x:event.clientX,y:event.clientY,width:0,height:0};this.trackedNodeEl=nodeEl;const rect=nodeEl.getBoundingClientRect();return{x:rect.left+rect.width/2,y:rect.top,width:rect.width,height:rect.height}}inputLimitMessages(properties=["nodes","edges"]){const messages=[],format=getNumberFormat(this.effectiveLocale);for(const property2 of properties){const loss=publicCollectionTruncation(this,property2);loss&&messages.push(this.localize(property2==="nodes"?"graphNodeLimit":"graphEdgeLimit",void 0,{shown:format.format(loss.retained),total:format.format(loss.source)}))}return messages}render(){const groupLabel=retrievalSemanticLabel(this,this.label==null?this.localize("graphExplorerLabel"):this.label),groupRole=retrievalSemanticRole(this,"group"),matches=this.matchingNodes(),detailsLimit=publicCollectionTruncation(this,"entityDetails"),model=this.graphModel,pinnedNodeIds=this.canonicalPinnedNodeIds,hiddenTypes=this.canonicalHiddenTypes,selectedEntity=this.graphSource!==void 0?this.sourceEntity:this.selectedNodeId?this.nodeById.get(this.selectedNodeId):void 0,isPinned=this.selectedNodeId!=null&&pinnedNodeIds.includes(this.selectedNodeId),dimmedDeps=[this.highlight,matches,this.selectedNodeId,this.hoveredNodeId,model],detailDeps=[this.selectedNodeId,model,hiddenTypes,this.entityDetails,this.sourceEntity],sourceFilter=this.sourceFilter,sourceCurrent=this.sourceCurrent(),renderedSource=this.graphSource,renderedEpoch=this.sourceEpoch,renderedOwner=this.ownerDocument,actionCurrent=renderedSource!==void 0?sourceCurrent:()=>this.graphSource===void 0&&this.sourceEpoch===renderedEpoch&&this.isConnected&&this.ownerDocument===renderedOwner;return html`
       <div
         part="base"
         role=${groupRole??nothing}
@@ -21,6 +21,8 @@ import{__decorate}from"tslib";import{collectionSupport,publicCollectionTruncatio
             @lr-visibility-change=${this.onVisibilityChange}
           ></lr-graph-legend>
         </div>
+        ${this.graphSource!==void 0&&sourceFilter.empty?html`<p part="source-status">${this.localize(sourceFilter.invalid?"statusError":"graphExplorerAllTypesHidden")}</p><button type="button" part="source-clear" data-source-clear-types @click=${()=>{sourceCurrent()&&(this.hiddenTypes=[],this.emit("lr-hidden-types-change",{hiddenTypes:this.hiddenTypes}))}}>${this.localize("graphExplorerClearTypes")}</button>`:nothing}
+        ${this.inputLimitMessages().map(message=>html`<p part="input-limit" role="note">${message}</p>`)}
         ${detailsLimit?html`<p part="details-limit" role="note">${this.localize("graphDataListLimit",void 0,{shown:getNumberFormat(this.effectiveLocale).format(detailsLimit.retained),total:getNumberFormat(this.effectiveLocale).format(detailsLimit.source)})}</p>`:nothing}
         ${matches?html`
               <div
@@ -55,20 +57,20 @@ import{__decorate}from"tslib";import{collectionSupport,publicCollectionTruncatio
                 >
                 ${pinnedNodeIds.map(id=>html`<lr-chip
                     removable
-                    @lr-remove=${event=>{event.stopPropagation(),this.togglePin(id)}}
+                    @lr-remove=${event=>{event.stopPropagation(),actionCurrent()&&this.togglePin(id)}}
                     >${this.nodeLabel(id)}</lr-chip
                   >`)}
-                ${pinnedNodeIds.length===2?html`<lr-button size="s" @click=${()=>this.requestPath()}
+                ${pinnedNodeIds.length===2?html`<lr-button size="s" @click=${()=>{actionCurrent()&&this.requestPath()}}
                       >${this.localize("graphExplorerFindPath")}</lr-button
                     >`:nothing}
               </div>
             `:nothing}
         <div class="sr-only" aria-hidden="true">${this.pinLiveText}</div>
-        ${this.path.length?html`<lr-path-strip
+        ${this.path.length?this.pathReady?html`<lr-path-strip
               part="path"
               .path=${this.path}
               @lr-entity-activate=${event=>event.stopPropagation()}
-            ></lr-path-strip>`:nothing}
+            ></lr-path-strip>`:html`<p part="path">${this.localize(this.optionalFailed?"statusError":"loading")}</p>`:nothing}
         <lr-graph
           part="graph"
           .nodes=${model.nodes}
@@ -93,6 +95,7 @@ import{__decorate}from"tslib";import{collectionSupport,publicCollectionTruncatio
           @lr-viewport-change=${this.onGraphViewportChange}
           @lr-camera-change=${this.onGraphViewportChange}
           @lr-view-change=${event=>{this.view=event.detail.view}}
+          ${ref(this.bindSourceChild)}
         ></lr-graph>
         <lr-popover
           part="detail-popover"
@@ -100,15 +103,19 @@ import{__decorate}from"tslib";import{collectionSupport,publicCollectionTruncatio
           @lr-hide=${this.onPopoverHide}
         >
           <slot name="details">
-            ${selectedEntity?html`
+            ${selectedEntity&&(this.graphSource===void 0||this.sourceDetailsOpen)?html`
                   <lr-entity-card
                     part="detail-card"
-                    .entity=${guard(detailDeps,()=>selectedEntity)}
+                    .entity=${guard(detailDeps,()=>this.selectedNodeId?this.entityFor(this.selectedNodeId)??null:null)}
                     .types=${model.nodeTypes}
                     community-label=${this.communityLabelFor(selectedEntity.communityId)}
                   >
                     <lr-neighbor-list
-                      .rows=${guard(detailDeps,()=>this.neighborRowsFor(this.selectedNodeId))}
+                      part="detail-neighbors"
+                      .graphSource=${this.graphSource}
+                      .centerKey=${this.graphSource!==void 0&&this.selectedNodeId?`node:${this.selectedNodeId}`:null}
+                      .sourceNodeTypes=${sourceFilter.nodeTypes}
+                      .rows=${guard(detailDeps,()=>this.graphSource===void 0?this.neighborRowsFor(this.selectedNodeId):[])}
                       .types=${model.nodeTypes}
                       expandable
                     ></lr-neighbor-list>
@@ -116,7 +123,7 @@ import{__decorate}from"tslib";import{collectionSupport,publicCollectionTruncatio
                     <lr-button
                       slot="actions"
                       size="s"
-                      @click=${()=>this.selectedNodeId&&this.togglePin(this.selectedNodeId)}
+                      @click=${()=>actionCurrent()&&this.selectedNodeId&&this.togglePin(this.selectedNodeId)}
                     >
                       ${this.localize(isPinned?"graphExplorerUnpin":"graphExplorerPin")}
                     </lr-button>
@@ -126,4 +133,4 @@ import{__decorate}from"tslib";import{collectionSupport,publicCollectionTruncatio
           </slot>
         </lr-popover>
       </div>
-    `}}__decorate([property({attribute:!1})],LyraKnowledgeGraphExplorer.prototype,"nodes",void 0),__decorate([property({attribute:!1})],LyraKnowledgeGraphExplorer.prototype,"edges",void 0),__decorate([property({attribute:!1})],LyraKnowledgeGraphExplorer.prototype,"nodeTypes",void 0),__decorate([property({attribute:!1})],LyraKnowledgeGraphExplorer.prototype,"communities",void 0),__decorate([property({attribute:!1})],LyraKnowledgeGraphExplorer.prototype,"entityDetails",void 0),__decorate([property({attribute:!1})],LyraKnowledgeGraphExplorer.prototype,"pinnedNodeIds",void 0),__decorate([property({attribute:!1})],LyraKnowledgeGraphExplorer.prototype,"path",void 0),__decorate([property({attribute:!1})],LyraKnowledgeGraphExplorer.prototype,"hiddenTypes",void 0),__decorate([property({attribute:"selected-node-id"})],LyraKnowledgeGraphExplorer.prototype,"selectedNodeId",void 0),__decorate([property()],LyraKnowledgeGraphExplorer.prototype,"renderer",void 0),__decorate([property()],LyraKnowledgeGraphExplorer.prototype,"view",void 0),__decorate([property({attribute:!1})],LyraKnowledgeGraphExplorer.prototype,"camera",void 0),__decorate([property({attribute:"node-labels"})],LyraKnowledgeGraphExplorer.prototype,"nodeLabels",void 0),__decorate([property({attribute:"fit-to"})],LyraKnowledgeGraphExplorer.prototype,"fitTo",void 0),__decorate([property({converter:graphLengthConverter})],LyraKnowledgeGraphExplorer.prototype,"width",void 0),__decorate([property({converter:graphLengthConverter})],LyraKnowledgeGraphExplorer.prototype,"height",void 0),__decorate([property()],LyraKnowledgeGraphExplorer.prototype,"label",void 0),__decorate([property()],LyraKnowledgeGraphExplorer.prototype,"highlight",void 0),__decorate([property()],LyraKnowledgeGraphExplorer.prototype,"query",void 0),__decorate([state()],LyraKnowledgeGraphExplorer.prototype,"pinLiveText",void 0),__decorate([state()],LyraKnowledgeGraphExplorer.prototype,"hoveredNodeId",void 0),__decorate([state()],LyraKnowledgeGraphExplorer.prototype,"activeResult",void 0),__decorate([query('[part="graph"]')],LyraKnowledgeGraphExplorer.prototype,"graphEl",void 0),__decorate([query('[part="detail-popover"]')],LyraKnowledgeGraphExplorer.prototype,"popoverEl",void 0);export{LyraKnowledgeGraphExplorer};
+    `}}__decorate([state()],LyraKnowledgeGraphExplorer.prototype,"sourceEntity",void 0),__decorate([state()],LyraKnowledgeGraphExplorer.prototype,"sourceDetailsOpen",void 0),__decorate([state()],LyraKnowledgeGraphExplorer.prototype,"sourcePaint",void 0),__decorate([property({attribute:!1,noAccessor:!0,hasChanged:()=>!0})],LyraKnowledgeGraphExplorer.prototype,"graphSource",null),__decorate([property({type:Number,attribute:"source-page",noAccessor:!0})],LyraKnowledgeGraphExplorer.prototype,"sourcePage",null),__decorate([property({type:Number,attribute:"source-page-size",noAccessor:!0})],LyraKnowledgeGraphExplorer.prototype,"sourcePageSize",null),__decorate([property({attribute:!1})],LyraKnowledgeGraphExplorer.prototype,"nodes",void 0),__decorate([property({attribute:!1})],LyraKnowledgeGraphExplorer.prototype,"edges",void 0),__decorate([property({attribute:!1})],LyraKnowledgeGraphExplorer.prototype,"nodeTypes",void 0),__decorate([property({attribute:!1})],LyraKnowledgeGraphExplorer.prototype,"communities",void 0),__decorate([property({attribute:!1})],LyraKnowledgeGraphExplorer.prototype,"entityDetails",void 0),__decorate([property({attribute:!1})],LyraKnowledgeGraphExplorer.prototype,"pinnedNodeIds",void 0),__decorate([property({attribute:!1})],LyraKnowledgeGraphExplorer.prototype,"path",void 0),__decorate([property({attribute:!1})],LyraKnowledgeGraphExplorer.prototype,"hiddenTypes",void 0),__decorate([property({attribute:"selected-node-id"})],LyraKnowledgeGraphExplorer.prototype,"selectedNodeId",void 0),__decorate([property()],LyraKnowledgeGraphExplorer.prototype,"renderer",void 0),__decorate([property()],LyraKnowledgeGraphExplorer.prototype,"view",void 0),__decorate([property({attribute:!1})],LyraKnowledgeGraphExplorer.prototype,"camera",void 0),__decorate([property({attribute:"node-labels"})],LyraKnowledgeGraphExplorer.prototype,"nodeLabels",void 0),__decorate([property({attribute:"fit-to"})],LyraKnowledgeGraphExplorer.prototype,"fitTo",void 0),__decorate([property({converter:graphLengthConverter})],LyraKnowledgeGraphExplorer.prototype,"width",void 0),__decorate([property({converter:graphLengthConverter})],LyraKnowledgeGraphExplorer.prototype,"height",void 0),__decorate([property()],LyraKnowledgeGraphExplorer.prototype,"label",void 0),__decorate([property()],LyraKnowledgeGraphExplorer.prototype,"highlight",void 0),__decorate([property()],LyraKnowledgeGraphExplorer.prototype,"query",void 0),__decorate([state()],LyraKnowledgeGraphExplorer.prototype,"pinLiveText",void 0),__decorate([state()],LyraKnowledgeGraphExplorer.prototype,"hoveredNodeId",void 0),__decorate([state()],LyraKnowledgeGraphExplorer.prototype,"activeResult",void 0),__decorate([query('[part="graph"]')],LyraKnowledgeGraphExplorer.prototype,"graphEl",void 0),__decorate([query('[part="detail-popover"]')],LyraKnowledgeGraphExplorer.prototype,"popoverEl",void 0);export{LyraKnowledgeGraphExplorer};

package/dist/components/retrieval/knowledge-graph-explorer/knowledge-graph-explorer.d.ts

@@ -1,2 +1,2 @@
 /** @deprecated Import @aceshooting/lyra-ui/components/lr-knowledge-graph-explorer.js to register this component. */
-export*from'./knowledge-graph-explorer.class.js';import'../graph/graph.js';import'../graph-legend/graph-legend.js';import'../entity-card/entity-card.js';import'../neighbor-list/neighbor-list.js';import'../path-strip/path-strip.js';import'../../overlays/overlay/popover.js';import'../../forms/input/input.js';import'../../overlays/chip/chip.js';import'../../forms/button/button.js';
+export*from'./knowledge-graph-explorer.class.js';import'../graph/graph.js';import'../graph-legend/graph-legend.js';import'../entity-card/entity-card.js';import'../neighbor-list/neighbor-list.js';import'../../overlays/overlay/popover.js';import'../../forms/input/input.js';import'../../forms/button/button.js';

package/dist/components/retrieval/knowledge-graph-explorer/knowledge-graph-explorer.js

@@ -1 +1 @@
-export*from"./knowledge-graph-explorer.class.js";import{LyraKnowledgeGraphExplorer}from"./knowledge-graph-explorer.class.js";import{defineElement}from"../../../internal/prefix.js";import"../graph/graph.js";import"../graph-legend/graph-legend.js";import"../entity-card/entity-card.js";import"../neighbor-list/neighbor-list.js";import"../path-strip/path-strip.js";import"../../overlays/overlay/popover.js";import"../../forms/input/input.js";import"../../overlays/chip/chip.js";import"../../forms/button/button.js";defineElement("knowledge-graph-explorer",LyraKnowledgeGraphExplorer);
+export*from"./knowledge-graph-explorer.class.js";import{LyraKnowledgeGraphExplorer}from"./knowledge-graph-explorer.class.js";import{defineElement}from"../../../internal/prefix.js";import"../graph/graph.js";import"../graph-legend/graph-legend.js";import"../entity-card/entity-card.js";import"../neighbor-list/neighbor-list.js";import"../../overlays/overlay/popover.js";import"../../forms/input/input.js";import"../../forms/button/button.js";defineElement("knowledge-graph-explorer",LyraKnowledgeGraphExplorer);

package/dist/components/retrieval/knowledge-graph-explorer/knowledge-graph-explorer.styles.js

@@ -1 +1 @@
-import{iconHitTarget}from"../../../internal/interactive-control.styles.js";import{css}from"lit";const styles=css` :host { display: block; block-size: var(--lr-canvas-reserved-height, var(--lr-size-24rem)); --_lr-knowledge-graph-explorer-detail-clamp: var( --lr-popover-viewport-clamp ); } [part='base'] { display: flex; flex-direction: column; gap: var(--lr-space-s); min-inline-size: 0; block-size: 100%; min-block-size: 0; } [part='toolbar'] { display: flex; flex-wrap: wrap; align-items: center; gap: var(--lr-space-s); } [part='search'] { flex: 1 1 var(--lr-size-12rem); min-inline-size: 0; } [part='search-results'] { display: flex; flex-direction: column; gap: var(--lr-size-2px); max-block-size: var(--lr-size-12rem); overflow-y: auto; overflow-x: clip; border: var(--lr-border-width-thin) solid var(--lr-color-border); border-radius: var(--lr-radius); background: var(--lr-color-surface); } [part='search-result'] { display: block; } [part='search-result'] button { display: block; inline-size: 100%; box-sizing: border-box; ${iconHitTarget} text-align: start; padding: var(--lr-space-xs) var(--lr-space-s); border: none; background: transparent; color: var(--lr-color-text); font: inherit; overflow-wrap: anywhere; cursor: pointer; transition: background-color var(--lr-transition-fast); } [part='search-result'] button:hover { background: color-mix(in oklab, transparent, var(--lr-color-mix-partner) var(--lr-color-mix-hover)); } [part='search-result'] button:active { background: color-mix(in oklab, transparent, var(--lr-color-mix-partner) var(--lr-color-mix-active)); } [part='search-result'] button:focus-visible { outline: var(--lr-focus-ring-width) solid var(--lr-focus-ring-color); outline-offset: calc(-1 * var(--lr-focus-ring-width)); } [part='search-empty'] { padding: var(--lr-space-xs) var(--lr-space-s); color: var(--lr-color-text-quiet); font-size: var(--lr-font-size-sm); } [part='pinned'] { display: flex; flex-wrap: wrap; align-items: center; gap: var(--lr-space-xs); } [part='pinned-heading'] { color: var(--lr-color-text-quiet); font-size: var(--lr-font-size-sm); } [part='legend'] { flex: 0 1 auto; max-block-size: var(--lr-size-12rem); overflow-y: auto; overflow-x: clip; } [part='graph'] { display: block; inline-size: 100%; flex: 0 1 auto; min-block-size: 0; block-size: var( --lr-canvas-reserved-height, var(--_lr-graph-requested-height, var(--lr-size-24rem)) ); } [part='detail-card'] { max-inline-size: min( var(--_lr-knowledge-graph-explorer-detail-clamp), var(--lr-size-24rem) ); } `;export{styles};
+import{iconHitTarget,focusRing}from"../../../internal/interactive-control.styles.js";import{css}from"lit";const styles=css` :host { display: block; block-size: var(--lr-canvas-reserved-height, var(--lr-size-24rem)); --_lr-knowledge-graph-explorer-detail-clamp: var( --lr-popover-viewport-clamp ); } [part='base'] { display: flex; flex-direction: column; gap: var(--lr-space-s); min-inline-size: 0; block-size: 100%; min-block-size: 0; } [part='toolbar'] { display: flex; flex-wrap: wrap; align-items: center; gap: var(--lr-space-s); } [part='search'] { flex: 1 1 var(--lr-size-12rem); min-inline-size: 0; } [part='source-clear'] { ${iconHitTarget} font: inherit; color: var(--lr-color-text); background: var(--lr-color-surface-raised); border: var(--lr-border-width-thin) solid var(--lr-color-border); border-radius: var(--lr-radius-xs); cursor: pointer; transition: var(--lr-transition-interactive); } [part='source-clear']:hover { background: var(--lr-color-brand-quiet); } [part='source-clear']:active { background: color-mix(in oklab, var(--lr-color-brand-quiet), var(--lr-color-mix-partner) var(--lr-color-mix-active)); } [part='source-clear']:focus-visible { ${focusRing} } [part='source-status'] { overflow-wrap: anywhere; margin-block: var(--lr-space-xs); } [part='search-results'] { display: flex; flex-direction: column; gap: var(--lr-size-2px); max-block-size: var(--lr-size-12rem); overflow-y: auto; overflow-x: clip; border: var(--lr-border-width-thin) solid var(--lr-color-border); border-radius: var(--lr-radius); background: var(--lr-color-surface); } [part='search-result'] { display: block; } [part='search-result'] button { display: block; inline-size: 100%; box-sizing: border-box; ${iconHitTarget} text-align: start; padding: var(--lr-space-xs) var(--lr-space-s); border: none; background: transparent; color: var(--lr-color-text); font: inherit; overflow-wrap: anywhere; cursor: pointer; transition: background-color var(--lr-transition-fast); } [part='search-result'] button:hover { background: color-mix(in oklab, transparent, var(--lr-color-mix-partner) var(--lr-color-mix-hover)); } [part='search-result'] button:active { background: color-mix(in oklab, transparent, var(--lr-color-mix-partner) var(--lr-color-mix-active)); } [part='search-result'] button:focus-visible { outline: var(--lr-focus-ring-width) solid var(--lr-focus-ring-color); outline-offset: calc(-1 * var(--lr-focus-ring-width)); } [part='search-empty'] { padding: var(--lr-space-xs) var(--lr-space-s); color: var(--lr-color-text-quiet); font-size: var(--lr-font-size-sm); } [part='pinned'] { display: flex; flex-wrap: wrap; align-items: center; gap: var(--lr-space-xs); } [part='pinned-heading'] { color: var(--lr-color-text-quiet); font-size: var(--lr-font-size-sm); } [part='legend'] { flex: 0 1 auto; max-block-size: var(--lr-size-12rem); overflow-y: auto; overflow-x: clip; } [part='graph'] { display: block; inline-size: 100%; flex: 0 1 auto; min-block-size: 0; block-size: var( --lr-canvas-reserved-height, var(--_lr-graph-requested-height, var(--lr-size-24rem)) ); } [part='detail-card'] { max-inline-size: min( var(--_lr-knowledge-graph-explorer-detail-clamp), var(--lr-size-24rem) ); } [part='input-limit'] { margin-block: var(--lr-space-xs); color: var(--lr-color-text-quiet); font-size: var(--lr-font-size-sm); } `;export{styles};

package/dist/components/retrieval/mind-map/mind-map-layout.js

@@ -1 +1 @@
-import{minMax}from"../../../internal/numbers.js";import{isNonBlankIdentity}from"../retrieval-identity.js";function normalizeMindMapTopics(topics){const seen=new Set,normalize=values=>{const source=Array.isArray(values)?values:[],retained=[];for(const topic of source){if(topic===null||typeof topic!="object"||!isNonBlankIdentity(topic.id)||seen.has(topic.id))continue;seen.add(topic.id);const children=normalize(topic.children??[]);retained.push(Object.freeze({...topic,...topic.children===void 0?{}:{children}}))}return Object.freeze(retained)};return normalize(topics)}const LAYOUT_PADDING=60;function syntheticHubIdentity(topics){const ids=new Set,collect=values=>{for(const topic of values)ids.add(topic.id),collect(topic.children??[])};collect(topics);let identity="__hub__";for(;ids.has(identity);)identity=`_${identity}`;return identity}const leafCounts=new WeakMap;function visibleLeafCount(node,depth,opts){let count=leafCounts.get(node);if(count===void 0){const children=node.children??[];count=children.length===0||!opts.isExpanded(node.id,depth)?1:Math.max(1,children.reduce((sum,c)=>sum+visibleLeafCount(c,depth+1,opts),0)),leafCounts.set(node,count)}return count}function place(node,depth,angleStart,angleEnd,parentId,cx,cy,opts,out,links){const angle=(angleStart+angleEnd)/2,r=depth*opts.ringGap,dir=opts.rtl?-1:1,x=cx+dir*r*Math.sin(angle),y=cy-r*Math.cos(angle),hasChildren=node.children.length>0,expanded=hasChildren&&opts.isExpanded(node.id,depth);if(out.push({id:node.id,label:node.label,depth,x,y,angle,parentId,hasChildren,expanded}),parentId&&links.push({fromId:parentId,toId:node.id}),!hasChildren||!expanded)return;const counts=node.children.map(c=>visibleLeafCount(c,depth+1,opts)),total=counts.reduce((a,b)=>a+b,0)||1,span=angleEnd-angleStart;let cursor=angleStart;node.children.forEach((child,i)=>{const childSpan=counts[i]/total*span;place({id:child.id,label:child.label,children:child.children??[]},depth+1,cursor,cursor+childSpan,node.id,cx,cy,opts,out,links),cursor+=childSpan})}function layoutMindMap(topics,hubLabel,opts){const normalizedTopics=normalizeMindMapTopics(topics);if(normalizedTopics.length===0)return{placed:[],links:[],width:0,height:0,centerX:0,centerY:0};const root=normalizedTopics.length===1?{id:normalizedTopics[0].id,label:normalizedTopics[0].label,children:normalizedTopics[0].children??[]}:{id:syntheticHubIdentity(normalizedTopics),label:hubLabel,children:normalizedTopics},placed=[],links=[];place(root,0,0,2*Math.PI,null,0,0,opts,placed,links);const[xLo,xHi]=minMax(placed.map(p=>p.x))??[0,0],[yLo,yHi]=minMax(placed.map(p=>p.y))??[0,0],minX=xLo-LAYOUT_PADDING,maxX=xHi+LAYOUT_PADDING,minY=yLo-LAYOUT_PADDING,maxY=yHi+LAYOUT_PADDING;return{placed:placed.map(p=>({...p,x:p.x-minX,y:p.y-minY})),links,width:maxX-minX,height:maxY-minY,centerX:-minX,centerY:-minY}}function apportionByWeight(weights,budget){const shares=weights.map(()=>0),total=weights.reduce((sum,weight)=>sum+weight,0);if(total<=0||budget<=0||weights.length===0)return shares;const sampleCount=Math.min(budget,total),step=total/sampleCount;let childIndex=0,boundary=weights[0];for(let sample=0;sample<sampleCount;sample++){const target=(sample+.5)*step;for(;target>=boundary&&childIndex<weights.length-1;)childIndex+=1,boundary+=weights[childIndex];shares[childIndex]=shares[childIndex]+1}return shares}function decimateMindMapLayout(placed,links,maxNodes){const totalCount=placed.length;if(totalCount<=maxNodes||maxNodes<=0)return{placed:[...placed],links:[...links],totalCount,truncated:!1};const childrenByParent=new Map;for(const node of placed){const siblings=childrenByParent.get(node.parentId);siblings?siblings.push(node):childrenByParent.set(node.parentId,[node])}const subtreeSizeCache=new Map,subtreeSize=id=>{const cached=subtreeSizeCache.get(id);if(cached!==void 0)return cached;subtreeSizeCache.set(id,1);const children=childrenByParent.get(id)??[];let total=1;for(const child of children)total+=subtreeSize(child.id);return subtreeSizeCache.set(id,total),total},kept=new Set,visit=(node,budget)=>{if(budget<=0)return;kept.add(node.id);const children=childrenByParent.get(node.id)??[];if(children.length===0||budget<=1)return;const shares=apportionByWeight(children.map(child=>subtreeSize(child.id)),budget-1);children.forEach((child,index)=>visit(child,shares[index]))},roots=childrenByParent.get(null)??[],rootShares=apportionByWeight(roots.map(root=>subtreeSize(root.id)),maxNodes);return roots.forEach((root,index)=>visit(root,rootShares[index])),{placed:placed.filter(node=>kept.has(node.id)),links:links.filter(link=>kept.has(link.fromId)&&kept.has(link.toId)),totalCount,truncated:!0}}export{decimateMindMapLayout,layoutMindMap};
+import{minMax}from"../../../internal/numbers.js";import{isNonBlankIdentity}from"../retrieval-identity.js";function normalizeMindMapTopics(topics){const seen=new Set,normalize=values=>{const source=Array.isArray(values)?values:[],retained=[];for(const topic of source){if(topic===null||typeof topic!="object"||!isNonBlankIdentity(topic.id)||seen.has(topic.id))continue;seen.add(topic.id);const children=normalize(topic.children??[]);retained.push(Object.freeze({...topic,...topic.children===void 0?{}:{children}}))}return Object.freeze(retained)};return normalize(topics)}const LAYOUT_PADDING=60;function syntheticHubIdentity(topics){const ids=new Set,collect=values=>{for(const topic of values)ids.add(topic.id),collect(topic.children??[])};collect(topics);let identity="__hub__";for(;ids.has(identity);)identity=`_${identity}`;return identity}function visibleLeafCount(node,depth,opts,leafCounts){let count=leafCounts.get(node);if(count===void 0){const children=node.children??[];count=children.length===0||!opts.isExpanded(node.id,depth)?1:Math.max(1,children.reduce((sum,c)=>sum+visibleLeafCount(c,depth+1,opts,leafCounts),0)),leafCounts.set(node,count)}return count}function place(node,depth,angleStart,angleEnd,parentId,cx,cy,opts,leafCounts,out,links){const angle=(angleStart+angleEnd)/2,r=depth*opts.ringGap,dir=opts.rtl?-1:1,x=cx+dir*r*Math.sin(angle),y=cy-r*Math.cos(angle),hasChildren=node.children.length>0,expanded=hasChildren&&opts.isExpanded(node.id,depth);if(out.push({id:node.id,label:node.label,depth,x,y,angle,parentId,hasChildren,expanded}),parentId&&links.push({fromId:parentId,toId:node.id}),!hasChildren||!expanded)return;const counts=node.children.map(c=>visibleLeafCount(c,depth+1,opts,leafCounts)),total=counts.reduce((a,b)=>a+b,0)||1,span=angleEnd-angleStart;let cursor=angleStart;node.children.forEach((child,i)=>{const childSpan=counts[i]/total*span;place({id:child.id,label:child.label,children:child.children??[]},depth+1,cursor,cursor+childSpan,node.id,cx,cy,opts,leafCounts,out,links),cursor+=childSpan})}function layoutMindMap(topics,hubLabel,opts){return createMindMapLayout(topics)(hubLabel,opts)}function createMindMapLayout(topics){const normalizedTopics=normalizeMindMapTopics(topics);return(hubLabel,opts)=>layoutNormalizedMindMap(normalizedTopics,hubLabel,opts)}function layoutNormalizedMindMap(normalizedTopics,hubLabel,opts){if(normalizedTopics.length===0)return{placed:[],links:[],width:0,height:0,centerX:0,centerY:0};const root=normalizedTopics.length===1?{id:normalizedTopics[0].id,label:normalizedTopics[0].label,children:normalizedTopics[0].children??[]}:{id:syntheticHubIdentity(normalizedTopics),label:hubLabel,children:normalizedTopics},placed=[],links=[];place(root,0,0,2*Math.PI,null,0,0,opts,new WeakMap,placed,links);const[xLo,xHi]=minMax(placed.map(p=>p.x))??[0,0],[yLo,yHi]=minMax(placed.map(p=>p.y))??[0,0],minX=xLo-LAYOUT_PADDING,maxX=xHi+LAYOUT_PADDING,minY=yLo-LAYOUT_PADDING,maxY=yHi+LAYOUT_PADDING;return{placed:placed.map(p=>({...p,x:p.x-minX,y:p.y-minY})),links,width:maxX-minX,height:maxY-minY,centerX:-minX,centerY:-minY}}function apportionByWeight(weights,budget){const shares=weights.map(()=>0),total=weights.reduce((sum,weight)=>sum+weight,0);if(total<=0||budget<=0||weights.length===0)return shares;const sampleCount=Math.min(budget,total),step=total/sampleCount;let childIndex=0,boundary=weights[0];for(let sample=0;sample<sampleCount;sample++){const target=(sample+.5)*step;for(;target>=boundary&&childIndex<weights.length-1;)childIndex+=1,boundary+=weights[childIndex];shares[childIndex]=shares[childIndex]+1}return shares}function decimateMindMapLayout(placed,links,maxNodes){const totalCount=placed.length;if(totalCount<=maxNodes||maxNodes<=0)return{placed:[...placed],links:[...links],totalCount,truncated:!1};const childrenByParent=new Map;for(const node of placed){const siblings=childrenByParent.get(node.parentId);siblings?siblings.push(node):childrenByParent.set(node.parentId,[node])}const subtreeSizeCache=new Map,subtreeSize=id=>{const cached=subtreeSizeCache.get(id);if(cached!==void 0)return cached;subtreeSizeCache.set(id,1);const children=childrenByParent.get(id)??[];let total=1;for(const child of children)total+=subtreeSize(child.id);return subtreeSizeCache.set(id,total),total},kept=new Set,visit=(node,budget)=>{if(budget<=0)return;kept.add(node.id);const children=childrenByParent.get(node.id)??[];if(children.length===0||budget<=1)return;const shares=apportionByWeight(children.map(child=>subtreeSize(child.id)),budget-1);children.forEach((child,index)=>visit(child,shares[index]))},roots=childrenByParent.get(null)??[],rootShares=apportionByWeight(roots.map(root=>subtreeSize(root.id)),maxNodes);return roots.forEach((root,index)=>visit(root,rootShares[index])),{placed:placed.filter(node=>kept.has(node.id)),links:links.filter(link=>kept.has(link.fromId)&&kept.has(link.toId)),totalCount,truncated:!0}}export{createMindMapLayout,decimateMindMapLayout,layoutMindMap};

package/dist/components/retrieval/mind-map/mind-map-model.js

@@ -0,0 +1 @@
+import{readOwnArrayLength,readOwnDataValue}from"../../../internal/data-descriptors.js";const TOPIC_COPY_LIMIT=5e4,TOPIC_DEPTH_LIMIT=64;function arrayLength(value){try{return Array.isArray(value)?readOwnArrayLength(value):void 0}catch{return}}function snapshotMindMapTopics(value){const topics=[],owned=[],queue=[],length=arrayLength(value);length!==void 0&&queue.push({source:value,target:topics,depth:0,length});let inspected=0,truncated=!1;for(let frameIndex=0;frameIndex<queue.length;frameIndex++){const frame=queue[frameIndex];if(inspected>=TOPIC_COPY_LIMIT){truncated=!0;break}for(let index=0;index<frame.length;index++){if(inspected>=TOPIC_COPY_LIMIT){truncated=!0;break}inspected++;const topic=readOwnDataValue(frame.source,String(index));if(topic===null||typeof topic!="object")continue;let cyclic=!1;for(let ancestor=frame.parent;ancestor;ancestor=ancestor.parent)if(ancestor.source===topic){cyclic=!0;break}if(cyclic)continue;const id=readOwnDataValue(topic,"id"),label=readOwnDataValue(topic,"label");if(typeof id!="string"||!id.trim()||typeof label!="string")continue;const children=readOwnDataValue(topic,"children"),childCount=arrayLength(children),copy={id,label,...childCount===void 0?{}:{children:[]}};frame.target.push(copy),owned.push(copy),childCount&&(frame.depth>=TOPIC_DEPTH_LIMIT?truncated=!0:queue.push({source:children,target:copy.children,depth:frame.depth+1,length:childCount,parent:{source:topic,parent:frame.parent}}))}}for(const copy of owned)copy.children&&Object.freeze(copy.children),Object.freeze(copy);return{topics:Object.freeze(topics),truncated}}export{snapshotMindMapTopics};

package/dist/components/retrieval/mind-map/mind-map.class.d.ts

@@ -1,4 +1,4 @@
-import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import{type LyraTopic}from'./mind-map-layout.js';export type{LyraTopic};export interface LyraMindMapEventMap{'lr-topic-select':CustomEvent<{topicId:string;}>;'lr-topic-toggle':CustomEvent<{topicId:string;expanded:boolean;}>;}
+import type{LyraHierarchySource,LyraHierarchyQuery}from'../../../data-sources.js';import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import{type LyraTopic}from'./mind-map-layout.js';export type{LyraTopic};export type MindMapSource=LyraHierarchySource<LyraTopic,LyraHierarchyQuery>;export interface LyraMindMapEventMap{'lr-topic-select':CustomEvent<{topicId:string;}>;'lr-topic-toggle':CustomEvent<{topicId:string;expanded:boolean;}>;}
 /**
 * `<lr-mind-map>` — a radial expandable topic tree (NotebookLM Mind Maps): a spatial overview of
 * a topic hierarchy where activating a topic drills in or hands the topic to the chat. Hierarchy,
@@ -17,6 +17,18 @@ import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from
 * @event lr-topic-select - A *leaf* topic was activated. `detail: { topicId }`.
 * @event lr-topic-toggle - A parent topic was activated (or auto-expanded by keyboard descent).
 * `detail: { topicId, expanded }`.
+* Provider treeSource is authoritative for topology, expansion and selection. Its complete
+* preorder navigator reaches every key. The diagram is one connected subtree of currently
+* mounted rows (at most301), and its notice discloses clipping; it never implies a clipped parent
+* is a leaf. expandDepth and local expansion overrides apply only to legacy topics.
+*
+* @csspart source-diagram - The bounded connected subtree diagram in provider mode.
+* @csspart source-list - The complete virtualized source navigator.
+* @csspart source-row - An exact hierarchy row with global positional metadata.
+* @csspart source-toggle - A source expand, collapse or retry action.
+* @csspart source-label - A source topic label.
+* @csspart source-status - Source loading, empty and global-count status.
+* @csspart source-error - Source failure and retry status.
 * @csspart base - The wrapper.
 * @csspart svg - The single-tab-stop SVG focus target.
 * @csspart node - A topic node group.
@@ -25,6 +37,7 @@ import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from
 * @csspart focus-ring - The keyboard focus ring, drawn from the moment the svg takes focus (the
 * first placed topic is seeded as the keyboard cursor) rather than only after the first arrow key.
 * @csspart live-region - The visually hidden announcement region.
+* @csspart input-limit - A localized notice when the input safety boundary omits topics.
 * @csspart empty - The empty-state message, shown when `topics` is empty.
 * @csspart limit - The "showing N of M" notice, present only once the currently-visible topic
 *   count exceeds the render cap. The rendered subset is a deterministic, connectivity-preserving,
@@ -37,14 +50,24 @@ import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from
 * @status stable
 * @since 4.0.0
 */
-export declare class LyraMindMap extends LyraElement<LyraMindMapEventMap>{static styles:import("lit").CSSResultGroup[];static get observedAttributes():string[];private _topics;private topicsSource;
+export declare class LyraMindMap extends LyraElement<LyraMindMapEventMap>{static styles:import("lit").CSSResultGroup[];static get observedAttributes():string[];private _treeSource?;private sourceVersion;private sourceWrapper?;private readonly sourceViewAuthority;private sourcePaint;private sourceDiagramScheduled;private sourceDiagramRows;private sourceDiagramCurrent;private readonly sourceControl;
+/** Complete immutable provider preorder. Four 100-row pages and one focused row are retained;
+* at most 301 navigator rows mount. The diagram shows one connected subtree from those rows,
+* with provider child counts and expansion metadata. Nested value.children is never read.
+* Reassign even the same source or call requestUpdate() to refresh. Unset restores topics.
+* @default undefined */
+get treeSource():MindMapSource|undefined;set treeSource(value:MindMapSource|undefined);
+/** Reveal and focus any full-source key without emitting a topic event. */
+revealSourceKey(key:string):Promise<boolean>;private sourceAuthority;private wrapSource;private clearSourceDiagram;requestUpdate(name?:PropertyKey,oldValue?:unknown):void;private selectSourceRow;private scheduleSourceDiagram;private _topics;private topicsSource;private inputTruncated;
 /** A single root sits at the center; multiple roots hang off an implicit center hub whose
 *  visible text is `label`. A tree too large for one collection snapshot keeps its first
-*  50,000 topics, shallowest first, as `{ id, label, children }`. */
+*  50,000 inspected positions, shallowest first, with at most 64 descendant levels, as
+*  descriptor-safe `{ id, label, children }` records. A separate input notice reports omitted
+*  branches without counting descendants beyond the boundary. */
 get topics():readonly LyraTopic[];set topics(value:readonly LyraTopic[]);
 /** Accessible name for the SVG group *and* the implicit hub's text; falls back to the localized
 *  `mindMapLabel` when omitted. An explicitly empty override stays empty. */
 label?:string;
 /** Initial expansion depth (root + first ring). Expansion state is component-managed
 *  afterward, keyed by topic id, and survives `topics` reassignment. */
-expandDepth:number;private svgEl?;private expandedOverrides;private focusedId;private liveText;private cachedLayout;private totalTopicCount;private topicsTruncated;private resizeObserver?;private resizeObserverDocument?;private resizeRafId?;private resizeRafOwner?;private resizeRafDocument?;private ownerRealmGeneration;private observedSize;private layoutInvalidated;private layoutContext;private announcementSink?;connectedCallback():void;private armResizeObserver;disconnectedCallback():void;adoptedCallback():void;private resetResizeWork;attributeChangedCallback(name:string,oldValue:string|null,value:string|null):void;private get effectiveExpandDepth();private isExpanded;private ringGapPx;private relayout;protected willUpdate(changed:PropertyValues):void;private setAnnouncement;private toggle;private activate;private siblingsOf;private childrenOf;private announce;private focusNodeById;private onKeyDown;private onFocusIn;private onNodeClick;private connectorControlPoint;private renderSemanticNode;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-mind-map':LyraMindMap;}}
+expandDepth:number;private svgEl?;private expandedOverrides;private focusedId;private liveText;private cachedLayout;private totalTopicCount;private topicsTruncated;private resizeObserver?;private resizeObserverDocument?;private resizeRafId?;private resizeRafOwner?;private resizeRafDocument?;private ownerRealmGeneration;private observedSize;private layoutInvalidated;private layoutContext;private announcementSink?;connectedCallback():void;private armResizeObserver;disconnectedCallback():void;adoptedCallback():void;private resetResizeWork;attributeChangedCallback(name:string,oldValue:string|null,value:string|null):void;private get effectiveExpandDepth();private isExpanded;private ringGapPx;private laidOutInputs?;private layoutInputs;private topicLayout?;private relayout;protected willUpdate(changed:PropertyValues):void;private setAnnouncement;private toggle;private activate;private siblingsOf;private childrenOf;private announce;private focusNodeById;private onKeyDown;private onFocusIn;private onNodeClick;private connectorControlPoint;private renderSemanticNode;private renderInputLimit;render():TemplateResult;private renderDiagram;}declare global{interface HTMLElementTagNameMap{'lr-mind-map':LyraMindMap;}}