Skip to content

docs: correct README, API docs, and type definitions - #497

Merged
avoidwork merged 1 commit into
masterfrom
docs/readme-audit
Sep 27, 2026
Merged

avoidwork merged 1 commit into
masterfrom
docs/readme-audit

Conversation

@avoidwork

Copy link
Copy Markdown
Owner

Description

Corrects factual errors and stale data in the README, API docs, and TypeScript definitions. Fixes the constructor validation claim (LRU validates params and throws TypeError), corrects onEvict to fire only on evict()/set() (not setWithEvicted()), refreshes test/suite counts (169/27) and branch coverage (99.39%), and reconciles the comparison table with measured min+gzip bundle sizes. Removes the off-base lru-cache "2x size" claim and attributes the dual-cache design to quick-lru. Replaces the Security section with a pointer to the Technical Documentation.

Type of Change

  • Bugfix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update
  • Refactor (no functional changes)
  • Performance improvement
  • CI / build / tooling

Testing

Ran npm run lint (0 warnings, 0 errors) and npm test (169 tests, 27 suites, all passing). Coverage maintained at 100% lines / 99.39% branches / 100% functions.

Coverage

  • 100% line coverage maintained

Checklist

  • npm run lint passes
  • Tests pass with 100% line coverage
  • No forbidden patterns used
  • Conventional Commit style applied

- Fix constructor validation claim (LRU validates params, throws TypeError)
- Correct onEvict to fire only on evict()/set(), not setWithEvicted()
- Refresh test/suite counts (169/27) and branch coverage (99.39%)
- Reconcile comparison table with measured min+gzip bundle sizes
- Remove off-base lru-cache 2x claim; attribute dual-cache to quick-lru
- Replace Security section with pointer to Technical Documentation
- Add items property, clarify peek()/getMany()/keys() behavior
@avoidwork avoidwork self-assigned this Sep 27, 2026
@avoidwork
avoidwork merged commit e9a2c53 into master Sep 27, 2026
4 checks passed
@avoidwork
avoidwork deleted the docs/readme-audit branch September 27, 2026 02:12
@avoidwork avoidwork mentioned this pull request Sep 27, 2026
12 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant