@mp70/react-networks 0.5.1 → 0.6.0

package/README.md

@@ -1,7 +1,7 @@
 # react-networks
 
-[![npm version](https://img.shields.io/npm/v/@mp70/react-networks.svg)](https://www.npmjs.com/package/@mp70/react-networks)
-[![license](https://img.shields.io/npm/l/@mp70/react-networks.svg)](https://www.npmjs.com/package/@mp70/react-networks)
+[![npm version](https://img.shields.io/npm/v/react-networks.svg)](https://www.npmjs.com/package/react-networks)
+[![license](https://img.shields.io/npm/l/react-networks.svg)](https://www.npmjs.com/package/react-networks)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
 
 A React library for creating interactive network diagrams with support for rack management, fiber networks, and power distribution. Built on React Flow with TypeScript support.
@@ -25,19 +25,19 @@ A React library for creating interactive network diagrams with support for rack
 ### Installation
 
 ```bash
-npm install @mp70/react-networks react react-dom reactflow
+npm install react-networks react react-dom reactflow
 # or
-yarn add @mp70/react-networks react react-dom reactflow
+yarn add react-networks react react-dom reactflow
 # or
-pnpm add @mp70/react-networks react react-dom reactflow
+pnpm add react-networks react react-dom reactflow
 ```
 
 ### Basic Usage
 
 ```tsx
 import React from 'react';
-import { NetworkDiagram, NetworkNode, NetworkEdge } from '@mp70/react-networks';
-import '@mp70/react-networks/index.css';
+import { NetworkDiagram, NetworkNode, NetworkEdge } from 'react-networks';
+import 'react-networks/index.css';
 
 const nodes: NetworkNode[] = [
   {
@@ -87,7 +87,7 @@ export default App;
 
 ### Data Model
 
-`@mp70/react-networks` supports two control layers:
+`react-networks` supports two control layers:
 
 - `document` / `initialDocument` / `onDocumentChange` use `DiagramDocument`, the canonical persisted/editor schema. Prefer this for saved diagrams, import/export, and external integrations.
 - `nodes` / `edges` remain the lower-level React Flow-shaped control surface when you want direct control of rendered nodes and edges.
@@ -199,6 +199,8 @@ For new code, prefer the document-model props. The graph props and React Flow es
 | `onEdgeUpdate` | `(oldEdge: ReactFlowEdge, newConnection: Connection) => void` | - | Edge update (reconnect) override |
 | `isValidConnection` | `(connection: Connection) => boolean` | - | Connection validation override |
 | `connectionMode` | `ConnectionMode` | - | React Flow connection mode |
+| `connectionRadius` | `number` | React Flow default | Pointer snap distance (px) for handles. Raise to make small ports easier to target; lower to avoid mis-targeting on dense devices |
+| `onConnectRejected` | `(payload: NetworkConnectionRejection) => void` | - | Fired when a connect/reconnect attempt is rejected, so you can surface feedback instead of failing silently |
 | `reAssignable` | `boolean` | `true` | Allow devices to move between racks / ungroup on drag |
 | `colorMode` | `'light' \| 'dark' \| 'system'` | - | Diagram color mode |
 | `onInit` | `(instance: ReactFlowInstance) => void` | - | Called when React Flow is ready |
@@ -292,7 +294,7 @@ type NetworkEdgeType = 'fiber' | 'ethernet' | 'power' | 'smoothstep' | 'step' |
 ### Rack Configuration
 
 ```tsx
-import { RackConfig, buildNodesFromRackConfig, Width } from '@mp70/react-networks';
+import { RackConfig, buildNodesFromRackConfig, Width } from 'react-networks';
 
 const rackSchema: RackConfig[] = [
   {
@@ -339,7 +341,7 @@ Device images (e.g. server front/rear photos or SVGs) use `frontImageUrl` and `r
 ### Inventory Integration
 
 ```tsx
-import { inventoryToNetworkDiagram } from '@mp70/react-networks';
+import { inventoryToNetworkDiagram } from 'react-networks';
 
 const inventoryData = {
   racks: [...],
@@ -353,7 +355,7 @@ const { nodes, edges } = inventoryToNetworkDiagram(inventoryData);
 ### Custom Styling
 
 ```tsx
-import '@mp70/react-networks/index.css';
+import 'react-networks/index.css';
 
 // Override CSS variables
 .network-diagram {

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import React$1, { Component, ReactNode, ErrorInfo, CSSProperties } from 'react';
 import * as reactflow from 'reactflow';
-import { Node, NodeTypes, EdgeTypes, Connection, Edge, ConnectionMode, ReactFlowInstance, Viewport, FitViewOptions, NodeProps, EdgeProps } from 'reactflow';
+import { Node, Connection, NodeTypes, EdgeTypes, Edge, ConnectionMode, ReactFlowInstance, Viewport, FitViewOptions, NodeProps, EdgeProps } from 'reactflow';
 
 type FibreFlowCableKind = 'simple' | 'tube';
 interface FibreFlowEndpoint {
@@ -241,12 +241,12 @@ declare enum Width {
  * Port type enumeration
  * @public
  */
-type PortType = 'ethernet' | 'rj45' | 'fiber' | 'console' | 'mgmt' | 'usb' | 'power_ac' | 'power_c13' | 'power_c19';
+type PortType = "ethernet" | "rj45" | "fiber" | "console" | "mgmt" | "usb" | "power_ac" | "power_c13" | "power_c19";
 /**
  * Cable types used for connected network ports.
  * @public
  */
-type PortCableType = 'smf' | 'cat6' | 'om3' | 'om4' | 'om5' | 'cat5e' | 'cat6a' | 'cat7' | 'fiber' | 'ethernet';
+type PortCableType = "smf" | "cat6" | "om3" | "om4" | "om5" | "cat5e" | "cat6a" | "cat7" | "fiber" | "ethernet";
 /**
  * Device image fit options.
  *
@@ -255,12 +255,12 @@ type PortCableType = 'smf' | 'cat6' | 'om3' | 'om4' | 'om5' | 'cat5e' | 'cat6a'
  *
  * @public
  */
-type DeviceImageFit = 'cover' | 'contain' | 'contain-height' | 'fill' | 'none' | 'scale-down';
+type DeviceImageFit = "cover" | "contain" | "contain-height" | "fill" | "none" | "scale-down";
 /**
  * Device image repeat options.
  * @public
  */
-type DeviceImageRepeat = 'no-repeat' | 'repeat' | 'repeat-x' | 'repeat-y';
+type DeviceImageRepeat = "no-repeat" | "repeat" | "repeat-x" | "repeat-y";
 /**
  * Shared image configuration for rack-mounted devices and device nodes.
  * @public
@@ -289,7 +289,7 @@ interface DeviceImageOptions {
  */
 interface PortPosition {
     /** Handle side on the node */
-    side?: 'top' | 'right' | 'bottom' | 'left';
+    side?: "top" | "right" | "bottom" | "left";
     /** Side offset as percentage (0-100) */
     offsetPercent?: number;
     /** Side offset in pixels */
@@ -315,7 +315,7 @@ interface DevicePort {
     /** Display label for the port */
     label: string;
     /** Front/rear device face. `back` is accepted as an alias for `rear`. */
-    face?: DeviceFace | 'back';
+    face?: DeviceFace | "back";
     /** Optional block/group name (for example `Network Ports`, `QSFP28`, `Power Ports`) */
     group?: string;
     /** Optional source/detected family label used for visual kind inference */
@@ -327,7 +327,7 @@ interface DevicePort {
     /** Cable type for connection validation */
     cableType?: PortCableType;
     /** Optional power connector type for rendering (mainly for PDU ports) */
-    connectorType?: 'C13' | 'C14' | 'C19' | 'C20';
+    connectorType?: "C13" | "C14" | "C19" | "C20";
     /** Optional compatibility keys. When omitted, defaults are derived from type/cable/connector data. */
     compatibility?: string[];
     /** Optional sort order within a face/group bucket */
@@ -353,7 +353,7 @@ interface Port {
     /** Cable type for connection validation */
     cableType?: PortCableType;
     /** Optional power connector type for rendering (mainly for PDU ports) */
-    connectorType?: 'C13' | 'C14' | 'C19' | 'C20';
+    connectorType?: "C13" | "C14" | "C19" | "C20";
     /** Optional compatibility keys. When omitted, defaults are derived from type/cable/connector data. */
     compatibility?: string[];
     /** Optional explicit handle placement */
@@ -373,17 +373,17 @@ interface PortBlock {
  * Network node types supported by the diagram
  * @public
  */
-type NetworkNodeType = 'rack' | 'switch' | 'router' | 'server' | 'fiber' | 'patch-panel' | 'device' | 'vertical-pdu' | 'splice' | 'splice-tray' | 'tube' | 'cable' | 'multi-tube-cable' | 'coupler' | 'closure' | 'fibre-split' | 'fibre-flow-cable' | 'fibre-flow-closure';
+type NetworkNodeType = "rack" | "switch" | "router" | "server" | "fiber" | "patch-panel" | "device" | "vertical-pdu" | "splice" | "splice-tray" | "tube" | "cable" | "multi-tube-cable" | "coupler" | "closure" | "fibre-split" | "fibre-flow-cable" | "fibre-flow-closure";
 /**
  * Device status states
  * @public
  */
-type DeviceStatus = 'active' | 'inactive' | 'maintenance';
+type DeviceStatus = "active" | "inactive" | "maintenance";
 /**
  * Device face orientations
  * @public
  */
-type DeviceFace = 'front' | 'rear';
+type DeviceFace = "front" | "rear";
 type DiagramPortHandleRef = {
     nodeId: string;
     handleId: string;
@@ -399,22 +399,22 @@ type DiagramPortClickPayload = {
  * Rack rendering layout modes.
  * @public
  */
-type RackLayoutMode = 'single-face' | 'split-face';
+type RackLayoutMode = "single-face" | "split-face";
 /**
  * Rack mounting behavior for a device.
  * @public
  */
-type RackMountMode = 'front' | 'rear' | 'both';
+type RackMountMode = "front" | "rear" | "both";
 /**
  * Power port side configuration
  * @public
  */
-type PowerSide = 'left' | 'right';
+type PowerSide = "left" | "right";
 /**
  * U numbering direction for racks
  * @public
  */
-type UNumberingDirection = 'bottom-up' | 'top-down';
+type UNumberingDirection = "bottom-up" | "top-down";
 /**
  * Shared node data fields available across node types.
  * Specific node kinds can narrow these fields via `NetworkNodeDataByType`.
@@ -438,11 +438,11 @@ interface NetworkNodeDataBase extends DeviceImageOptions {
     /** NetBox integration ID */
     netboxId?: number | string;
     /** NetBox object type */
-    netboxType?: 'device' | 'rack' | 'interface' | 'cable' | string;
+    netboxType?: "device" | "rack" | "interface" | "cable" | string;
     /** Inventory integration ID */
     inventoryId?: number | string;
     /** Inventory object type */
-    inventoryType?: 'device' | 'rack' | 'interface' | 'cable' | string;
+    inventoryType?: "device" | "rack" | "interface" | "cable" | string;
     /** Rack height in U units */
     uHeight?: number;
     /** Device position within rack in U units */
@@ -477,13 +477,13 @@ interface NetworkNodeDataBase extends DeviceImageOptions {
     /** Number of AC power ports */
     powerPorts?: number;
     /** Optional explicit PDU connector sequence */
-    portTypes?: Array<'C13' | 'C19'>;
+    portTypes?: Array<"C13" | "C19">;
     /** Optional grouped PDU ports (supports custom positions/types) */
     pduPortGroups?: PortBlock[];
     /** Vertical PDU width in pixels */
     widthPx?: number;
     /** Optional management unit position for vertical PDUs */
-    mgmt_unit?: 'top' | 'middle' | 'bottom';
+    mgmt_unit?: "top" | "middle" | "bottom";
     /** U numbering direction for rack nodes */
     uNumberingDirection?: UNumberingDirection;
     /** Custom header text for rack nodes */
@@ -495,13 +495,13 @@ interface NetworkNodeDataBase extends DeviceImageOptions {
     /** Loss value in dB for splice nodes */
     lossDb?: number;
     /** Splice mode */
-    mode?: 'single' | 'ribbon';
+    mode?: "single" | "ribbon";
     /** Legacy ribbon flag */
     ribbon?: boolean;
     /** Ribbon fiber IDs */
     ribbonFiberIds?: number[];
     /** Connector type for coupler nodes */
-    connector?: 'SC' | 'LC';
+    connector?: "SC" | "LC";
     /** Number of fibers for coupler nodes (1, 2, or 4) */
     couplerFiberCount?: 1 | 2 | 4;
     /** Optional port labels for left side of coupler */
@@ -529,7 +529,7 @@ interface NetworkNodeDataBase extends DeviceImageOptions {
     /** Header text for container nodes */
     header?: string;
     /** Type of fibre splitter: 'splitter' or 'WDM' (default: 'splitter') */
-    splitterType?: 'splitter' | 'WDM';
+    splitterType?: "splitter" | "WDM";
     /** Number of input fibers on the left (1 or 2, default: 1) */
     inputCount?: number;
     /** Number of output fibers on the right (1-64, default: 8) */
@@ -551,7 +551,7 @@ interface NetworkNodeDataBase extends DeviceImageOptions {
     /** Rotation in degrees for rotatable nodes */
     rotation?: number;
     /** Tube handle orientation */
-    startOn?: 'left-center' | 'left' | 'right';
+    startOn?: "left-center" | "left" | "right";
     /** Rack metadata for integrations */
     facilityId?: string | number | null;
     /** Rack serial metadata */
@@ -573,7 +573,7 @@ interface NetworkNodeDataBase extends DeviceImageOptions {
     devices?: unknown[];
     cables?: unknown[];
     /** UI color mode metadata */
-    colorMode?: 'light' | 'dark' | 'system';
+    colorMode?: "light" | "dark" | "system";
     /** Generic dimensions used by some helpers */
     height?: number;
     headerHeight?: number;
@@ -602,13 +602,13 @@ interface DeviceNodeData extends NetworkNodeDataBase {
  */
 interface FibreFlowCableNodeData extends NetworkNodeDataBase {
     cable: FibreFlowCable;
-    side: 'left' | 'right';
+    side: "left" | "right";
     rowHeight: number;
     columnWidth: number;
     showTubeLabels: boolean;
     showFiberNumbers: boolean;
     layout: unknown;
-    colorMode?: 'dark' | 'light';
+    colorMode?: "dark" | "light";
 }
 /**
  * Fibre flow closure node data.
@@ -618,7 +618,7 @@ interface FibreFlowClosureNodeData extends NetworkNodeDataBase {
     width?: number;
     height?: number;
     headerHeight?: number;
-    colorMode?: 'dark' | 'light';
+    colorMode?: "dark" | "light";
 }
 /**
  * Mapping from node type to corresponding data type.
@@ -630,19 +630,19 @@ interface NetworkNodeDataByType {
     router: DeviceNodeData;
     server: DeviceNodeData;
     fiber: NetworkNodeDataBase;
-    'patch-panel': NetworkNodeDataBase;
+    "patch-panel": NetworkNodeDataBase;
     device: DeviceNodeData;
-    'vertical-pdu': NetworkNodeDataBase;
+    "vertical-pdu": NetworkNodeDataBase;
     splice: NetworkNodeDataBase;
-    'splice-tray': NetworkNodeDataBase;
+    "splice-tray": NetworkNodeDataBase;
     tube: NetworkNodeDataBase;
     cable: NetworkNodeDataBase;
-    'multi-tube-cable': NetworkNodeDataBase;
+    "multi-tube-cable": NetworkNodeDataBase;
     coupler: NetworkNodeDataBase;
     closure: NetworkNodeDataBase;
-    'fibre-split': NetworkNodeDataBase;
-    'fibre-flow-cable': FibreFlowCableNodeData;
-    'fibre-flow-closure': FibreFlowClosureNodeData;
+    "fibre-split": NetworkNodeDataBase;
+    "fibre-flow-cable": FibreFlowCableNodeData;
+    "fibre-flow-closure": FibreFlowClosureNodeData;
 }
 /**
  * Union of all node data variants.
@@ -663,7 +663,7 @@ type NetworkNode<TType extends NetworkNodeType = NetworkNodeType, TExtra = unkno
  * Network edge types
  * @public
  */
-type NetworkEdgeType = 'fiber' | 'ethernet' | 'power' | 'smoothstep' | 'step' | 'thick-cable' | 'fibre-flow' | 'fibre-flow-link';
+type NetworkEdgeType = "fiber" | "ethernet" | "power" | "smoothstep" | "step" | "thick-cable" | "fibre-flow" | "fibre-flow-link";
 /**
  * Edge data payload.
  * @public
@@ -676,7 +676,7 @@ interface NetworkEdgeData {
     /** Edge color for styling */
     color?: string;
     /** Edge kind for styling/validation */
-    kind?: 'fiber' | 'power' | 'network';
+    kind?: "fiber" | "power" | "network";
     /** Whether this edge represents a ribbon fiber connection */
     isRibbon?: boolean;
     /** Array of fiber IDs for ribbon mode (6-12 fibers) */
@@ -695,10 +695,10 @@ interface NetworkEdgeData {
     cableType?: PortCableType;
     /** NetBox integration metadata */
     netboxId?: number | string;
-    netboxType?: 'device' | 'rack' | 'interface' | 'cable' | string;
+    netboxType?: "device" | "rack" | "interface" | "cable" | string;
     /** Inventory integration metadata */
     inventoryId?: number | string;
-    inventoryType?: 'device' | 'rack' | 'interface' | 'cable' | string;
+    inventoryType?: "device" | "rack" | "interface" | "cable" | string;
     /** Status metadata */
     status?: string;
     /** Endpoint metadata */
@@ -755,7 +755,7 @@ interface DiagramDocument {
  * Node kinds used by the document model.
  * @public
  */
-type DiagramNodeKind = 'rack' | 'equipment' | 'pdu' | 'fiber' | 'tube' | 'cable' | 'multi-tube-cable' | 'splice' | 'coupler' | 'splitter' | 'container' | 'fibre-flow-cable' | 'fibre-flow-closure';
+type DiagramNodeKind = "rack" | "equipment" | "pdu" | "fiber" | "tube" | "cable" | "multi-tube-cable" | "splice" | "coupler" | "splitter" | "container" | "fibre-flow-cable" | "fibre-flow-closure";
 /**
  * Placement data for document nodes.
  * @public
@@ -766,7 +766,7 @@ interface DiagramNodePlacement {
         y: number;
     };
     parentId?: string;
-    extent?: 'parent';
+    extent?: "parent";
     rack?: {
         uPosition?: number;
         mountMode?: RackMountMode;
@@ -786,10 +786,10 @@ interface DiagramNodePlacement {
 interface DiagramEndpoint {
     id: string;
     label: string;
-    face?: DeviceFace | 'internal';
+    face?: DeviceFace | "internal";
     group?: string;
-    role?: 'network' | 'power' | 'fiber' | 'tube' | 'splice' | 'coupler' | 'splitter' | 'cable' | 'generic';
-    medium?: 'ethernet' | 'fiber' | 'power' | 'tube' | 'generic';
+    role?: "network" | "power" | "fiber" | "tube" | "splice" | "coupler" | "splitter" | "cable" | "generic";
+    medium?: "ethernet" | "fiber" | "power" | "tube" | "generic";
     type?: PortType;
     cableType?: PortCableType;
     connector?: string;
@@ -808,7 +808,7 @@ interface DiagramNodeRender {
     height?: number;
     header?: string;
     color?: string;
-    colorMode?: 'light' | 'dark' | 'system';
+    colorMode?: "light" | "dark" | "system";
     rackWidthPx?: number;
     rackFaceGapPx?: number;
     images?: DeviceImageOptions;
@@ -823,7 +823,7 @@ interface DiagramNodeRender {
  * @public
  */
 interface DiagramExternalRef {
-    source: 'netbox' | 'inventory' | string;
+    source: "netbox" | "inventory" | string;
     id: string | number;
     type?: string;
     metadata?: Record<string, unknown>;
@@ -880,7 +880,7 @@ interface DiagramUiState {
  * Rack device types
  * @public
  */
-type RackDeviceType = 'server' | 'switch' | 'router' | 'patch-panel' | 'ups';
+type RackDeviceType = "server" | "switch" | "router" | "patch-panel" | "ups";
 /**
  * Rack configuration structure
  * @public
@@ -950,7 +950,7 @@ interface RackDevice extends DeviceImageOptions {
  * Fiber cable types
  * @public
  */
-type FiberCableType = 'single-mode' | 'multi-mode';
+type FiberCableType = "single-mode" | "multi-mode";
 /**
  * Fiber cable configuration
  * @public
@@ -988,7 +988,7 @@ interface SpliceConfig {
     /** Loss value in dB */
     lossDb?: number;
     /** Splice mode: 'single' for individual fiber, 'ribbon' for ribbon splices */
-    mode?: 'single' | 'ribbon';
+    mode?: "single" | "ribbon";
     /** For ribbon mode: array of fiber IDs (6-12) in the ribbon */
     ribbonFiberIds?: number[];
 }
@@ -1091,7 +1091,7 @@ interface NetworkDiagramToImageOptions {
  * Fit-view options that support targeting node IDs directly.
  * @public
  */
-interface NetworkDiagramFitViewOptions extends Omit<FitViewOptions, 'nodes'> {
+interface NetworkDiagramFitViewOptions extends Omit<FitViewOptions, "nodes"> {
     /** Optional node IDs to fit */
     nodes?: string[];
 }
@@ -1205,7 +1205,7 @@ interface NetworkDiagramProps {
     /** Allow rack-mounted devices to move between racks/ungroup on drag and drop. Defaults to true. */
     reAssignable?: boolean;
     /** Color mode for the diagram */
-    colorMode?: 'light' | 'dark' | 'system';
+    colorMode?: "light" | "dark" | "system";
     /** Callback when React Flow instance is initialized */
     onInit?: (instance: ReactFlowInstance) => void;
     /** Callback to get React Flow methods for save/restore */
@@ -1213,7 +1213,7 @@ interface NetworkDiagramProps {
     /** Show download button */
     showDownloadButton?: boolean;
     /** Download button position */
-    downloadButtonPosition?: 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
+    downloadButtonPosition?: "top-right" | "top-left" | "bottom-right" | "bottom-left";
     /** Custom download button text */
     downloadButtonText?: string;
     /** Download button styling options */
@@ -1228,6 +1228,15 @@ interface NetworkDiagramProps {
     actionPanel?: NetworkDiagramActionPanelOptions;
     /** Optional fitView options passed to React Flow */
     fitViewOptions?: FitViewOptions;
+    /**
+     * Minimum zoom passed to React Flow. Defaults to 0.1 so the always-on
+     * fitView can actually fit tall scenes (React Flow's own 0.5 default clamps
+     * the fit and crops full-height racks, which viewport culling then never
+     * mounts).
+     */
+    minZoom?: number;
+    /** Maximum zoom passed to React Flow. Defaults to 4. */
+    maxZoom?: number;
     /**
      * Let React Flow render only viewport-visible nodes and edges.
      * Defaults to true, matching the library's existing large-diagram behavior.
@@ -1253,6 +1262,30 @@ interface NetworkDiagramProps {
     highlightedPortHandles?: DiagramPortHandleRef[];
     /** Fired when a port handle is clicked (typically in read-only trace mode). */
     onPortClick?: (payload: DiagramPortClickPayload) => void;
+    /**
+     * Pointer distance (px) within which a drag snaps onto a handle, forwarded to
+     * React Flow's `connectionRadius`. Larger values make small port handles easier
+     * to target; smaller values reduce mis-targeting on densely packed devices.
+     * When omitted, React Flow's default is used.
+     */
+    connectionRadius?: number;
+    /**
+     * Fired when a connection attempt is rejected by the diagram's validation
+     * (incompatible endpoints, an occupied non-replaceable handle, a disallowed
+     * fiber pairing, etc.). Lets host apps surface feedback instead of failing
+     * silently. Not called for the continuous hover validation during a drag —
+     * only when an actual connect or reconnect attempt is rejected.
+     */
+    onConnectRejected?: (payload: NetworkConnectionRejection) => void;
+}
+/** Payload describing why a connection attempt was rejected. */
+interface NetworkConnectionRejection {
+    /** The connection the user attempted to make. */
+    connection: Connection;
+    /** Human-readable reason the connection was rejected. */
+    reason: string;
+    /** Whether the rejection happened while creating a new edge or reconnecting an existing one. */
+    phase: "connect" | "reconnect";
 }
 
 declare const NetworkDiagram: React$1.FC<NetworkDiagramProps>;
@@ -2827,4 +2860,4 @@ declare function useNetworkDiagram(store: NetworkDiagramStore): NetworkDiagramSt
 declare function useNodes(store: NetworkDiagramStore): NetworkNode[];
 declare function useEdges(store: NetworkDiagramStore): NetworkEdge[];
 
-export { type BuildPathLayoutOptions, COUPLERS_PER_PANEL, COUPLER_SLOT_HEIGHT_PX, COUPLER_WIDTH_PX, CableNode, ClosureNode, CouplerNode, DEFAULT_DIAGRAM_DIM_OPACITY, type DeviceFace, type DeviceImageFit, type DeviceImageOptions, type DeviceImageRepeat, DeviceNode, type DeviceNodeData, DevicePlacementError, type DevicePlacementValidation, type DevicePort, type DeviceStatus, type DeviceTemplateV2, type DiagramDocument, type DiagramEdge, type DiagramEdgeEndpoint, type DiagramEndpoint, DiagramErrorBoundary, type DiagramErrorBoundaryProps, type DiagramErrorBoundaryState, type DiagramExternalRef, type DiagramFocusOptions, type DiagramNode, type DiagramNodeKind, type DiagramNodePlacement, type DiagramNodeRender, type DiagramPortClickPayload, type DiagramPortContextValue, type DiagramPortHandleRef, DiagramPortProvider, type DiagramUiState, type EndpointConnectionKind, type EndpointMetadata, FIBER_COLORS_12, type FiberCable, type FiberCableType, type FiberColorId, FiberEdge, FiberNode, FibreCableWithTubesExpanded, type FibreCableWithTubesExpandedProps, type FibreFlowCable, type FibreFlowCableKind, type FibreFlowCableLayout, type FibreFlowCableNodeData, type FibreFlowCircuit, type FibreFlowClosure, type FibreFlowClosureNodeData, type FibreFlowColorMode, type FibreFlowEndpoint, type FibreFlowLayoutDirection, FibreFlowMap, type FibreFlowMapProps, type FibreFlowRow, type FibreFlowSplice, type FibreFlowTubeLabel, FibreSplitNode, HANDLE_EXTENSION_PX, type InventoryCableDTO, type InventoryDeviceDTO, type InventoryRackDTO, type ListPossiblePortHandleIdsOptions, type MountClass, MultiTubeCableNode, type NetBoxCable, type NetBoxDevice, type NetBoxDeviceTransformOptions, type NetBoxInterface, type NetBoxMappedPort, type NetBoxPortPosition, type NetBoxRack, NetworkDiagram, type NetworkDiagramActionPanelOptions, type NetworkDiagramFitViewOptions, type NetworkDiagramFlowMethods, type NetworkDiagramFlowObject, type NetworkDiagramInteractionOptions, type NetworkDiagramOptions, type NetworkDiagramProps, type NetworkDiagramState, type NetworkDiagramStore, type NetworkDiagramStoreApi, type NetworkDiagramStoreState, type NetworkDiagramToImageOptions, type NetworkDiagramValidateConnectionParams, type NetworkDiagramValidationResult, type NetworkEdge, type NetworkEdgeData, type NetworkEdgeType, type NetworkGraphSnapshot, type NetworkNode, type NetworkNodeData, type NetworkNodeDataBase, type NetworkNodeDataByType, type NetworkNodeType, PANEL_BORDER_WIDTH, PANEL_HEADER_HEIGHT, PANEL_HEIGHT_PX, PANEL_PADDING, PANEL_TUBE_TRAY_SPACING, PANEL_WIDTH_PX, POWER_CONNECTORS, PatchPanelNode, type PathLayoutDirection, type PathLayoutEdgeInput, type PathLayoutStepInput, type Port, type PortBlock, type PortCableType, type PortPosition, type PortType, type PortVisualDimensions, type PortVisualInput, type PortVisualKind, type PowerConnectorConfig, PowerEdge, type PowerPortStyle, type PowerSide, RACK_HEADER_HEIGHT, RACK_WIDTH_PX, type RackConfig, type RackDevice, type RackDeviceType, type RackLayoutMode, type RackMountMode, type RackMountedNodeType, RackNode, type RackNodeData, type RackNodeProps, type RackSchemaOptions, type RawNetboxTemplate, type RawTemplatePort, type RawTemplatePortBlock, type ReplaceEdgeOptions, type SpliceConfig, SpliceNode, SplicePlacementError, type SplicePlacementValidation, type SpliceSchemaOptions, type SpliceTrayConfig, SpliceTrayNode, TEMPLATE_SCHEMA_VERSION, type TemplateFaceData, type TemplateFrontRearPortLink, type TemplateParseResult, type TemplatePort, type TemplatePortBlock, type TemplateSource, type TemplateValidationIssue, type TemplateValidationReport, type TemplateWidth, TubeNode, type UNumberingDirection, U_HEIGHT_PX, type ValidateConnectionParams, type ValidationResult, VerticalPDU, Width, addDeviceToRack, addSpliceToTray, applyDeviceDisplayToNodes, applyDiagramFocusToEdges, applyDiagramFocusToNodes, baseColorFor, buildDevicePortGroupsFromPorts, buildNodesFromRackConfig, buildNodesFromSpliceConfig, buildPathLayoutGraph, buildPortBlocksFromPorts, buildPortHandleId, buildPortHandleId as buildReactNetworksHandleId, buildReactNetworksPortGroupsFromPorts, calculateClosureDimensions, calculateCouplerRightX, calculateCouplerSlotSpacing, calculateCouplerSpacing, calculateDevicePositionFromU, calculatePanelDimensions, calculateSlotPositionFromY, calculateSplicePositionFromNumber, calculateUPositions, calculateYFromSlotPosition, countTemplateFacePorts, createNetworkDiagramStore, createRackConfigFromNodes, createSpliceConfigFromNodes, diagramDocumentToNetworkGraph, fiberSolidOrStriped, findNearestRack, findNextAvailableHolderPosition, findNextAvailableUPosition, flattenDevicePortsFromGroups, flattenReactNetworksPortGroups, generateLayout, getConnectorConfig, getCouplerDimensions, getDefaultDeviceFace, getDeviceConnectorType, getEndpointMetadata, getFiberColor, getFrontPortBlocks, getInnerContentWidth, getPDUPortType, getPanelHeight, getPanelWidth, getPowerPortStyle, getRackBounds, getRearPortBlocks, getResolvedPortBlocks, getStandardPortVisualDimensions, getStatusColor, getTrayDimensions, getTubeDimensions, hasDiagramFocus, hasFrontPorts, hasRearPorts, inventoryCableToNetworkEdge, inventoryDeviceToNetworkNode, inventoryRackToNetworkNode, inventoryToDiagramDocument, inventoryToNetworkDiagram, isDeviceDiagramNode, isDiagramPortHandleHighlighted, isEdgeInDiagramFocus, isHighPowerConnector, isNodeInDiagramFocus, isPointInRack, isPowerPortType, isStriped, isUPositionAvailable, listPossiblePortHandleIds, looksLikePowerHandleId, netboxCableToNetworkEdge, netboxDeviceToNetworkNode, netboxRackToNetworkNode, netboxToDiagramDocument, netboxToNetworkDiagram, networkGraphToDiagramDocument, normalizeDevicePorts, normalizeDirectionalHandleId, normalizeHandleId, normalizePortPositionInput, normalizeReactNetworksPorts, parseNetboxTemplate, parseSemanticPortPosition, removeDeviceFromRack, removeSpliceFromTray, replaceEdge, resolveDevicePortBlocksFromFlatPorts, resolveDevicePortFace, resolveDevicePortGroup, resolveEndpointCompatibilityKeys, resolveNodeDevicePorts, resolvePortVisualKind, resolveReactNetworksNodePorts, resolveReactNetworksPortFace, resolveReactNetworksPortGroup, snapToCouplerPosition, snapToSplicePosition, snapToUPosition, updateDeviceUPosition$1 as updateDeviceUPosition, updateDeviceUPosition as updateDeviceUPositionInSchema, updateSpliceHolderPosition, useEdges as useDiagramEdges, useNodes as useDiagramNodes, useDiagramPortInteraction, useNetworkDiagram, validateAndSnapDevice, validatePortHandleOnNodeData, validateRackDevicePlacements, validateRenderFidelity, validateSplicePlacements };
+export { type BuildPathLayoutOptions, COUPLERS_PER_PANEL, COUPLER_SLOT_HEIGHT_PX, COUPLER_WIDTH_PX, CableNode, ClosureNode, CouplerNode, DEFAULT_DIAGRAM_DIM_OPACITY, type DeviceFace, type DeviceImageFit, type DeviceImageOptions, type DeviceImageRepeat, DeviceNode, type DeviceNodeData, DevicePlacementError, type DevicePlacementValidation, type DevicePort, type DeviceStatus, type DeviceTemplateV2, type DiagramDocument, type DiagramEdge, type DiagramEdgeEndpoint, type DiagramEndpoint, DiagramErrorBoundary, type DiagramErrorBoundaryProps, type DiagramErrorBoundaryState, type DiagramExternalRef, type DiagramFocusOptions, type DiagramNode, type DiagramNodeKind, type DiagramNodePlacement, type DiagramNodeRender, type DiagramPortClickPayload, type DiagramPortContextValue, type DiagramPortHandleRef, DiagramPortProvider, type DiagramUiState, type EndpointConnectionKind, type EndpointMetadata, FIBER_COLORS_12, type FiberCable, type FiberCableType, type FiberColorId, FiberEdge, FiberNode, FibreCableWithTubesExpanded, type FibreCableWithTubesExpandedProps, type FibreFlowCable, type FibreFlowCableKind, type FibreFlowCableLayout, type FibreFlowCableNodeData, type FibreFlowCircuit, type FibreFlowClosure, type FibreFlowClosureNodeData, type FibreFlowColorMode, type FibreFlowEndpoint, type FibreFlowLayoutDirection, FibreFlowMap, type FibreFlowMapProps, type FibreFlowRow, type FibreFlowSplice, type FibreFlowTubeLabel, FibreSplitNode, HANDLE_EXTENSION_PX, type InventoryCableDTO, type InventoryDeviceDTO, type InventoryRackDTO, type ListPossiblePortHandleIdsOptions, type MountClass, MultiTubeCableNode, type NetBoxCable, type NetBoxDevice, type NetBoxDeviceTransformOptions, type NetBoxInterface, type NetBoxMappedPort, type NetBoxPortPosition, type NetBoxRack, type NetworkConnectionRejection, NetworkDiagram, type NetworkDiagramActionPanelOptions, type NetworkDiagramFitViewOptions, type NetworkDiagramFlowMethods, type NetworkDiagramFlowObject, type NetworkDiagramInteractionOptions, type NetworkDiagramOptions, type NetworkDiagramProps, type NetworkDiagramState, type NetworkDiagramStore, type NetworkDiagramStoreApi, type NetworkDiagramStoreState, type NetworkDiagramToImageOptions, type NetworkDiagramValidateConnectionParams, type NetworkDiagramValidationResult, type NetworkEdge, type NetworkEdgeData, type NetworkEdgeType, type NetworkGraphSnapshot, type NetworkNode, type NetworkNodeData, type NetworkNodeDataBase, type NetworkNodeDataByType, type NetworkNodeType, PANEL_BORDER_WIDTH, PANEL_HEADER_HEIGHT, PANEL_HEIGHT_PX, PANEL_PADDING, PANEL_TUBE_TRAY_SPACING, PANEL_WIDTH_PX, POWER_CONNECTORS, PatchPanelNode, type PathLayoutDirection, type PathLayoutEdgeInput, type PathLayoutStepInput, type Port, type PortBlock, type PortCableType, type PortPosition, type PortType, type PortVisualDimensions, type PortVisualInput, type PortVisualKind, type PowerConnectorConfig, PowerEdge, type PowerPortStyle, type PowerSide, RACK_HEADER_HEIGHT, RACK_WIDTH_PX, type RackConfig, type RackDevice, type RackDeviceType, type RackLayoutMode, type RackMountMode, type RackMountedNodeType, RackNode, type RackNodeData, type RackNodeProps, type RackSchemaOptions, type RawNetboxTemplate, type RawTemplatePort, type RawTemplatePortBlock, type ReplaceEdgeOptions, type SpliceConfig, SpliceNode, SplicePlacementError, type SplicePlacementValidation, type SpliceSchemaOptions, type SpliceTrayConfig, SpliceTrayNode, TEMPLATE_SCHEMA_VERSION, type TemplateFaceData, type TemplateFrontRearPortLink, type TemplateParseResult, type TemplatePort, type TemplatePortBlock, type TemplateSource, type TemplateValidationIssue, type TemplateValidationReport, type TemplateWidth, TubeNode, type UNumberingDirection, U_HEIGHT_PX, type ValidateConnectionParams, type ValidationResult, VerticalPDU, Width, addDeviceToRack, addSpliceToTray, applyDeviceDisplayToNodes, applyDiagramFocusToEdges, applyDiagramFocusToNodes, baseColorFor, buildDevicePortGroupsFromPorts, buildNodesFromRackConfig, buildNodesFromSpliceConfig, buildPathLayoutGraph, buildPortBlocksFromPorts, buildPortHandleId, buildPortHandleId as buildReactNetworksHandleId, buildReactNetworksPortGroupsFromPorts, calculateClosureDimensions, calculateCouplerRightX, calculateCouplerSlotSpacing, calculateCouplerSpacing, calculateDevicePositionFromU, calculatePanelDimensions, calculateSlotPositionFromY, calculateSplicePositionFromNumber, calculateUPositions, calculateYFromSlotPosition, countTemplateFacePorts, createNetworkDiagramStore, createRackConfigFromNodes, createSpliceConfigFromNodes, diagramDocumentToNetworkGraph, fiberSolidOrStriped, findNearestRack, findNextAvailableHolderPosition, findNextAvailableUPosition, flattenDevicePortsFromGroups, flattenReactNetworksPortGroups, generateLayout, getConnectorConfig, getCouplerDimensions, getDefaultDeviceFace, getDeviceConnectorType, getEndpointMetadata, getFiberColor, getFrontPortBlocks, getInnerContentWidth, getPDUPortType, getPanelHeight, getPanelWidth, getPowerPortStyle, getRackBounds, getRearPortBlocks, getResolvedPortBlocks, getStandardPortVisualDimensions, getStatusColor, getTrayDimensions, getTubeDimensions, hasDiagramFocus, hasFrontPorts, hasRearPorts, inventoryCableToNetworkEdge, inventoryDeviceToNetworkNode, inventoryRackToNetworkNode, inventoryToDiagramDocument, inventoryToNetworkDiagram, isDeviceDiagramNode, isDiagramPortHandleHighlighted, isEdgeInDiagramFocus, isHighPowerConnector, isNodeInDiagramFocus, isPointInRack, isPowerPortType, isStriped, isUPositionAvailable, listPossiblePortHandleIds, looksLikePowerHandleId, netboxCableToNetworkEdge, netboxDeviceToNetworkNode, netboxRackToNetworkNode, netboxToDiagramDocument, netboxToNetworkDiagram, networkGraphToDiagramDocument, normalizeDevicePorts, normalizeDirectionalHandleId, normalizeHandleId, normalizePortPositionInput, normalizeReactNetworksPorts, parseNetboxTemplate, parseSemanticPortPosition, removeDeviceFromRack, removeSpliceFromTray, replaceEdge, resolveDevicePortBlocksFromFlatPorts, resolveDevicePortFace, resolveDevicePortGroup, resolveEndpointCompatibilityKeys, resolveNodeDevicePorts, resolvePortVisualKind, resolveReactNetworksNodePorts, resolveReactNetworksPortFace, resolveReactNetworksPortGroup, snapToCouplerPosition, snapToSplicePosition, snapToUPosition, updateDeviceUPosition$1 as updateDeviceUPosition, updateDeviceUPosition as updateDeviceUPositionInSchema, updateSpliceHolderPosition, useEdges as useDiagramEdges, useNodes as useDiagramNodes, useDiagramPortInteraction, useNetworkDiagram, validateAndSnapDevice, validatePortHandleOnNodeData, validateRackDevicePlacements, validateRenderFidelity, validateSplicePlacements };