Alert Banner Module for Drupal 10

# Alert Banner Module for Drupal 10

## Project Description
A Drupal 10 module that provides configurable alert banners that can be placed anywhere on the site. The module supports:
- Multiple alert types with customizable styling
- Permanent and dismissible alerts
- Page-specific visibility rules
- Australian Government Design System compatibility
- REST API integration
- Configurable display settings

## Directory Structure
```
alert_banner/
├── alert_banner.info.yml # Module information
├── alert_banner.install # Installation and update hooks
├── alert_banner.libraries.yml # Frontend asset definitions
├── alert_banner.links.menu.yml # Menu link definitions
├── alert_banner.module # Core module functionality
├── alert_banner.permissions.yml # Permission definitions
├── alert_banner.routing.yml # Route definitions
├── composer.json # Composer dependencies
├── config/
│ └── install/ # Configuration installation files
│ ├── alert_banner.settings.yml
│ ├── core.date_format.alert_banner_date.yml
│ ├── core.entity_form_display.node.alert_banner.default.yml
│ ├── core.entity_view_display.node.alert_banner.default.yml
│ ├── field.field..yml # Field configuration files
│ ├── field.storage..yml # Field storage configuration files
│ ├── node.type.alert_banner.yml
│ ├── taxonomy.vocabulary.alert_banner_type.yml
│ └── views.view.alert_banners.yml
├── css/
│ ├── alert_banner.css # Main styles
│ └── alert_banner_au_dta.css # Australian Gov Design System styles
├── js/
│ └── alert_banner.js # Frontend functionality
└── src/
├── Form/
│ └── ConfigForm.php # Module configuration form
└── Plugin/
├── Field/
│ └── FieldFormatter/
│ └── HashSha256Formatter.php
└── Validation/
└── Constraint/
├── HtmlNotEmpty.php
└── HtmlNotEmptyValidator.php
```

## Key Files and Their Purpose

### Core Files
- `alert_banner.info.yml`: Module metadata and dependencies
- `alert_banner.module`: Core hooks and functionality
- `alert_banner.libraries.yml`: Frontend asset management
- `alert_banner.routing.yml`: Route definitions for admin pages

### Configuration
- `config/install/*.yml`: Default configuration files
- `src/Form/ConfigForm.php`: Admin configuration form

### Frontend Assets
- `css/`: Stylesheet files
- `js/`: JavaScript functionality
- `libraries.yml`: Asset dependency management

### Field & Entity Configuration
- `config/install/field.*.yml`: Field configuration
- `config/install/core.entity_*.yml`: Entity display settings

### Validation
- `src/Plugin/Validation/`: Custom validation constraints

## Coding Standards
- PHP: PSR-12, Drupal Coding Standards
- JavaScript: ESLint, Drupal JavaScript Standards
- CSS: Drupal CSS Standards
- YAML: Drupal Configuration Standards

## Dependencies
- Drupal Core: ^10
- Core Modules: block, text, options

# Alert Banner Module for Drupal 10

## Commit Message Format
Each commit message consists of a header, a body and a footer. The header has a special format that includes a type, a scope and a subject:

```.cursorrules
<type>(<scope>): <subject>
<BLANK LINE>
<body>
<BLANK LINE>
<footer>
```

### Types
- feat: A new feature
- fix: A bug fix
- docs: Documentation only changes
- style: Changes that do not affect the meaning of the code (white-space, formatting, etc)
- refactor: A code change that neither fixes a bug nor adds a feature
- perf: A code change that improves performance
- test: Adding missing tests or correcting existing tests
- chore: Changes to the build process or auxiliary tools and libraries
- ci: Changes to CI configuration files and scripts
- revert: Reverts a previous commit

### Scopes
- core: Core module functionality
- admin: Administration interface
- api: REST API functionality
- ui: User interface components
- style: CSS/styling changes
- js: JavaScript functionality
- config: Configuration changes
- deps: Dependency updates
- test: Test-related changes
- ci: CI/CD related changes

### Examples
```
feat(api): add REST endpoint for alert filtering

Add new query parameters to the REST API endpoint to support filtering alerts by:
- type
- date range
- visibility

Closes #123
```

```
fix(ui): resolve contrast issues in dark mode

- Update color calculation logic
- Add fallback colors for edge cases
- Improve accessibility compliance

Fixes #456
```

## Project Description
...(rest of the file remains unchanged)...