Add type definition descriptions

[flyingsquirrel0419]

Summary

• Add JSDoc descriptions to public type definitions so TypeScript language server hover/autocomplete can explain methods and options in editors.
• Cover core cache entry options, stack options, metrics/result types, layer interfaces, invalidation interfaces, and public helper/integration option surfaces.
• Add method-level documentation for CacheStack, CacheNamespace, concrete layers, tag indexes, serializers, stampede/single-flight helpers, and integration helpers.

Fixes #39

Type of Change

• Bug fix (non-breaking change that fixes an issue)
• New feature (non-breaking change that adds functionality)
• Breaking change (fix or feature that would cause existing behavior to change)
• Documentation update
• Type definition improvement

Testing

• npm run build
• npm run lint
• npm test
• Verified generated declaration files preserve representative JSDoc comments in dist/*.d.ts and dist/*.d.cts

Notes

• This is documentation-only at runtime: no implementation behavior was changed.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
layercache-docs	Ready	Preview, Comment	May 2, 2026 0:49am