@mp70/react-networks 0.5.1 → 0.7.0

package/dist/index.d.ts

@@ -1,47 +1,9 @@
-import React$1, { Component, ReactNode, ErrorInfo, CSSProperties } from 'react';
+import React, { Component, ReactNode, ErrorInfo, CSSProperties } from 'react';
+import { N as NetworkDiagramProps, a as NetworkNode, b as NetworkEdgeData, c as NetworkNodeDataBase, R as RackNodeData, D as DeviceNodeData, F as FibreFlowCableNodeData, d as FibreFlowClosureNodeData, e as FibreFlowClosure, f as FibreFlowCircuit, g as NetworkDiagramInteractionOptions, h as FibreFlowCable, i as NetworkEdge, j as DiagramDocument, k as RackConfig, l as RackDevice, S as SpliceTrayConfig, m as SpliceConfig, P as PortBlock, n as DevicePort, o as DeviceFace, p as PortType, q as DeviceStatus, r as DiagramPortHandleRef, s as DiagramPortClickPayload, t as PortCableType, u as PortPosition } from './document-adapter-B-6MM_tj.js';
+export { A as ApplyDirectionalPortHandleIdOptions, B as BuildPathLayoutOptions, v as DescribedPortHandle, w as DeviceImageFit, x as DeviceImageOptions, y as DeviceImageRepeat, z as DiagramEdge, C as DiagramEdgeEndpoint, E as DiagramEndpoint, G as DiagramExternalRef, H as DiagramNode, I as DiagramNodeKind, J as DiagramNodePlacement, K as DiagramNodeRender, L as DiagramUiState, M as FiberCable, O as FiberCableType, Q as FibreFlowCableKind, T as FibreFlowEndpoint, U as FibreFlowSplice, V as HandleShape, W as ListPossiblePortHandleIdsOptions, X as NetworkConnectionRejection, Y as NetworkDiagramActionPanelOptions, Z as NetworkDiagramFitViewOptions, _ as NetworkDiagramFlowMethods, $ as NetworkDiagramFlowObject, a0 as NetworkDiagramStoreApi, a1 as NetworkDiagramStoreState, a2 as NetworkDiagramToImageOptions, a3 as NetworkDiagramValidateConnectionParams, a4 as NetworkDiagramValidationResult, a5 as NetworkEdgeType, a6 as NetworkGraphSnapshot, a7 as NetworkNodeData, a8 as NetworkNodeDataByType, a9 as NetworkNodeType, aa as ParsedHandleId, ab as PathLayoutDirection, ac as PathLayoutEdgeInput, ad as PathLayoutStepInput, ae as Port, af as PowerSide, ag as RackDeviceType, ah as RackLayoutMode, ai as RackMountMode, aj as UNumberingDirection, ak as Width, al as applyDirectionalPortHandleId, am as applyFaceAliasHandleId, an as buildCouplerHandleId, ao as buildDevicePortGroupsFromPorts, ap as buildFiberHandleId, aq as buildPathLayoutGraph, ar as buildPortHandleId, as as buildReactNetworksHandleId, at as buildReactNetworksPortGroupsFromPorts, au as buildSpliceHandleId, av as buildSplitIoHandleId, aw as buildTubeHandleId, ax as describePortHandle, ay as diagramDocumentToNetworkGraph, az as flattenDevicePortsFromGroups, aA as flattenReactNetworksPortGroups, aB as getOppositeSideHandleId, aC as isPowerPortType, aD as listPossiblePortHandleIds, aE as looksLikePowerHandleId, aF as networkGraphToDiagramDocument, aG as normalizeDevicePorts, aH as normalizeDirectionalHandleId, aI as normalizeHandleId, aJ as normalizePortPositionInput, aK as normalizeReactNetworksPorts, aL as parseHandleId, aM as parseSemanticPortPosition, aN as resolveDevicePortBlocksFromFlatPorts, aO as resolveDevicePortFace, aP as resolveDevicePortGroup, aQ as resolveNodeDevicePorts, aR as resolveReactNetworksNodePorts, aS as resolveReactNetworksPortFace, aT as resolveReactNetworksPortGroup, aU as sanitizeHandleIdForMatching, aV as validatePortHandleOnNodeData } from './document-adapter-B-6MM_tj.js';
 import * as reactflow from 'reactflow';
-import { Node, NodeTypes, EdgeTypes, Connection, Edge, ConnectionMode, ReactFlowInstance, Viewport, FitViewOptions, NodeProps, EdgeProps } from 'reactflow';
-
-type FibreFlowCableKind = 'simple' | 'tube';
-interface FibreFlowEndpoint {
-    tube?: number;
-    fiber: number;
-}
-interface FibreFlowSplice {
-    id: string;
-    from: FibreFlowEndpoint;
-    to: FibreFlowEndpoint;
-    lossDb?: number;
-    circuitId?: string;
-    label?: string;
-    color?: string;
-}
-interface FibreFlowCable {
-    id: string;
-    label: string;
-    kind?: FibreFlowCableKind;
-    fiberCount?: number;
-    tubeCount?: number;
-    fibersPerTube?: number;
-    tubeStartIndex?: number;
-    fiberStartIndex?: number;
-    tubeColorMap?: Record<number, string>;
-    jacketColor?: string;
-    distanceLabel?: string;
-    distanceMeters?: number;
-}
-interface FibreFlowClosure {
-    id: string;
-    chamberId?: string;
-    leftCable: FibreFlowCable;
-    rightCable: FibreFlowCable;
-    splices: FibreFlowSplice[];
-}
-interface FibreFlowCircuit {
-    id: string;
-    label: string;
-    color?: string;
-}
+import { NodeProps, EdgeProps, Edge, Connection } from 'reactflow';
+export { Connection, ConnectionMode, EdgeTypes, FitViewOptions, NodeTypes, Position, ReactFlowInstance, Viewport, XYPosition } from 'reactflow';
 
 interface NetBoxPortPosition {
     side?: 'top' | 'right' | 'bottom' | 'left';
@@ -222,1040 +184,7 @@ interface NetBoxCable {
     };
 }
 
-/**
- * Rack device width configuration
- * @public
- */
-
-declare enum Width {
-    /** Full width device (19" rack width) */
-    FULL = "full",
-    /** Half width device (9.5" rack width) */
-    HALF = "half"
-}
-/**
- * Port configuration for network devices
- * @public
- */
-/**
- * Port type enumeration
- * @public
- */
-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';
-/**
- * Device image fit options.
- *
- * Values mirror object-fit terms for API ergonomics and are mapped to valid
- * background-size values by renderers where needed.
- *
- * @public
- */
-type DeviceImageFit = 'cover' | 'contain' | 'contain-height' | 'fill' | 'none' | 'scale-down';
-/**
- * Device image repeat options.
- * @public
- */
-type DeviceImageRepeat = 'no-repeat' | 'repeat' | 'repeat-x' | 'repeat-y';
-/**
- * Shared image configuration for rack-mounted devices and device nodes.
- * @public
- */
-interface DeviceImageOptions {
-    /** Optional front image URL for device background (PNG, SVG, JPEG, etc.) */
-    frontImageUrl?: string;
-    /** Optional rear image URL for device background (PNG, SVG, JPEG, etc.) */
-    rearImageUrl?: string;
-    /** Optional attribution URL for front image (e.g. source/license link) */
-    frontImageAttribution?: string;
-    /** Optional attribution URL for rear image (e.g. source/license link) */
-    rearImageAttribution?: string;
-    /** Optional background sizing for device images */
-    imageFit?: DeviceImageFit;
-    /** Optional background position for device images */
-    imagePosition?: string;
-    /** Optional background repeat for device images */
-    imageRepeat?: DeviceImageRepeat;
-    /** When true, stretch device image to fill the device bounds (overrides imageFit) */
-    stretchToFit?: boolean;
-}
-/**
- * Explicit handle placement for a device/PDU port.
- * @public
- */
-interface PortPosition {
-    /** Handle side on the node */
-    side?: 'top' | 'right' | 'bottom' | 'left';
-    /** Side offset as percentage (0-100) */
-    offsetPercent?: number;
-    /** Side offset in pixels */
-    offsetPx?: number;
-    /** Absolute X position as percentage (0-100) */
-    xPercent?: number;
-    /** Absolute Y position as percentage (0-100) */
-    yPercent?: number;
-    /** Authored port width as a percentage of the rendered image frame */
-    widthPercent?: number;
-    /** Authored port height as a percentage of the rendered image frame */
-    heightPercent?: number;
-}
-/**
- * Recommended simple port input for device and PDU rendering.
- * Pass a flat array in `ports`; `react-networks` groups entries into front/rear
- * `PortBlock[]` internally using each port's `face` and `group`.
- * @public
- */
-interface DevicePort {
-    /** Stable handle identifier override (defaults to `group + label`, or `label` for power) */
-    id?: string;
-    /** Display label for the port */
-    label: string;
-    /** Front/rear device face. `back` is accepted as an alias for `rear`. */
-    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 */
-    sourceTypeLabel?: string;
-    /** Whether the port is currently connected */
-    connected?: boolean;
-    /** Type of port for styling and validation */
-    type?: PortType;
-    /** Cable type for connection validation */
-    cableType?: PortCableType;
-    /** Optional power connector type for rendering (mainly for PDU ports) */
-    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 */
-    order?: number;
-    /**
-     * Optional placement hint.
-     * Use `side` with `offsetPercent`/`offsetPx` for edge-anchored placement,
-     * or `xPercent`/`yPercent` for exact coordinates.
-     */
-    position?: PortPosition;
-}
-interface Port {
-    /** Stable handle identifier override (defaults to `label`) */
-    id?: string;
-    /** Display label for the port */
-    label: string;
-    /** Optional source/detected family label used for visual kind inference */
-    sourceTypeLabel?: string;
-    /** Whether the port is currently connected */
-    connected: boolean;
-    /** Type of port for styling and validation */
-    type?: PortType;
-    /** Cable type for connection validation */
-    cableType?: PortCableType;
-    /** Optional power connector type for rendering (mainly for PDU ports) */
-    connectorType?: 'C13' | 'C14' | 'C19' | 'C20';
-    /** Optional compatibility keys. When omitted, defaults are derived from type/cable/connector data. */
-    compatibility?: string[];
-    /** Optional explicit handle placement */
-    position?: PortPosition;
-}
-/**
- * Group of related ports on a device
- * @public
- */
-interface PortBlock {
-    /** Name of the port group */
-    name: string;
-    /** Array of ports in this group */
-    ports: Port[];
-}
-/**
- * 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';
-/**
- * Device status states
- * @public
- */
-type DeviceStatus = 'active' | 'inactive' | 'maintenance';
-/**
- * Device face orientations
- * @public
- */
-type DeviceFace = 'front' | 'rear';
-type DiagramPortHandleRef = {
-    nodeId: string;
-    handleId: string;
-};
-type DiagramPortClickPayload = {
-    nodeId: string;
-    handleId: string;
-    groupName: string;
-    portLabel: string;
-    face: DeviceFace;
-};
-/**
- * Rack rendering layout modes.
- * @public
- */
-type RackLayoutMode = 'single-face' | 'split-face';
-/**
- * Rack mounting behavior for a device.
- * @public
- */
-type RackMountMode = 'front' | 'rear' | 'both';
-/**
- * Power port side configuration
- * @public
- */
-type PowerSide = 'left' | 'right';
-/**
- * U numbering direction for racks
- * @public
- */
-type UNumberingDirection = 'bottom-up' | 'top-down';
-/**
- * Shared node data fields available across node types.
- * Specific node kinds can narrow these fields via `NetworkNodeDataByType`.
- * @public
- */
-interface NetworkNodeDataBase extends DeviceImageOptions {
-    /** Display label for the node */
-    label: string;
-    /** Current status of the node/device */
-    status?: DeviceStatus | string;
-    /** Simple flat port input or grouped port blocks. Use `portGroups` / `rearPortGroups` for explicit grouped control. */
-    ports?: DevicePort[] | PortBlock[] | number;
-    /** Advanced grouped front port input */
-    portGroups?: PortBlock[];
-    /** Advanced grouped rear port input */
-    rearPortGroups?: PortBlock[];
-    /** Grouped rear port blocks (rack JSON alias for `rearPortGroups`) */
-    rearPorts?: PortBlock[];
-    /** List of connected node IDs */
-    connections?: string[];
-    /** NetBox integration ID */
-    netboxId?: number | string;
-    /** NetBox object type */
-    netboxType?: 'device' | 'rack' | 'interface' | 'cable' | string;
-    /** Inventory integration ID */
-    inventoryId?: number | string;
-    /** Inventory object type */
-    inventoryType?: 'device' | 'rack' | 'interface' | 'cable' | string;
-    /** Rack height in U units */
-    uHeight?: number;
-    /** Device position within rack in U units */
-    uPosition?: number;
-    /** Whether this node is currently mounted inside a rack container */
-    isRackMounted?: boolean;
-    /** Front/rear orientation for devices and rack faces */
-    face?: DeviceFace;
-    /** Rack rendering layout mode */
-    rackLayout?: RackLayoutMode;
-    /** Gap in pixels between front and rear faces in split-face mode */
-    rackFaceGapPx?: number;
-    /** Device mount behavior within a rack */
-    mountMode?: RackMountMode;
-    /** Device type specification */
-    deviceType?: string;
-    /**
-     * When false, device elevation renders as a status-colored block without front/rear photos.
-     * Defaults to true (show photos when URLs exist).
-     */
-    showDeviceImages?: boolean;
-    /** Device manufacturer */
-    manufacturer?: string;
-    /** Device role in network */
-    role?: string;
-    /** Device width configuration */
-    width?: Width | number;
-    /** Power port side for rear face */
-    powerSide?: PowerSide;
-    /** Vertical PDU height in centimeters */
-    heightCm?: number;
-    /** Number of AC power ports */
-    powerPorts?: number;
-    /** Optional explicit PDU connector sequence */
-    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';
-    /** U numbering direction for rack nodes */
-    uNumberingDirection?: UNumberingDirection;
-    /** Custom header text for rack nodes */
-    customHeaderText?: string;
-    /** Rack UI marker visibility */
-    showUMarkers?: boolean;
-    /** Holder position within tray (1-12) for splice nodes */
-    holderPosition?: number;
-    /** Loss value in dB for splice nodes */
-    lossDb?: number;
-    /** Splice mode */
-    mode?: 'single' | 'ribbon';
-    /** Legacy ribbon flag */
-    ribbon?: boolean;
-    /** Ribbon fiber IDs */
-    ribbonFiberIds?: number[];
-    /** Connector type for coupler nodes */
-    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 */
-    portLabelsLeft?: string[];
-    /** Optional port labels for right side of coupler */
-    portLabelsRight?: string[];
-    /** Slot position for couplers inside panels (1-based, vertical slots aligned to right edge) */
-    slotPosition?: number;
-    /** Width override for panel-like container nodes */
-    panelWidth?: number;
-    /** Height override for panel-like container nodes */
-    panelHeight?: number;
-    /** Width override for closure nodes */
-    closureWidth?: number;
-    /** Height override for closure nodes */
-    closureHeight?: number;
-    /** Optional rack width in pixels (for rack nodes, default: 300px) */
-    rackWidthPx?: number;
-    /** Number of rows for container nodes (patch-panel, closure) */
-    rows?: number;
-    /** Number of columns for container nodes (patch-panel, closure) */
-    cols?: number;
-    /** Number of trays for closure nodes */
-    trayCount?: number;
-    /** Header text for container nodes */
-    header?: string;
-    /** Type of fibre splitter: 'splitter' or 'WDM' (default: 'splitter') */
-    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) */
-    outputCount?: number;
-    /** Tube index (1-based) */
-    tubeIndex?: number;
-    /** Tube count for multi-tube cables */
-    tubeCount?: number;
-    /** Tube start index for multi-tube cables */
-    tubeStartIndex?: number;
-    /** Number of fibers per tube */
-    fibersPerTube?: number;
-    /** Total fiber count for cables */
-    fiberCount?: number;
-    /** Cable identifier */
-    cableId?: string;
-    /** Primary node color override */
-    color?: string;
-    /** Rotation in degrees for rotatable nodes */
-    rotation?: number;
-    /** Tube handle orientation */
-    startOn?: 'left-center' | 'left' | 'right';
-    /** Rack metadata for integrations */
-    facilityId?: string | number | null;
-    /** Rack serial metadata */
-    serial?: string | null;
-    /** Asset tag metadata */
-    assetTag?: string | null;
-    /** Site metadata */
-    site?: string;
-    /** Tenant metadata */
-    tenant?: string;
-    /** Primary IPv4 metadata */
-    primaryIp4?: string;
-    /** Primary IPv6 metadata */
-    primaryIp6?: string;
-    /** Rack name metadata */
-    rack?: string | number | null;
-    /** Optional arrays used by inventory/netbox transforms */
-    racks?: unknown[];
-    devices?: unknown[];
-    cables?: unknown[];
-    /** UI color mode metadata */
-    colorMode?: 'light' | 'dark' | 'system';
-    /** Generic dimensions used by some helpers */
-    height?: number;
-    headerHeight?: number;
-    /** Optional precomputed map for handle-to-face resolution */
-    handleSideMap?: Record<string, DeviceFace>;
-    /** Additional extension metadata */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Rack node data.
- * @public
- */
-interface RackNodeData extends NetworkNodeDataBase {
-    ports?: number;
-}
-/**
- * Device-like node data (servers/switches/routers/generic device).
- * @public
- */
-interface DeviceNodeData extends NetworkNodeDataBase {
-    ports?: DevicePort[] | PortBlock[] | number;
-}
-/**
- * Fibre flow cable node data.
- * @public
- */
-interface FibreFlowCableNodeData extends NetworkNodeDataBase {
-    cable: FibreFlowCable;
-    side: 'left' | 'right';
-    rowHeight: number;
-    columnWidth: number;
-    showTubeLabels: boolean;
-    showFiberNumbers: boolean;
-    layout: unknown;
-    colorMode?: 'dark' | 'light';
-}
-/**
- * Fibre flow closure node data.
- * @public
- */
-interface FibreFlowClosureNodeData extends NetworkNodeDataBase {
-    width?: number;
-    height?: number;
-    headerHeight?: number;
-    colorMode?: 'dark' | 'light';
-}
-/**
- * Mapping from node type to corresponding data type.
- * @public
- */
-interface NetworkNodeDataByType {
-    rack: RackNodeData;
-    switch: DeviceNodeData;
-    router: DeviceNodeData;
-    server: DeviceNodeData;
-    fiber: NetworkNodeDataBase;
-    'patch-panel': NetworkNodeDataBase;
-    device: DeviceNodeData;
-    'vertical-pdu': NetworkNodeDataBase;
-    splice: NetworkNodeDataBase;
-    'splice-tray': NetworkNodeDataBase;
-    tube: NetworkNodeDataBase;
-    cable: NetworkNodeDataBase;
-    'multi-tube-cable': NetworkNodeDataBase;
-    coupler: NetworkNodeDataBase;
-    closure: NetworkNodeDataBase;
-    'fibre-split': NetworkNodeDataBase;
-    'fibre-flow-cable': FibreFlowCableNodeData;
-    'fibre-flow-closure': FibreFlowClosureNodeData;
-}
-/**
- * Union of all node data variants.
- * @public
- */
-type NetworkNodeData = NetworkNodeDataByType[NetworkNodeType];
-/**
- * Network node structure with data discriminated by `type`.
- * @public
- */
-type NetworkNode<TType extends NetworkNodeType = NetworkNodeType, TExtra = unknown> = TType extends NetworkNodeType ? Node<NetworkNodeDataByType[TType] & TExtra, TType> & {
-    /** Type of network node */
-    type: TType;
-    /** Node data and configuration */
-    data: NetworkNodeDataByType[TType] & TExtra;
-} : never;
-/**
- * Network edge types
- * @public
- */
-type NetworkEdgeType = 'fiber' | 'ethernet' | 'power' | 'smoothstep' | 'step' | 'thick-cable' | 'fibre-flow' | 'fibre-flow-link';
-/**
- * Edge data payload.
- * @public
- */
-interface NetworkEdgeData {
-    /** Connection bandwidth */
-    bandwidth?: string;
-    /** Cable length */
-    length?: number;
-    /** Edge color for styling */
-    color?: string;
-    /** Edge kind for styling/validation */
-    kind?: 'fiber' | 'power' | 'network';
-    /** Whether this edge represents a ribbon fiber connection */
-    isRibbon?: boolean;
-    /** Array of fiber IDs for ribbon mode (6-12 fibers) */
-    ribbonFiberIds?: number[];
-    /** Highlight edge with a pulsing stroke */
-    highlight?: boolean;
-    /** Override highlight color (defaults to edge color) */
-    highlightColor?: string;
-    /** Override highlight max stroke width */
-    highlightWidth?: number;
-    /** Optional tag for grouping edges in demos */
-    traceTag?: string;
-    /** Legacy striped edge flag */
-    striped?: boolean;
-    /** Cable type metadata used by demos/helpers */
-    cableType?: PortCableType;
-    /** NetBox integration metadata */
-    netboxId?: number | string;
-    netboxType?: 'device' | 'rack' | 'interface' | 'cable' | string;
-    /** Inventory integration metadata */
-    inventoryId?: number | string;
-    inventoryType?: 'device' | 'rack' | 'interface' | 'cable' | string;
-    /** Status metadata */
-    status?: string;
-    /** Endpoint metadata */
-    terminationA?: string;
-    terminationB?: string;
-    /** Optional display label for the edge */
-    label?: string;
-    /** Optional opacity for styling (0–1) */
-    opacity?: number;
-    /** Optional power edge stroke width override */
-    powerStrokeWidth?: number;
-    /** Optional power edge stroke dasharray override */
-    powerStrokeDasharray?: string;
-    /** Optional power edge opacity override (0–1) */
-    powerOpacity?: number;
-    /** Additional extension metadata */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Network edge data structure
- * @public
- */
-type NetworkEdge<TData extends NetworkEdgeData = NetworkEdgeData> = {
-    /** Unique identifier for the edge */
-    id: string;
-    /** Source node ID */
-    source: string;
-    /** Target node ID */
-    target: string;
-    /** Source handle/port ID */
-    sourceHandle?: string;
-    /** Target handle/port ID */
-    targetHandle?: string;
-    /** Type of network connection */
-    type?: NetworkEdgeType;
-    /** Whether the edge should be hidden from rendering */
-    hidden?: boolean;
-    /** Edge data and configuration */
-    data?: TData;
-};
-/**
- * Canonical persisted/editor document schema independent from React Flow handle ids.
- * Prefer this model for saving diagrams, syncing external systems, and controlled
- * document-mode usage via `document` / `onDocumentChange`.
- * @public
- */
-interface DiagramDocument {
-    nodes: DiagramNode[];
-    edges: DiagramEdge[];
-    ui?: DiagramUiState;
-    metadata?: Record<string, unknown>;
-}
-/**
- * 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';
-/**
- * Placement data for document nodes.
- * @public
- */
-interface DiagramNodePlacement {
-    position: {
-        x: number;
-        y: number;
-    };
-    parentId?: string;
-    extent?: 'parent';
-    rack?: {
-        uPosition?: number;
-        mountMode?: RackMountMode;
-        rackLayout?: RackLayoutMode;
-        rackWidthPx?: number;
-        rackFaceGapPx?: number;
-    };
-    container?: {
-        slotPosition?: number;
-        holderPosition?: number;
-    };
-}
-/**
- * Endpoint definition for document nodes.
- * @public
- */
-interface DiagramEndpoint {
-    id: string;
-    label: string;
-    face?: DeviceFace | 'internal';
-    group?: string;
-    role?: 'network' | 'power' | 'fiber' | 'tube' | 'splice' | 'coupler' | 'splitter' | 'cable' | 'generic';
-    medium?: 'ethernet' | 'fiber' | 'power' | 'tube' | 'generic';
-    type?: PortType;
-    cableType?: PortCableType;
-    connector?: string;
-    compatibility?: string[];
-    layout?: PortPosition;
-}
-/**
- * Render-focused node data for the document model.
- * @public
- */
-interface DiagramNodeRender {
-    status?: DeviceStatus | string;
-    face?: DeviceFace;
-    width?: Width | number;
-    widthPx?: number;
-    height?: number;
-    header?: string;
-    color?: string;
-    colorMode?: 'light' | 'dark' | 'system';
-    rackWidthPx?: number;
-    rackFaceGapPx?: number;
-    images?: DeviceImageOptions;
-    dimensions?: Record<string, number | undefined>;
-    showUMarkers?: boolean;
-    customHeaderText?: string;
-    powerSide?: PowerSide;
-    rotation?: number;
-}
-/**
- * External reference attached to a document node.
- * @public
- */
-interface DiagramExternalRef {
-    source: 'netbox' | 'inventory' | string;
-    id: string | number;
-    type?: string;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Document node.
- * @public
- */
-interface DiagramNode {
-    id: string;
-    kind: DiagramNodeKind;
-    subtype?: string;
-    label: string;
-    placement: DiagramNodePlacement;
-    endpoints?: DiagramEndpoint[];
-    render?: DiagramNodeRender;
-    config?: Record<string, unknown>;
-    externalRefs?: DiagramExternalRef[];
-    metadata?: Record<string, unknown>;
-}
-/**
- * Endpoint reference used by document edges.
- * @public
- */
-interface DiagramEdgeEndpoint {
-    nodeId: string;
-    endpointId?: string | null;
-}
-/**
- * Document edge.
- * @public
- */
-interface DiagramEdge {
-    id: string;
-    source: DiagramEdgeEndpoint;
-    target: DiagramEdgeEndpoint;
-    type?: NetworkEdgeType;
-    hidden?: boolean;
-    data?: NetworkEdgeData;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Non-topology UI state stored alongside a document.
- * @public
- */
-interface DiagramUiState {
-    nodeState?: Record<string, {
-        face?: DeviceFace;
-        handleSideMap?: Record<string, DeviceFace>;
-    }>;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Rack device types
- * @public
- */
-type RackDeviceType = 'server' | 'switch' | 'router' | 'patch-panel' | 'ups';
-/**
- * Rack configuration structure
- * @public
- */
-interface RackConfig {
-    /** Unique rack identifier */
-    id: string;
-    /** Rack display name */
-    name: string;
-    /** Rack position coordinates */
-    position: {
-        x: number;
-        y: number;
-    };
-    /** Rack height in U units */
-    units: number;
-    /** U numbering direction (default: 'bottom-up') */
-    uNumberingDirection?: UNumberingDirection;
-    /** Custom header text for rack */
-    customHeaderText?: string;
-    /** Rack rendering layout mode */
-    rackLayout?: RackLayoutMode;
-    /** Gap in pixels between front and rear faces in split-face mode */
-    rackFaceGapPx?: number;
-    /** Devices mounted in the rack */
-    devices: RackDevice[];
-    /** Optional rack width in pixels (default: 300px which represents standard 48.26cm/19" rack) */
-    rackWidthPx?: number;
-}
-/**
- * Device mounted in a rack
- * @public
- */
-interface RackDevice extends DeviceImageOptions {
-    /** Unique device identifier */
-    id: string;
-    /** Device display name */
-    name: string;
-    /** Starting U position in rack */
-    unit: number;
-    /** Device height in U units */
-    height: number;
-    /** Device type */
-    type: RackDeviceType;
-    /** Device width configuration */
-    width?: Width;
-    /** Device mount behavior within a rack */
-    mountMode?: RackMountMode;
-    /** Device role in network */
-    role?: string;
-    /** Recommended simple port input (flat `DevicePort[]` or grouped `PortBlock[]`). */
-    ports?: DevicePort[] | PortBlock[];
-    /** Current status of the device */
-    status?: DeviceStatus | string;
-    /** Advanced grouped front port input */
-    portGroups?: PortBlock[];
-    /** Advanced grouped rear port input */
-    rearPortGroups?: PortBlock[];
-    /** Grouped rear port blocks (rack JSON alias for `rearPortGroups`) */
-    rearPorts?: PortBlock[];
-    /** Power port side for rear face */
-    powerSide?: PowerSide;
-    /** Connected device IDs */
-    connections?: string[];
-}
-/**
- * Fiber cable types
- * @public
- */
-type FiberCableType = 'single-mode' | 'multi-mode';
-/**
- * Fiber cable configuration
- * @public
- */
-interface FiberCable {
-    /** Unique cable identifier */
-    id: string;
-    /** Cable display name */
-    name: string;
-    /** Fiber cable type */
-    type: FiberCableType;
-    /** Cable length */
-    length: number;
-    /** Cable color for visualization */
-    color: string;
-    /** Connection endpoints */
-    connections: {
-        /** Source connection point */
-        from: string;
-        /** Target connection point */
-        to: string;
-    };
-}
-/**
- * Splice configuration structure
- * @public
- */
-interface SpliceConfig {
-    /** Unique splice identifier */
-    id: string;
-    /** Splice display name */
-    name: string;
-    /** Holder position within tray (1-12) */
-    holder: number;
-    /** Loss value in dB */
-    lossDb?: number;
-    /** Splice mode: 'single' for individual fiber, 'ribbon' for ribbon splices */
-    mode?: 'single' | 'ribbon';
-    /** For ribbon mode: array of fiber IDs (6-12) in the ribbon */
-    ribbonFiberIds?: number[];
-}
-/**
- * Splice tray configuration structure
- * @public
- */
-interface SpliceTrayConfig {
-    /** Unique tray identifier */
-    id: string;
-    /** Tray display name */
-    name: string;
-    /** Tray position coordinates */
-    position: {
-        x: number;
-        y: number;
-    };
-    /** Splices in this tray */
-    splices: SpliceConfig[];
-}
-/**
- * Fine-grained interaction controls for network diagrams.
- * @public
- */
-interface NetworkDiagramInteractionOptions {
-    /** Enable node dragging. */
-    nodesDraggable?: boolean;
-    /** Enable creating connections from node handles. */
-    nodesConnectable?: boolean;
-    /** Enable selecting nodes/edges. */
-    elementsSelectable?: boolean;
-    /** Enable keyboard/mouse focus on edges. */
-    edgesFocusable?: boolean;
-    /** Enable reconnecting existing edges. */
-    edgesReconnectable?: boolean;
-    /** Enable click-to-connect behavior on handles. */
-    connectOnClick?: boolean;
-    /** Enable panning by dragging the canvas. */
-    panOnDrag?: boolean;
-    /** Enable panning by scrolling. */
-    panOnScroll?: boolean;
-    /** Enable zoom via mouse wheel/trackpad scroll. */
-    zoomOnScroll?: boolean;
-    /** Enable pinch-zoom gestures. */
-    zoomOnPinch?: boolean;
-    /** Enable zoom on double click. */
-    zoomOnDoubleClick?: boolean;
-    /** Enable deleting selected edges with keyboard keys. */
-    allowKeyboardDelete?: boolean;
-    /** Show or hide the built-in React Flow controls widget. */
-    showControls?: boolean;
-    /** Show or hide the minimap. */
-    showMiniMap?: boolean;
-    /** Show or hide the interactive lock/unlock button in controls. */
-    showInteractiveControl?: boolean;
-}
-/**
- * Selection action panel options rendered above selected racks/devices.
- * @public
- */
-interface NetworkDiagramActionPanelOptions {
-    /** Enable or disable the floating action panel entirely. Defaults to true. */
-    enabled?: boolean;
-    /** Show or hide the front/rear toggle button. Defaults to true. */
-    showRearToggle?: boolean;
-    /** Show or hide the De-rack button for rack-mounted devices. Defaults to true. */
-    showDeRack?: boolean;
-}
-/**
- * Serializable flow snapshot payload for save/restore helpers.
- * @public
- */
-interface NetworkDiagramFlowObject {
-    /** Snapshot nodes */
-    nodes: NetworkNode[];
-    /** Snapshot edges */
-    edges: NetworkEdge[];
-    /** Optional viewport state */
-    viewport?: Viewport;
-}
-/**
- * Options for exported diagram images.
- * @public
- */
-interface NetworkDiagramToImageOptions {
-    /** Export width in px (clamped to 1-8192). */
-    width?: number;
-    /** Export height in px (clamped to 1-8192). */
-    height?: number;
-    backgroundColor?: string;
-    /** Export padding in px (clamped to 0-2048). */
-    padding?: number;
-    /** Device pixel ratio multiplier (clamped to 0.1-4). */
-    pixelRatio?: number;
-    /** JPEG/WebP quality (clamped to 0-1 when used). */
-    quality?: number;
-    filter?: (domNode: HTMLElement) => boolean;
-}
-/**
- * Fit-view options that support targeting node IDs directly.
- * @public
- */
-interface NetworkDiagramFitViewOptions extends Omit<FitViewOptions, 'nodes'> {
-    /** Optional node IDs to fit */
-    nodes?: string[];
-}
-/**
- * Exposed methods for save/restore and export integrations.
- * @public
- */
-interface NetworkDiagramFlowMethods {
-    toObject: () => NetworkDiagramFlowObject;
-    setViewport: (viewport: Viewport) => void;
-    setNodes: (nodes: NetworkNode[]) => void;
-    setEdges: (edges: NetworkEdge[]) => void;
-    toImage: (options?: NetworkDiagramToImageOptions) => Promise<string>;
-    getNodes: () => NetworkNode[];
-    getEdges: () => NetworkEdge[];
-    fitView: (options?: NetworkDiagramFitViewOptions) => void;
-}
-/**
- * Store state shape used by `NetworkDiagramStoreApi`.
- * @public
- */
-interface NetworkDiagramStoreState {
-    nodes: NetworkNode[];
-    edges: NetworkEdge[];
-    debug?: boolean;
-}
-/**
- * Store connection validation parameters.
- * @public
- */
-interface NetworkDiagramValidateConnectionParams {
-    source: string | null;
-    target: string | null;
-    sourceHandle?: string | null;
-    targetHandle?: string | null;
-}
-/**
- * Store connection validation result.
- * @public
- */
-interface NetworkDiagramValidationResult {
-    valid: boolean;
-    reason?: string;
-}
-/**
- * Store contract accepted by `NetworkDiagram`.
- * @public
- */
-interface NetworkDiagramStoreApi {
-    getState: () => NetworkDiagramStoreState;
-    setState: (partial: Partial<NetworkDiagramStoreState>) => void;
-    subscribe: (listener: (state: NetworkDiagramStoreState) => void) => () => void;
-    selectEdgeZIndex: (edge: NetworkEdge) => number;
-    validateConnection: (params: NetworkDiagramValidateConnectionParams) => NetworkDiagramValidationResult;
-    selectNodeById: (id: string) => NetworkNode | undefined;
-    selectConnectedEdges: (nodeId: string) => NetworkEdge[];
-}
-/**
- * Network diagram component props
- * @public
- */
-interface NetworkDiagramProps {
-    /** Controlled document model. When provided, it takes precedence over nodes/edges props. */
-    document?: DiagramDocument;
-    /** Initial document for uncontrolled document mode. */
-    initialDocument?: DiagramDocument;
-    /** Callback when the document changes in document mode. */
-    onDocumentChange?: (document: DiagramDocument) => void;
-    /** Controlled nodes array */
-    nodes?: NetworkNode[];
-    /** Controlled edges array */
-    edges?: NetworkEdge[];
-    /** Callback when nodes change (controlled mode) */
-    onNodesChange?: (nodes: NetworkNode[]) => void;
-    /** Callback when edges change (controlled mode) */
-    onEdgesChange?: (edges: NetworkEdge[]) => void;
-    /** Initial nodes for uncontrolled mode */
-    initialNodes?: NetworkNode[];
-    /** Initial edges for uncontrolled mode */
-    initialEdges?: NetworkEdge[];
-    /** Headless store injection */
-    store?: NetworkDiagramStoreApi;
-    /** Enable debug mode */
-    debug?: boolean;
-    /** Callback when a node is clicked or selection changes (null when deselected) */
-    onNodeClick?: (node: NetworkNode | null) => void;
-    /** Callback when an edge is clicked */
-    onEdgeClick?: (edge: NetworkEdge) => void;
-    /** Custom React Flow node types to merge with defaults */
-    nodeTypes?: NodeTypes;
-    /** Custom React Flow edge types to merge with defaults */
-    edgeTypes?: EdgeTypes;
-    /** Optional onConnect override (React Flow connection handler) */
-    onConnect?: (connection: Connection) => void;
-    /** Optional onEdgeUpdate override */
-    onEdgeUpdate?: (oldEdge: Edge, newConnection: Connection) => void;
-    /** Optional isValidConnection override */
-    isValidConnection?: (connection: Connection) => boolean;
-    /** Optional connection mode override */
-    connectionMode?: ConnectionMode;
-    /** Callback when a device face changes */
-    onFaceChange?: (nodeId: string, face: DeviceFace) => void;
-    /** Callback when rack face changes */
-    onRackFaceChange?: (rackId: string, face: DeviceFace) => void;
-    /** CSS class name */
-    className?: string;
-    /** Inline styles */
-    style?: React.CSSProperties;
-    /** If true, vertically align rack bottoms to the same baseline */
-    alignRacksToBottom?: boolean;
-    /** 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';
-    /** Callback when React Flow instance is initialized */
-    onInit?: (instance: ReactFlowInstance) => void;
-    /** Callback to get React Flow methods for save/restore */
-    onFlowMethods?: (methods: NetworkDiagramFlowMethods) => void;
-    /** Show download button */
-    showDownloadButton?: boolean;
-    /** Download button position */
-    downloadButtonPosition?: 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
-    /** Custom download button text */
-    downloadButtonText?: string;
-    /** Download button styling options */
-    downloadButtonStyle?: React.CSSProperties;
-    /** Use smoothstep edges for tube connections (both tube-to-cable and cable-to-tube). Default is fiber. */
-    useSmoothstepEdgesForTubes?: boolean;
-    /** Force read-only behavior for the diagram (no drag/connect/delete/reconnect/pan/zoom edits). */
-    readOnly?: boolean;
-    /** Centralized interaction options for consistent edit/lock behavior. */
-    interaction?: NetworkDiagramInteractionOptions;
-    /** Configuration for the floating action panel shown on selected rack/device nodes. */
-    actionPanel?: NetworkDiagramActionPanelOptions;
-    /** Optional fitView options passed to React Flow */
-    fitViewOptions?: FitViewOptions;
-    /**
-     * Let React Flow render only viewport-visible nodes and edges.
-     * Defaults to true, matching the library's existing large-diagram behavior.
-     */
-    onlyRenderVisibleElements?: boolean;
-    /** Node IDs to keep at full opacity when diagram focus dimming is enabled */
-    highlightedNodeIds?: string[];
-    /** Edge IDs to keep at full opacity when diagram focus dimming is enabled */
-    highlightedEdgeIds?: string[];
-    /**
-     * When true, non-highlighted nodes and edges are dimmed while focus IDs are set.
-     * Edges connected to highlighted nodes remain in focus unless
-     * `connectEdgesToHighlightedNodes` is false.
-     */
-    dimUnhighlighted?: boolean;
-    /** Opacity for dimmed nodes/edges (0-1). Defaults to 0.25 */
-    dimOpacity?: number;
-    /** When false, only explicit highlightedEdgeIds stay bright during focus. */
-    connectEdgesToHighlightedNodes?: boolean;
-    /** When false, devices render without rack photos. Status border still uses `getStatusColor`. Default true. */
-    showDeviceImages?: boolean;
-    /** Port handles kept highlighted during diagram trace/focus. */
-    highlightedPortHandles?: DiagramPortHandleRef[];
-    /** Fired when a port handle is clicked (typically in read-only trace mode). */
-    onPortClick?: (payload: DiagramPortClickPayload) => void;
-}
-
-declare const NetworkDiagram: React$1.FC<NetworkDiagramProps>;
+declare const NetworkDiagram: React.FC<NetworkDiagramProps>;
 
 interface DiagramErrorBoundaryProps {
     /** Content to render when an error is caught */
@@ -1301,16 +230,23 @@ interface RackNodeProps extends NodeProps<NetworkNode['data']> {
     onRackFaceChange?: (rackId: string, face: 'front' | 'rear') => void;
     isDragOver?: boolean;
 }
-/** Memoized; uses useStoreApi (not useReactFlow) so rack chrome does not re-render on every node move. */
-declare const RackNode: React$1.NamedExoticComponent<RackNodeProps>;
+/**
+ * Memoized; uses useStoreApi (not useReactFlow) so rack chrome does not re-render on every node move.
+ *
+ * The comparator intentionally omits the `onFaceChange` / `onRackFaceChange` function
+ * props: this is only safe because `NetworkDiagram` passes them as ref-backed stable
+ * callbacks. If a caller ever renders `RackNode` with unstable face-change handlers,
+ * add them here or the node will keep a stale callback.
+ */
+declare const RackNode: React.NamedExoticComponent<RackNodeProps>;
 
-declare const FiberNode: React$1.FC<NodeProps<NetworkNode['data']>>;
+declare const FiberNode: React.FC<NodeProps<NetworkNode['data']>>;
 
-declare const FiberEdge: React$1.NamedExoticComponent<Pick<reactflow.Edge<NetworkEdgeData | undefined>, "id" | "data" | "source" | "target" | "style" | "selected" | "animated"> & Pick<reactflow.WrapEdgeProps<any>, "sourcePosition" | "targetPosition" | "interactionWidth" | "sourceX" | "sourceY" | "targetX" | "targetY" | "sourceHandleId" | "targetHandleId"> & {
-    label?: string | React$1.ReactNode;
-    labelStyle?: React$1.CSSProperties;
+declare const FiberEdge: React.NamedExoticComponent<Pick<reactflow.Edge<NetworkEdgeData | undefined>, "id" | "source" | "target" | "data" | "style" | "selected" | "animated"> & Pick<reactflow.WrapEdgeProps<any>, "sourcePosition" | "targetPosition" | "interactionWidth" | "sourceX" | "sourceY" | "targetX" | "targetY" | "sourceHandleId" | "targetHandleId"> & {
+    label?: string | React.ReactNode;
+    labelStyle?: React.CSSProperties;
     labelShowBg?: boolean;
-    labelBgStyle?: React$1.CSSProperties;
+    labelBgStyle?: React.CSSProperties;
     labelBgPadding?: [number, number];
     labelBgBorderRadius?: number;
 } & {
@@ -1321,16 +257,16 @@ declare const FiberEdge: React$1.NamedExoticComponent<Pick<reactflow.Edge<Networ
     className?: string;
 }>;
 
-declare const PowerEdge: React$1.NamedExoticComponent<EdgeProps>;
+declare const PowerEdge: React.NamedExoticComponent<EdgeProps>;
 
 /** Memoized to avoid re-rendering rack devices when unrelated nodes move (React Flow perf guide). */
-declare const DeviceNode: React$1.NamedExoticComponent<NodeProps<NetworkNodeDataBase | RackNodeData | DeviceNodeData | FibreFlowCableNodeData | FibreFlowClosureNodeData>>;
+declare const DeviceNode: React.NamedExoticComponent<NodeProps<NetworkNodeDataBase | RackNodeData | DeviceNodeData | FibreFlowCableNodeData | FibreFlowClosureNodeData>>;
 
-declare const VerticalPDU: React$1.NamedExoticComponent<NodeProps<NetworkNodeDataBase | RackNodeData | DeviceNodeData | FibreFlowCableNodeData | FibreFlowClosureNodeData>>;
+declare const VerticalPDU: React.NamedExoticComponent<NodeProps<NetworkNodeDataBase | RackNodeData | DeviceNodeData | FibreFlowCableNodeData | FibreFlowClosureNodeData>>;
 
-declare const SpliceNode: React$1.FC<NodeProps<NetworkNode['data']>>;
+declare const SpliceNode: React.FC<NodeProps<NetworkNode['data']>>;
 
-declare const SpliceTrayNode: React$1.FC<NodeProps<NetworkNode['data']>>;
+declare const SpliceTrayNode: React.FC<NodeProps<NetworkNode['data']>>;
 
 /**
  * TubeNode
@@ -1342,7 +278,7 @@ declare const SpliceTrayNode: React$1.FC<NodeProps<NetworkNode['data']>>;
  *   - 'left': handles on left side, tube handle on left
  *   - 'right': handles on right side with reversed colors, tube handle on right
  */
-declare const TubeNode: React$1.FC<NodeProps<NetworkNode['data']>>;
+declare const TubeNode: React.FC<NodeProps<NetworkNode['data']>>;
 
 /**
  * CableNode
@@ -1350,7 +286,7 @@ declare const TubeNode: React$1.FC<NodeProps<NetworkNode['data']>>;
  * - Each colored handle corresponds to a single fiber
  * - Displays cable summary text (fiber count + cable identifier)
  */
-declare const CableNode: React$1.FC<NodeProps<NetworkNode['data']>>;
+declare const CableNode: React.FC<NodeProps<NetworkNode['data']>>;
 
 /**
  * MultiTubeCableNode
@@ -1358,13 +294,13 @@ declare const CableNode: React$1.FC<NodeProps<NetworkNode['data']>>;
  * - Each colored handle corresponds to a tube within the cable
  * - Displays cable summary text (fiber count + cable identifier)
  */
-declare const MultiTubeCableNode: React$1.FC<NodeProps<NetworkNode['data']>>;
+declare const MultiTubeCableNode: React.FC<NodeProps<NetworkNode['data']>>;
 
-declare const CouplerNode: React$1.FC<NodeProps<NetworkNode['data']>>;
+declare const CouplerNode: React.FC<NodeProps<NetworkNode['data']>>;
 
-declare const PatchPanelNode: React$1.FC<NodeProps<NetworkNode['data']>>;
+declare const PatchPanelNode: React.FC<NodeProps<NetworkNode['data']>>;
 
-declare const ClosureNode: React$1.FC<NodeProps<NetworkNode['data']>>;
+declare const ClosureNode: React.FC<NodeProps<NetworkNode['data']>>;
 
 /**
  * FibreSplitNode component for rendering fiber splitters and WDM devices
@@ -1372,7 +308,7 @@ declare const ClosureNode: React$1.FC<NodeProps<NetworkNode['data']>>;
  *
  * @public
  */
-declare const FibreSplitNode: React$1.FC<NodeProps<NetworkNode['data']>>;
+declare const FibreSplitNode: React.FC<NodeProps<NetworkNode['data']>>;
 
 type FibreFlowLayoutDirection = 'horizontal' | 'vertical';
 type FibreFlowColorMode = 'dark' | 'light';
@@ -1391,11 +327,11 @@ interface FibreFlowMapProps {
     colorMode?: FibreFlowColorMode;
     showCircuitId?: boolean;
     className?: string;
-    style?: React$1.CSSProperties;
+    style?: React.CSSProperties;
     readOnly?: boolean;
     interaction?: NetworkDiagramInteractionOptions;
 }
-declare const FibreFlowMap: React$1.FC<FibreFlowMapProps>;
+declare const FibreFlowMap: React.FC<FibreFlowMapProps>;
 
 interface FibreFlowRow {
     key: string;
@@ -1429,7 +365,7 @@ interface FibreCableWithTubesExpandedProps {
     showFiberNumbers?: boolean;
     showCableLabel?: boolean;
 }
-declare const FibreCableWithTubesExpanded: React$1.FC<FibreCableWithTubesExpandedProps>;
+declare const FibreCableWithTubesExpanded: React.FC<FibreCableWithTubesExpandedProps>;
 
 interface InventoryRackDTO {
     id: string | number;
@@ -2106,13 +1042,20 @@ declare function buildPortBlocksFromPorts(devicePorts: DevicePort[]): {
     rearPorts: PortBlock[];
 };
 /**
- * Resolve the grouped front/rear port blocks from either supported input form:
- * flat `ports: DevicePort[]` or explicit `portGroups` / `rearPortGroups`.
+ * Node-data subset accepted by {@link getResolvedPortBlocks}: a flat
+ * `DevicePort[]` on `ports`, grouped `PortBlock[]` on
+ * `ports`/`portGroups`/`rearPortGroups`, or a `rearPorts` block fallback.
  * @public
  */
 type ResolvedPortBlockInput = Pick<NetworkNode['data'], 'ports' | 'portGroups' | 'rearPortGroups'> & {
     rearPorts?: PortBlock[];
 };
+/**
+ * Resolve the grouped front/rear port blocks from any supported input form:
+ * flat `ports: DevicePort[]`, grouped `PortBlock[]`, or explicit
+ * `portGroups` / `rearPortGroups`.
+ * @public
+ */
 declare function getResolvedPortBlocks(data: ResolvedPortBlockInput | undefined): {
     ports: PortBlock[];
     rearPorts: PortBlock[];
@@ -2143,146 +1086,6 @@ declare function hasRearPorts(data: Pick<NetworkNode['data'], 'ports' | 'portGro
  */
 declare function getDefaultDeviceFace(data: Pick<NetworkNode['data'], 'ports' | 'portGroups' | 'rearPortGroups'> | undefined): DeviceFace;
 
-/**
- * Normalize source/target directional suffixes used for bidirectional handles.
- * Example: `Rear Ports-1-target` -\> `Rear Ports-1`.
- */
-declare function normalizeDirectionalHandleId(handleId: string | null | undefined): string;
-/**
- * Normalize rendered handle ids back to their canonical endpoint id.
- * This removes both directional suffixes and split-face rear aliases.
- */
-declare function normalizeHandleId(handleId: string | null | undefined): string;
-/**
- * Returns true when a port type is considered power-related.
- */
-declare function isPowerPortType(portType: string | undefined): boolean;
-/**
- * Build a stable handle id for a port.
- * Power ports use the label directly to preserve legacy ids.
- */
-declare function buildPortHandleId(portBlockName: string, port: Pick<Port, 'label' | 'id'> & {
-    type?: string;
-}): string;
-/**
- * Heuristic for whether a handle id represents a power endpoint.
- */
-declare function looksLikePowerHandleId(handleId: string): boolean;
-
-/**
- * Resolve the effective device face for a flat port input.
- * @public
- */
-declare function resolveDevicePortFace(port: Pick<DevicePort, 'face' | 'type'>): DeviceFace;
-/** @deprecated Use {@link resolveDevicePortFace}. */
-declare const resolveReactNetworksPortFace: typeof resolveDevicePortFace;
-/**
- * Resolve the effective port group name for a flat port input.
- * @public
- */
-declare function resolveDevicePortGroup(port: Pick<DevicePort, 'face' | 'group' | 'type'>): string;
-/** @deprecated Use {@link resolveDevicePortGroup}. */
-declare const resolveReactNetworksPortGroup: typeof resolveDevicePortGroup;
-/**
- * Normalize unknown port array input into canonical flat {@link DevicePort} entries.
- * @public
- */
-declare function normalizeDevicePorts(value: unknown): DevicePort[] | undefined;
-/** @deprecated Use {@link normalizeDevicePorts}. */
-declare const normalizeReactNetworksPorts: typeof normalizeDevicePorts;
-/**
- * Resolve flat device ports from node data supporting flat or grouped port input.
- * @public
- */
-declare function resolveNodeDevicePorts(value: unknown): DevicePort[] | undefined;
-/** @deprecated Use {@link resolveNodeDevicePorts}. */
-declare const resolveReactNetworksNodePorts: typeof resolveNodeDevicePorts;
-/**
- * Flatten grouped port blocks into canonical flat {@link DevicePort} entries.
- * @public
- */
-declare function flattenDevicePortsFromGroups({ portGroups, rearPortGroups, }: {
-    portGroups?: PortBlock[];
-    rearPortGroups?: PortBlock[];
-}): DevicePort[];
-/** @deprecated Use {@link flattenDevicePortsFromGroups}. */
-declare const flattenReactNetworksPortGroups: typeof flattenDevicePortsFromGroups;
-/**
- * Build grouped port blocks from flat device port input.
- * @public
- */
-declare function buildDevicePortGroupsFromPorts(ports: DevicePort[] | undefined): {
-    portGroups: PortBlock[];
-    rearPortGroups: PortBlock[];
-};
-/** @deprecated Use {@link buildDevicePortGroupsFromPorts}. */
-declare const buildReactNetworksPortGroupsFromPorts: typeof buildDevicePortGroupsFromPorts;
-interface ListPossiblePortHandleIdsOptions {
-    deviceType?: string;
-    face?: DeviceFace;
-}
-/**
- * List handle ids that may exist on a rendered node for a port.
- * @public
- */
-declare function listPossiblePortHandleIds(portBlockName: string, port: Pick<Port, 'id' | 'label' | 'type'>, options?: ListPossiblePortHandleIdsOptions): string[];
-/**
- * Validate that a handle id exists on node data after grouping resolution.
- * @public
- */
-declare function validatePortHandleOnNodeData(nodeData: Pick<NetworkNodeDataBase, 'ports' | 'portGroups' | 'rearPortGroups'> | undefined, handle: string, options?: {
-    deviceType?: string;
-    sanitizeHandle?: (value: string) => string;
-}): boolean;
-/**
- * Convert flat ports to grouped blocks using the same rules as renderers.
- * @public
- */
-declare function resolveDevicePortBlocksFromFlatPorts(ports: DevicePort[]): {
-    portGroups: PortBlock[];
-    rearPortGroups: PortBlock[];
-};
-
-declare const parseSemanticPortPosition: (value: string) => PortPosition | undefined;
-declare const normalizePortPositionInput: (value: unknown) => PortPosition | undefined;
-
-type PathLayoutDirection = 'horizontal' | 'vertical';
-interface PathLayoutStepInput {
-    id: string;
-    type?: NetworkNode['type'];
-    data?: NetworkNode['data'];
-}
-interface PathLayoutEdgeInput {
-    id: string;
-    source: string;
-    target: string;
-    type?: NetworkEdge['type'];
-    data?: NetworkEdge['data'];
-}
-interface BuildPathLayoutOptions {
-    direction?: PathLayoutDirection;
-    spacing?: number;
-    origin?: {
-        x: number;
-        y: number;
-    };
-}
-/**
- * Lay out a sequential path of nodes and connecting edges with deterministic spacing.
- * @public
- */
-declare function buildPathLayoutGraph(steps: PathLayoutStepInput[], edges: PathLayoutEdgeInput[], options?: BuildPathLayoutOptions): {
-    nodes: NetworkNode[];
-    edges: NetworkEdge[];
-};
-
-interface NetworkGraphSnapshot {
-    nodes: NetworkNode[];
-    edges: NetworkEdge[];
-}
-declare function networkGraphToDiagramDocument(snapshot: NetworkGraphSnapshot, previousDocument?: DiagramDocument): DiagramDocument;
-declare function diagramDocumentToNetworkGraph(document: DiagramDocument): NetworkGraphSnapshot;
-
 type EndpointConnectionKind = 'power' | 'network' | 'unknown';
 interface EndpointMetadata {
     normalizedHandle: string;
@@ -2401,7 +1204,7 @@ declare function isStriped(id: FiberColorId | number): boolean;
  * @returns CSS properties for the color
  * @public
  */
-declare function fiberSolidOrStriped(id: FiberColorId | number): React$1.CSSProperties;
+declare function fiberSolidOrStriped(id: FiberColorId | number): React.CSSProperties;
 /**
  * Get the hex color code for a fiber color ID
  * @param id - Fiber color ID (1-24)
@@ -2495,9 +1298,11 @@ declare const DEFAULT_DIAGRAM_DIM_OPACITY = 0.25;
 declare function hasDiagramFocus(options: DiagramFocusOptions): boolean;
 declare function isNodeInDiagramFocus(nodeId: string, options: DiagramFocusOptions): boolean;
 declare function isEdgeInDiagramFocus(edgeId: string, edge: Pick<NetworkEdge, 'source' | 'target'>, options: DiagramFocusOptions): boolean;
+/** A {@link NetworkNode} carrying the runtime `style` React Flow applies (e.g. dim opacity). @public */
 type RuntimeNode = NetworkNode & {
     style?: CSSProperties;
 };
+/** A {@link NetworkEdge} carrying the runtime `style` React Flow applies (e.g. dim opacity). @public */
 type RuntimeEdge = NetworkEdge & {
     style?: CSSProperties;
 };
@@ -2514,7 +1319,7 @@ type DiagramPortContextValue = {
     onPortClick?: (payload: DiagramPortClickPayload) => void;
     portClickEnabled: boolean;
 };
-declare const DiagramPortProvider: React$1.Provider<DiagramPortContextValue>;
+declare const DiagramPortProvider: React.Provider<DiagramPortContextValue>;
 declare function useDiagramPortInteraction(): DiagramPortContextValue;
 declare function isDiagramPortHandleHighlighted(highlightedPortHandles: readonly DiagramPortHandleRef[] | undefined, nodeId: string, handleId: string): boolean;
 
@@ -2827,4 +1632,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 { COUPLERS_PER_PANEL, COUPLER_SLOT_HEIGHT_PX, COUPLER_WIDTH_PX, CableNode, ClosureNode, CouplerNode, DEFAULT_DIAGRAM_DIM_OPACITY, DeviceFace, DeviceNode, DeviceNodeData, DevicePlacementError, type DevicePlacementValidation, DevicePort, DeviceStatus, type DeviceTemplateV2, DiagramDocument, DiagramErrorBoundary, type DiagramErrorBoundaryProps, type DiagramErrorBoundaryState, type DiagramFocusOptions, DiagramPortClickPayload, type DiagramPortContextValue, DiagramPortHandleRef, DiagramPortProvider, type EndpointConnectionKind, type EndpointMetadata, FIBER_COLORS_12, type FiberColorId, FiberEdge, FiberNode, FibreCableWithTubesExpanded, type FibreCableWithTubesExpandedProps, FibreFlowCable, type FibreFlowCableLayout, FibreFlowCableNodeData, FibreFlowCircuit, FibreFlowClosure, FibreFlowClosureNodeData, type FibreFlowColorMode, type FibreFlowLayoutDirection, FibreFlowMap, type FibreFlowMapProps, type FibreFlowRow, type FibreFlowTubeLabel, FibreSplitNode, HANDLE_EXTENSION_PX, type InventoryCableDTO, type InventoryDeviceDTO, type InventoryRackDTO, type MountClass, MultiTubeCableNode, type NetBoxCable, type NetBoxDevice, type NetBoxDeviceTransformOptions, type NetBoxInterface, type NetBoxMappedPort, type NetBoxPortPosition, type NetBoxRack, NetworkDiagram, NetworkDiagramInteractionOptions, type NetworkDiagramOptions, NetworkDiagramProps, type NetworkDiagramState, type NetworkDiagramStore, NetworkEdge, NetworkEdgeData, NetworkNode, NetworkNodeDataBase, PANEL_BORDER_WIDTH, PANEL_HEADER_HEIGHT, PANEL_HEIGHT_PX, PANEL_PADDING, PANEL_TUBE_TRAY_SPACING, PANEL_WIDTH_PX, POWER_CONNECTORS, PatchPanelNode, PortBlock, PortCableType, PortPosition, PortType, type PortVisualDimensions, type PortVisualInput, type PortVisualKind, type PowerConnectorConfig, PowerEdge, type PowerPortStyle, RACK_HEADER_HEIGHT, RACK_WIDTH_PX, RackConfig, RackDevice, type RackMountedNodeType, RackNode, RackNodeData, type RackNodeProps, type RackSchemaOptions, type RawNetboxTemplate, type RawTemplatePort, type RawTemplatePortBlock, type ReplaceEdgeOptions, type ResolvedPortBlockInput, type RuntimeEdge, type RuntimeNode, SpliceConfig, SpliceNode, SplicePlacementError, type SplicePlacementValidation, type SpliceSchemaOptions, SpliceTrayConfig, SpliceTrayNode, TEMPLATE_SCHEMA_VERSION, type TemplateFaceData, type TemplateFrontRearPortLink, type TemplateParseResult, type TemplatePort, type TemplatePortBlock, type TemplateSource, type TemplateValidationIssue, type TemplateValidationReport, type TemplateWidth, TubeNode, U_HEIGHT_PX, type ValidateConnectionParams, type ValidationResult, VerticalPDU, addDeviceToRack, addSpliceToTray, applyDeviceDisplayToNodes, applyDiagramFocusToEdges, applyDiagramFocusToNodes, baseColorFor, buildNodesFromRackConfig, buildNodesFromSpliceConfig, buildPortBlocksFromPorts, calculateClosureDimensions, calculateCouplerRightX, calculateCouplerSlotSpacing, calculateCouplerSpacing, calculateDevicePositionFromU, calculatePanelDimensions, calculateSlotPositionFromY, calculateSplicePositionFromNumber, calculateUPositions, calculateYFromSlotPosition, countTemplateFacePorts, createNetworkDiagramStore, createRackConfigFromNodes, createSpliceConfigFromNodes, fiberSolidOrStriped, findNearestRack, findNextAvailableHolderPosition, findNextAvailableUPosition, 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, isStriped, isUPositionAvailable, netboxCableToNetworkEdge, netboxDeviceToNetworkNode, netboxRackToNetworkNode, netboxToDiagramDocument, netboxToNetworkDiagram, parseNetboxTemplate, removeDeviceFromRack, removeSpliceFromTray, replaceEdge, resolveEndpointCompatibilityKeys, resolvePortVisualKind, snapToCouplerPosition, snapToSplicePosition, snapToUPosition, updateDeviceUPosition$1 as updateDeviceUPosition, updateDeviceUPosition as updateDeviceUPositionInSchema, updateSpliceHolderPosition, useEdges as useDiagramEdges, useNodes as useDiagramNodes, useDiagramPortInteraction, useNetworkDiagram, validateAndSnapDevice, validateRackDevicePlacements, validateRenderFidelity, validateSplicePlacements };