Standard Library Module Index

This index lists every module currently present under seen_std/src. Detailed pages cover the stable/user-facing families; lower-level platform and runtime modules are listed here so missing API-reference coverage is visible.

The separately versioned seen/seen-tokenizers package lives under packages/seen_tokenizers. It provides bounded strict tokenizer JSON, reproducibly generated Unicode 16.0.0 classification tables, deterministic GPT byte-level BPE, validated decoding, and explicit special-token policies. Its byte-offset and Unicode-codepoint APIs are intentionally distinct.

Module Families

Modules

async

• async/future
• async/runtime

audio

• audio/audio
• audio/openal

collections

• collections/bit_set
• collections/btree_map
• collections/btree_set
• collections/byte_buffer
• collections/hash/mod
• collections/hash_map
• collections/hashset
• collections/linked_list
• collections/list_utils
• collections/map
• collections/pool
• collections/std_string
• collections/string_buffer
• collections/string_hash_map
• collections/vec
• collections/vecdeque

core

• core/binary
• core/bitfield
• core/compress
• core/convert
• core/intrinsics
• core/json_derive
• core/option
• core/ord
• core/packet
• core/prelude
• core/reflect
• core/result
• core/to_string
• core/unit

crypto

• crypto/md5
• crypto/sha256

env

• env/env

ffi

• ffi/c_types
• ffi/cinterop

framework

• framework/component
• framework/executor
• framework/hotreload
• framework/middleware
• framework/routing
• framework/store
• framework/vdom
• framework/vdom_lite

fs

• fs/file
• fs/mod
• fs/operations
• fs/path
• fs/types

graphics

• graphics/gpu
• graphics/renderer
• graphics/shader

hash

• hash/mod

input

• input/gamepad
• input/gamepad_unified

io

• io/buffered
• io/bytes
• io/direct
• io/file
• io/stdio

io/bytes defines the native ByteBuffer, ByteSlice, and MutableByteSlice ownership contract. Byte ranges use checked nonnegative 64-bit Int geometry, including offsets above 4 GiB. Immutable views share an owner generation; mutable views are exclusive. Closing views and releasing the owner are idempotent, and any view whose owner was released is rejected with the stable byte.invalid code. Cancellation-aware acquisition reports byte.cancelled. See seen_std/examples/byte_slices.seen for a compiling example.

ByteBuffer also provides bounded growable storage. Call tryByteBufferWithCapacity or tryZeroedByteBuffer to select a checked logical capacity and power-of-two alignment up to 32 bytes. reserve, push, and append reject growth while any view is borrowed, preserve existing bytes, and cap every allocation at BYTE_MAX_CAPACITY. Native Seen arrays are 32-byte aligned by the runtime; smaller requested alignments are compatibility requirements satisfied by that storage. toArray is the explicit copying escape hatch; slices remain generation-checked zero-copy views.

Synchronous byte I/O is specified by the Reader, Writer, Seeker, BufRead, and Flush traits. The native Seen ByteReader and ByteWriter implement the same concrete contracts without foreign policy: each operation accepts an OperationContext, returns exact partial progress, rejects stale views and checked-limit overflow, and reports cancellation or expiration before side effects. ByteWriter is created with tryByteWriterWithLimit; it never grows beyond the caller's bound. See seen_std/examples/byte_streams.seen.

Bounded adapters include LimitedReader, CountingReader, TeeReader, HashingWriter, BufferedReader, and BufferedWriter. copyLimited uses a caller-bounded scratch buffer and returns CopyResult with separate read and write progress, an explicit limit marker, and completion state. Tee, hash, and copy accounting covers only bytes actually accepted; cancellation is checked before progress and every owned adapter closes idempotently. See seen_std/examples/byte_adapters.seen.

UTF-8 codecs provide strict validation, lossy U+FFFD replacement, bounded encoding, and cancellation before side effects. Endian codecs read and write checked 16-, 32-, and 64-bit integer storage in both byte orders. Float16, BFloat16, and Float64 helpers deliberately preserve raw IEEE bit patterns so NaN payloads and signed zero round-trip exactly; scalar interpretation belongs to the scalar type layer. Every codec validates its complete range before mutation. See seen_std/examples/byte_codecs.seen.

Asynchronous byte I/O is specified by AsyncReader, AsyncWriter, AsyncSeeker, AsyncBufRead, and AsyncFlush. The native Seen AsyncByteReader and AsyncByteWriter preserve checked borrowed spans, nonnegative 64-bit progress, exact partial completion, cancellation before side effects, and idempotent cleanup. Memory-backed operations are direct-ready coroutines; readiness scheduling and operating-system queues remain the responsibility of backend implementations. See seen_std/examples/async_byte_streams.seen.

reactor

• reactor/mod
• reactor/reactor

The reactor provides move-only native handles, generation-safe registrations, finite event batches, prompt wakeups, monotonic timers, fair diagnostics, and a fixed-worker bounded blocking pool. Linux epoll, macOS kqueue readiness, and Windows IOCP completion share one event contract while retaining explicit capability and unsupported-platform diagnostics. See docs/api-reference/reactor.md.

json

• json/builder
• json/canonical
• json/mod
• json/parser
• json/strict
• json/value

formats

• formats/safetensors

inference

• inference/scalars
• inference/span

math

• math/math

memory

• memory/aligned_buffer
• memory/allocation
• memory/mapped_region
• memory/pool_region
• memory/stack_region

accelerator

• accelerator/cuda/error (explicit Linux x86-64 CUDA dependency)
• accelerator/cuda/mod (experimental hardware maturity)

CudaStream.borrowLaunchToken() returns a non-owning CudaStreamLaunchToken for one immediately nested model-kernel adapter call. The token is generation- and device-checked, supports graph capture, and does not authorize retention, synchronization, destruction, or device changes.

net

• net/poll
• net/tcp

platform

• platform/darwin/cocoa
• platform/darwin/coreaudio
• platform/darwin/gamecontroller
• platform/darwin/metal
• platform/darwin/sdl3
• platform/darwin/window
• platform/linux/alsa
• platform/linux/evdev
• platform/linux/libinput
• platform/linux/pipewire
• platform/linux/sdl3
• platform/linux/steam
• platform/linux/steam_wrapper
• platform/linux/vulkan
• platform/linux/wayland
• platform/linux/window
• platform/linux/x11
• platform/web/webgpu
• platform/windows/win32
• platform/windows/xinput

process

• process/process

random

• random/rng

scripting

• scripting/lua

security

• security/enclave

simd

• simd/simd_math
• simd/simd_types

str

• str/char
• str/escape
• str/string

sync

• sync/atomic
• sync/atomic_queue
• sync/atomic_stack
• sync/barrier
• sync/channel
• sync/mpsc_queue
• sync/mutex
• sync/ordering
• sync/rwlock
• sync/spsc_queue
• sync/thread_local

thread

• thread/affinity
• thread/mod
• thread/pool

time

• time/backoff
• time/format
• time/mod
• time/time
• time/timer

uww

• uww/fixed
• uww/mod