Hooks Laravel Package

Added

• HookDeprecations primitive for backwards-compatible hook renaming
  • deprecateHook(string $old, string $new): void helper registers a rename in one line
  • Action and Filter transparently route add()/remove()/removeAll() through the alias map
  • do() / apply() fan out across canonical and alias buckets so pre-deprecation subscribers still fire
  • Callbacks registered under both the old and canonical names are de-duplicated by identity within a single dispatch (closures, invokable objects, [$obj, 'method'], [Class::class, 'staticMethod'], and string function names all key correctly). Deliberate double-registrations within a single bucket still fire twice
  • Stable insertion-order tie-break within a priority is preserved via a monotonic sequence counter, even when a callback is routed through an alias bucket
  • Cycles are rejected: deprecateHook('a', 'b') followed by deprecateHook('b', 'a') throws InvalidArgumentException instead of silently creating a b → b self-alias
  • Deprecation notices log only on dispatch (do/apply), never on add/remove — so the log entry is anchored to real hook use, not to boot-time registration
  • Log gate reads from the published config/artisanpack/hooks.php (deprecation_level key), falling back to HOOKS_DEPRECATION_LEVEL env for zero-config use. Any PSR-3 level (emergency, alert, critical, error, warning, notice, info, debug) is accepted; off suppresses the log
  • "Log once per unique alias" is scoped per request, not per process: the service provider resets the dedup on Octane RequestReceived and Queue JobProcessing so long-lived workers do not swallow every notice after the first request/job
  • HookDeprecations is container-resolvable via app(HookDeprecations::class) — no new Facade or helper surface beyond deprecateHook()
• Config file at config/hooks.php, publishable via php artisan vendor:publish --tag=hooks-config
• src/Concerns/ManagesHookBuckets.php trait shared by Action and Filter, so bucket / alias / dedup / removal logic lives in one place instead of duplicated across both classes
• README section documenting the naming convention and shared cross-package hooks (ap.google.scopes, ap.icons.registerIconSets)

Added

• Laravel 13 support
  • illuminate/support constraint now accepts ^13.0
  • PHP 8.3+ is required when installing on Laravel 13 (enforced by Laravel itself; PHP 8.2 remains supported on Laravel 11/12)

Changed

• Aligned illuminate/support constraint to ^11.0|^12.0|^13.0 to match the actively tested matrix
• Updated supported Laravel versions in README to 11.x, 12.x, and 13.x

Removed

• Dropped explicit declaration of support for Laravel < 11
  • The previous >=5.3 constraint was overly permissive; the package was only ever tested against Laravel 10/11. Users on Laravel 10 or earlier should pin to ^1.2.0.

Added\n- Initial release of ArtisanPack UI Hooks package\n- WordPress-style actions and filters system for Laravel applications\n- Action hooks management with priority-based execution\n- Action class for registering and executing action hooks\n- Support for callback priorities (lower numbers execute first)\n- Filter system for value transformation through callback chains\n- Filter class for registering and applying filters\n- Chained value processing with multiple callbacks\n- Helper functions for easy integration:\n- addAction(string , callable , int = 10) - Register action callbacks\n- doAction(string , mixed ...) - Execute action callbacks\n- addFilter(string , callable , int = 10) - Register filter callbacks\n- applyFilters(string , mixed , mixed ...) - Apply filter callbacks\n- Laravel Facades for static access:\n- Action facade for action management\n- Filter facade for filter management\n- Blade directives for template integration:\n- [@action](https://github.com/action)('hook_name', ...) - Execute actions in Blade views\n- [@filter](https://github.com/filter)('hook_name', , ...) - Apply filters and echo results in Blade views\n- Service providers with automatic Laravel package discovery:\n- HooksServiceProvider - Registers Action and Filter singletons\n- BladeDirectiveServiceProvider - Registers custom Blade directives\n- Automatic facade alias registration for Action and Filter\n- PSR-4 autoloading with namespace ArtisanPackUI\Hooks\\n- Comprehensive test suite using Pest testing framework\n- Full documentation with examples and usage guidelines\n### Requirements\n- PHP 8.2 or higher\n- Laravel 5.3+ (tested with Laravel 10.x and 11.x)\n- Illuminate/Support package\n### Features\n- Priority-based callback execution (lower numbers run first)\n- Modular architecture supporting plugin-style extensions\n- Clean separation of concerns for maintainable code\n- Framework-native Laravel integration\n- MIT license for open source usage

Added\n- Action removal APIs:\n- Action::remove(string , callable , int = 10): bool\n- Action::removeAll(string , int|false = false): bool\n- Filter removal APIs:\n- Filter::remove(string , callable , int = 10): bool\n- Filter::removeAll(string , int|false = false): bool\n- Helper functions:\n- removeAction(), removeAllActions(), removeFilter(), removeAllFilters()\n- Facade methods documented: Action::remove(), Action::removeAll(), Filter::remove(), Filter::removeAll()\n- Unit tests for removal behaviors\n- Documentation updates with examples and API references

Added\n- Laravel Boost AI guidelines integration\n- Added resources/boost/guidelines/core.blade.php for AI-assisted development\n- Comprehensive package documentation for Laravel Boost users\n- Code examples for actions, filters, priorities, and Blade directives\n- Laravel Pint code style support\n- Added laravel/pint package for PHP code formatting\n- Added artisanpack-ui/code-style-pint package for ArtisanPackUI preset\n- Added pint-setup.php script for generating Pint configuration\n- Added pint.json configuration with ArtisanPackUI coding standards\n- GitLab CI Pint code style job\n- Automated code style checking using Pint in CI pipeline\n- Configured as non-blocking (allow_failure: true)\n### Changed\n- GitLab CI configuration standardized to PHP 8.4\n- Updated build stage to use PHP 8.4 with Composer\n- Updated test stage to use PHP 8.4\n- Updated code-style stage to use PHP 8.4\n- Added installation of git, unzip, and PHP zip extension in build stage\n- Ensures consistent PHP version across all CI jobs\n- Updated Symfony dependencies to v7.3.7 (security update)\n- Fixed security advisory PKSA-365x-2zjk-pt47 in symfony/http-foundation\n### Development\n- Improved CI/CD pipeline reliability\n- Enhanced code quality tools with Pint integration