@aceshooting/lyra-ui 29.0.2 → 29.1.0

package/dist/components/data/file-tree/file-tree.d.ts

@@ -1,2 +1,3 @@
+import'../../layout/virtual-list/virtual-list.js';
 /** @deprecated Import @aceshooting/lyra-ui/components/lr-file-tree.js to register this component. */
 export*from'./file-tree.class.js';import'../tree/tree.js';import'../../media/file-icon/file-icon.js';

package/dist/components/data/file-tree/file-tree.js

@@ -1 +1 @@
-export*from"./file-tree.class.js";import"../tree/tree.js";import"../../media/file-icon/file-icon.js";import{LyraFileTree}from"./file-tree.class.js";import{defineElement}from"../../../internal/prefix.js";defineElement("file-tree",LyraFileTree);
+import"../../layout/virtual-list/virtual-list.js";export*from"./file-tree.class.js";import"../tree/tree.js";import"../../media/file-icon/file-icon.js";import{LyraFileTree}from"./file-tree.class.js";import{defineElement}from"../../../internal/prefix.js";defineElement("file-tree",LyraFileTree);

package/dist/components/data/flow-canvas/flow-canvas.class.d.ts

@@ -1,4 +1,4 @@
-import{type TemplateResult,type PropertyValues}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraOrientation}from'../../../internal/shared-unions.js';import{type FlowEdge,type FlowLayoutChangeDetail,type FlowNode,type FlowRunDecorations,type FlowStructureSnapshot}from'./flow-types.js';export*from'./flow-types.js';export interface LyraFlowCanvasEventMap{'lr-node-activate':CustomEvent<Readonly<{nodeId:string;}>>;'lr-edge-activate':CustomEvent<Readonly<{edgeId:string;sourceNodeId:string;targetNodeId:string;
+import type{LyraGraphSource}from'../../../data-sources.js';import{type TemplateResult,type PropertyValues}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraOrientation}from'../../../internal/shared-unions.js';import{type FlowEdge,type FlowLayoutChangeDetail,type FlowNode,type FlowRunDecorations,type FlowStructureSnapshot}from'./flow-types.js';export*from'./flow-types.js';export type FlowCanvasSource=LyraGraphSource<FlowNode,FlowEdge>;export interface LyraFlowCanvasEventMap{'lr-node-activate':CustomEvent<Readonly<{nodeId:string;}>>;'lr-edge-activate':CustomEvent<Readonly<{edgeId:string;sourceNodeId:string;targetNodeId:string;
 /** @deprecated Use `sourceNodeId`; it carries the same node id. */
 source:string;
 /** @deprecated Use `targetNodeId`; it carries the same node id. */
@@ -8,7 +8,10 @@ target:string;}>>;'lr-selection-change':CustomEvent<Readonly<{selectedNodeIds:re
 * SVG edges between their handles, runs a shared layered auto-layout for unpositioned nodes, and owns
 * all selection/drag/connect interaction. A viewer by default; opt into editor gestures
 * individually via `nodes-draggable`, `connectable`, `droppable`. `nodes` and `edges` remain
-* controlled and are never mutated internally. Selection is an internally applied interaction
+* controlled and are never mutated internally. Node cards and edges outside the viewport are
+* culled, while active/selected nodes, connection targets and their incident edges remain
+* available. Keyboard navigation retains the complete model order and reveals its destination;
+* companions receive the complete admitted geometry. Selection is an internally applied interaction
 * state: `selectedNodeIds`/`selectedEdgeIds` can seed or replace it, and node/edge activation
 * updates those arrays before emitting `lr-selection-change`. Interaction announcements are
 * flushed to the document's shared light-DOM polite sink; mount is silent and repeated identical
@@ -56,6 +59,12 @@ target:string;}>>;'lr-selection-change':CustomEvent<Readonly<{selectedNodeIds:re
 * @event lr-viewport-change - `detail: { x, y, zoom }`.
 * @event lr-layout-change - `detail: { positions, truncated }`.
 * @csspart base - The root wrapper.
+* @csspart source-navigator - Complete source records and paging controls.
+* @csspart source-controls - Source query and page controls.
+* @csspart source-records - The bounded current records page.
+* @csspart source-record - A record and its scope or endpoint actions.
+* @csspart source-status - Source loading, failure, and total status.
+* @csspart source-coverage - Exact scene coverage relative to complete source totals.
 * @csspart viewport - The focusable pan/zoom surface.
 * @csspart background - The dotted background grid.
 * @csspart edges - The edges SVG.
@@ -85,6 +94,7 @@ target:string;}>>;'lr-selection-change':CustomEvent<Readonly<{selectedNodeIds:re
 * members.
 * @csspart edge-hit-area - The transparent wide pointer target behind an edge.
 * @csspart empty - The `lr-empty` shown when `nodes` is empty.
+* @csspart input-limit - A localized notice when nodes, edges, or node data exceed an input safety boundary.
 * @csspart layout-limit - A visible localized notice shown when layered layout reaches its bounded
 *   edge-ordering work limit. Its announcement is sent through the shared light-DOM polite sink.
 * @csspart live-region - An aria-hidden shadow mirror of the current item/gesture announcement;
@@ -129,9 +139,24 @@ target:string;}>>;'lr-selection-change':CustomEvent<Readonly<{selectedNodeIds:re
 * @status stable
 * @since 4.0.0
 */
-export declare class LyraFlowCanvas extends LyraElement<LyraFlowCanvasEventMap>{static styles:import("lit").CSSResultGroup[];private _nodes;private nodesSource?;
+export declare class LyraFlowCanvas extends LyraElement<LyraFlowCanvasEventMap>{static styles:import("lit").CSSResultGroup[];private _graphSource?;private sourceEpoch;private sourceIntent;private sourceSyncing;private sourceInputs?;private sourcePageInputs?;private sourcePagePromise;private sourceSceneInputs;private sourceQuery;private sourceError?;private sourceSceneFailure;private sourceMissing;private sourceNodes;private sourceEdges;private sourceAcceptedScene?;private sourceWorld?;private sourceOverview;private sourceOverviewEpoch;private sourceOverviewRunning;private sourceOverviewQueued?;private sourceState;private readonly sourceOverviewRequests;private readonly sourcePages;private readonly sourceScene;
+/** Complete source records and separately bounded positioned viewport scenes. Defined sources
+* override legacy nodes/edges, preserve offscene selection and disable model editing only.
+* Reassign the source (including the same reference) or requestUpdate() after revision changes.
+* Unset restores the latest legacy inputs. @default undefined */
+get graphSource():FlowCanvasSource|undefined;set graphSource(value:FlowCanvasSource|undefined);private _sourcePage;
+/** Zero-based global record page, normalized against sourcePageSize. */
+get sourcePage():number;set sourcePage(value:number);private _sourcePageSize;
+/** Source records per page, normalized to 1–500. */
+get sourcePageSize():number;set sourcePageSize(value:number);
+/** Exact active record-query total; null when unavailable. */
+get sourceTotal():number|null;private get modelNodes();private get modelEdges();private get sourceMode();private resetFlowSource;private sourceAuthority;private syncFlowSource;private sourceViewportBounds;private requestSourceScene;private requestSourceOverview;private pumpSourceOverview;private setSourceQuery;
+/** Reveal a canonical node:<id> or edge:<id> in the complete records navigator, clearing scope. */
+revealSourceKey(key:string):Promise<boolean>;private focusSourceRecord;private renderSourceNavigator;private _nodes;private nodesSource?;private nodesInputTruncated;private edgesInputTruncated;
 /** Controlled node model, deeply snapshotted and frozen at assignment, bounded to the first
-* 10,000 source nodes and a finite nested-data budget. Blank ids and later duplicates are omitted
+* 10,000 source nodes and a shared 50,000-position nested-data inspection budget per assignment.
+* Metadata copies preserve shared references across nodes. Each record inspects at most 10,000
+* own keys and at most 16 descendant levels; input-limit reports omitted input. Blank ids and later duplicates are omitted
 * first-wins. Assign a new array to update; replacing it cancels active node-drag and pointer/keyboard
 * connect gestures and prunes selected ids that no longer exist. */
 get nodes():readonly FlowNode[];set nodes(value:readonly FlowNode[]);private _edges;private edgesSource?;
@@ -173,7 +198,7 @@ nodeGap:number;private _decorations;private decorationsSource?;
 * retaining valid neighbors. Assign a new record to update. */
 get decorations():FlowRunDecorations|null;set decorations(value:FlowRunDecorations|null);
 /** Accessible name of the canvas region and viewport; defaults to a localized summary. */
-accessibleLabel:string|null;private get safeMinZoom();private get safeMaxZoom();private get effectiveZoomBounds();private get safeGrid();private get safeLayerGap();private get safeNodeGap();private readonly arrowMarkerIds;private readonly liveRegionId;private readonly announcements;private readonly announcer;private activeItemIndex;private connecting;private layoutTruncated;private hasConnectedLayoutBaseline;private layoutLimitAnnouncementPending;private keyboardConnectSourceId;private keyboardConnectTargetIndex;private autoPositions;private measuredSizes;private resizeObserver?;private readonly observedNodeEls;private authoredCardObserver?;private authoredCardObserverDocument?;private authoredCardObserverGeneration;private authoredCardSyncQueued;private readonly authoredCardSlotLeases;private layoutRaf;private connectedWindow?;private panX;private panY;private zoomLevel;private viewportEl?;private worldEl?;private viewportChangeRaf;private hasFitOnce;private rovingCache?;private companionStructure?;private wheelMeasure;private wheelMeasureRaf;private panDrag?;private nodeDrag?;private nodeIncidentEdges;private dragEdgeRefs?;private connectState?;private connectionLineEl?;private connectInvalidNodeId;private companionCallbacks;private companionRaf;private stopMotionWatch?;connectedCallback():void;disconnectedCallback():void;adoptedCallback():void;private requestOwnerAnimationFrame;private cancelOwnerAnimationFrame;private mirrorAnnouncement;private resetAuthoredCardObserver;private bindAuthoredCardObserver;private scheduleAuthoredCardReconciliation;private observeNodeWrappers;protected willUpdate(changed:PropertyValues):void;private pruneNodeCaches;protected updated(changed:PropertyValues):void;private syncAuthoredCards;private leaseAuthoredCardSlot;private releaseAuthoredCardSlot;private restoreAuthoredCardSlots;private pushCardPropsAll;private setCardProperty;private nodePosition;private nodeSize;private resolvedNode;private handleOffset;private handlePoint;private edgePathD;private nodeAccessibleText;private edgeAccessibleText;private onNodesResized;private measureNodeWrappers;private scheduleLayoutPass;private setLayoutTruncated;private runAutoLayoutIfNeeded;get viewport():Readonly<{x:number;y:number;zoom:number;}>;
+accessibleLabel:string|null;private get safeMinZoom();private get safeMaxZoom();private get effectiveZoomBounds();private get safeGrid();private get safeLayerGap();private get safeNodeGap();private readonly arrowMarkerIds;private readonly liveRegionId;private readonly announcements;private readonly announcer;private activeItemIndex;private viewportRevision;private explicitRefresh;private renderEpoch;private renderResolved?;private visibleGeometry?;private visibleViewport;private geometryRtl;private hasUnpositionedNodes;private readonly nodeModelOrder;private readonly edgeModelOrder;private nodeViewportIndex?;private edgeViewportIndex?;private baseVisibleNodes;private baseVisibleEdges;private renderedNodes;private renderedEdges;private activeControl?;private renderedConnectTargetId?;private indexItems?;private indexes?;requestUpdate(...args:Parameters<LyraElement['requestUpdate']>):void;private connecting;private layoutTruncated;private hasConnectedLayoutBaseline;private layoutLimitAnnouncementPending;private keyboardConnectSourceId;private keyboardConnectTargetIndex;private autoPositions;private measuredSizes;private readonly nodeWrappers;private readonly edgeWrappers;private readonly fallbackSizes;private fallbackPassDepth;private withFallbackSizes;private indexedNodes?;private indexedEdges?;private readonly nodesById;private readonly edgesById;private readonly outgoingTargets;private connectTargets?;private fallbackEdges;private ensureModelIndexes;private bindNodeWrapper;private resizeObserver?;private readonly observedNodeEls;private authoredCardObserver?;private authoredCardObserverDocument?;private authoredCardObserverGeneration;private authoredCardSyncQueued;private readonly authoredCardSlotLeases;private layoutRaf;private geometryRaf;private connectedWindow?;private panX;private panY;private zoomLevel;private viewportEl?;private worldEl?;private viewportChangeRaf;private hasFitOnce;private rovingCache?;private companionStructure?;private wheelMeasure;private wheelMeasureRaf;private panDrag?;private nodeDrag?;private nodeIncidentEdges;private dragEdgeRefs?;private connectState?;private connectionLineEl?;private connectInvalidNodeId;private companionCallbacks;private companionRaf;private stopMotionWatch?;connectedCallback():void;disconnectedCallback():void;adoptedCallback():void;private requestOwnerAnimationFrame;private cancelOwnerAnimationFrame;private mirrorAnnouncement;private resetAuthoredCardObserver;private bindAuthoredCardObserver;private scheduleAuthoredCardReconciliation;private observeNodeWrappers;protected willUpdate(changed:PropertyValues):void;private pruneNodeCaches;protected updated(changed:PropertyValues):void;private syncAuthoredCards;private leaseAuthoredCardSlot;private releaseAuthoredCardSlot;private restoreAuthoredCardSlots;private pushCardPropsAll;private setCardProperty;private nodePosition;private nodeSize;private resolvedNode;private handleOffset;private handlePoint;private edgePathD;private nodeAccessibleText;private edgeAccessibleText;private onNodesResized;private scheduleGeometryRefresh;private measureNodeWrappers;private scheduleLayoutPass;private setLayoutTruncated;private runAutoLayoutIfNeeded;get viewport():Readonly<{x:number;y:number;zoom:number;}>;
 /**
 * Read-only, derived from the live layout — {@link setViewport} is the mutator. The setter
 * exists and is a documented no-op because this getter's return shape is exactly
@@ -191,4 +216,4 @@ zoomOut():void;
 resetZoom():void;fit(options?:{padding?:number;}):void;private applyFit;focusNode(id:string,options?:{zoom?:number;}):void;toContentPoint(clientX:number,clientY:number):{x:number;y:number;};
 /** Subscribes to rAF-coalesced structure/viewport snapshots. The viewport includes the finite,
 * sorted `minZoom`/`maxZoom` bounds actually used by canvas zoom operations. */
-registerCompanion(cb:(snapshot:FlowStructureSnapshot)=>void):()=>void;private scheduleCompanionNotify;private buildSnapshot;private clampZoom;private applyWorldTransform;private scheduleViewportChange;private zoomAtCenter;private zoomAtPoint;private localWorldX;private isFromTopLayerSurface;private onWheel;private onBackgroundPointerDown;private onBackgroundPointerMove;private onBackgroundPointerUp;private endBackgroundPan;private onViewportKeyDown;private panBy;private onViewportDragOver;private onViewportDragLeave;private onViewportDrop;private focusableEdges;private rovingItems;private itemCount;private isRovingItemDisabled;private normalizedItemIndex;private nextEnabledItemIndex;private firstEnabledItemIndex;private lastEnabledItemIndex;private itemAccessibleText;private spatialItemIndex;private announceItem;private formatNumber;private onItemFocus;private renderedElementByDataId;private renderedNodeById;private renderedEdgeById;private focusActiveItem;private applySelection;private clearSelection;private deleteSelection;private onNodeActivate;private startedOnAction;private onNodeClick;private onEdgeActivate;private onItemKeyDown;private setActiveItemQuiet;private itemIndexMaps;private snap;private rebuildIncidentEdgesIndex;private buildDragEdgeRefs;private updateIncidentEdges;private onNodePointerDown;private onNodePointerMove;private onNodePointerUp;private endNodeDrag;private nudgeNode;private nodeIdFromComposedPath;private isInvalidConnectTarget;private onWorldPointerDown;private startConnectGesture;private connectContentPoint;private onConnectPointerMove;private onConnectPointerUp;private isInvalidConnectTargetFor;private onConnectPointerCancel;private endConnectGesture;private cancelActiveGestures;private cancelModelBoundGestures;private eligibleConnectTargets;private startKeyboardConnect;private cycleKeyboardConnectTarget;private announceKeyboardConnectTarget;private commitKeyboardConnect;private cancelKeyboardConnect;private statusTone;private edgeTone;private edgeIsRunning;private renderEdges;private renderNodes;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-flow-canvas':LyraFlowCanvas;}}
+registerCompanion(cb:(snapshot:FlowStructureSnapshot)=>void):()=>void;private scheduleCompanionNotify;private buildSnapshot;private clampZoom;private applyWorldTransform;private scheduleViewportChange;private zoomAtCenter;private zoomAtPoint;private localWorldX;private isFromTopLayerSurface;private onWheel;private onBackgroundPointerDown;private onBackgroundPointerMove;private onBackgroundPointerUp;private endBackgroundPan;private onViewportKeyDown;private panBy;private onViewportDragOver;private onViewportDragLeave;private onViewportDrop;private focusableEdges;private rovingItems;private itemCount;private isRovingItemDisabled;private normalizedItemIndex;private nextEnabledItemIndex;private firstEnabledItemIndex;private lastEnabledItemIndex;private itemAccessibleText;private spatialItemIndex;private announceItem;private formatNumber;private onItemFocus;private renderedElementByDataId;private renderedNodeById;private renderedEdgeById;private focusActiveItem;private revealItem;private applySelection;private clearSelection;private deleteSelection;private onNodeActivate;private startedOnAction;private onNodeClick;private onEdgeActivate;private onItemKeyDown;private setActiveItemQuiet;private itemIndexMaps;private snap;private rebuildIncidentEdgesIndex;private buildDragEdgeRefs;private updateIncidentEdges;private onNodePointerDown;private onNodePointerMove;private onNodePointerUp;private endNodeDrag;private nudgeNode;private nodeIdFromComposedPath;private isInvalidConnectTarget;private onWorldPointerDown;private startConnectGesture;private connectContentPoint;private onConnectPointerMove;private onConnectPointerUp;private isInvalidConnectTargetFor;private onConnectPointerCancel;private endConnectGesture;private cancelActiveGestures;private cancelModelBoundGestures;private eligibleConnectTargets;private startKeyboardConnect;private cycleKeyboardConnectTarget;private announceKeyboardConnectTarget;private commitKeyboardConnect;private cancelKeyboardConnect;private statusTone;private edgeTone;private edgeIsRunning;private renderEdges;private renderNodes;private nodeViewportBounds;private edgeViewportBounds;private focusedNodeId;private selectRenderedGeometry;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-flow-canvas':LyraFlowCanvas;}}