Standard Library
This directory is the sole authority for the portable public modules distributed with Nocter. Every module index.nct owns its compiler-checked public declarations and declaration doc comments. The catalog below assigns each longer observable subject to one behavior guide. A guide may span tightly coupled modules when separating their cross-operation invariants would create duplicate authorities. Declarations answer what can be called; guides explain observable behavior, failure, complexity, and invariants without repeating signatures. The package identity itself is defined by the checked root declaration.
Language constructs and target primitives are referenced from their owning specification chapters rather than redefined here. Generated contract pages show the exact checked index.nct source: only declarations with public language visibility are public API, while visible see edges and restricted declarations remain source-level module assembly and package contracts. Independent package-only modules live under std/internal and are excluded from generated navigation. The guides below cover modules whose observable behavior needs more explanation than declaration comments.
Behavior Guide Authority
| Observable subject | Sole guide | Checked contracts |
|---|---|---|
| borrowed UTF-8 text | Borrowed Text | std/str |
| owned UTF-8 text | Owned Strings | std/string |
| growable sequences | Vectors | std/vec |
| inline fixed-capacity sequences and byte staging | Fixed-Capacity Collections | std/fixed |
| borrowed sequences | Slices | std/slice |
| borrowed parsing windows | Borrowed Scanning | std/scan |
| fixed-width binary scalar encoding | Binary Scalar Codecs | std/bytes |
| canonical hexadecimal bytes | Hexadecimal Bytes | std/hex |
| standard and URL-safe Base64 bytes | Base64 Bytes | std/base64 |
| cryptographic content digests | Cryptographic Digests | std/digest |
| accidental-corruption checksums | CRC-32 Checksums | std/checksum |
| streaming compressed representations | Streaming Compression | std/compress |
| streaming archive entries and safe relative paths | Streaming Tar Archives | std/archive |
| iteration and collection | Iteration | std/iter, std/iter/collect |
| value formatting | Formatting | std/fmt |
| byte streams and buffering | I/O | std/io, std/io/buffer |
| paths and filesystem operations | Filesystem | std/path, std/fs |
| durable local byte storage | Durable Local Byte Storage | std/store |
| source-neutral configuration, publication, and input adapters | Source-Neutral Configuration | std/config, std/config/arguments, std/config/environment, std/config/json |
| numeric values and text conversion | Numeric Values | std/num |
| total ordering and comparison results | Total Ordering | std/order |
| allocation and storage failure | Allocation and Failure | std/mem |
| recoverable failure payloads | Recoverable Errors | std/error |
| pointers and addresses | Pointer and Address Conversion | std/ptr |
| hashing and unordered collections | Associative Collections | std/hash, std/map, std/set |
| cryptographically secure random bytes and scalars | Cryptographic Randomness | std/random |
| canonical UUID values and version-4 generation | Universally Unique Identifiers | std/uuid |
| opaque session identifiers | Opaque Session Identifiers | std/session |
| JSON values, parsing, and generation | JSON Values and Text | std/json |
| structured operational events and redaction | Structured Operational Logging | std/log |
| durations, monotonic time, wall-clock time, and UTC calendar values | Time | std/time |
| structured asynchronous computation composition | Structured Asynchronous Tasks | std/task |
| cooperative shared ownership and synchronization | Cooperative Synchronization | std/sync |
| long-running task ownership, reload, and graceful shutdown | Service Lifecycle | std/service |
| synchronous processes and process context | Synchronous Processes | std/process |
| structured command-line parsing and help | Command-Line Applications | std/cli |
| numeric network addresses and socket I/O | Network I/O | std/net |
| authenticated TLS client streams | Authenticated TLS | std/tls |
| absolute HTTP-family URLs and request targets | URL | std/url |
| HTTP/1.1 client, server, message values, and framing | HTTP/1.1 | std/http |
| Unicode scalars and text transforms | Unicode Text and Scalars | std/char, Unicode operations on std/str and std/string |
| native assertions | Native Assertions | std/testing |