Development documentation · Some APIs may be unreleased Published release →

Guides

Public reference coverage and compiler support

The metadata inventory includes all public types in the compiler-reference assembly, including public nested types. New public types are automatically selected for generation; missing prose is reported without hiding their pages. Internal runtime providers and private helpers are outside this public inventory.

Many sample programs use ArrayList, HashMap, Sequence, Optional, Result, Function shapes and query operators. Their member references supplement the collections, outcomes and Function types walkthroughs.

Enum additionally exposes executable development helpers for names and values, with TypeInfo and constrained generic overloads. Its class remains non-constructible; its presence does not imply every .NET Enum method is supported. Development Parse/TryParse generic overloads now support Int32 enum names, signed numbers and comma-separated names. Parse returns Result with NumberParseError; TryParse resets its out parameter on failure. The generic overloads require struct type arguments; enum identity is checked at runtime, matching .NET.

Enum parsing (development)

static func Parse<TEnum>(text: string?) -> Result<TEnum, NumberParseError> where TEnum: struct
static func Parse<TEnum>(text: string?, ignoreCase: bool) -> Result<TEnum, NumberParseError> where TEnum: struct
static func TryParse<TEnum>(text: string?, out result: TEnum) -> bool where TEnum: struct
static func TryParse<TEnum>(text: string?, ignoreCase: bool, out result: TEnum) -> bool where TEnum: struct

text accepts a declared name, comma-separated names, or one signed decimal Int32. Surrounding whitespace is ignored. Numbers need not name declared members, and lists combine bits even without Flags. ignoreCase selects ordinal case-insensitive matching; omitting it means case-sensitive matching. Null, empty text, unknown names, empty list tokens, numeric lists, hexadecimal and fractional input produce InvalidFormat. An out-of-range integer produces Overflow. TryParse returns false for both errors and writes the zero/default enum value; success writes the parsed value.

TEnum must be a supported Int32 enum. Reference types and unconstrained generic forwarding reject at compile time. Non-enum value types still fault at runtime, including with null text, as in .NET’s generic enum parsing contract. Unicode member names are preserved; ordinal matching does not normalize canonically equivalent spellings. Parse uses Result rather than throwing .NET parsing exceptions. This API may allocate trimmed/token strings, an enum box and a Result carrier; it does not allocate names/values snapshot arrays.

The built-in suite includes this usage:

var value = State.Failed
let success = Enum.TryParse<State>("READY", true, out value)

Here State declares Ready = 1 and Failed = -1; success is true and value is Ready.

Native metadata and documentation inputs

Production libraries are built from Raven source and imported through native metadata. The compiler and language server use these native definitions; host CLR support types do not become application APIs.

The website renders the committed native API snapshot. A separate legacy CLI reference remains for documentation tooling and fixture compatibility. Delegate, MulticastDelegate, placeholder exceptions and CLI case carriers in that projection do not describe additional executable neoCLR capabilities. Exact exclusions and manual rendering exceptions remain recorded in the reference inventory.

Manual entries for renderer limitations

No public type is silently excluded. The following entries preserve declarations that the pinned metadata model or publisher does not emit as ordinary type pages:

Public type Reference and reason
System.NamespaceMembers Container reference. Its functions are promoted to the System namespace.
System.Math.NamespaceMembers Container reference. Its functions are promoted to the System.Math namespace.
System.Runtime.CompilerServices.IsReadOnlyAttribute Marker and constructor. The metadata model consumes the marker without exposing its public definition to RavenDoc.

These are rendering limitations, not application-type exclusions. All other public types, except the explicitly excluded scaffolds above, have generated reference pages. The existing String and ThreadPool scaffold constructor exclusions remain explicit; they are not supported application constructors.

Union representations

Native structural unions use signature metadata. Declared Raven unions remain nominal. Ordinary source uses named cases, patterns and propagation, including explicit None construction for absence. Generated carriers in the isolated CLI reference are tooling details, not a native interface requirement.

Source attribute base

System.Attribute has a source-built abstract declaration with a protected constructor, following the basic .NET nominal attribute inheritance shape. System.Runtime.CompilerServices.UnionAttribute derives from it; source-owned union markers retain that base relationship in native metadata. The reference assembly exposes the same abstract/protected shape. This adds no .NET attribute discovery, usage-policy enforcement or runtime instantiation service. Bootstrap compiler markers remain explicitly bootstrap-owned while source Attribute/UnionAttribute belong to the rebuilt library.