Filament Character Counter Laravel Package

Fixed

• RichEditor: Filament now renders the editor itself and the counter is placed around it. File attachments, mentions, floating toolbars, link protocols and resizable images were silently switched off by the copied view.
• The counter no longer breaks when the limit is empty: the limit is always a number, so Alpine gets valid JavaScript.
• The counter now follows every input event and the Livewire state, so it updates on paste, autofill, dictation, $set() and form resets, not only on key presses.
• Characters are counted per code point in the browser too, so an emoji counts as one, like Laravel's max: rule.
• The RichEditor counter no longer polls every 500 ms and no longer leaks a Livewire hook per editor.
• Invalid inline height on the Textarea.
• Development files (.claude/, CLAUDE.md, package-lock.json, stubs/ and more) are no longer included in the Packagist archive.

Added

• Going over the limit is shown in words, for example "(12 too many)", and in bold, not by colour alone. The message is announced to screen readers and the input points at the counter with aria-describedby.
• characters_over translation in every language.
• shouldShowCharacterCounter(); getShowCharacterCounter() is deprecated.
• Support for Laravel 13. CI now tests PHP 8.2 to 8.5 on Laravel 12 and 13 with Filament 4 and 5. Laravel 11 is no longer tested: Composer refuses its releases because of open security advisories.

Changed

• The package requires filament/forms and filament/support instead of the whole filament/filament panel package.
• The stylesheet is plain CSS using Filament's colour variables (dark mode included), so there is no build step anymore. The exceeded class is now fi-input-charcounter-exceeded instead of warning.
• The old translation key character_seperator is no longer read.
• declare(strict_types=1) everywhere, PHPStan on the highest level.

Fixed

• RichEditor character counting: Completely refactored RichEditor character counter implementation

  • Fixed JavaScript errors during component initialization (missing parameters for richEditorFormComponent)
  • Added all required Filament v4/v5 parameters (acceptedFileTypes, floatingToolbars, mentions, linkProtocols, etc.) with safe defaults
  • Changed from trying to access TipTap editor instance to directly reading DOM element text content
  • Character counter now uses $el.querySelector('.fi-fo-rich-editor-content') to get text content
  • Implemented Livewire.hook('commit') for reactive updates + periodic polling (500ms) as fallback
  • RichEditor now properly counts characters in real-time while typing

• HasCharacterLimit trait: Made characterLimit() automatically call maxLength() to enforce HTML maxlength attribute

  • Prevents users from pasting or entering more characters than the limit
  • Ensures consistency between visual counter and actual enforcement

Technical Details

• Session timestamp: 2026-01-30
• Estimated time: ~2 hours debugging and implementation
• Components tested: TextInput ✓, Textarea ✓, RichEditor ✓
• Test environments: Filament v4 and v5 test projects

Added

• showCharacterCounter(bool|Closure $condition = true) method to conditionally display the character counter on individual fields (#41, thanks @mediatorviolet)
• Central Kurdish (ckb) translation (#43, thanks @Hamoi1)

Notes

showCharacterCounter() was merged after the v5.0.1 tag and never released, which caused #50. This release ships it via Composer.

Full Changelog: https://github.com/schmeits/filament-character-counter/compare/v5.0.1...v5.1.0

## Fixed

- **characterLimit() is now a soft limit again** (#36): characterLimit() no longer enforces HTML maxlength or validation. Use maxLength() for hard enforcement, or combine both.

- Fixed test suite (removed obsolete BladeCaptureDirective dependency)

- Fixed PHPStan config (removed deprecated options)

What's New

✨ Added

• Filament v5 Support: Full compatibility with Filament v5 (Livewire v4) alongside v4
• Comprehensive Tests: Unit tests for all component types (TextInput, Textarea, RichEditor)
• Better Spacing: Proper spacing for RichEditor character counter

🐛 Fixed

RichEditor Character Counting - Complete refactor:

• Fixed JavaScript initialization errors
• Added all required Filament v4/v5 parameters with safe defaults
• Switched to direct DOM text content reading for accuracy
• Implemented Livewire.hook('commit') for reactive updates
• Character counter now updates in real-time while typing

HasCharacterLimit Trait:

• Automatically enforces HTML maxlength attribute
• Prevents paste overflow beyond character limit
• Ensures consistency between visual counter and enforcement

🔧 Technical Details

• RichEditor uses `$el.querySelector()` for DOM-based character counting
• Added `.fi-fo-rich-editor-wrapper` CSS class for proper spacing
• Textarea maxLength enforcement with Alpine.js watcher
• Views compatible with both Filament 4 and 5

Testing

Tested and working in:

• ✅ Filament v4 (Livewire v3)
• ✅ Filament v5 (Livewire v4)

All components (TextInput, Textarea, RichEditor) working correctly in both versions.

Updated readme

First release Filament 4 version

New : Added French translation (thanks to @tgeorgel)

Fix: The showInsideControl was missing from the Textarea (Thanks @CharlieEtienne for the PR)

Updated:

• updated rich-editor.blade.php
  • Fixing async alpine not loading in spa
  • Add disableGrammarly Method
  • Use Heroicons for rich editor and Markdown editor
  • Add CSS class to rich editor editor
• updated textarea.blade.php
  • Fixing async alpine not loading in spa

Changed: Updated README with new RichEditor support

New: Added Arabi clanguage (thanks to Omar @devOMAR-2) New: Added RichEditor support

New: Added German translation (thanks to @dissto) Fix: Fixed a translation key (thanks to @dissto)

Fix: Respect maxLength in combination with characterLimit

fix: typo in translation for the dutch variant of characters

Fixed a bug if you use ->live() on the Fields, the counter would stutter and the character count was not correct.

Added the option to show the counter in the component (default is outside the component)

Fix: Placed helper in correct section

First release of the package