Module rules 

Constraint evaluation, connection planning, and diagnostics.

This module is intentionally small in v1: the contracts are more important than the algorithms.

Structs

ConnectPlan

A rules-driven plan for connecting two ports.

DeletePlan

A rules-driven plan for deleting graph elements.

Diagnostic

A diagnostic produced by validation or connection planning.

InsertNodeSpec

Specification for inserting a new node as part of a connection workflow.

InsertNodeTemplate

A template for inserting a node between two ports.

PortTemplate

A template for a port to be instantiated during an insertion workflow.

Enums

ConnectDecision

Connection decision.

DeleteDecision

Delete decision.

DiagnosticSeverity

Diagnostic severity.

DiagnosticTarget

Diagnostic target.

EdgeEndpoint

Which endpoint of an existing edge is being reconnected.

Functions

plan_connect

Plans connecting two ports (strict mode).

plan_connect_by_inserting_node

Plans connecting two ports by inserting a node with default interaction policy.

plan_connect_by_inserting_node_with_policy

Plans connecting two ports by inserting a node between them.

plan_connect_typed

Plans connecting two ports with optional type compatibility checks.

plan_connect_typed_with_mode_and_policy

Plans connecting two ports with mode, policy, and optional type compatibility checks.

plan_connect_typed_with_policy

Plans connecting two ports with policy and optional type compatibility checks.

plan_connect_with_mode

Plans connecting two ports with default interaction policy.

plan_connect_with_mode_and_policy

Plans connecting two ports.

plan_delete_edge

Plans deleting an edge with default interaction policy.

plan_delete_edge_with_policy

Plans deleting an edge with explicit interaction policy.

plan_delete_elements

Plans deleting nodes and edges with default interaction policy.

plan_delete_elements_with_policy

Plans deleting nodes and edges with explicit interaction policy.

plan_delete_node

Plans deleting a node with default interaction policy.

plan_delete_node_with_policy

Plans deleting a node with explicit interaction policy.

plan_reconnect_edge

Plans reconnecting one endpoint of an existing edge (strict mode).

plan_reconnect_edge_with_mode

Plans reconnecting one endpoint of an existing edge with default interaction policy.

plan_reconnect_edge_with_mode_and_policy

Plans reconnecting one endpoint of an existing edge to a new port.

plan_split_edge_by_inserting_node

Plans splitting an existing edge by inserting a node (preserving the edge identity for the first segment).