@aceshooting/lyra-ui 4.2.0 → 5.0.0

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

@@ -0,0 +1,360 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { html, nothing, svg } from 'lit';
+import { property } from 'lit/decorators.js';
+import { LyraElement } from '../../../internal/lyra-element.js';
+import { getDateTimeFormat } from '../../../internal/intl-cache.js';
+import { playIcon, pauseIcon } from '../../../internal/icons.js';
+import { styles } from './knowledge-base.styles.js';
+import '../../data/table/table.js';
+import '../../overlays/badge/badge.js';
+import '../../data/stat/stat.js';
+import '../../layout/menu/menu.js';
+import '../../forms/button/button.js';
+const SYNC_STATUS_VARIANT = {
+    idle: 'neutral',
+    syncing: 'brand',
+    paused: 'warning',
+    synced: 'success',
+    error: 'danger',
+};
+const HEALTH_VARIANT = {
+    healthy: 'success',
+    degraded: 'warning',
+    failed: 'danger',
+    unknown: 'neutral',
+};
+const PERMISSION_VARIANT = {
+    owner: 'brand',
+    editor: 'neutral',
+    viewer: 'neutral',
+    restricted: 'warning',
+};
+// One-off glyphs kept local rather than added to the shared internal/icons.ts set -- same approach
+// lr-thread-list's local pinIcon()/archiveIcon()/trashIcon() take, for the identical reason (these
+// aren't part of the library's general-purpose icon vocabulary). trashIcon mirrors lr-thread-list's
+// own glyph verbatim so a destructive action reads identically everywhere it appears.
+const ICON_VIEW_BOX = '0 0 24 24';
+const ICON_STROKE_WIDTH = '1.75';
+function trashIcon() {
+    return svg `
+    <svg width="1em" height="1em" viewBox=${ICON_VIEW_BOX} fill="none" stroke="currentColor" stroke-width=${ICON_STROKE_WIDTH} stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">
+      <path d="M4 7h16"></path>
+      <path d="M10 11v6"></path>
+      <path d="M14 11v6"></path>
+      <path d="M6 7l1 14h10l1-14"></path>
+      <path d="M9 7V4h6v3"></path>
+    </svg>
+  `;
+}
+/** A vertical three-dot "more actions" trigger glyph -- filled dots rather than this set's usual
+ *  stroked paths, since that's the conventional rendering for an overflow-menu affordance. */
+function kebabIcon() {
+    return svg `
+    <svg width="1em" height="1em" viewBox=${ICON_VIEW_BOX} fill="currentColor" stroke="none" aria-hidden="true" focusable="false">
+      <circle cx="12" cy="5" r="1.75"></circle>
+      <circle cx="12" cy="12" r="1.75"></circle>
+      <circle cx="12" cy="19" r="1.75"></circle>
+    </svg>
+  `;
+}
+function normalizeTimestamp(value) {
+    if (value === undefined)
+        return undefined;
+    const date = value instanceof Date ? value : new Date(value);
+    return Number.isNaN(date.getTime()) ? undefined : date;
+}
+/**
+ * `<lr-knowledge-base>` — a source list for a retrieval knowledge base: sync status, indexing
+ * health, permissions, and per-row create/sync/pause/delete affordances. A controlled data view,
+ * like every other Lyra data component: it never syncs or indexes anything itself, only presents
+ * `sources` and emits request-only events (`lr-kb-create`/`-sync`/`-pause`/`-delete`) for the host
+ * to act on and reflect back into a new `sources` value -- mirrors `lr-thread-list`'s
+ * `lr-thread-pin`/`-archive`/`-delete` convention exactly.
+ *
+ * `permission` is rendered informationally only (a badge in the permission column); this component
+ * does not gate the per-row action menu by it -- authorization enforcement is the host's own
+ * concern, consistent with the controlled/presentational-only contract above. A `'syncing'` row's
+ * "Sync now" action is disabled (a sync is already running); every other row's is enabled,
+ * including `'error'`, so re-running a failed sync is one click. "Pause sync" is enabled only while
+ * `'syncing'`.
+ *
+ * Composes `<lr-table>` for the source list (its own click/keydown delegation already treats any
+ * custom-element or `role="menuitem"` cell content as interactive, so the per-row `<lr-menu>` never
+ * misfires the table's row-click handling), `<lr-badge>` for the sync-status/indexing-health/
+ * permission indicators, `<lr-stat>` for the aggregate summary row above the table, and `<lr-menu>`
+ * for the per-row action affordances. The table's own `lr-row-click` is intentionally stopped from
+ * propagating further (this component doesn't expose row-click/selection semantics -- only the
+ * per-row action menu is interactive).
+ *
+ * @customElement lr-knowledge-base
+ * @event lr-kb-create - The toolbar "Add source" affordance was activated. No detail.
+ * @event lr-kb-sync - A row's "Sync now" action was activated. `detail: { sourceId }`.
+ * @event lr-kb-pause - A row's "Pause sync" action was activated. `detail: { sourceId }`.
+ * @event lr-kb-delete - A row's "Delete source" action was activated. `detail: { sourceId }`.
+ * @csspart base - The root.
+ * @csspart toolbar - The heading + "Add source" row.
+ * @csspart heading - The heading text.
+ * @csspart create-button - The "Add source" `<lr-button>`, omitted while `hideCreate` is set.
+ * @csspart summary - The aggregate-stats row, omitted while `hideSummary` is set or `sources` is empty.
+ * @csspart summary-stat - One `<lr-stat>` inside `summary`.
+ * @csspart table - The `<lr-table>` listing every source.
+ * @csspart name-cell - A row's source-name cell wrapper.
+ * @csspart source-name - The source's name text.
+ * @csspart source-type - The source's `type` text, omitted when unset.
+ * @csspart sync-cell - A row's sync-status cell wrapper.
+ * @csspart sync-badge - The sync-status `<lr-badge>`.
+ * @csspart sync-timestamp - The formatted `lastSyncedAt` text (or a "never synced" fallback).
+ * @csspart sync-error - The `errorMessage` text, shown only while `syncStatus` is `'error'` and it's set.
+ * @csspart health-cell - A row's indexing-health cell wrapper.
+ * @csspart health-badge - The indexing-health `<lr-badge>`.
+ * @csspart document-count - The formatted `documentCount` text, omitted when unset.
+ * @csspart permission-badge - The permission `<lr-badge>`, omitted when `permission` is unset.
+ * @csspart actions-menu - A row's `<lr-menu>`.
+ * @csspart actions-trigger - The kebab `<button>` opening a row's action menu.
+ */
+export class LyraKnowledgeBase extends LyraElement {
+    constructor() {
+        super(...arguments);
+        /** The sources to list, in display order. */
+        this.sources = [];
+        /** Heading text and the table's accessible name. Falls back to a localized default. */
+        this.label = '';
+        /** Hides the aggregate summary row (total/synced/syncing/needs-attention). */
+        this.hideSummary = false;
+        /** Hides the toolbar's "Add source" affordance, e.g. for a read-only or permission-gated view. */
+        this.hideCreate = false;
+    }
+    static { this.styles = [LyraElement.styles, styles]; }
+    syncStatusLabel(status) {
+        switch (status) {
+            case 'idle':
+                return this.localize('knowledgeBaseSyncIdle');
+            case 'syncing':
+                return this.localize('knowledgeBaseSyncSyncing');
+            case 'paused':
+                return this.localize('knowledgeBaseSyncPaused');
+            case 'synced':
+                return this.localize('knowledgeBaseSyncSynced');
+            case 'error':
+                return this.localize('knowledgeBaseSyncError');
+        }
+    }
+    healthLabel(health) {
+        switch (health) {
+            case 'healthy':
+                return this.localize('knowledgeBaseHealthHealthy');
+            case 'degraded':
+                return this.localize('knowledgeBaseHealthDegraded');
+            case 'failed':
+                return this.localize('knowledgeBaseHealthFailed');
+            case 'unknown':
+                return this.localize('knowledgeBaseHealthUnknown');
+        }
+    }
+    permissionLabel(permission) {
+        switch (permission) {
+            case 'owner':
+                return this.localize('knowledgeBasePermissionOwner');
+            case 'editor':
+                return this.localize('knowledgeBasePermissionEditor');
+            case 'viewer':
+                return this.localize('knowledgeBasePermissionViewer');
+            case 'restricted':
+                return this.localize('knowledgeBasePermissionRestricted');
+        }
+    }
+    renderNameCell(source) {
+        return html `
+      <div part="name-cell">
+        <span part="source-name">${source.name}</span>
+        ${source.type ? html `<span part="source-type">${source.type}</span>` : nothing}
+      </div>
+    `;
+    }
+    renderSyncCell(source) {
+        const lastSynced = normalizeTimestamp(source.lastSyncedAt);
+        return html `
+      <div part="sync-cell">
+        <lr-badge part="sync-badge" variant=${SYNC_STATUS_VARIANT[source.syncStatus]}
+          >${this.syncStatusLabel(source.syncStatus)}</lr-badge
+        >
+        <span part="sync-timestamp">
+          ${lastSynced
+            ? getDateTimeFormat(this.effectiveLocale, { dateStyle: 'medium', timeStyle: 'short' }).format(lastSynced)
+            : this.localize('knowledgeBaseNeverSynced')}
+        </span>
+        ${source.syncStatus === 'error' && source.errorMessage
+            ? html `<span part="sync-error">${source.errorMessage}</span>`
+            : nothing}
+      </div>
+    `;
+    }
+    renderHealthCell(source) {
+        const health = source.indexingHealth ?? 'unknown';
+        return html `
+      <div part="health-cell">
+        <lr-badge part="health-badge" variant=${HEALTH_VARIANT[health]}>${this.healthLabel(health)}</lr-badge>
+        ${source.documentCount != null
+            ? html `<span part="document-count"
+              >${this.localize('knowledgeBaseDocumentCount', undefined, {
+                count: source.documentCount,
+            })}</span
+            >`
+            : nothing}
+      </div>
+    `;
+    }
+    renderPermissionCell(source) {
+        if (!source.permission)
+            return html ``;
+        return html `<lr-badge part="permission-badge" variant=${PERMISSION_VARIANT[source.permission]}
+      >${this.permissionLabel(source.permission)}</lr-badge
+    >`;
+    }
+    onRowAction(source, action) {
+        if (action === 'sync')
+            this.emit('lr-kb-sync', { sourceId: source.id });
+        else if (action === 'pause')
+            this.emit('lr-kb-pause', { sourceId: source.id });
+        else if (action === 'delete')
+            this.emit('lr-kb-delete', { sourceId: source.id });
+    }
+    renderActionsCell(source) {
+        const canPause = source.syncStatus === 'syncing';
+        const canSync = source.syncStatus !== 'syncing';
+        const label = this.localize('knowledgeBaseRowActionsLabel', undefined, { name: source.name });
+        return html `
+      <lr-menu
+        part="actions-menu"
+        label=${label}
+        @lr-menu-select=${(e) => this.onRowAction(source, e.detail.value)}
+      >
+        <button slot="trigger" type="button" part="actions-trigger" aria-label=${label}>${kebabIcon()}</button>
+        <lr-menu-item value="sync" ?disabled=${!canSync}>
+          <span slot="icon">${playIcon()}</span>
+          ${this.localize('knowledgeBaseSyncAction')}
+        </lr-menu-item>
+        <lr-menu-item value="pause" ?disabled=${!canPause}>
+          <span slot="icon">${pauseIcon()}</span>
+          ${this.localize('knowledgeBasePauseAction')}
+        </lr-menu-item>
+        <lr-menu-item value="delete" destructive>
+          <span slot="icon">${trashIcon()}</span>
+          ${this.localize('knowledgeBaseDeleteAction')}
+        </lr-menu-item>
+      </lr-menu>
+    `;
+    }
+    // Recomputed every render (not memoized) so column labels stay correct across a locale change --
+    // this list is small (five columns), so the recomputation cost is negligible.
+    tableColumns() {
+        return [
+            {
+                key: 'name',
+                label: this.localize('knowledgeBaseNameColumn'),
+                cell: (row) => this.renderNameCell(row),
+            },
+            {
+                key: 'sync',
+                label: this.localize('knowledgeBaseSyncColumn'),
+                cell: (row) => this.renderSyncCell(row),
+            },
+            {
+                key: 'health',
+                label: this.localize('knowledgeBaseHealthColumn'),
+                cell: (row) => this.renderHealthCell(row),
+            },
+            {
+                key: 'permission',
+                label: this.localize('knowledgeBasePermissionColumn'),
+                cell: (row) => this.renderPermissionCell(row),
+            },
+            {
+                key: 'actions',
+                label: this.localize('knowledgeBaseActionsColumn'),
+                align: 'end',
+                cell: (row) => this.renderActionsCell(row),
+            },
+        ];
+    }
+    renderSummary() {
+        const total = this.sources.length;
+        const synced = this.sources.filter((s) => s.syncStatus === 'synced').length;
+        const syncing = this.sources.filter((s) => s.syncStatus === 'syncing').length;
+        const attention = this.sources.filter((s) => s.syncStatus === 'error' || s.indexingHealth === 'failed' || s.indexingHealth === 'degraded').length;
+        return html `
+      <div part="summary">
+        <lr-stat
+          part="summary-stat"
+          label=${this.localize('knowledgeBaseTotalSources')}
+          value=${String(total)}
+        ></lr-stat>
+        <lr-stat
+          part="summary-stat"
+          label=${this.localize('knowledgeBaseSyncedSources')}
+          value=${String(synced)}
+        ></lr-stat>
+        <lr-stat
+          part="summary-stat"
+          label=${this.localize('knowledgeBaseSyncingSources')}
+          value=${String(syncing)}
+        ></lr-stat>
+        <lr-stat
+          part="summary-stat"
+          variant=${attention > 0 ? 'danger' : 'neutral'}
+          label=${this.localize('knowledgeBaseNeedsAttention')}
+          value=${String(attention)}
+        ></lr-stat>
+      </div>
+    `;
+    }
+    render() {
+        const heading = this.label || this.localize('knowledgeBaseHeading');
+        return html `
+      <div part="base">
+        <div part="toolbar">
+          <h3 part="heading">${heading}</h3>
+          ${!this.hideCreate
+            ? html `<lr-button
+                part="create-button"
+                variant="brand"
+                size="s"
+                @click=${() => this.emit('lr-kb-create')}
+              >
+                ${this.localize('knowledgeBaseCreateSource')}
+              </lr-button>`
+            : nothing}
+        </div>
+        ${!this.hideSummary && this.sources.length > 0 ? this.renderSummary() : nothing}
+        <lr-table
+          part="table"
+          .columns=${this.tableColumns()}
+          .rows=${this.sources}
+          .rowKey=${(row) => row.id}
+          aria-label=${heading}
+          empty-heading=${this.localize('knowledgeBaseEmptyHeading')}
+          empty-description=${this.localize('knowledgeBaseEmptyDescription', undefined)}
+          @lr-row-click=${(e) => e.stopPropagation()}
+        ></lr-table>
+      </div>
+    `;
+    }
+}
+__decorate([
+    property({ attribute: false })
+], LyraKnowledgeBase.prototype, "sources", void 0);
+__decorate([
+    property()
+], LyraKnowledgeBase.prototype, "label", void 0);
+__decorate([
+    property({ type: Boolean, attribute: 'hide-summary', reflect: true })
+], LyraKnowledgeBase.prototype, "hideSummary", void 0);
+__decorate([
+    property({ type: Boolean, attribute: 'hide-create', reflect: true })
+], LyraKnowledgeBase.prototype, "hideCreate", void 0);
+//# sourceMappingURL=knowledge-base.class.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-base.class.js","sourceRoot":"","sources":["../../../../src/components/retrieval/knowledge-base/knowledge-base.class.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAA+C,MAAM,KAAK,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD,OAAO,2BAA2B,CAAC;AAEnC,OAAO,+BAA+B,CAAC;AACvC,OAAO,yBAAyB,CAAC;AAEjC,OAAO,2BAA2B,CAAC;AACnC,OAAO,8BAA8B,CAAC;AAoDtC,MAAM,mBAAmB,GAAoD;IAC3E,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,QAAQ;CAChB,CAAC;AAEF,MAAM,cAAc,GAAwD;IAC1E,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF,MAAM,kBAAkB,GAAoD;IAC1E,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,UAAU,EAAE,SAAS;CACtB,CAAC;AAEF,mGAAmG;AACnG,mGAAmG;AACnG,oGAAoG;AACpG,sFAAsF;AACtF,MAAM,aAAa,GAAG,WAAW,CAAC;AAClC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEjC,SAAS,SAAS;IAChB,OAAO,GAAG,CAAA;4CACgC,aAAa,mDAAmD,iBAAiB;;;;;;;GAO1H,CAAC;AACJ,CAAC;AAED;8FAC8F;AAC9F,SAAS,SAAS;IAChB,OAAO,GAAG,CAAA;4CACgC,aAAa;;;;;GAKtD,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAgC;IAC1D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,IAAI,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AACzD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,MAAM,OAAO,iBAAkB,SAAQ,WAAsC;IAA7E;;QAGE,6CAA6C;QACb,YAAO,GAAsB,EAAE,CAAC;QAEhE,uFAAuF;QAC3E,UAAK,GAAG,EAAE,CAAC;QAEvB,8EAA8E;QACP,gBAAW,GAAG,KAAK,CAAC;QAE3F,kGAAkG;QAC5B,eAAU,GAAG,KAAK,CAAC;IAkO3F,CAAC;aA9OQ,WAAM,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,AAA/B,CAAgC;IAcrC,eAAe,CAAC,MAAiC;QACvD,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,MAAM;gBACT,OAAO,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;YAChD,KAAK,SAAS;gBACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC;YACnD,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;YAClD,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;YAClD,KAAK,OAAO;gBACV,OAAO,IAAI,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,MAAqC;QACvD,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,SAAS;gBACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CAAC;YACrD,KAAK,UAAU;gBACb,OAAO,IAAI,CAAC,QAAQ,CAAC,6BAA6B,CAAC,CAAC;YACtD,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CAAC;YACpD,KAAK,SAAS;gBACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAEO,eAAe,CAAC,UAAqC;QAC3D,QAAQ,UAAU,EAAE,CAAC;YACnB,KAAK,OAAO;gBACV,OAAO,IAAI,CAAC,QAAQ,CAAC,8BAA8B,CAAC,CAAC;YACvD,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC;YACxD,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC;YACxD,KAAK,YAAY;gBACf,OAAO,IAAI,CAAC,QAAQ,CAAC,mCAAmC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,MAAuB;QAC5C,OAAO,IAAI,CAAA;;mCAEoB,MAAM,CAAC,IAAI;UACpC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA,4BAA4B,MAAM,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,OAAO;;KAEjF,CAAC;IACJ,CAAC;IAEO,cAAc,CAAC,MAAuB;QAC5C,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAA;;8CAE+B,mBAAmB,CAAC,MAAM,CAAC,UAAU,CAAC;aACvE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC;;;YAGxC,UAAU;YACV,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;YACzG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC;;UAE7C,MAAM,CAAC,UAAU,KAAK,OAAO,IAAI,MAAM,CAAC,YAAY;YACpD,CAAC,CAAC,IAAI,CAAA,2BAA2B,MAAM,CAAC,YAAY,SAAS;YAC7D,CAAC,CAAC,OAAO;;KAEd,CAAC;IACJ,CAAC;IAEO,gBAAgB,CAAC,MAAuB;QAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,IAAI,SAAS,CAAC;QAClD,OAAO,IAAI,CAAA;;gDAEiC,cAAc,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;UACxF,MAAM,CAAC,aAAa,IAAI,IAAI;YAC5B,CAAC,CAAC,IAAI,CAAA;iBACC,IAAI,CAAC,QAAQ,CAAC,4BAA4B,EAAE,SAAS,EAAE;gBACxD,KAAK,EAAE,MAAM,CAAC,aAAa;aAC5B,CAAC;cACF;YACJ,CAAC,CAAC,OAAO;;KAEd,CAAC;IACJ,CAAC;IAEO,oBAAoB,CAAC,MAAuB;QAClD,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO,IAAI,CAAA,EAAE,CAAC;QACtC,OAAO,IAAI,CAAA,6CAA6C,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC;SACxF,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC;MAC1C,CAAC;IACL,CAAC;IAEO,WAAW,CAAC,MAAuB,EAAE,MAAc;QACzD,IAAI,MAAM,KAAK,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;aACnE,IAAI,MAAM,KAAK,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;aAC1E,IAAI,MAAM,KAAK,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IACnF,CAAC;IAEO,iBAAiB,CAAC,MAAuB;QAC/C,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC;QACjD,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,8BAA8B,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9F,OAAO,IAAI,CAAA;;;gBAGC,KAAK;0BACK,CAAC,CAAgC,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;;iFAEvB,KAAK,IAAI,SAAS,EAAE;+CACtD,CAAC,OAAO;8BACzB,QAAQ,EAAE;YAC5B,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC;;gDAEJ,CAAC,QAAQ;8BAC3B,SAAS,EAAE;YAC7B,IAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC;;;8BAGvB,SAAS,EAAE;YAC7B,IAAI,CAAC,QAAQ,CAAC,2BAA2B,CAAC;;;KAGjD,CAAC;IACJ,CAAC;IAED,iGAAiG;IACjG,8EAA8E;IACtE,YAAY;QAClB,OAAO;YACL;gBACE,GAAG,EAAE,MAAM;gBACX,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC;gBAC/C,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;aACxC;YACD;gBACE,GAAG,EAAE,MAAM;gBACX,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC;gBAC/C,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;aACxC;YACD;gBACE,GAAG,EAAE,QAAQ;gBACb,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,2BAA2B,CAAC;gBACjD,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC;aAC1C;YACD;gBACE,GAAG,EAAE,YAAY;gBACjB,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,+BAA+B,CAAC;gBACrD,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC;aAC9C;YACD;gBACE,GAAG,EAAE,SAAS;gBACd,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,4BAA4B,CAAC;gBAClD,KAAK,EAAE,KAAK;gBACZ,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC;aAC3C;SACF,CAAC;IACJ,CAAC;IAEO,aAAa;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;QAC5E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;QAC9E,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CACnC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,OAAO,IAAI,CAAC,CAAC,cAAc,KAAK,QAAQ,IAAI,CAAC,CAAC,cAAc,KAAK,UAAU,CACpG,CAAC,MAAM,CAAC;QACT,OAAO,IAAI,CAAA;;;;kBAIG,IAAI,CAAC,QAAQ,CAAC,2BAA2B,CAAC;kBAC1C,MAAM,CAAC,KAAK,CAAC;;;;kBAIb,IAAI,CAAC,QAAQ,CAAC,4BAA4B,CAAC;kBAC3C,MAAM,CAAC,MAAM,CAAC;;;;kBAId,IAAI,CAAC,QAAQ,CAAC,6BAA6B,CAAC;kBAC5C,MAAM,CAAC,OAAO,CAAC;;;;oBAIb,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;kBACtC,IAAI,CAAC,QAAQ,CAAC,6BAA6B,CAAC;kBAC5C,MAAM,CAAC,SAAS,CAAC;;;KAG9B,CAAC;IACJ,CAAC;IAED,MAAM;QACJ,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC;QACpE,OAAO,IAAI,CAAA;;;+BAGgB,OAAO;YAC1B,CAAC,IAAI,CAAC,UAAU;YAChB,CAAC,CAAC,IAAI,CAAA;;;;yBAIO,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC;;kBAEtC,IAAI,CAAC,QAAQ,CAAC,2BAA2B,CAAC;2BACjC;YACf,CAAC,CAAC,OAAO;;UAEX,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,OAAO;;;qBAGlE,IAAI,CAAC,YAAY,EAAE;kBACtB,IAAI,CAAC,OAAO;oBACV,CAAC,GAAoB,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE;uBAC7B,OAAO;0BACJ,IAAI,CAAC,QAAQ,CAAC,2BAA2B,CAAC;8BACtC,IAAI,CAAC,QAAQ,CAAC,+BAA+B,EAAE,SAAS,CAC3E;0BACe,CAAC,CAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,EAAE;;;KAGtD,CAAC;IACJ,CAAC;CACF;AA3OiC;IAA/B,QAAQ,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;kDAAiC;AAGpD;IAAX,QAAQ,EAAE;gDAAY;AAGgD;IAAtE,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;sDAAqB;AAGrB;IAArE,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;qDAAoB"}

package/dist/components/retrieval/knowledge-base/knowledge-base.d.ts

@@ -0,0 +1,7 @@
+export * from './knowledge-base.class.js';
+import '../../data/table/table.js';
+import '../../overlays/badge/badge.js';
+import '../../data/stat/stat.js';
+import '../../layout/menu/menu.js';
+import '../../forms/button/button.js';
+//# sourceMappingURL=knowledge-base.d.ts.map

package/dist/components/retrieval/knowledge-base/knowledge-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-base.d.ts","sourceRoot":"","sources":["../../../../src/components/retrieval/knowledge-base/knowledge-base.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAG1C,OAAO,2BAA2B,CAAC;AACnC,OAAO,+BAA+B,CAAC;AACvC,OAAO,yBAAyB,CAAC;AACjC,OAAO,2BAA2B,CAAC;AACnC,OAAO,8BAA8B,CAAC"}

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

@@ -0,0 +1,10 @@
+export * from './knowledge-base.class.js';
+import { LyraKnowledgeBase } from './knowledge-base.class.js';
+import { defineElement } from '../../../internal/prefix.js';
+import '../../data/table/table.js';
+import '../../overlays/badge/badge.js';
+import '../../data/stat/stat.js';
+import '../../layout/menu/menu.js';
+import '../../forms/button/button.js';
+defineElement('knowledge-base', LyraKnowledgeBase);
+//# sourceMappingURL=knowledge-base.js.map

package/dist/components/retrieval/knowledge-base/knowledge-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-base.js","sourceRoot":"","sources":["../../../../src/components/retrieval/knowledge-base/knowledge-base.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,2BAA2B,CAAC;AACnC,OAAO,+BAA+B,CAAC;AACvC,OAAO,yBAAyB,CAAC;AACjC,OAAO,2BAA2B,CAAC;AACnC,OAAO,8BAA8B,CAAC;AACtC,aAAa,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC"}

package/dist/components/retrieval/knowledge-base/knowledge-base.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-base.styles.d.ts","sourceRoot":"","sources":["../../../../src/components/retrieval/knowledge-base/knowledge-base.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,yBA2FlB,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-base.styles.js","sourceRoot":"","sources":["../../../../src/components/retrieval/knowledge-base/knowledge-base.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2FxB,CAAC"}

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

@@ -0,0 +1,218 @@
+import { type PropertyValues, type TemplateResult } from 'lit';
+import { LyraElement } from '../../../internal/lyra-element.js';
+import type { GraphNode, GraphLink, GraphNodeType, GraphCommunity } 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';
+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';
+/** Extra `LyraEntity` fields a plain `GraphNode` 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 `links`, `description`/
+ *  `properties` are simply omitted. */
+export type LyraKnowledgeGraphEntityDetails = Pick<LyraEntity, 'description' | 'properties' | 'degree'>;
+export interface LyraKnowledgeGraphExplorerEventMap {
+    /** The user asked to find a path between the two currently pinned nodes (the "Find path" action,
+     *  only rendered once exactly two nodes are pinned). `detail: { sourceId, targetId }` -- this
+     *  component has no graph-traversal algorithm of its own (client-side, backend call, whatever the
+     *  host prefers); it only requests one. The host computes/fetches the path and assigns the result
+     *  back through `path`. */
+    'lr-path-request': CustomEvent<{
+        sourceId: string;
+        targetId: string;
+    }>;
+    /** A node's pinned state changed by user interaction. `detail: { pinnedNodeIds }` -- the complete
+     *  updated array. This component already toggles its own `pinnedNodeIds` copy before emitting
+     *  (the same self-toggle-then-emit contract `lr-graph-legend`'s `hiddenTypes`/`lr-visibility-
+     *  change` already establishes), so reassigning it back is optional -- useful only for a host
+     *  that wants to persist or observe pins elsewhere. */
+    'lr-pin-change': CustomEvent<{
+        pinnedNodeIds: string[];
+    }>;
+}
+/**
+ * `<lr-knowledge-graph-explorer>` — an orchestration-level surface for exploring a knowledge
+ * graph: the `lr-graph` canvas plus entity search, type filters, neighborhood expansion, pinned
+ * nodes, path finding between pins, node selection, and a details overlay. Composes existing
+ * primitives rather than re-implementing graph rendering: `lr-graph` (canvas/pan-zoom/selection),
+ * `lr-graph-legend` (type filters), `lr-entity-card` (the details popover's default content),
+ * `lr-neighbor-list` (the selected entity's relationships), `lr-path-strip` (a found path), and
+ * `lr-popover.showAt()` (the details overlay itself).
+ *
+ * **How the details popover finds its viewport position.** `lr-graph.getNodePosition()` and the
+ * `lr-node-click` event's `{ x, y }` are in the graph's own *local drawing space* (pre pan/zoom),
+ * never viewport pixels -- passing them straight to `showAt()` would anchor the popover at the
+ * wrong place as soon as the graph has panned or zoomed even once. A direct node click resolves
+ * the correct viewport rect the way this library's own documented `lr-graph` + `lr-popover.showAt()`
+ * composition does: for `renderer="svg"` (the default), `event.composedPath()` (the native `click`
+ * that bubbles out of `lr-graph`'s shadow root) locates the actual clicked `[part="node"]` element,
+ * whose `getBoundingClientRect()` is already viewport-relative; for `renderer="canvas"` (no
+ * per-node DOM element to find), the click event's own `clientX`/`clientY` are used directly, since
+ * canvas hit-testing already treats those as viewport coordinates internally. While the popover
+ * stays open after an `renderer="svg"` click, this component re-reads that same resolved node
+ * element's `getBoundingClientRect()` and re-calls `showAt()` every time the composed `lr-graph`
+ * emits its own `lr-viewport-change` (a frame-coalesced pan/zoom/simulation-tick signal) --
+ * schedules no `requestAnimationFrame` loop of its own, unlike an idle popover polling the DOM on
+ * every frame regardless of whether anything actually moved. Selecting a node any other
+ * way -- a search result, a neighbor row, a path-strip element, keyboard Enter/Space on a graph
+ * node (which never dispatches a native `click`) -- has no click event to read a rect from, so it
+ * instead calls the public `lr-graph.focusNode(id)` (which centers that node in the viewport) and
+ * then anchors the popover at the graph element's own `getBoundingClientRect()` center once that
+ * settles; no continuous tracking applies to that path.
+ *
+ * **Controlled vs. self-managed state.** `nodes`/`links`/`nodeTypes`/`communities`/`entityDetails`/
+ * `path` are purely host-supplied data, rendered as given. `hiddenTypes`/`selectedNodeId`/
+ * `searchQuery`/`pinnedNodeIds` are this component's own genuinely new contribution: it wires them
+ * into `lr-graph`'s existing controlled props (`hiddenTypes`, `selectedNodeIds`, `dimmedNodeIds`,
+ * `dimmedLinkIds`) itself, toggling its own copy on interaction (the same self-toggle-then-emit
+ * contract `lr-graph-legend` already uses) so every feature works with zero host wiring, while
+ * still being presettable/observable properties and emitting events (`lr-pin-change`,
+ * `lr-path-request`, plus every composed primitive's own event bubbling straight through
+ * unmodified) for a host that wants to persist or react to them.
+ *
+ * `highlight` controls what drives that dimming, on top of the always-active search-match
+ * dimming: `'selection'` (the default) dims by the selected node's immediate neighborhood;
+ * `'hover'` also dims by whichever node is currently pointer-hovered (falling back to the selected
+ * node's neighborhood while nothing is hovered); `'none'` turns this component's own dimming off
+ * entirely, forwarding empty `dimmedNodeIds`/`dimmedLinkIds` regardless of search/selection state
+ * -- for a host that wants to drive `lr-graph`'s dimming through a different composition instead.
+ *
+ * @customElement lr-knowledge-graph-explorer
+ * @slot details - Overrides the details popover's default content (an `lr-entity-card` with a
+ *   nested `lr-neighbor-list` and a pin toggle). Receives no data -- a consumer overriding this
+ *   slot reads the selected entity from `selectedNodeId`/`nodes` itself.
+ * @event lr-path-request - `detail: { sourceId, targetId }`. See the class doc above.
+ * @event lr-pin-change - `detail: { pinnedNodeIds }`. See the class doc above.
+ * @event lr-node-click - Bubbles straight through from the composed `lr-graph`, unmodified.
+ * @event lr-link-click - Bubbles straight through from the composed `lr-graph`, unmodified.
+ * @event lr-node-expand - Bubbles straight through from `lr-graph` and/or `lr-neighbor-list` (the
+ *   same event name/detail shape from either source) -- this component never appends neighbors
+ *   itself, only forwards the request; a host fetches/generates the expansion and assigns updated
+ *   `nodes`/`links` back.
+ * @event lr-community-click - Bubbles straight through from the composed `lr-graph`, unmodified.
+ * @event lr-relation-activate - Bubbles straight through from the composed `lr-path-strip`, unmodified.
+ * @csspart base - The root `role="group"` wrapper.
+ * @csspart toolbar - The row wrapping the search input and the type-filter legend.
+ * @csspart search - The composed `lr-entity-card` search `lr-input`.
+ * @csspart legend - The composed `lr-graph-legend`.
+ * @csspart search-results - The search-match list, only rendered while `searchQuery` is non-empty.
+ * @csspart search-result - One search-match row (`role="listitem"`, wrapping a `<button>`).
+ * @csspart search-empty - The "no matches" message, shown when `searchQuery` is non-empty but no node matches.
+ * @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 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.
+ */
+export declare class LyraKnowledgeGraphExplorer extends LyraElement<LyraKnowledgeGraphExplorerEventMap> {
+    static styles: import("lit").CSSResultGroup[];
+    nodes: GraphNode[];
+    links: GraphLink[];
+    nodeTypes: GraphNodeType[];
+    communities: GraphCommunity[];
+    /** Extra dossier fields, keyed by node id -- see `LyraKnowledgeGraphEntityDetails`. */
+    entityDetails: Record<string, LyraKnowledgeGraphEntityDetails>;
+    /** Currently-pinned node ids. Self-toggled by the pin action in the details popover and by a
+     *  pinned chip's remove button (see the class doc's "controlled vs. self-managed" note); still
+     *  presettable/overridable like any other property. Exactly two pinned nodes reveals the "Find
+     *  path" action. */
+    pinnedNodeIds: string[];
+    /** Host-supplied path-finding result, rendered via `lr-path-strip`. Empty (the default) renders
+     *  no path strip. See `lr-path-request`. */
+    path: LyraPathElement[];
+    /** Currently-hidden `GraphNode.type` values, forwarded to both `lr-graph.hiddenTypes` and
+     *  `lr-graph-legend.hiddenTypes`. Self-toggled by the composed legend; still presettable. */
+    hiddenTypes: string[];
+    /** The currently-selected node id, driving both the details popover and `lr-graph`'s
+     *  `selectedNodeIds` visual state. Presettable (e.g. to deep-link to a specific entity) as well
+     *  as self-managed on every selection interaction. `null` (the default) shows no selection and
+     *  keeps the details popover closed. */
+    selectedNodeId: string | null;
+    /** Forwarded to `lr-graph.renderer`. `renderer="canvas"` has no per-node DOM element, which
+     *  narrows how the node-detail popover anchors and disables its pan/zoom tracking -- see the
+     *  class doc's anchoring note. */
+    renderer: 'svg' | 'canvas';
+    width: number;
+    height: number;
+    /** Accessible name for the root landmark; falls back to the localized `graphExplorerLabel`. */
+    label: string;
+    /** What drives this component's own `dimmedNodeIds`/`dimmedLinkIds` forwarding, on top of the
+     *  always-active search-match dimming -- see the class doc's dedicated paragraph. */
+    highlight: 'selection' | 'hover' | 'none';
+    private searchQuery;
+    private pinLiveText;
+    /** Currently pointer-hovered node id, set only while `highlight === 'hover'` (see
+     *  `onGraphNodeEnter`/`onGraphNodeLeave`) -- read by `computedDimmedNodeIds`. */
+    private hoveredNodeId;
+    private graphEl?;
+    private popoverEl?;
+    /** Set by `onGraphNodeClick` and consumed either synchronously by the native `click` that
+     *  follows it on the same user gesture (a real pointer click), or, failing that, by a queued
+     *  microtask fallback (a keyboard Enter/Space activation, which -- unlike a native `<button>` --
+     *  never dispatches a synthetic `click` on a `role="button"` SVG/canvas element). */
+    private pendingNodeId?;
+    /** The exact rendered `[part="node"]` element resolved for the currently-open popover
+     *  (`renderer="svg"`, direct-click path only) -- re-read on every `lr-viewport-change` so the
+     *  popover keeps tracking a pan/zoom gesture or simulation tick while it stays open. */
+    private trackedNodeEl?;
+    protected willUpdate(changed: PropertyValues): void;
+    private nodeLabel;
+    private degreeOf;
+    private entityFor;
+    private communityLabelFor;
+    private neighborRowsFor;
+    private matchingNodes;
+    private neighborIdsOf;
+    /** The same key derivation `lr-graph`'s own (private) `linkKey()` uses for `dimmedLinkIds` --
+     *  an explicit `id` when the link has one, else `source->target`. */
+    private linkKey;
+    /** Non-matching nodes while searching; otherwise everything outside the focus node's immediate
+     *  neighborhood (the selected node, or -- while `highlight === 'hover'` -- the hovered node when
+     *  nothing is selected); otherwise nothing while `highlight === 'none'`. Wires the search/
+     *  selection/hover state this component owns into `lr-graph`'s existing `dimmedNodeIds` contract
+     *  instead of introducing a parallel highlighting mechanism. */
+    private get computedDimmedNodeIds();
+    /** The link-side mirror of `computedDimmedNodeIds` -- a link is dimmed whenever either endpoint
+     *  is, so unrelated edges dim along with unrelated nodes with no extra host wiring. */
+    private get computedDimmedLinkIds();
+    private togglePin;
+    private requestPath;
+    private onVisibilityChange;
+    private onSearchInput;
+    private onEntityActivate;
+    /** Selects `id` and opens its details popover without a click event to read a rect from --
+     *  centers the node via the public `lr-graph.focusNode()`, then anchors at the graph element's
+     *  own viewport rect center once that settles. Shared by search results, neighbor rows,
+     *  path-strip elements, `lr-entity-card`'s own built-in focus button, and the keyboard-Enter/
+     *  Space fallback for a direct graph node activation. */
+    private activateEntity;
+    private openDetailAt;
+    /** Resolves the viewport rect for a direct pointer click on a graph node -- see the class doc's
+     *  "how the details popover finds its viewport position" note for the full reasoning. */
+    private resolveDirectClickAnchor;
+    private onGraphNodeClick;
+    private onGraphNativeClick;
+    /** Re-anchors the open details popover to `trackedNodeEl`'s current rect -- wired to the
+     *  composed `lr-graph`'s `lr-viewport-change` (see the class doc's anchoring note). A no-op
+     *  whenever there's nothing to track (`renderer="canvas"`, a non-direct-click selection, or the
+     *  popover isn't open), so this never schedules work of its own; it only reacts to `lr-graph`'s
+     *  already frame-coalesced signal. */
+    private onGraphViewportChange;
+    private onGraphNodeEnter;
+    private onGraphNodeLeave;
+    private onPopoverHide;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lr-knowledge-graph-explorer': LyraKnowledgeGraphExplorer;
+    }
+}
+//# sourceMappingURL=knowledge-graph-explorer.class.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph-explorer.class.d.ts","sourceRoot":"","sources":["../../../../src/components/retrieval/knowledge-graph-explorer/knowledge-graph-explorer.class.ts"],"names":[],"mappings":"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"}