@aceshooting/lyra-ui 29.0.2 → 29.1.0

package/dist/components/retrieval/graph/graph-spatial.js

@@ -1 +1 @@
-import{finiteRange}from"../../../internal/numbers.js";import{getOwnDataDescriptor}from"../../../internal/data-descriptors.js";import{graphLinkIdentity}from"./graph-model.js";const WORLD_LIMIT=1e6,CAMERA_LIMIT=WORLD_LIMIT*10,EDGE_SEGMENTS=16,FIELD_OF_VIEW=Math.PI/4,NO_POSITION=Object.freeze({x:0,y:0,z:0});function own(value,key){if(value===null||typeof value!="object")return;const descriptor=getOwnDataDescriptor(value,key);return typeof descriptor=="object"?descriptor.value:void 0}function coordinate(value,fallback){return finiteRange(typeof value=="number"?value:NaN,fallback,-WORLD_LIMIT,WORLD_LIMIT)}function positionValue(value){const x=own(value,"x"),y=own(value,"y"),z=own(value,"z");if([x,y,z].every(entry=>typeof entry=="number"&&Number.isFinite(entry)))return Object.freeze({x:coordinate(x,0),y:coordinate(y,0),z:coordinate(z,0)})}function normalizeGraphCamera(value,fallback){const yaw=own(value,"yaw"),pitch=own(value,"pitch"),distance=own(value,"distance");return Object.freeze({yaw:finiteRange(typeof yaw=="number"?yaw:NaN,fallback.yaw,-CAMERA_LIMIT,CAMERA_LIMIT)%(Math.PI*2),pitch:finiteRange(typeof pitch=="number"?pitch:NaN,fallback.pitch,-Math.PI/2+.01,Math.PI/2-.01),distance:finiteRange(typeof distance=="number"?distance:NaN,fallback.distance,.01,CAMERA_LIMIT),target:positionValue(own(value,"target"))??Object.freeze({...fallback.target})})}function spatialNodePosition(node){const explicit=positionValue(own(node,"position"));if(explicit)return explicit;let hash=2166136261;for(const character of node.id)hash=Math.imul(hash^character.charCodeAt(0),16777619);const latitude=(hash>>>0)/4294967296*2-1,angle=(Math.imul(hash,2246822519)>>>0)/4294967296*Math.PI*2,radius=120+(hash>>>8)%81,ring=Math.sqrt(Math.max(0,1-latitude*latitude));return Object.freeze({x:radius*ring*Math.cos(angle),y:radius*latitude,z:radius*ring*Math.sin(angle)})}function cameraPoint(point,camera){const dx=point.x-camera.target.x,dy=point.y-camera.target.y,dz=point.z-camera.target.z,x=Math.cos(camera.yaw)*dx-Math.sin(camera.yaw)*dz,z=Math.sin(camera.yaw)*dx+Math.cos(camera.yaw)*dz;return{x,y:Math.cos(camera.pitch)*dy-Math.sin(camera.pitch)*z,z:camera.distance-(Math.sin(camera.pitch)*dy+Math.cos(camera.pitch)*z)}}function perspective(point,viewport){const scale=viewport.height/(2*Math.tan(FIELD_OF_VIEW/2)*point.z);return{x:viewport.width/2+point.x*scale,y:viewport.height/2+point.y*scale,depth:point.z,scale}}function nearPlane(camera){return Math.max(.01,camera.distance*1e-4)}function projectSpatialPoint(point,camera,viewport){const transformed=cameraPoint(point,camera);return transformed.z<nearPlane(camera)?void 0:perspective(transformed,viewport)}function fittedGraphCamera(nodes,viewport,padding=24){if(!nodes.length)return normalizeGraphCamera(void 0,{yaw:0,pitch:0,distance:500,target:NO_POSITION});let minX=1/0,minY=1/0,minZ=1/0,maxX=-1/0,maxY=-1/0,maxZ=-1/0;for(const{position:p,radius:radius2}of nodes)minX=Math.min(minX,p.x-radius2),maxX=Math.max(maxX,p.x+radius2),minY=Math.min(minY,p.y-radius2),maxY=Math.max(maxY,p.y+radius2),minZ=Math.min(minZ,p.z-radius2),maxZ=Math.max(maxZ,p.z+radius2);const target={x:(minX+maxX)/2,y:(minY+maxY)/2,z:(minZ+maxZ)/2},radius=Math.max(1,Math.hypot(maxX-minX,maxY-minY,maxZ-minZ)/2),safePadding=finiteRange(padding,24,0,Math.min(viewport.width,viewport.height)*.45),aspect=Math.min((viewport.width-2*safePadding)/viewport.height,(viewport.height-2*safePadding)/viewport.height),angle=Math.atan(Math.tan(FIELD_OF_VIEW/2)*Math.max(.01,aspect));return normalizeGraphCamera({yaw:0,pitch:0,distance:radius/Math.sin(angle),target},{yaw:0,pitch:0,distance:500,target:NO_POSITION})}function interpolate(a,b,t){return{x:a.x+(b.x-a.x)*t,y:a.y+(b.y-a.y)*t,z:a.z+(b.z-a.z)*t}}function projectSpatialScene(nodes,edges,camera,viewport){const byId=new Map(nodes.map(node=>[node.node.id,node])),projected=[],segments=[],primitives=[];for(const node of nodes){const point=projectSpatialPoint(node.position,camera,viewport);if(!point)continue;const entry={...node,...point,screenRadius:Math.min(Math.max(viewport.width,viewport.height)*2,node.radius*point.scale)};projected.push(entry),primitives.push({kind:"node",value:entry,depth:entry.depth})}for(const edge of edges){if(finiteRange(edge.width??1.5,1.5,0)===0)continue;const source=byId.get(edge.source);if(!source)continue;const target=byId.get(edge.target),self=edge.source===edge.target,end=target?.position??{x:source.position.x+28,y:source.position.y-28,z:source.position.z};let offset=0;for(let index=0;index<EDGE_SEGMENTS;index++){const at=t=>self?{x:source.position.x+Math.sin(t*Math.PI*2)*source.radius*1.6,y:source.position.y-(1-Math.cos(t*Math.PI*2))*source.radius*1.6,z:source.position.z}:interpolate(source.position,end,t);let a=cameraPoint(at(index/EDGE_SEGMENTS),camera),b=cameraPoint(at((index+1)/EDGE_SEGMENTS),camera);const near=nearPlane(camera);if(a.z<near&&b.z<near)continue;a.z<near&&(a=interpolate(a,b,(near-a.z)/(b.z-a.z))),b.z<near&&(b=interpolate(b,a,(near-b.z)/(a.z-b.z)));const entry={edge,id:graphLinkIdentity(edge),a:perspective(a,viewport),b:perspective(b,viewport),depth:(a.z+b.z)/2,last:index===EDGE_SEGMENTS-1,middle:index===EDGE_SEGMENTS/2,dangling:!target,offset};offset+=Math.hypot(entry.b.x-entry.a.x,entry.b.y-entry.a.y),segments.push(entry),primitives.push({kind:"link",value:entry,depth:entry.depth})}}return primitives.sort((a,b)=>b.depth-a.depth||(a.kind===b.kind?0:a.kind==="link"?-1:1)),{nodes:projected,segments,primitives}}function pickSpatialScene(scene,x,y){let result,nearest=1/0;for(const node of scene.nodes){const dx=Math.abs(x-node.x),dy=Math.abs(y-node.y),r=Math.max(12,node.screenRadius);(node.shape==="square"?Math.max(dx,dy)<=Math.max(12,node.screenRadius*Math.sqrt(Math.PI)/2):node.shape==="diamond"?dx+dy<=r*Math.sqrt(Math.PI/2):Math.hypot(dx,dy)<=r)&&node.depth<=nearest&&(nearest=node.depth,result={kind:"node",id:node.node.id,node:node.node})}for(const segment of scene.segments){if(segment.dangling)continue;const dx=segment.b.x-segment.a.x,dy=segment.b.y-segment.a.y,t=Math.min(1,Math.max(0,((x-segment.a.x)*dx+(y-segment.a.y)*dy)/(dx*dx+dy*dy||1))),depth=1/((1-t)/segment.a.depth+t/segment.b.depth),width=finiteRange(segment.edge.width??1.5,1.5,0,1e3);Math.hypot(x-segment.a.x-dx*t,y-segment.a.y-dy*t)<=Math.max(6,width/2)&&(depth<nearest-.001||result?.kind==="link"&&depth===nearest)&&(nearest=depth,result={kind:"link",id:segment.id,edge:segment.edge})}return result}function panGraphCamera(camera,dx,dy,viewport){const units=2*camera.distance*Math.tan(FIELD_OF_VIEW/2)/viewport.height,sy=Math.sin(camera.yaw),cy=Math.cos(camera.yaw),sp=Math.sin(camera.pitch),cp=Math.cos(camera.pitch);return normalizeGraphCamera({...camera,target:{x:camera.target.x-units*(cy*dx+sy*sp*dy),y:camera.target.y-units*cp*dy,z:camera.target.z-units*(-sy*dx+cy*sp*dy)}},camera)}export{fittedGraphCamera,normalizeGraphCamera,panGraphCamera,pickSpatialScene,projectSpatialPoint,projectSpatialScene,spatialNodePosition};
+import{finiteRange}from"../../../internal/numbers.js";import{normalizeGraphCamera}from"./graph-spatial-model.js";import{normalizeGraphCamera as normalizeGraphCamera2,spatialNodePosition}from"./graph-spatial-model.js";import{graphLinkIdentity}from"./graph-model.js";const EDGE_SEGMENTS=16,FIELD_OF_VIEW=Math.PI/4,NO_POSITION=Object.freeze({x:0,y:0,z:0});function cameraPoint(point,camera){const dx=point.x-camera.target.x,dy=point.y-camera.target.y,dz=point.z-camera.target.z,x=Math.cos(camera.yaw)*dx-Math.sin(camera.yaw)*dz,z=Math.sin(camera.yaw)*dx+Math.cos(camera.yaw)*dz;return{x,y:Math.cos(camera.pitch)*dy-Math.sin(camera.pitch)*z,z:camera.distance-(Math.sin(camera.pitch)*dy+Math.cos(camera.pitch)*z)}}function perspective(point,viewport){const scale=viewport.height/(2*Math.tan(FIELD_OF_VIEW/2)*point.z);return{x:viewport.width/2+point.x*scale,y:viewport.height/2+point.y*scale,depth:point.z,scale}}function nearPlane(camera){return Math.max(.01,camera.distance*1e-4)}function projectSpatialPoint(point,camera,viewport){const transformed=cameraPoint(point,camera);return transformed.z<nearPlane(camera)?void 0:perspective(transformed,viewport)}function fittedGraphCamera(nodes,viewport,padding=24){if(!nodes.length)return normalizeGraphCamera(void 0,{yaw:0,pitch:0,distance:500,target:NO_POSITION});let minX=1/0,minY=1/0,minZ=1/0,maxX=-1/0,maxY=-1/0,maxZ=-1/0;for(const{position:p,radius:radius2}of nodes)minX=Math.min(minX,p.x-radius2),maxX=Math.max(maxX,p.x+radius2),minY=Math.min(minY,p.y-radius2),maxY=Math.max(maxY,p.y+radius2),minZ=Math.min(minZ,p.z-radius2),maxZ=Math.max(maxZ,p.z+radius2);const target={x:(minX+maxX)/2,y:(minY+maxY)/2,z:(minZ+maxZ)/2},radius=Math.max(1,Math.hypot(maxX-minX,maxY-minY,maxZ-minZ)/2),safePadding=finiteRange(padding,24,0,Math.min(viewport.width,viewport.height)*.45),aspect=Math.min((viewport.width-2*safePadding)/viewport.height,(viewport.height-2*safePadding)/viewport.height),angle=Math.atan(Math.tan(FIELD_OF_VIEW/2)*Math.max(.01,aspect));return normalizeGraphCamera({yaw:0,pitch:0,distance:radius/Math.sin(angle),target},{yaw:0,pitch:0,distance:500,target:NO_POSITION})}function interpolate(a,b,t){return{x:a.x+(b.x-a.x)*t,y:a.y+(b.y-a.y)*t,z:a.z+(b.z-a.z)*t}}class SpatialProjectionWorkspace{constructor(){this.bytes=new Uint8Array(0),this.source=new Uint32Array(0),this.target=new Uint32Array(0),this.counts=new Uint32Array(256)}order(primitives){const length=primitives.length;if(primitives.some(entry=>!Number.isFinite(entry.depth)||entry.depth<=0))return primitives.sort((a,b)=>b.depth-a.depth||(a.kind===b.kind?0:a.kind==="link"?-1:1));if(this.source.length<length){const capacity=2**Math.ceil(Math.log2(Math.max(1,length)));this.source=new Uint32Array(capacity),this.target=new Uint32Array(capacity),this.bytes=new Uint8Array(capacity*8)}const depths=new DataView(this.bytes.buffer);let index=0;for(let i=0;i<length;i++)primitives[i].kind==="link"&&(this.source[index++]=i);for(let i=0;i<length;i++)primitives[i].kind==="node"&&(this.source[index++]=i);for(let i=0;i<length;i++)depths.setFloat64(i*8,primitives[i].depth,!0);for(let byte=0;byte<8;byte++){this.counts.fill(0);for(let i=0;i<length;i++)this.counts[this.bytes[this.source[i]*8+byte]]++;let offset=0;for(let value=255;value>=0;value--){const count=this.counts[value];this.counts[value]=offset,offset+=count}for(let i=0;i<length;i++){const entry=this.source[i];this.target[this.counts[this.bytes[entry*8+byte]]++]=entry}[this.source,this.target]=[this.target,this.source]}return Array.from({length},(_,i)=>primitives[this.source[i]])}}function projectSpatialScene(nodes,edges,camera,viewport,workspace=new SpatialProjectionWorkspace){const byId=new Map(nodes.map(node=>[node.node.id,node])),projected=[],segments=[],primitives=[];for(const node of nodes){const point=projectSpatialPoint(node.position,camera,viewport);if(!point)continue;const entry={...node,...point,screenRadius:Math.min(Math.max(viewport.width,viewport.height)*2,node.radius*point.scale)};projected.push(entry),primitives.push({kind:"node",value:entry,depth:entry.depth})}for(const edge of edges){if(finiteRange(edge.width??1.5,1.5,0)===0)continue;const source=byId.get(edge.source);if(!source)continue;const target=byId.get(edge.target),self=edge.source===edge.target,end=target?.position??{x:source.position.x+28,y:source.position.y-28,z:source.position.z},sourceDepth=cameraPoint(source.position,camera).z,targetDepth=cameraPoint(end,camera).z,count=self?EDGE_SEGMENTS:Math.max(1,Math.min(EDGE_SEGMENTS,Math.ceil(Math.abs(sourceDepth-targetDepth)/Math.max(1,Math.min(sourceDepth,targetDepth)/EDGE_SEGMENTS)))),at=t=>self?{x:source.position.x+Math.sin(t*Math.PI*2)*source.radius*1.6,y:source.position.y-(1-Math.cos(t*Math.PI*2))*source.radius*1.6,z:source.position.z}:interpolate(source.position,end,t),midpoint=projectSpatialPoint(at(.5),camera,viewport);let offset=0;for(let index=0;index<count;index++){let a=cameraPoint(at(index/count),camera),b=cameraPoint(at((index+1)/count),camera);const near=nearPlane(camera);if(a.z<near&&b.z<near)continue;a.z<near&&(a=interpolate(a,b,(near-a.z)/(b.z-a.z))),b.z<near&&(b=interpolate(b,a,(near-b.z)/(a.z-b.z)));const entry={edge,id:graphLinkIdentity(edge),a:perspective(a,viewport),b:perspective(b,viewport),depth:(a.z+b.z)/2,last:index===count-1,middle:index===Math.floor(count/2)&&midpoint!==void 0,labelPoint:index===Math.floor(count/2)?midpoint:void 0,dangling:!target,offset};offset+=Math.hypot(entry.b.x-entry.a.x,entry.b.y-entry.a.y),segments.push(entry),primitives.push({kind:"link",value:entry,depth:entry.depth})}}return{nodes:projected,segments,primitives:workspace.order(primitives)}}function pickSpatialScene(scene,x,y){let result,nearest=1/0;for(const node of scene.nodes){const dx=Math.abs(x-node.x),dy=Math.abs(y-node.y),r=Math.max(12,node.screenRadius);(node.shape==="square"?Math.max(dx,dy)<=Math.max(12,node.screenRadius*Math.sqrt(Math.PI)/2):node.shape==="diamond"?dx+dy<=r*Math.sqrt(Math.PI/2):Math.hypot(dx,dy)<=r)&&node.depth<=nearest&&(nearest=node.depth,result={kind:"node",id:node.node.id,node:node.node})}for(const segment of scene.segments){if(segment.dangling)continue;const dx=segment.b.x-segment.a.x,dy=segment.b.y-segment.a.y,t=Math.min(1,Math.max(0,((x-segment.a.x)*dx+(y-segment.a.y)*dy)/(dx*dx+dy*dy||1))),depth=1/((1-t)/segment.a.depth+t/segment.b.depth),width=finiteRange(segment.edge.width??1.5,1.5,0,1e3);Math.hypot(x-segment.a.x-dx*t,y-segment.a.y-dy*t)<=Math.max(6,width/2)&&(depth<nearest-.001||result?.kind==="link"&&depth===nearest)&&(nearest=depth,result={kind:"link",id:segment.id,edge:segment.edge})}return result}class SpatialHitIndex{constructor(scene){this.scene=scene,this.cells=new Map,this.wide={nodes:[],segments:[]},scene.nodes.forEach((node,index)=>{const radius=Math.max(16,node.screenRadius*Math.SQRT2);this.insert("nodes",index,node.x-radius,node.y-radius,node.x+radius,node.y+radius)}),scene.segments.forEach((segment,index)=>{if(segment.dangling)return;const radius=Math.max(6,finiteRange(segment.edge.width??1.5,1.5,0,1e3)/2);this.insert("segments",index,Math.min(segment.a.x,segment.b.x)-radius,Math.min(segment.a.y,segment.b.y)-radius,Math.max(segment.a.x,segment.b.x)+radius,Math.max(segment.a.y,segment.b.y)+radius)})}insert(kind,index,left,top,right,bottom){const x1=Math.floor(left/64),y1=Math.floor(top/64),x2=Math.floor(right/64),y2=Math.floor(bottom/64);if(![x1,y1,x2,y2].every(Number.isFinite)||(x2-x1+1)*(y2-y1+1)>64){this.wide[kind].push(index);return}for(let x=x1;x<=x2;x++)for(let y=y1;y<=y2;y++){const key=`${x},${y}`;let cell=this.cells.get(key);cell||(cell={nodes:[],segments:[]},this.cells.set(key,cell)),cell[kind].push(index)}}hit(x,y){const cell=this.cells.get(`${Math.floor(x/64)},${Math.floor(y/64)}`),merge=(a,b)=>{const indexes=[];let i=0,j=0;for(;i<a.length||j<b.length;)indexes.push(j>=b.length||i<a.length&&a[i]<b[j]?a[i++]:b[j++]);return indexes};return pickSpatialScene({nodes:merge(cell?.nodes??[],this.wide.nodes).map(index=>this.scene.nodes[index]),segments:merge(cell?.segments??[],this.wide.segments).map(index=>this.scene.segments[index]),primitives:[]},x,y)}}function panGraphCamera(camera,dx,dy,viewport){const units=2*camera.distance*Math.tan(FIELD_OF_VIEW/2)/viewport.height,sy=Math.sin(camera.yaw),cy=Math.cos(camera.yaw),sp=Math.sin(camera.pitch),cp=Math.cos(camera.pitch);return normalizeGraphCamera({...camera,target:{x:camera.target.x-units*(cy*dx+sy*sp*dy),y:camera.target.y-units*cp*dy,z:camera.target.z-units*(-sy*dx+cy*sp*dy)}},camera)}export{SpatialHitIndex,SpatialProjectionWorkspace,fittedGraphCamera,normalizeGraphCamera2 as normalizeGraphCamera,panGraphCamera,pickSpatialScene,projectSpatialPoint,projectSpatialScene,spatialNodePosition};

package/dist/components/retrieval/graph/graph.class.d.ts

@@ -1,4 +1,6 @@
-import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';import{type TemplateResult,type PropertyValues}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,type LyraGraphPosition,type LyraGraphView,type LyraGraphCommunity,type LyraGraphEdge,type LyraGraphNode}from'./graph-model.js';export type{LyraGraphCamera,LyraGraphPosition,LyraGraphView,LyraGraphCommunity,LyraGraphEdge,LyraGraphNode,}from'./graph-model.js';import'../../overlays/skeleton/skeleton.class.js';export type LyraGraphLayout='force'|'layered';export type LyraGraphRenderer='svg'|'canvas';export type LyraGraphSelectionMode='none'|'single'|'multiple';export type LyraGraphPickKind='node'|'link';
+import type{LyraGraphSource}from'../../../data-sources.js';import'../../data/pagination/pagination.class.js';import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';import{type TemplateResult,type PropertyValues}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,type LyraGraphPosition,type LyraGraphView,type LyraGraphCommunity,type LyraGraphEdge,type LyraGraphNode}from'./graph-model.js';export type{LyraGraphCamera,LyraGraphPosition,LyraGraphView,LyraGraphCommunity,LyraGraphEdge,LyraGraphNode,}from'./graph-model.js';import'../../overlays/skeleton/skeleton.class.js';
+/** Complete host-owned node/edge catalog with bounded graph scenes. Source edges require stable IDs. */
+export type GraphSource=LyraGraphSource<LyraGraphNode,LyraGraphEdge&{readonly id:string;}>;export type LyraGraphLayout='force'|'layered';export type LyraGraphRenderer='svg'|'canvas';export type LyraGraphSelectionMode='none'|'single'|'multiple';export type LyraGraphPickKind='node'|'link';
 /** See `nodeLabels`'s own doc for the per-renderer default when unset. */
 export type LyraGraphNodeLabelsMode='always'|'zoom'|'none';
 /** See `fitTo`'s own doc. `'none'` keeps the numeric `width`/`height` as the drawing space;
@@ -66,6 +68,15 @@ export type LyraGraphFit='none'|'container';export type{LyraScoreThresholds}from
 * Public collection properties take bounded, clone-owned readonly snapshots. Create a new
 * collection and reassign it after changes; mutating the assigned array does not update the view.
 *
+* Source mode uses a global paged node/edge navigator beside a bounded diagram. Its complete
+* logical totals come from the provider; neighborhood/summary coverage is disclosed separately.
+* fit() frames the current scene, not the full source. Dragging changes local layout only.
+* Removing graphSource restores the current legacy arrays without modifying their getters.
+* @csspart source-navigator - Global node/edge query, record list and pagination.
+* @csspart source-row - A mounted global record activation button.
+* @csspart source-row-active - The record holding the navigator's roving tab stop.
+* @csspart source-status - Source loading, unavailable-record, and error text.
+* @csspart source-coverage - Full-source totals and current diagram coverage.
 * @customElement lr-graph
 * Empty/blank node, link, node-type, and community identities are omitted, and later duplicate
 * effective identities are first-wins before layout, keyed DOM, selection, focus, or events.
@@ -171,7 +182,21 @@ export type LyraGraphFit='none'|'container';export type{LyraScoreThresholds}from
 * @status stable
 * @since 4.0.0
 */
-export declare class LyraGraph extends LyraElement<LyraGraphEventMap>{protected static collectionSupport:import("../../../internal/lyra-element.js").LyraCollectionSupport;protected static readonly ownedCollectionProperties:readonly string[];static get observedAttributes():string[];static styles:import("lit").CSSResultGroup[];protected static readonly immutableEventDetails:readonly string[];
+export declare class LyraGraph extends LyraElement<LyraGraphEventMap>{protected static collectionSupport:import("../../../internal/lyra-element.js").LyraCollectionSupport;protected static readonly identityCollectionObjectProperties:readonly string[];protected static readonly ownedCollectionProperties:readonly string[];static get observedAttributes():string[];static styles:import("lit").CSSResultGroup[];protected static readonly immutableEventDetails:readonly string[];private _graphSource?;private sourceEpoch;private sourceNavigation;private sourceSyncing;private sourceInputs?;private sourcePageInputs?;private sourceBindingError?;private sourceQuery;private sourceCenter;private sourceKeys;private sourceModel?;private sourceModelScene?;private sourceMissing;private sourceRovingKey?;private sourceRestoreFocus;private sourceRestorePager;private sourcePagePromise;private sourceState;private sourceModelVersion;private sourcePaint;private readonly sourceScene;private readonly sourcePages;private compositionPublished?;private readonly sourceComposition;private publishSourceComposition;
+/** Full host-owned graph. Node keys are node:<id>; edge keys are edge:<id> with explicit edge IDs.
+* Takes precedence over nodes/edges; undefined restores legacy arrays. Reassign even the same
+* source or call requestUpdate() to refresh. Records are paged globally; diagrams retain at
+* most 500 nodes and 1,000 edges, with up to 32 reserved active/focused keys. */
+get graphSource():GraphSource|undefined;set graphSource(value:GraphSource|undefined);
+/** Zero-based global records page. Applies only with graphSource. */
+sourcePage:number;
+/** Records per source page, normalized to 1..500. Changing size resets sourcePage to zero. */
+sourcePageSize:number;
+/** Exact total for the active node/edge query, or null before a successful current response. */
+get sourceTotal():number|null;private get sourceMode();private get sourceList();private get sourceRows();private get sourceDiagramBlocked();private paintGraph;private assertSourceTotals;private syncGraphSource;private sourceAuthority;private setSourceQuery;
+/** Reveal and focus a canonical node:<id> or edge:<id> row in the global navigator. Clears
+* query filters, uses provider locate, and never selects or activates the record. */
+revealSourceKey(key:string):Promise<boolean>;private revealSourceRecord;private ensureSourceScene;private activateSourceRecord;private onSourceRowKey;private renderSourceNavigator;
 /** Readonly nodes in the controlled graph model. Node ids provide stable render and interaction identity. */
 nodes:readonly LyraGraphNode[];
 /** Directed or undirected connections between node ids in `nodes`. */
@@ -293,18 +318,18 @@ selectedEdgeIds:readonly string[];
 dimmedNodeIds:readonly string[];
 /** Same contract as `dimmedNodeIds`, for edges. An edge's dimming key is the same `linkKey()`
 *  value (`LyraGraphEdge.id`, else `` `${source}->${target}` ``) `selectedEdgeIds` already uses. */
-dimmedEdgeIds:readonly string[];private readonly arrowMarkerId;private loading;private loadFailed;private loadLibrary;private loadGeneration;private containerSize;private simNodes;private simLinks;private simNodeById;private danglingLinks;private lastPositionById;private lastHiddenNodeCount;private activeGraphItem;private graphLiveText;private readonly announcements;private graphAnnouncementsReady;private pendingGraphItemFocus;private isMounting;private authorRole;private syncingGraphHostRole;private simulation?;private chargeForce?;private linkForce?;private d3?;private detachedGraphChanges;private zoomedEl?;private gEl?;private zoomBehavior?;private boundNodeEls;private nodeEls;private nodeHitEls;private nodeLabelEls;private expandIndicatorEls;private lastKeyActivateIndex;private lastKeyActivateTime;private lastActivation?;private lastAppliedFocusNodeId;private focusHaloEl?;private communityHullEls;private communityHullHitEls;private communityLabelEls;private canvasEl?;private canvasCtx?;private pickCanvas?;private pickCtx?;private hostResizeObserver?;private hostResizeObserverDocument?;private canvasDprQuery?;private canvasDrawRafId?;private canvasDrawRafOwner?;private visible;private intersectionObserver?;private canvasDrawPending;private pickDirty;private canvasCamera;private canvasTooltipEl?;private pickItems;private canvasDragNode?;private canvasPointerId?;private canvasPointerDownAt?;private canvasPointerDownId?;private pendingHover?;private canvasHover?;private hoverRafId?;private hoverRafOwner?;private svgHoverNodeId?;private canvasScene?;private canvasSceneHasEdgeLabels;private cameraTweenId?;private cameraTweenFrameOwner?;private cameraTweenResolve?;private isCameraTweening;private viewportChangeRafId?;private viewportChangeRafOwner?;private linkEls;private linkHitEls;private linkLabelEls;private linkLabelHiddenByLength;private edgeLabelWidthCache;private danglingLinkEls;private edgeLabelMeasureCanvas?;private edgeLabelMeasureCtx?;private linkPaintProbe?;private readonly linkPaintVisibilityCache;private readonly resolvedCssColorCache;private reducedMotion;private readonly spatial;private spatialMessages;constructor();attributeChangedCallback(name:string,oldValue:string|null,value:string|null):void;private hostOwnsGraphSemantics;private syncGraphHostRole;private get ownerWindow();private computedStyle;connectedCallback():void;private connect2d;disconnectedCallback():void;adoptedCallback():void;private scheduleViewportChange;private nodeRadius;private safeLinkWidth;private isInteractiveLink;private navigableLinksCache?;private navigableLinks;private lengthInPixels;private get requestedWidth();private get requestedHeight();private get safeWidth();private get safeHeight();private recordContainerSize;private measureHostBox;private syncRequestedHeightVar;private get safeMinZoom();private get safeMaxZoom();private get effectiveZoomBounds();private get safeEdgeLabelMinZoom();private get resolvedNodeLabelsMode();private canvasNodeLabelsVisible;private get safeSeed();private get safeChargeStrength();private get safeLinkDistance();private nodeTypeIndex?;private nodeTypeEntry;private resolveNodeType;private nodeShape;private labeledNodeTypes;private nodeFill;private visibleNodes;private resolveLinksAgainst;private communityMembers;private visibleCommunitiesCache?;private visibleCommunities;private communityHull;private onCommunityClick;private cameraTransitionMs;private cancelCameraTween;private isApplyingZoomTransform;private applyZoomTransform;private tweenCamera;
+dimmedEdgeIds:readonly string[];private readonly arrowMarkerId;private loading;private loadFailed;private loadLibrary;private loadGeneration;private containerSize;private simNodes;private simLinks;private simNodeById;private danglingLinks;private lastPositionById;private lastHiddenNodeCount;private activeGraphItem;private graphLiveText;private readonly announcements;private graphAnnouncementsReady;private pendingGraphItemFocus;private isMounting;private authorRole;private syncingGraphHostRole;private simulation?;private chargeForce?;private linkForce?;private d3?;private detachedGraphChanges;private zoomedEl?;private gEl?;private zoomBehavior?;private boundNodeEls;private nodeEls;private nodeHitEls;private nodeLabelEls;private expandIndicatorEls;private lastKeyActivateIndex;private lastKeyActivateTime;private lastActivation?;private lastAppliedFocusNodeId;private focusHaloEl?;private communityHullEls;private communityHullHitEls;private communityLabelEls;private canvasEl?;private canvasCtx?;private pickCanvas?;private pickCtx?;private hostResizeObserver?;private hostResizeObserverDocument?;private canvasDprQuery?;private canvasDrawRafId?;private canvasDrawRafOwner?;private visible;private intersectionObserver?;private canvasDrawPending;private pickDirty;private canvasCamera;private canvasTooltipEl?;private pickItems;private canvasDragNode?;private canvasPointerId?;private canvasDragFrame?;private canvasDragFrameOwner?;private canvasDragGeneration;private pendingCanvasDrag?;private canvasPointerDownAt?;private canvasPointerDownId?;private pendingHover?;private canvasHover?;private hoverRafId?;private hoverRafOwner?;private svgHoverNodeId?;private canvasScene?;private canvasSceneHasEdgeLabels;private cameraTweenId?;private cameraTweenFrameOwner?;private cameraTweenResolve?;private isCameraTweening;private viewportChangeRafId?;private viewportChangeRafOwner?;private linkEls;private linkHitEls;private linkLabelEls;private linkLabelHiddenByLength;private edgeLabelWidthCache;private danglingLinkEls;private edgeLabelMeasureCanvas?;private edgeLabelMeasureCtx?;private linkPaintProbe?;private readonly linkPaintVisibilityCache;private readonly resolvedCssColorCache;private reducedMotion;private spatial?;private spatialLoad?;private spatialGeneration;private layeredEngine?;private layeredLoad?;private layeredGeneration;private optionalLoadFailure?;private d3LoadFailed;private loadSpatialController;private loadLayeredLayout;private ensureSpatial;private ensureLayered;protected getUpdateComplete():Promise<boolean>;private createSpatial;private spatialMessages;constructor();attributeChangedCallback(name:string,oldValue:string|null,value:string|null):void;private hostOwnsGraphSemantics;private syncGraphHostRole;private get ownerWindow();private computedStyle;connectedCallback():void;private setGraphVisibility;private connect2d;disconnectedCallback():void;adoptedCallback():void;private scheduleViewportChange;private nodeRadius;private safeLinkWidth;private isInteractiveLink;private navigableLinksCache?;private navigableLinks;private lengthInPixels;private get requestedWidth();private get requestedHeight();private get safeWidth();private get safeHeight();private recordContainerSize;private measureHostBox;private syncRequestedHeightVar;private get safeMinZoom();private get safeMaxZoom();private get effectiveZoomBounds();private get safeEdgeLabelMinZoom();private get resolvedNodeLabelsMode();private canvasNodeLabelsVisible;private get safeSeed();private get safeChargeStrength();private get safeLinkDistance();private nodeTypeIndex?;private nodeTypeEntry;private resolveNodeType;private nodeShape;private labeledNodeTypes;private nodeFill;private visibleNodes;private resolveLinksAgainst;private visibleCommunitiesCache?;private visibleCommunities;private communityHull;private onCommunityClick;private cameraTransitionMs;private cancelCameraTween;private isApplyingZoomTransform;private applyZoomTransform;private tweenCamera;
 /** Animates the camera so `id` centers in the viewport (the `width` x `height` viewBox), at
 *  `options.zoom` (clamped to `[minZoom, maxZoom]`) or the current scale when omitted. Resolves
 *  `true` on arrival; `false` for an id with no matching entry in `simNodes` -- there's nothing
 *  to center on. Announces `graphNodeFocused` through the shared light-DOM sink. Does not move DOM
 *  focus -- this is a camera operation, not a roving-focus one. */
-focusNode(id:string,options?:{zoom?:number;}):Promise<boolean>;
+focusNode(id:string,options?:{zoom?:number;}):Promise<boolean>;private focusSceneNode;
 /** Animates the camera to frame the bounding box of every currently visible node position (plus
 *  each node's own radius) at the largest scale that fits within `width` x `height` minus
 *  `padding` viewport-px on each side (clamped to `[minZoom, maxZoom]`). Silent -- no data
 *  changed, so no announcement. A no-op with no visible nodes. */
-fit(options?:{padding?:number;}):void;private updateFocusHalo;private setUpCanvasSurface;private ensureCanvasOwnerRealm;private syncHostResizeObserver;private watchHostResize;private watchCanvasDpr;private onCanvasDprChange;private markCanvasDirty;private markCanvasCameraDirty;private scheduleCanvasDraw;private resolveCssColorWithProbe;private createCanvasColorProbe;private withCanvasColorResolver;private buildCanvasScene;private updateCanvasFocus;private drawCanvas;private rebuildPickItems;private redrawPickCanvas;private hitTest;private bindCanvasZoom;private bindCanvasPointer;private onCanvasPointerDown;private onCanvasPointerMove;private simulationIsTicking;private onCanvasPointerUp;private finishCanvasNodeDrag;private takeCanvasPointerDown;private onCanvasPointerCancel;private onCanvasLostPointerCapture;private onCanvasPointerLeave;private canvasHoverSuppressed;private updateCanvasHover;private onCanvasDblClick;private nodeAtCanvasPoint;private updateCanvasTooltip;private isSelected;private paintedCurrent;private isDimmed;private linkKey;private emitSelectionIntent;private clearSelection;protected willUpdate(changed:PropertyValues):void;protected updated(changed:PropertyValues):void;private isDragging;private isPanning;private applyInteractions;private updateHitAreaZoomScale;private applyCanvasInteractions;private onTick;private rebuildSimulation;private announceHiddenNodeCount;private rebuildLayeredLayout;private onNodeClick;
+fit(options?:{padding?:number;}):void;private updateFocusHalo;private setUpCanvasSurface;private ensureCanvasOwnerRealm;private syncHostResizeObserver;private watchHostResize;private watchCanvasDpr;private onCanvasDprChange;private markCanvasDirty;private markCanvasCameraDirty;private scheduleCanvasDraw;private resolveCssColorWithProbe;private createCanvasColorProbe;private withCanvasColorResolver;private canvasNodesById;private canvasLinksById;private canvasLabelNodes;private canvasExpandableNodes;private refreshCanvasGeometry;private buildCanvasScene;private updateCanvasFocus;private drawCanvas;private rebuildPickItems;private redrawPickCanvas;private hitTest;private bindCanvasZoom;private bindCanvasPointer;private onCanvasPointerDown;private onCanvasPointerMove;private simulationIsTicking;private onCanvasPointerUp;private flushCanvasDrag;private finishCanvasNodeDrag;private takeCanvasPointerDown;private onCanvasPointerCancel;private onCanvasLostPointerCapture;private onCanvasPointerLeave;private canvasHoverSuppressed;private updateCanvasHover;private onCanvasDblClick;private nodeAtCanvasPoint;private updateCanvasTooltip;private isSelected;private paintedCurrent;private isDimmed;private linkKey;private emitSelectionIntent;private clearSelection;private explicitRefresh;private cursorUpdate;private paintUpdate;private svgTemplate?;private svgCursorItems;private svgCursorElement?;requestUpdate(...args:Parameters<LyraElement['requestUpdate']>):void;protected willUpdate(changed:PropertyValues):void;protected updated(changed:PropertyValues):void;private isDragging;private isPanning;private applyInteractions;private updateHitAreaZoomScale;private applyCanvasInteractions;private onTick;private rebuildSimulation;private announceHiddenNodeCount;private rebuildLayeredLayout;private selectionActionAuthority;private onNodeClick;
 /** Returns a node's current position in the graph's local drawing space. */
 getNodePosition(id:string):{x:number;y:number;}|undefined;
 /** World x/y/z in spatial/list view, or undefined for a missing/hidden node or view="2d".
@@ -313,4 +338,4 @@ getNodePosition3d(id:string):LyraGraphPosition|undefined;
 /** Projected CSS pixels relative to this element's border-box top-left. Undefined for list
 * view, missing/hidden nodes or a spatial point behind the near plane. Add the host's viewport
 * rect left/top to anchor a viewport-positioned overlay. This method does not move the camera. */
-getNodeScreenPosition(id:string):{x:number;y:number;}|undefined;private onLinkClick;private onNodeEnter;private onNodeLeave;private onNodeDblClick;private onLinkEnter;private linkHoverDetail;private onLinkLeave;private emitEdgeHover;private nodeAccessibleText;private boundedGraphText;private nodeTooltipText;private linkAccessibleText;private linkTooltipText;private linkCoordinates;private edgeLabelPosition;private edgeLabelFontPx;private edgeLabelContext;private edgeLabelWidth;private updateEdgeLabelZoomGate;private updateNodeLabelZoomGate;private linkIndexBase;private communityIndexBase;private graphItemCount;private normalizedGraphItem;private graphItemIdentity;private graphItemIndex;private communityText;private graphItemText;private graphItemAnnouncement;private onGraphItemFocus;private focusGraphItem;private focusGraphItemElement;private onGraphKeyDown;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-graph':LyraGraph;}}
+getNodeScreenPosition(id:string):{x:number;y:number;}|undefined;private onLinkClick;private onNodeEnter;private onNodeLeave;private onNodeDblClick;private onLinkEnter;private linkHoverDetail;private onLinkLeave;private emitEdgeHover;private nodeAccessibleText;private boundedGraphText;private nodeTooltipText;private linkAccessibleText;private linkTooltipText;private linkCoordinates;private edgeLabelPosition;private edgeLabelFontPx;private edgeLabelContext;private edgeLabelWidth;private updateEdgeLabelZoomGate;private updateNodeLabelZoomGate;private linkIndexBase;private communityIndexBase;private graphItemCount;private normalizedGraphItem;private graphItemIdentity;private graphItemIndex;private communityText;private graphItemText;private graphItemAnnouncement;private onGraphItemFocus;private focusGraphItem;private focusGraphItemElement;private onGraphKeyDown;render():TemplateResult;private renderGraph;}declare global{interface HTMLElementTagNameMap{'lr-graph':LyraGraph;}}