Development documentation · Some APIs may be unreleased Published release →

Guides

Module overview

Use this overview to find the part of the neoCLR library that fits your task. It describes the development module organization. Use matching compiler, reference and runtime artifacts. Names and contracts remain experimental.

The list grows as APIs are implemented. Every public reference type is inventoried, with generated pages or an explicitly linked manual entry for a renderer limitation. A module here does not imply the full corresponding .NET API is supported.

Application modules

Module What it contains Explore
System Core types such as Object, Value, HashCode, primitives, String and Array; Func delegates; Optional and Result; common capability and error types; Console. Console is a class in this module. Core reference, Object and Value, Console, arrays, outcomes, dates and clocks
System.Time Dates, TimeOfDay, durations, clocks, calendars, timezone mappings and related errors. Reference, time guide
Neo.DependencyInjection Optional service contracts in Neo.DependencyInjection.Abstractions; default container in Neo.DependencyInjection. DI reference
Neo.Configuration Development hierarchical settings, ordered providers and DI integration. Configuration reference
Neo.Logging Development structured logging, factories, providers and typed DI integration. Logging guide
Neo.Localization Development string catalogues, typed scopes, configurable JSON fallback and missing-key reporting. Reference, localization guide
System.Globalization Development culture/language profiles, calendar-selecting date/time formatters and fixed/system culture providers. Reference, globalization guide
System.Collections Iteration and collection capabilities: Iterable, Iterator, Collection, Sequence, List and map interfaces, with ArrayList and HashMap implementations. Collections reference · ArrayList · HashMap · Collections guide
System.Networking Host-backed IPv4 lookup through Dns and typed DnsError, separate from connecting. Networking guide, reference
System.Networking.Sockets IPv4 TCP connections and listeners: Connect, Listen, Accept, Send, Receive, GetLocalPort, Close and typed SocketError. Guide, reference
System.Web.Http Bounded HTTP client/server, request/response/content and replaceable client handler pipeline. Web guide, reference
System.Concurrency Explicit Thread lifecycle and ThreadPool execution using isolated workers. Reference, thread guide
System.Environment Functions for command-line arguments, the current directory and environment-variable lookup. Lookup distinguishes a missing variable from a host access error through Result and Optional. Development native source builds return fresh managed argument arrays; execution gate. Environment.
System.Introspection Assembly, module, type, member and parameter descriptions, binding flags and metadata tokens for inspecting the loaded program. Introspection guide
System.IO InputStream, OutputStream and optional SeekableStream capabilities; file byte streams; TextReader/TextWriter and async StreamReader/StreamWriter, with explicit SyncTextReader/SyncTextWriter and SyncStreamReader/SyncStreamWriter alternatives; typed stream and text errors. Current text readers use bounded, strict UTF-8 reads. Reference, stream guide, standard streams
System.Linq Query operators over iterable collections, including filtering, projection and terminal operations. Optional and single-result queries use explicit outcomes, with SingleError for cardinality failures. Query reference · Collections and queries
System.Math Integer and floating-point functions, including Abs, Min, Max, Clamp, rounding, roots and trigonometry. Integer Abs reports overflow and Clamp reports an invalid range through Result. Math reference · Expected outcomes.
System.Runtime RuntimeContext, the application entry point for the executing assembly and type information from runtime type handles. Runtime discovery
System.Storage Paths, storage items, File and Directory interfaces, StorageProvider lookup, the host FileSystem provider, metadata and FileText helpers with typed errors. Items describe stored resources; their byte and text streams use System.IO. Reference, storage items, providers, working POC
System.Concurrency.Tasks Task, Promise, TaskQueue, completion state, TaskOutcome and composition/propagation helpers. Tasks describe completion and cancellation; expected errors remain values such as Result. Reference, Tasks guide, callback methods
System.Security.Cryptography Development buffer-based SHA-256, HMAC verification and secure random fill. Cryptography contracts
System.Text UnicodeScalar helpers, strict UTF-8/ASCII Encoding policies, conversion sessions and text error types. String itself lives in System. Text reference · Strings and UTF-8

Runtime and compiler support

These modules serve lower-level integration rather than ordinary collection, text or I/O workflows. Public metadata support is included and labelled separately from application services.

Module What it contains
System.Runtime.CompilerServices Compiler-facing metadata such as UnionAttribute and IsExternalInit, IsReadOnlyAttribute, plus runtime integration support. Internal bootstrap services are not application APIs.
System.Runtime.InteropServices NativeMemory allocation and freeing for the supported unsafe pointer surface. This is separate from managed object and array storage.

Finding a type

Expand modules in the generated reference to browse documented types and members. See reference support and renderer limits for the few manual entries. Generated declarations use Raven notation; the API guide explains how to read them for Raven.

Future module ideas belong in proposals until they have implemented APIs. This list will expand alongside the library.

The transitional async builder guide covers generated state ownership and links the compiler-facing System.Runtime.CompilerServices contracts to their temporary role.

EquatableTo<T> defines typed equality as Equals(T), without imposing nullable value types. Path now supplies that contract and Object overrides.

System.Introspection

TypeInfo and MemberInfo describe types and metadata. AssemblyInfo and ModuleInfo describe the loaded catalog. ConstructorInfo, FieldInfo, MethodInfo and PropertyInfo describe declarations. ParameterInfo describes method and index parameters; BindingFlags selects metadata query categories. See descriptor identity for Object behavior and remaining descriptor coverage.

System.Runtime.Reflection provides provisional construction, invocation and member-access extensions with Result-based validation errors.

ConvertibleInto<T> provides explicit Convert() -> T; implementations choose failure policy. No implicit conversion is introduced.

System.Runtime also contains the development GC class; see garbage collection for object counters, explicit collection and lifetime use.

System.IO.Compression

GZipStream composes async byte streams; see compression.

System.Networking.Security

SslStream and immutable TLS options compose async byte streams and explicit certificate trust. These development types belong to System.Networking.