Cache behavior and utilities for Raxol performance optimization.

This module defines the standard cache interface and provides utilities for cache key generation and invalidation patterns.

Caching Strategies

Raxol uses several caching strategies depending on the use case:

ETS Cache (ETSCacheManager)

For runtime caching with LRU eviction. Best for:

• Layout calculations
• Style resolutions
• Buffer regions
• Cell creation

Module Attribute Cache

Compile-time caching using module attributes. Best for:

• Static ANSI sequences
• Predefined color maps
• Constants

Delegated Cache

Using cache: true options on existing modules. Best for:

• Theme resolution
• Component styles

Cache Keys

Cache keys should be deterministic and based on the input parameters. Use compute_hash/1 for complex structures.

Example Usage

# Using ETSCacheManager directly
alias Raxol.Performance.ETSCacheManager

case ETSCacheManager.get_layout(tree_hash, constraints) do
  {:ok, result} -> result
  :miss ->
    result = compute_expensive_layout(tree, constraints)
    ETSCacheManager.cache_layout(tree_hash, constraints, result)
    result
end

# Using the cache pattern helpers
alias Raxol.Performance.Cache

Cache.with_cache(
  :layout,
  {tree_hash, constraints},
  fn -> compute_expensive_layout(tree, constraints) end
)