docs / stdlib

Stdlib index
  1. Overview
  1. Captured-borrow migration worklist (3.3.3)
  2. Owned-bind migration worklist (8.2.7)
  3. Return-side title audit — the ride-through enumeration
  4. stdlib ownership audit
  5. stdlib ownership dispositions (plan 1.3.1 / 4.3.1)

aot

  1. Components
  2. Scope
  3. Scoped

codec

  1. Base32
  2. Base64

codec / csv

  1. Csv

codec / json

  1. Json

collection

  1. ArrayList
  2. BPlusTree
  3. Cache
  4. Collectors
  5. HashMap
  6. HashSet
  7. Heap
  8. ImmutableList
  9. ImmutableMap
  10. ImmutableSet
  11. LinkedList
  12. RedBlackTree
  13. Sort

collection / ltm

  1. LtmBPlusTree

concurrent

  1. AtomicInt32
  2. AtomicInt64
  3. Channel
  4. Fiber
  5. FiberLocal
  6. Lock
  7. Mutex
  8. RwLock
  9. Semaphore
  10. Tasks

error

  1. Exception
  2. NoOptionalValueException
  3. NotProvidedException
  4. RecoverableException
  5. ScopedBuildFailedException
  6. ScopeNotActiveException
  7. Throwable
  8. UnrecoverableException

gfx

  1. Sampler
  2. Texture2D

hash

  1. DefaultHasher
  2. Hash
  3. SipHash
  4. XXHash3

ifx

  1. BackendRegistry
  2. Window

io

  1. Buffer

io / file

  1. File
  2. FileInfo
  3. FileReader
  4. FileWriter
  5. Path
  6. Watcher

io / net

  1. BufferPool
  2. ByteBuffer
  3. IpAddress
  4. Server
  5. ServerBuilder
  6. SocketAddress
  7. TcpListener
  8. TcpStream
  9. UdpSocket

io / net / dns

  1. Dns

io / net / uri

  1. Uri
  2. UriBuilder

lang

  1. Guid
  2. Math
  3. Optional
  4. Pair
  5. Slice
  6. String
  7. StringBuilder

lang / stream

  1. ArrayStream
  2. Stream

math

  1. Camera
  2. Color
  3. DType
  4. Ray
  5. Rotation
  6. Tensor
  7. Transform

math / fft

  1. Fft

math / linalg

  1. LinAlg

math / npio

  1. Npy

math / poly

  1. Poly

math / random

  1. Generator

math / stats

  1. Stats

nucleo

  1. Columns — the Arrow-laid-out substrate
  2. Fused tensor expressions — Fuse
  3. Table — the lazy, typed dataframe
  4. Tape — define-by-run autograd
  5. Transform intrinsics — Grad, Vmap, Jit

process

  1. Command
  2. Process

reflect

  1. Class

search / distance

  1. Distance

search / fuzzy

  1. Matcher

search / ngram

  1. Index

session

  1. PackageInstallException
  2. Packages

time

  1. Clock
  2. DateTimeFormatter
  3. Duration
  4. Instant
  5. LocalDate
  6. LocalDateTime
  7. LocalTime
  8. Period
  9. ZonedDateTime
  10. ZoneId
  11. ZoneOffset

wire

  1. Compressor
  2. CompressStream
  3. DecompressionLimitException
  4. Decompressor
  5. Encoder
  6. Schema
  7. SchemaEncoder

xpu

  1. Device
  2. KernelBuffer
  3. KernelStream
  4. KernelTimer

xpu / mesh

  1. MeshSimplifier

Stdlib reference

One document per public stdlib class: purpose, the @EntryPoint-tagged methods, and the full public method surface, verified against runtime/src/cajeta/. The guide is the linear tutorial; it links here for API detail. Docs link the tour demo that exercises each class, where one exists.

cajeta.lang

Class
StringImmutable UTF-8 text, the single string type
StringBuilderGrowable byte buffer for building a String in amortized O(N)
OptionalValue-typed sum: present or empty
PairTwo-field generic value type
MathNumeric utilities + device math intrinsics
Guid128-bit UUID backed by a single uint128
SliceZero-copy array window, the arr[a:b] result type

cajeta.lang.stream

Class
StreamThe pull-protocol base for stdlib iteration
ArrayStreamA Stream over a contiguous T[] range

cajeta.collection

Class
ArrayListGrowable index-addressable sequence; the workhorse list
LinkedListDoubly-linked list
HashMapSwissTable-backed hash map over a dense entry array
HashSetHash-based set of unique values
ImmutableListImmutable array-backed list
ImmutableMapFrozen hash-indexed map snapshot
ImmutableSetFrozen hash-indexed set
HeapArray-backed binary heap / priority queue
RedBlackTreeOrdered map, CLRS red-black tree
BPlusTreeIn-memory ordered map, B+ tree leaves in a linked chain
CacheBounded cache with LRU eviction and optional TTL
CollectorsStandard Collector factories for stream terminal ops
SortGeneral-purpose host sorting + shared comparison protocol

cajeta.collection.ltm

Class
LtmBPlusTreeDisk-backed larger-than-memory ordered map

cajeta.concurrent

Class
MutexFused mutual exclusion + protected data
RwLockReader-writer lock for read-heavy shared state
LockNo-data RAII gate
SemaphoreCounting permit pool
ChannelBounded MPMC queue
AtomicInt32Lock-free atomic int32 cell
AtomicInt64Lock-free atomic int64 cell
FiberLocalAmbient per-request state
TasksTask utilities
FiberSleep the calling fiber

cajeta.time

Class
ClockThe static “what time is it” surface
InstantA moment on the UTC timeline, nanosecond precision
DurationSigned time-based amount, nanosecond precision
PeriodCalendar-based amount: years, months, days
LocalDateCalendar date, no time-of-day or zone
LocalTimeTime-of-day, no date or zone
LocalDateTimeDate paired with time, no zone
ZonedDateTimeDate-time with a fixed UTC offset
ZoneIdRegion time-zone identifier
ZoneOffsetFixed offset from UTC
DateTimeFormatterTemporal value ⇄ text formatting

cajeta.io

Class
BufferByte buffer with typed, reinterpreting access

cajeta.io.file

Class
FileFilesystem access: whole-file statics + handle instance
FileInfoOne-stat snapshot: size, timestamps, type, permissions
FileReaderStreaming byte reader
FileWriterStreaming byte writer
PathImmutable filesystem path
WatcherFilesystem-change notifier

cajeta.io.net

Class
IpAddressImmutable IPv4/IPv6 address
SocketAddressIP address + port
TcpStreamConnected blocking TCP stream
TcpListenerPassive TCP listening socket
UdpSocketUDP datagram socket
ServerTCP server core: bind, listen, accept loop
ServerBuilderModel-selection builder for Server
ByteBufferPooled byte buffer with read and write cursors, filled from and written to a channel in place
BufferPoolBounded free list of same-sized buffers, one pair per connection

cajeta.io.net.dns

Class
DnsBlocking hostname resolution

cajeta.io.net.uri

Class
UriImmutable parsed URI (RFC 3986)
UriBuilderBuilder for Uri

HTTP/1.1 and WebSocket are not stdlib — they are application-layer protocols and live in the external dev.cajeta.http library.

TLS is not stdlib either: TlsStream, TlsListener and TlsConnection live in the external dev.cajeta.crypto library (dev.cajeta.crypto.tls), which took them from cajeta.io.net.tls.

cajeta.hash

Class
HashHash utility namespace
DefaultHasherProcess-seeded XXH3-64 behind synthesized hash()
XXHash3Fast 64-bit non-cryptographic hash
SipHashDoS-resistant keyed 64-bit hash

Cryptographic digests (Sha256, Sha1, MD5, Blake3), HmacSha256, HmacSha1, Pbkdf2, Totp and SecureRandom are the external dev.cajeta.crypto library, with the same names and APIs; cajeta.hash.Sha256 became dev.cajeta.crypto.Sha256. Hash.constantTimeEquals stays here.

cajeta.math

Class
TensorThe keystone n-dimensional array
DTypeRuntime numeric dtype descriptor
RotationQuaternion construction ergonomics
TransformTRS rigid+scale transform
CameraProjection and view matrix builders
RayHalf-line query primitive for picking and culling
ColorRGBA color, sRGB ⇄ linear

cajeta.math.* (numerics)

Class
FftDiscrete Fourier transform surface
LinAlgLinear-algebra factorizations
GeneratorRandom numbers over Philox4x32-10
StatsDescriptive statistics: histogram, bincount, digitize
PolyPolynomial operations
NpyNumPy .npy binary array I/O

cajeta.codec

Class
Base64Base64 (RFC 4648) byte ⇄ text codec
Base32Base32 (RFC 4648) codec, for OTP secrets
CsvTyped CSV: bind rows to a declared type
JsonTop-level JSON parse/serialize entry points

cajeta.wire

Class
EncoderBidirectional wire codec: T ⇄ bytes
SchemaThe schema a SchemaEncoder decodes against
SchemaEncoderSchema-carrying wire codec
CompressorCompress stage: block, levelled, or streamed
DecompressorDecompress stage: sized by the block header, or capped
CompressStreamAn open compression: write, flush, finish
DecompressionLimitExceptionA decompression over its caller’s cap

cajeta.search

Class
DistanceString edit-distance functions
IndexN-gram inverted index for fuzzy candidates
MatcherTypo-tolerant key→value lookup

cajeta.process

Class
CommandSubprocess command: program, args, env, capture
ProcessA spawned, still-running child

cajeta.error

Class
ThrowableRoot of the exception hierarchy: message, diagnostic code, stack trace, JSON
ExceptionBase of the catchable exception hierarchy
RecoverableExceptionErrors a caller might handle and proceed past
NoOptionalValueExceptionUnwrap of an empty Optional — catchable, not panic
ScopeNotActiveExceptionA scoped component used outside its scope
ScopedBuildFailedExceptionA failed or repeated build of a scoped component
NotProvidedExceptionA provided-only component injected before it was provided
UnrecoverableExceptionFatal conditions: invariant violations, OOM

cajeta.aot

The compile-time DI graph. @Component, @Inject and @Factory are covered in the guide.

Class
ScopePublishes a component lifetime at the method or class that bounds it
ScopedA handle that resolves a scoped component at each get()
ComponentsPlaces values made at run time into their scope

cajeta.reflect

Class
ClassRuntime class representation; the reflection entry point

cajeta.xpu

Class
DeviceThe active XPU device and host-side queries
KernelBufferUnified handle to device memory
KernelStreamOrdered queue of XPU work
KernelTimerPer-kernel device timer with a stated tier and a peak gate
MeshSimplifierGarland–Heckbert edge-collapse mesh simplifier

cajeta.nucleo

The ML spine: compile-time function transforms and the runtime eager tape.

Class
TransformsThe Grad/Vmap/Jit compile-time transform intrinsics + @Grad/@Vmap/@Jit sugar
GradResultThe typed {value, grads} return bag of a differentiated function
TapeDefine-by-run autograd: records ops eagerly, replays gradients in reverse
VarHandle to one tape node (value + gradient readback)
TableThe lazy, record-typed dataframe: relational plan, gradual typing, pushdown + index interface, Arrow/Parquet boundaries
ColumnThe Arrow-laid-out columnar substrate: Column<T> / NullableColumn<T> / StringColumn, tensor-bit-identical, the frozen Arrow C ABI seam

cajeta.gfx

Class
Texture2DRead-only 2-D float32 texture, sampled in kernels
SamplerFiltering + addressing configuration for Texture2D

cajeta.ifx

Class
BackendRegistryUI backend registry, probe, and dispatcher
WindowThe portable window contract

Coverage is checked: scripts/check-stdlib-coverage.sh fails if any class with an @EntryPoint-tagged member lacks a document here.

Source: docs/stdlib/README.md · 7 min read · 1543 words