feat: Add caching and middleware support for placeholders, enhance documentation generation

[bentahsin]

No description provided.

[Copilot]

Pull request overview

This PR adds significant new features to the placeholder management system: caching support via @Cache annotation, middleware processing via @Middleware annotation, permission requirements via @RequirePermission annotation, and automatic documentation generation. It also enhances existing annotations with description and example fields.

Key Changes

• Introduces three new annotations (@Cache, @Middleware, @RequirePermission) and a middleware interface for extensible placeholder processing
• Refactors caching logic to support configurable cache durations with TimeUnit-based control
• Adds generateDocs() method to automatically create documentation files listing all registered placeholders with their metadata

Reviewed changes

Copilot reviewed 7 out of 8 changed files in this pull request and generated 10 comments.

Show a summary per file

File	Description
PlaceholderMiddleware.java	New functional interface for processing placeholder results before returning to PlaceholderAPI
RequirePermission.java	New annotation for permission-gated placeholders with customizable denial messages
RelationalPlaceholder.java	Added optional description and example fields for documentation generation
PlaceholderIdentifier.java	Added optional description and example fields for documentation generation
Middleware.java	New annotation to specify middleware chain for placeholder result processing
Cache.java	New annotation for configurable caching with duration and TimeUnit support
BenthPAPIManager.java	Major refactoring: added middleware support, permission checking, improved caching logic, and documentation generation functionality
.gitignore	Added dependency-reduced-pom.xml to ignore list

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.