Standard Library¶

This folder contains design notes for the normal std module. It is organized by namespace, not by API kind. It is not generated API reference, and it does not contain the compiler-provided prelude namespace.

std contains APIs that build on the prelude but are not required for core syntax or type checking.

std is a toolchain-provided normal module. It is available for resolution, but it is not implicitly imported and its declarations are not automatically in scope.

V1 accepts only the namespace skeleton and the minimal declarations needed by accepted examples and compiler tests. The broader standard library remains deferred.

Namespace Index¶

• std: root namespace policy and root-level declarations.
• std.collections: concrete collections and collection adapters.
• std.debug: debug rendering and debug-oriented helpers.
• std.fmt: formatting contracts and rendering helpers.
• std.hash: hashing contracts, hasher state, and hash algorithms.
• std.io: capability-oriented readers, writers, standard streams, and printing APIs.
• std.math: numeric helpers and order-dependent scalar algorithms.
• std.mem: memory helpers, allocator implementations, and allocation policy.
• std.sort: sorting algorithms.
• std.testing: test assertions and test-support APIs.
• std.text: owned strings, text builders, Unicode, and parsing helpers.

Future namespace candidates include filesystem, clocks, threads, processes, networking, and platform APIs. They should get namespace pages here when their expected surface is designed.

Deferred API Growth¶

Deferred standard-library API growth is tracked by standard collections, allocator implementations, standard text and formatting, standard result policy, standard utility APIs, and testing allocator leak reporting.