@mp70/react-networks 0.2.0-rc.0 → 0.3.0-alpha.1

package/dist/index.d.ts

@@ -42,6 +42,36 @@ interface FibreFlowCircuit {
     color?: string;
 }
 
+interface NetBoxPortPosition {
+    side?: 'top' | 'right' | 'bottom' | 'left';
+    offsetPercent?: number;
+    offsetPx?: number;
+    xPercent?: number;
+    yPercent?: number;
+}
+interface NetBoxMappedPort {
+    id?: string;
+    label?: string;
+    face?: 'front' | 'rear';
+    group?: string;
+    type?: string;
+    cableType?: string;
+    connected?: boolean;
+    connectorType?: 'C13' | 'C19' | 'C14' | 'C20';
+    position?: NetBoxPortPosition;
+}
+interface NetBoxDeviceTransformOptions {
+    /** Include interface arrays as `ports`/`rearPorts` in generated nodes */
+    includeInterfacePorts?: boolean;
+    /** Include per-port position metadata when provided */
+    includePortPositions?: boolean;
+    /** Optional mapper for full control over interface->port mapping */
+    mapInterfaceToPort?: (args: {
+        device: NetBoxDevice;
+        iface: NetBoxInterface;
+        index: number;
+    }) => NetBoxMappedPort | null | undefined;
+}
 interface NetBoxDevice {
     id: number;
     name: string;
@@ -102,6 +132,18 @@ interface NetBoxInterface {
         type: string;
         color: string;
     } | null;
+    /** Optional face hint used by UI transforms */
+    face?: 'front' | 'rear' | null;
+    /** Optional display/ordering position from external enrichments */
+    position?: number | null;
+    /** Optional grouping hint used by UI transforms */
+    port_group?: string | null;
+    /** Optional explicit connector hint (e.g., C13/C19 for PDUs) */
+    connector_type?: 'C13' | 'C19' | 'C14' | 'C20' | null;
+    /** Optional transform layout metadata */
+    layout?: NetBoxMappedPort;
+    /** Optional custom fields payload from NetBox */
+    custom_fields?: Record<string, unknown>;
 }
 interface NetBoxRack {
     id: number;
@@ -239,7 +281,25 @@ interface DeviceImageOptions {
     /** 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;
+}
 interface Port {
+    /** Stable handle identifier override (defaults to `label`) */
+    id?: string;
     /** Display label for the port */
     label: string;
     /** Whether the port is currently connected */
@@ -248,6 +308,10 @@ interface Port {
     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 explicit handle placement */
+    position?: PortPosition;
 }
 /**
  * Group of related ports on a device
@@ -274,6 +338,16 @@ type DeviceStatus = 'active' | 'inactive' | 'maintenance';
  * @public
  */
 type DeviceView = 'front' | 'rear';
+/**
+ * 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
@@ -316,6 +390,12 @@ interface NetworkNodeDataBase extends DeviceImageOptions {
     view?: DeviceView;
     /** Rack face orientation */
     face?: DeviceView;
+    /** 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;
     /** Device manufacturer */
@@ -330,6 +410,10 @@ interface NetworkNodeDataBase extends DeviceImageOptions {
     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 */
@@ -558,6 +642,12 @@ interface NetworkEdgeData {
     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>;
 }
@@ -606,6 +696,10 @@ interface RackConfig {
     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) */
@@ -628,6 +722,8 @@ interface RackDevice extends DeviceImageOptions {
     type: RackDeviceType;
     /** Device width configuration */
     width?: Width;
+    /** Device mount behavior within a rack */
+    mountMode?: RackMountMode;
     /** Device role in network */
     role?: string;
     /** Current status of the device */
@@ -1299,7 +1395,7 @@ declare const netboxRackToNetworkNode: (rack: NetBoxRack) => NetworkNode;
 /**
  * Convert NetBox device data to NetworkNode
  */
-declare const netboxDeviceToNetworkNode: (device: NetBoxDevice) => NetworkNode;
+declare const netboxDeviceToNetworkNode: (device: NetBoxDevice, options?: NetBoxDeviceTransformOptions) => NetworkNode;
 /**
  * Convert NetBox cable data to NetworkEdge
  */
@@ -1311,7 +1407,7 @@ declare const netboxToNetworkDiagram: (data: {
     racks: NetBoxRack[];
     devices: NetBoxDevice[];
     cables: NetBoxCable[];
-}) => {
+}, options?: NetBoxDeviceTransformOptions) => {
     nodes: NetworkNode[];
     edges: NetworkEdge[];
 };
@@ -1342,7 +1438,7 @@ declare const findNextAvailableUPosition: (rack: NetworkNode, device: NetworkNod
 /**
  * Calculate device position based on U position within a rack
  */
-declare const calculateDevicePositionFromU: (rack: NetworkNode, uPosition: number, deviceHeight?: number) => {
+declare const calculateDevicePositionFromU: (rack: NetworkNode, uPosition: number, deviceHeight?: number, deviceData?: Pick<NetworkNode["data"], "mountMode">) => {
     x: number;
     y: number;
 };
@@ -1836,7 +1932,7 @@ declare function removeSpliceFromTray(trays: SpliceTrayConfig[], trayId: string,
  * Power connector utilities for consistent styling across devices and PDUs
  */
 interface PowerConnectorConfig {
-    type: 'C13' | 'C14' | 'C19' | 'C20';
+    type: 'C13' | 'C14' | 'C19' | 'C20' | 'AC';
     color: string;
     borderColor: string;
     amperage: number;
@@ -1998,6 +2094,276 @@ interface ReplaceEdgeOptions {
  */
 declare function replaceEdge(options: ReplaceEdgeOptions): Edge[] | null;
 
+/**
+ * Template Schema V2 — unified device template model.
+ *
+ * Supports rackable devices (1U+), 0U/unrackable devices (vertical PDUs),
+ * and hybrid front/rear pass-through devices.  Strictly more expressive than
+ * NetBox device-type YAML while remaining import-compatible.
+ *
+ * @public
+ */
+
+/** Current schema version constant. */
+declare const TEMPLATE_SCHEMA_VERSION = 2;
+/** Device mount class — distinguishes rackable from 0U/standalone devices. */
+type MountClass = 'rackable' | 'zero-u';
+/** Device width within a rack (full 19" or half 9.5"). */
+type TemplateWidth = 'full' | 'half';
+/**
+ * Individual port inside a template port block.
+ * @public
+ */
+interface TemplatePort {
+    /** Stable identifier for the port (must be unique within the template). */
+    id: string;
+    /** Human-readable label. */
+    label: string;
+    /** Port classification for styling and validation. */
+    type?: PortType;
+    /** Cable type hint. */
+    cableType?: PortCableType;
+    /** Power connector classification. */
+    connectorType?: 'C13' | 'C14' | 'C19' | 'C20' | 'AC';
+    /** Explicit handle placement. */
+    position?: PortPosition;
+}
+/**
+ * Group of related ports on a single face.
+ * @public
+ */
+interface TemplatePortBlock {
+    /** Group name. */
+    name: string;
+    /** Ports in this group. */
+    ports: TemplatePort[];
+}
+/**
+ * Per-face data container for front or rear.
+ * @public
+ */
+interface TemplateFaceData {
+    /** Port blocks on this face. */
+    portBlocks: TemplatePortBlock[];
+    /** Optional image URL for this face. */
+    imageUrl?: string;
+    /** Optional attribution for the image. */
+    imageAttribution?: string;
+}
+/**
+ * Explicit front-to-rear pass-through link between ports.
+ * @public
+ */
+interface TemplateFrontRearPortLink {
+    /** Port ID on the front face. */
+    frontPortId: string;
+    /** Port ID on the rear face. */
+    rearPortId: string;
+}
+/**
+ * Source provenance for an imported template.
+ * @public
+ */
+interface TemplateSource {
+    /** Source system kind (e.g. 'netbox', 'manual'). */
+    kind: string;
+    /** Source repository URL. */
+    repository?: string;
+    /** Path within the repository. */
+    path?: string;
+}
+/**
+ * Canonical device template schema V2.
+ * @public
+ */
+interface DeviceTemplateV2 {
+    /** Schema version — always 2. */
+    templateSchemaVersion: 2;
+    /** Unique identifier (e.g. 'cisco-c9300-48p'). */
+    id: string;
+    /** URL-safe slug. */
+    slug: string;
+    /** Device manufacturer. */
+    manufacturer: string;
+    /** Device model. */
+    model: string;
+    /** Device role (e.g. 'switch', 'pdu', 'server'). */
+    role: string;
+    /** Mount class — rackable (1U+) or zero-u. */
+    mountClass: MountClass;
+    /** Height in rack units (0 for zero-u devices). */
+    uHeight: number;
+    /** Width within a rack. */
+    width: TemplateWidth;
+    /** Per-face port and image data. */
+    faces: {
+        front: TemplateFaceData;
+        rear: TemplateFaceData;
+    };
+    /** Explicit front-to-rear pass-through links. */
+    frontRearPortLinks: TemplateFrontRearPortLink[];
+    /** Optional image configuration. */
+    images?: {
+        front?: string | null;
+        rear?: string | null;
+    };
+    /** Source provenance. */
+    source?: TemplateSource;
+    /** Optional tags for search/filtering. */
+    tags?: string[];
+}
+/**
+ * Single validation issue from the parser pipeline.
+ * @public
+ */
+interface TemplateValidationIssue {
+    /** Severity level. */
+    severity: 'error' | 'warning';
+    /** Machine-readable code. */
+    code: string;
+    /** Human-readable description. */
+    message: string;
+    /** Optional path to the problematic field. */
+    path?: string;
+}
+/**
+ * Validation report emitted by the parser pipeline.
+ * @public
+ */
+interface TemplateValidationReport {
+    /** Whether the template is valid (no errors — warnings are allowed). */
+    valid: boolean;
+    /** List of issues found. */
+    issues: TemplateValidationIssue[];
+    /** Summary counts per face. */
+    portCounts: {
+        front: number;
+        rear: number;
+    };
+}
+/**
+ * Result of the full parser pipeline.
+ * @public
+ */
+interface TemplateParseResult {
+    /** Parsed template (present when valid). */
+    template: DeviceTemplateV2 | null;
+    /** Validation report. */
+    report: TemplateValidationReport;
+}
+
+/**
+ * NetBox → Template V2 parser pipeline.
+ *
+ * Five stages: Ingest → Normalize → Enrich → Validate → Export.
+ *
+ * **Port position semantics**: Positions use `xPercent` / `yPercent` (0-100)
+ * to express where the port CENTER should be relative to the device face.
+ * The renderer (`DeviceNode`) converts these to pixel coordinates and clamps
+ * them so the port stays fully inside the device bounds.  Clamp bounds are
+ * computed from the **actual** rendered port dimensions (which vary by port
+ * type — e.g., power C13/C19 connectors are larger than generic ethernet
+ * handles).  Templates therefore do NOT need to account for port size; the
+ * renderer handles that.
+ *
+ * @public
+ */
+
+/**
+ * Raw port entry from a NetBox-style template.
+ * @public
+ */
+interface RawTemplatePort {
+    id?: string;
+    name?: string;
+    label?: string;
+    type?: string;
+    connectorType?: string;
+    connector_type?: string;
+    position?: {
+        side?: string;
+        offsetPercent?: number;
+        offset_percent?: number;
+        offsetPx?: number;
+        offset_px?: number;
+        xPercent?: number;
+        x_percent?: number;
+        yPercent?: number;
+        y_percent?: number;
+    };
+}
+/**
+ * Raw port block from a NetBox-style template.
+ * @public
+ */
+interface RawTemplatePortBlock {
+    name?: string;
+    ports?: RawTemplatePort[];
+}
+/**
+ * Raw NetBox-style template input for the parser.
+ * @public
+ */
+interface RawNetboxTemplate {
+    id?: string;
+    slug?: string;
+    manufacturer?: string;
+    model?: string;
+    role?: string;
+    deviceType?: string;
+    device_type?: string;
+    uHeight?: number;
+    u_height?: number;
+    width?: string;
+    ports?: RawTemplatePortBlock[];
+    rearPorts?: RawTemplatePortBlock[];
+    rear_ports?: RawTemplatePortBlock[];
+    frontRearPortLinks?: Array<{
+        frontPortId?: string;
+        rearPortId?: string;
+        front_port_id?: string;
+        rear_port_id?: string;
+    }>;
+    front_rear_port_links?: Array<{
+        frontPortId?: string;
+        rearPortId?: string;
+        front_port_id?: string;
+        rear_port_id?: string;
+    }>;
+    frontImageUrl?: string;
+    front_image_url?: string;
+    rearImageUrl?: string;
+    rear_image_url?: string;
+    frontImageAttribution?: string;
+    rearImageAttribution?: string;
+    tags?: string[];
+    sourceRepository?: string;
+    source_repository?: string;
+    sourcePath?: string;
+    source_path?: string;
+}
+/**
+ * Parse a raw NetBox-style template through the full 5-stage pipeline.
+ *
+ * Returns a `TemplateParseResult` containing the validated V2 template
+ * (or `null` if validation failed) and a full validation report.
+ *
+ * @public
+ */
+declare function parseNetboxTemplate(raw: RawNetboxTemplate): TemplateParseResult;
+/**
+ * Count the total number of ports on a given face of a V2 template.
+ * @public
+ */
+declare function countTemplateFacePorts(face: TemplateFaceData): number;
+/**
+ * Validate that rendered handle counts match the template port counts.
+ * Returns issues when counts diverge — used as a regression guardrail.
+ *
+ * @public
+ */
+declare function validateRenderFidelity(template: DeviceTemplateV2, renderedFrontHandleCount: number, renderedRearHandleCount: number): TemplateValidationIssue[];
+
 interface NetworkDiagramState {
     nodes: NetworkNode[];
     edges: NetworkEdge[];
@@ -2033,4 +2399,4 @@ declare function useNetworkDiagram(store: NetworkDiagramStore): NetworkDiagramSt
 declare function useNodes(store: NetworkDiagramStore): NetworkNode[];
 declare function useEdges(store: NetworkDiagramStore): NetworkEdge[];
 
-export { COUPLERS_PER_PANEL, COUPLER_SLOT_HEIGHT_PX, COUPLER_WIDTH_PX, CableNode, ClosureNode, CouplerNode, type DeviceImageFit, type DeviceImageOptions, type DeviceImageRepeat, DeviceNode, DevicePlacementError, type DevicePlacementValidation, DiagramErrorBoundary, type DiagramErrorBoundaryProps, FIBER_COLORS_12, type FiberCable, type FiberColorId, FiberEdge, FiberNode, FibreCableWithTubesExpanded, type FibreFlowCable, type FibreFlowCableKind, type FibreFlowCableNodeData, type FibreFlowCircuit, type FibreFlowClosure, type FibreFlowClosureNodeData, type FibreFlowEndpoint, FibreFlowMap, type FibreFlowMapProps, type FibreFlowSplice, FibreSplitNode, HANDLE_EXTENSION_PX, MultiTubeCableNode, NetworkDiagram, type NetworkDiagramFitViewOptions, type NetworkDiagramFlowMethods, type NetworkDiagramFlowObject, type NetworkDiagramOptions, type NetworkDiagramProps, type NetworkDiagramStoreApi, type NetworkDiagramToImageOptions, type NetworkEdge, type NetworkEdgeData, type NetworkNode, type NetworkNodeData, type NetworkNodeDataBase, type NetworkNodeDataByType, PANEL_BORDER_WIDTH, PANEL_HEADER_HEIGHT, PANEL_HEIGHT_PX, PANEL_PADDING, PANEL_TUBE_TRAY_SPACING, PANEL_WIDTH_PX, POWER_CONNECTORS, PatchPanelNode, type Port, type PortBlock, type PortCableType, type PortType, PowerEdge, RACK_HEADER_HEIGHT, RACK_WIDTH_PX, type RackConfig, type RackDevice, RackNode, type RackSchemaOptions, type ReplaceEdgeOptions, type SpliceConfig, SpliceNode, SplicePlacementError, type SplicePlacementValidation, type SpliceSchemaOptions, type SpliceTrayConfig, SpliceTrayNode, TubeNode, U_HEIGHT_PX, type ValidateConnectionParams, type ValidationResult, VerticalPDU, Width, addDeviceToRack, addSpliceToTray, baseColorFor, buildNodesFromRackConfig, buildNodesFromSpliceConfig, calculateClosureDimensions, calculateCouplerRightX, calculateCouplerSlotSpacing, calculateCouplerSpacing, calculateDevicePositionFromU, calculatePanelDimensions, calculateSlotPositionFromY, calculateSplicePositionFromNumber, calculateUPositions, calculateYFromSlotPosition, createNetworkDiagramStore, createRackConfigFromNodes, createSpliceConfigFromNodes, fiberSolidOrStriped, findNearestRack, findNextAvailableHolderPosition, findNextAvailableUPosition, generateLayout, getConnectorConfig, getCouplerDimensions, getDeviceConnectorType, getFiberColor, getInnerContentWidth, getPDUPortType, getPanelHeight, getPanelWidth, getPowerPortStyle, getRackBounds, getStatusColor, getTrayDimensions, getTubeDimensions, inventoryCableToNetworkEdge, inventoryDeviceToNetworkNode, inventoryRackToNetworkNode, inventoryToNetworkDiagram, isHighPowerConnector, isPointInRack, isStriped, isUPositionAvailable, netboxCableToNetworkEdge, netboxDeviceToNetworkNode, netboxRackToNetworkNode, netboxToNetworkDiagram, removeDeviceFromRack, removeSpliceFromTray, replaceEdge, snapToCouplerPosition, snapToSplicePosition, snapToUPosition, updateDeviceUPosition$1 as updateDeviceUPosition, updateDeviceUPosition as updateDeviceUPositionInSchema, updateSpliceHolderPosition, useEdges as useDiagramEdges, useNodes as useDiagramNodes, useNetworkDiagram, validateAndSnapDevice, validateRackDevicePlacements, validateSplicePlacements };
+export { COUPLERS_PER_PANEL, COUPLER_SLOT_HEIGHT_PX, COUPLER_WIDTH_PX, CableNode, ClosureNode, CouplerNode, type DeviceImageFit, type DeviceImageOptions, type DeviceImageRepeat, DeviceNode, DevicePlacementError, type DevicePlacementValidation, type DeviceTemplateV2, DiagramErrorBoundary, type DiagramErrorBoundaryProps, FIBER_COLORS_12, type FiberCable, type FiberColorId, FiberEdge, FiberNode, FibreCableWithTubesExpanded, type FibreFlowCable, type FibreFlowCableKind, type FibreFlowCableNodeData, type FibreFlowCircuit, type FibreFlowClosure, type FibreFlowClosureNodeData, type FibreFlowEndpoint, FibreFlowMap, type FibreFlowMapProps, type FibreFlowSplice, FibreSplitNode, HANDLE_EXTENSION_PX, type MountClass, MultiTubeCableNode, NetworkDiagram, type NetworkDiagramFitViewOptions, type NetworkDiagramFlowMethods, type NetworkDiagramFlowObject, type NetworkDiagramOptions, type NetworkDiagramProps, type NetworkDiagramStoreApi, type NetworkDiagramToImageOptions, type NetworkEdge, type NetworkEdgeData, type NetworkNode, type NetworkNodeData, type NetworkNodeDataBase, type NetworkNodeDataByType, PANEL_BORDER_WIDTH, PANEL_HEADER_HEIGHT, PANEL_HEIGHT_PX, PANEL_PADDING, PANEL_TUBE_TRAY_SPACING, PANEL_WIDTH_PX, POWER_CONNECTORS, PatchPanelNode, type Port, type PortBlock, type PortCableType, type PortType, PowerEdge, RACK_HEADER_HEIGHT, RACK_WIDTH_PX, type RackConfig, type RackDevice, type RackLayoutMode, type RackMountMode, RackNode, 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, U_HEIGHT_PX, type ValidateConnectionParams, type ValidationResult, VerticalPDU, Width, addDeviceToRack, addSpliceToTray, baseColorFor, buildNodesFromRackConfig, buildNodesFromSpliceConfig, calculateClosureDimensions, calculateCouplerRightX, calculateCouplerSlotSpacing, calculateCouplerSpacing, calculateDevicePositionFromU, calculatePanelDimensions, calculateSlotPositionFromY, calculateSplicePositionFromNumber, calculateUPositions, calculateYFromSlotPosition, countTemplateFacePorts, createNetworkDiagramStore, createRackConfigFromNodes, createSpliceConfigFromNodes, fiberSolidOrStriped, findNearestRack, findNextAvailableHolderPosition, findNextAvailableUPosition, generateLayout, getConnectorConfig, getCouplerDimensions, getDeviceConnectorType, getFiberColor, getInnerContentWidth, getPDUPortType, getPanelHeight, getPanelWidth, getPowerPortStyle, getRackBounds, getStatusColor, getTrayDimensions, getTubeDimensions, inventoryCableToNetworkEdge, inventoryDeviceToNetworkNode, inventoryRackToNetworkNode, inventoryToNetworkDiagram, isHighPowerConnector, isPointInRack, isStriped, isUPositionAvailable, netboxCableToNetworkEdge, netboxDeviceToNetworkNode, netboxRackToNetworkNode, netboxToNetworkDiagram, parseNetboxTemplate, removeDeviceFromRack, removeSpliceFromTray, replaceEdge, snapToCouplerPosition, snapToSplicePosition, snapToUPosition, updateDeviceUPosition$1 as updateDeviceUPosition, updateDeviceUPosition as updateDeviceUPositionInSchema, updateSpliceHolderPosition, useEdges as useDiagramEdges, useNodes as useDiagramNodes, useNetworkDiagram, validateAndSnapDevice, validateRackDevicePlacements, validateRenderFidelity, validateSplicePlacements };