<h1 id="top" align="center">
    <img width="99" alt="Rust logo" src="https://raw.githubusercontent.com/jamesgober/rust-collection/72baabd71f00e14aa9184efcb16fa3deddda3a0a/assets/rust-logo.svg">
    <br><b>cache-mod</b><br>
    <sub><sup>DOCUMENTATION</sup></sub>
</h1>
<div align="center">
    <sup>
        <a href="../README.md" title="Project Home"><b>HOME</b></a>
        <span>&nbsp;│&nbsp;</span>
        <span>DOCS</span>
        <span>&nbsp;│&nbsp;</span>
        <a href="./API.md" title="API Reference"><b>API</b></a>
        <span>&nbsp;│&nbsp;</span>
        <a href="../CHANGELOG.md" title="Changelog"><b>CHANGELOG</b></a>
    </sup>
</div>
<br>

## Contents

- **[API Reference](./API.md)** — complete public surface with signatures, contracts, and code examples for every public item.
- **[Release notes](./release/)** — per-version write-ups, paired with the matching GitHub Releases page.

## Quick links

- **README:** [../README.md](../README.md)
- **CHANGELOG:** [../CHANGELOG.md](../CHANGELOG.md)
- **REPS standards:** [../REPS.md](../REPS.md)
- **crates.io:** [crates.io/crates/cache-mod](https://crates.io/crates/cache-mod)
- **docs.rs:** [docs.rs/cache-mod](https://docs.rs/cache-mod)

## Release archive

| Version | Date       | Notes                                                            |
| ------- | ---------- | ---------------------------------------------------------------- |
| 0.7.0   | 2026-05-20 | Sharded internals: up to 16-way concurrent throughput — [v0.7.0](./release/v0.7.0.md) |
| 0.6.0   | 2026-05-20 | Arena-backed internals: O(1) LRU/TinyLFU/Sized, O(log n) LFU — [v0.6.0](./release/v0.6.0.md) |
| 0.5.1   | 2026-05-20 | Docs + repo hygiene patch — [v0.5.1](./release/v0.5.1.md)        |
| 0.5.0   | 2026-05-20 | TinyLFU, SizedCache, property tests, benchmarks — [v0.5.0](./release/v0.5.0.md) |
| 0.4.0   | 2026-05-20 | TTL eviction policy — [v0.4.0](./release/v0.4.0.md)              |
| 0.3.0   | 2026-05-20 | LFU eviction policy — [v0.3.0](./release/v0.3.0.md)              |
| 0.2.0   | 2026-05-20 | Foundation: public API surface — [v0.2.0](./release/v0.2.0.md)   |
| 0.1.0   | 2026-05-18 | Initial scaffold — [v0.1.0](./release/v0.1.0.md)                 |
