Development documentation · Some APIs may be unreleased Published release →

API Browser

Structural type families

Structural types compose data without requiring a named nominal declaration. They are real types, with identity, signatures and runtime introspection. Use them when a nominal name or domain-specific declaration would add no useful meaning: unions represent alternatives, tuples combine values, intersections describe simultaneous contracts, and function types describe callable shapes.

Efficient data computation is a design requirement. Value semantics do not require heap allocation, and a reference held inside a value remains a reference. Current implementation limits are separate from those semantic contracts.

Family Native contract Member reference
Array Structural element-shaped reference type, also representable through nominal Array<T> Array
Function Signature-shaped callable type with Object compatibility Function
Tuple Ordered structural value; native element names do not affect identity Tuple
Union Structural value admitting any listed alternative, including values and references Union
Intersection Structural view requiring every listed nominal contract; interface conformance stays explicit Intersection

See the runtime operation guide for union tests/extraction, tuple operations, intersections and callable binding/invocation.

Availability

Native unions, intersections and tuples are integrated into neoCLR main and the Raven neoCLR compiler line. The target selects native structural metadata without feature switches. Runtime nominal Union/Tuple carriers are removed; rebuild old consumers with matching compiler/runtime/library artifacts. Declared nominal unions and ordinary .NET representations remain distinct. Interpreter, macOS ARM64 AOT and managed JIT checks cover the supported workloads, including Task union delivery. This is development integration, not a published release. See the integration qualification.

Scoped parameters inside nominal constituents are supported, including Response<T> | HttpError | JsonError. Bare parameter alternatives such as T | Error and all combinations of structural types are not yet supported. See each family for its current boundary.

Introspection and identity

Use TypeInfo for common type queries. IsNominalType distinguishes declaration-backed descriptors. Structural signatures need no separate TypeDef, declaration name or module ownership to be types. DisplayName is diagnostic text, not an identity key.

UnionTypeInfo.Types and IntersectionTypeInfo.Types expose constituents. TupleTypeInfo.ElementTypes and ElementNames describe ordered elements. FunctionTypeInfo exposes the callable signature. Array shape and the nominal Array<T> declaration are distinct descriptors serving the same array value contract; the generic spelling does not introduce another wrapper allocation.

Object compatibility is family-specific. Structural identity alone does not imply reference semantics, Object inheritance or extensibility. Public factories for arbitrary guest structural descriptors remain future work.

These authored family pages are rendered and indexed alongside generated nominal API declarations. A separate page is not required for every closed signature.