Release 2.0.3: Symfony assets package for bundle CSS

HecFranco · cursoragent · HecFranco · commit ac2b51369ffb · 2026-07-13T08:26:06.000+02:00
Register the nowo_password_toggle asset package for AssetMapper-friendly
Twig URLs and document the recommended asset() syntax.

Co-authored-by: Cursor &lt;cursoragent@cursor.com&gt;
diff --git a/README.md b/README.md
@@ -161,7 +161,7 @@ The bundle includes CSS/SCSS styles for the toggle button. You can use them by:
 ### Option 1: Include the CSS file
 
 ```html
-<link rel="stylesheet" href="{{ asset('bundles/nowopasswordtoggle/css/toggle_password.css') }}">
+<link rel="stylesheet" href="{{ asset('css/toggle_password.css', 'nowo_password_toggle') }}">
 ```
 
 ### Option 2: Use the SCSS file
diff --git a/composer.lock b/composer.lock
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
@@ -8,6 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## Table of contents
 
 - [[Unreleased]](#unreleased)
+- [[2.0.3] - 2026-07-13](#203---2026-07-13)
 - [[2.0.2] - 2026-07-09](#202---2026-07-09)
 - [[2.0.1] - 2026-07-09](#201---2026-07-09)
 - [[2.0.0] - 2026-07-02](#200---2026-07-02)
@@ -28,6 +29,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.0.3] - 2026-07-13
+
+### Added
+
+- **Symfony assets package**: `NowoPasswordToggleExtension` prepends `framework.assets.packages.nowo_password_toggle` (`base_path`: `/bundles/nowopasswordtoggle`) so Twig can reference bundle CSS with `asset('css/toggle_password.css', 'nowo_password_toggle')` (AssetMapper-friendly).
+
+### Changed
+
+- **Documentation**: README, [`INSTALLATION.md`](INSTALLATION.md), and [`USAGE.md`](USAGE.md) recommend the named asset package instead of the legacy `bundles/nowopasswordtoggle/...` path; INSTALLATION adds optional CSS publish steps and an AssetMapper note.
+
 ## [2.0.2] - 2026-07-09
 
 ### Added
diff --git a/docs/INSTALLATION.md b/docs/INSTALLATION.md
@@ -80,6 +80,20 @@ return [
 
 4. **Create configuration** (optional). Create `config/packages/nowo_password_toggle.yaml` with your preferred defaults. See [CONFIGURATION.md](CONFIGURATION.md) for all options.
 
+5. **Publish optional CSS** (if you use the legacy stylesheet instead of your own styles):
+
+   ```bash
+   php bin/console assets:install
+   ```
+
+   ```twig
+   <link rel="stylesheet" href="{{ asset('css/toggle_password.css', 'nowo_password_toggle') }}">
+   ```
+
+   ### AssetMapper
+
+   If your app uses [Symfony AssetMapper](https://symfony.com/doc/current/frontend/asset_mapper.html), the bundle registers the `nowo_password_toggle` asset package. Run `assets:install` once so `css/toggle_password.css` is published to `public/bundles/nowopasswordtoggle/`.
+
 ## Missing icon packages (runtime behaviour)
 
 If `symfony/ux-icons` or `symfony/http-client` is not installed:
diff --git a/docs/RELEASE.md b/docs/RELEASE.md
@@ -6,13 +6,13 @@
 4. Commit all changes, create an annotated tag (e.g. `v1.2.10`), and push branch and tag. The release workflow will create the GitHub Release with the changelog.
 5. Publish the package to Packagist if applicable (usually automatic when the tag is pushed).
 
-## Example for v2.0.2
+## Example for v2.0.3
 
 ```bash
-git add docs/CHANGELOG.md docs/UPGRADING.md docs/RELEASE.md README.md
+git add docs/CHANGELOG.md docs/UPGRADING.md docs/RELEASE.md README.md docs/INSTALLATION.md docs/USAGE.md src/DependencyInjection/NowoPasswordToggleExtension.php tests/Unit/DependencyInjection/NowoPasswordToggleExtensionTest.php
 git status   # review
-git commit -m "Release 2.0.2: GitHub Spec Kit baseline and dev dependency updates"
-git tag -a v2.0.2 -m "Release 2.0.2: GitHub Spec Kit baseline and dev dependency updates"
+git commit -m "Release 2.0.3: Symfony assets package for bundle CSS"
+git tag -a v2.0.3 -m "Release 2.0.3: Symfony assets package for bundle CSS"
 git push origin main
-git push origin v2.0.2
+git push origin v2.0.3
 ```
diff --git a/docs/SECURITY.md b/docs/SECURITY.md
@@ -12,7 +12,8 @@
 
 | Version | Supported          |
 | ------- | ------------------ |
-| 1.x     | :white_check_mark: |
+| 2.x     | :white_check_mark: |
+| 1.x     | :white_check_mark: (security fixes only) |
 
 ## Reporting a Vulnerability
 
diff --git a/docs/UPGRADING.md b/docs/UPGRADING.md
@@ -2,6 +2,11 @@
 
 This document describes how to upgrade between major versions of Password Toggle Bundle.
 
+## 2.0.3
+
+- **Optional (AssetMapper / named assets):** prefer `asset('css/toggle_password.css', 'nowo_password_toggle')` in Twig instead of `asset('bundles/nowopasswordtoggle/css/toggle_password.css')`. Run `php bin/console assets:install` once so the CSS is published under `public/bundles/nowopasswordtoggle/`. The legacy path still works for classic asset setups.
+- **No PHP or YAML config changes.**
+
 ## 2.0.2
 
 - **No application upgrade steps.** Repository and maintainer tooling only (Spec Kit, baseline specs, dev dependency bumps, demo Docker `intl` extension).
diff --git a/docs/USAGE.md b/docs/USAGE.md
@@ -72,7 +72,7 @@ With **UX Icons 3.x**, this command scans Twig templates for `ux_icon()` usage (
 ## Styling
 
 - **Option 1:** Include the bundle CSS:  
-  `<link rel="stylesheet" href="{{ asset('bundles/nowopasswordtoggle/css/toggle_password.css') }}">`
+  `<link rel="stylesheet" href="{{ asset('css/toggle_password.css', 'nowo_password_toggle') }}">`
 - **Option 2:** Import the SCSS in your build (Webpack Encore, Vite, etc.):  
   `@import '@nowo-tech/password-toggle-bundle/src/Resources/public/css/toggle_password.scss';`
 - **Option 3:** Style the classes yourself: `.input-group-text.cursor-pointer`, `.form-password-toggle`, etc.
diff --git a/src/DependencyInjection/NowoPasswordToggleExtension.php b/src/DependencyInjection/NowoPasswordToggleExtension.php
@@ -56,6 +56,18 @@ public function load(array $configs, ContainerBuilder $container): void
 
     public function prepend(ContainerBuilder $container): void
     {
+        if ($container->hasExtension('framework')) {
+            $container->prependExtensionConfig('framework', [
+                'assets' => [
+                    'packages' => [
+                        'nowo_password_toggle' => [
+                            'base_path' => '/bundles/nowopasswordtoggle',
+                        ],
+                    ],
+                ],
+            ]);
+        }
+
         if (!$container->hasExtension('monolog')) {
             return;
         }
diff --git a/tests/Unit/DependencyInjection/NowoPasswordToggleExtensionTest.php b/tests/Unit/DependencyInjection/NowoPasswordToggleExtensionTest.php
@@ -131,6 +131,19 @@ public function testPrependIsNoOpWithoutMonolog(): void
         $this->assertFalse($container->hasExtension('monolog'));
     }
 
+    public function testPrependConfiguresAssets(): void
+    {
+        $container = new ContainerBuilder();
+        $container->registerExtension(new \Symfony\Bundle\FrameworkBundle\DependencyInjection\FrameworkExtension());
+
+        $this->extension->prepend($container);
+
+        $this->assertSame(
+            '/bundles/nowopasswordtoggle',
+            $container->getExtensionConfig('framework')[0]['assets']['packages']['nowo_password_toggle']['base_path'],
+        );
+    }
+
     public function testLoadWiresMonologLoggerWhenMonologExtensionPresent(): void
     {
         $container = new ContainerBuilder();
