feat/cache-function-pointers

Author: ATTron

README.md

@@ -90,7 +90,7 @@ pub fn main(init: std.process.Init) !void {
 }
 ```
 
-`resolveFrom` detects the CPU, picks the best variant, and returns a typed function pointer. Detection is cached after the first call, so `resolveFrom` is safe to call in hot paths.
+`resolveFrom` detects the CPU, picks the best variant, and returns a typed function pointer. CPU detection is cached, so repeated calls just do a few enum comparisons — cheap enough to call inline.
 
 ## Shared libraries / FFI
 

src/root.zig

@@ -90,8 +90,8 @@ pub fn resolveNoIo(comptime F: type, comptime name: []const u8) F {
     return resolve(F, name, std.Io.Threaded.global_single_threaded.io());
 }
 
-/// Resolve against a pre-detected level and custom level list. Use this when
-/// you need to resolve many functions at once or dispatch over non-default levels:
+/// Resolve against a pre-detected level and custom level list. Use this
+/// when you need custom levels or want to resolve many functions in a batch:
 ///
 ///   const level = oma.detectCpuLevel(io);
 ///   const dot = oma.resolveForLevel(DotFn, "dot", levels, level);