Inno.Core.Graphs
Section titled “Inno.Core.Graphs”
- Neutral editable graph documents, generation-scoped definitions, topology validation and current-format serialization.
This project separates persistent node/edge/value records from the live extension definitions that interpret them. It depends on shared Core collections, diagnostics and serialization, and does not own a scene, material compiler, graph widget or rendering backend.
Start with preserving an editable graph to create neutral records, validate them and restore interpretation when a definition returns.
Document and definition contract
Section titled “Document and definition contract”Node, edge and port IDs are stable strings. Values and metadata contain copied serialization bytes instead of CLR types, runtime delegates or extension instances. Node lookup uses a maintained ID index. Collection views are read-only and stable, but reflect edits to the mutable document; a read-only view is not an immutable publication.
Adding a node retains its mutable record. Removing it removes connected edges. Clone and ReplaceContents prepare deep neutral copies; self-replacement is rejected. The host serializes concurrent editing, validation and publication.
Resolvers and definitions belong to the active extension generation. Missing definitions produce warnings without deleting saved content. Physically absent endpoints, incompatible direction/types, over-capacity connections and missing required inputs are errors. Dynamic ports are resolved for current node data. Cycles require explicit allowance. No-error validation is not executable-graph certification, and custom resolver/conversion failures are not universally swallowed.
GraphDocumentCodec encodes and decodes the current neutral format using an explicit SerializationRegistry. Dictionary keys are ordinally ordered; node/edge order is retained. Decoding does not resolve current definitions. Asset file ownership, publication and any higher-level format rules belong to the asset consumer; no compatibility reader or former-ID alias is promised here.
The declared Runtime script namespace is InnoEngine.Graphs. Registry-taking value conversion methods are explicitly excluded, and GraphDocumentCodec is not in the export list. This reference is the host CLR inventory, not a substitute for actual projected declarations.
API reference
Section titled “API reference”Browse the exact types and member contracts in the selected CLR surface. Each declaration links to its captured source and preserves its shared constraints.
Logical script references
Section titled “Logical script references”The compiler-selected script declarations are separate from this project’s host CLR surface. Read the script calling guide and the associated module contracts before using a projected member.
Source project facts
Section titled “Source project facts”Project: Inno.Core.Graphs
Source: src/foundation/core/Inno.Core.Graphs/Inno.Core.Graphs.csproj
| Type | API | Description |
|---|---|---|
| GraphDiagnostic | engine | Reports one graph validation problem using stable document identifiers. |
| GraphDocument | engine | Owns neutral graph records and graph-level canvas metadata. |
| GraphDocumentCodec | engine | Persists neutral graph documents through the common Inno serialization pipeline. |
| GraphEdgeId | engine | Identifies an edge within one graph document using a stable serialized value. |
| GraphEdgeRecord | engine | Stores one typed connection between two graph endpoints. |
| GraphEndpoint | engine | Identifies one endpoint of a graph edge. |
| GraphNodeDefinition | engine | Describes node presentation and resolves ports without entering graph persistence. |
| GraphNodeId | engine | Identifies a node within one graph document using a stable serialized value. |
| GraphNodeRecord | engine | Stores one node without retaining a CLR type or runtime extension instance. |
| GraphPortCapacity | engine | Declares how many edges may connect to a graph port. |
| GraphPortDefinition | engine | Describes one dynamically or statically resolved node port. |
| GraphPortDirection | engine | Declares the direction in which values flow through a graph port. |
| GraphPortId | engine | Identifies a port within its owning node definition. |
| GraphPosition | engine | Stores a graph-space position independently from any editor UI framework. |
| GraphSerializedValue | engine | Stores one graph property as backend-neutral Inno serialization bytes. |
| GraphValidationResult | engine | Contains deterministic graph validation diagnostics. |
| GraphValidator | engine | Validates neutral graph topology against generation-scoped node definitions. |
| IGraphNodeDefinitionResolver | engine | Resolves generation-scoped node definitions by stable identifier. |
| IGraphTypeConversion | engine | Determines whether one graph value type can be converted to another. |
| GraphDiagnostic | Runtime | Reports one graph validation problem using stable document identifiers. |
| GraphDocument | Runtime | Owns neutral graph records and graph-level canvas metadata. |
| GraphEdgeId | Runtime | Identifies an edge within one graph document using a stable serialized value. |
| GraphEdgeRecord | Runtime | Stores one typed connection between two graph endpoints. |
| GraphEndpoint | Runtime | Identifies one endpoint of a graph edge. |
| GraphNodeDefinition | Runtime | Describes node presentation and resolves ports without entering graph persistence. |
| GraphNodeId | Runtime | Identifies a node within one graph document using a stable serialized value. |
| GraphNodeRecord | Runtime | Stores one node without retaining a CLR type or runtime extension instance. |
| GraphPortCapacity | Runtime | Declares how many edges may connect to a graph port. |
| GraphPortDefinition | Runtime | Describes one dynamically or statically resolved node port. |
| GraphPortDirection | Runtime | Declares the direction in which values flow through a graph port. |
| GraphPortId | Runtime | Identifies a port within its owning node definition. |
| GraphPosition | Runtime | Stores a graph-space position independently from any editor UI framework. |
| GraphSerializedValue | Runtime | Stores one graph property as backend-neutral Inno serialization bytes. |
| GraphValidationResult | Runtime | Contains deterministic graph validation diagnostics. |
| GraphValidator | Runtime | Validates neutral graph topology against generation-scoped node definitions. |
| IGraphNodeDefinitionResolver | Runtime | Resolves generation-scoped node definitions by stable identifier. |
| IGraphTypeConversion | Runtime | Determines whether one graph value type can be converted to another. |