@hmcts/opal-frontend-common 0.0.66 → 0.0.68

package/package.json

@@ -1,19 +1,50 @@
 {
   "name": "@hmcts/opal-frontend-common",
-  "version": "0.0.66",
+  "version": "0.0.68",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/hmcts/opal-frontend-common-ui-lib"
   },
+  "engines": {
+    "node": ">=18"
+  },
+  "types": "./types/hmcts-opal-frontend-common.d.ts",
   "peerDependencies": {
     "@angular/common": "^18.2.0 || ^19.0.0 || ^20.0.0 || ^21.0.0",
-    "@angular/core": "^18.2.0 || ^19.0.0 || ^20.0.0 || ^21.0.0"
+    "@angular/core": "^18.2.0 || ^19.0.0 || ^20.0.0 || ^21.0.0",
+    "@angular/forms": "^18.2.0 || ^19.0.0 || ^20.0.0 || ^21.0.0",
+    "@angular/platform-browser": "^18.2.0 || ^19.0.0 || ^20.0.0 || ^21.0.0",
+    "@angular/router": "^18.2.0 || ^19.0.0 || ^20.0.0 || ^21.0.0",
+    "@ngrx/signals": "^18.0.0 || ^19.0.0 || ^20.0.0 || ^21.0.0",
+    "rxjs": "^7.8.0"
+  },
+  "peerDependenciesMeta": {
+    "@ngrx/signals": {
+      "optional": true
+    }
   },
   "dependencies": {
+    "@microsoft/applicationinsights-web": "^3.3.6",
+    "@ministryofjustice/frontend": "^9.0.0",
+    "accessible-autocomplete": "^3.0.1",
+    "fast-sort": "^3.4.1",
+    "govuk-frontend": "^6.0.0",
+    "home-office-kit": "^1.2.0",
+    "launchdarkly-js-client-sdk": "^3.5.0",
+    "luxon": "^3.5.0",
     "tslib": "^2.3.0"
   },
   "sideEffects": false,
+  "files": [
+    "LICENSE",
+    "README.md",
+    "package.json",
+    "fesm2022/**/*.mjs",
+    "types/**/*.d.ts",
+    "styles/**/*"
+  ],
+  "sass": "./styles/styles.scss",
   "exports": {
     ".": {
       "import": "./fesm2022/hmcts-opal-frontend-common.mjs",
@@ -180,9 +211,6 @@
       "types": "./types/hmcts-opal-frontend-common-components-custom-custom-page-header.d.ts",
       "default": "./fesm2022/hmcts-opal-frontend-common-components-custom-custom-page-header.mjs"
     },
-    "./components/custom/custom-page-header/custom-page-header-action-buttons-container": {
-      "import": "./fesm2022/hmcts-opal-frontend-common-components-custom-custom-page-header-custom-page-header-action-buttons-container.mjs"
-    },
     "./components/custom/custom-horizontal-scroll-pane": {
       "import": "./fesm2022/hmcts-opal-frontend-common-components-custom-custom-horizontal-scroll-pane.mjs",
       "types": "./types/hmcts-opal-frontend-common-components-custom-custom-horizontal-scroll-pane.d.ts",
@@ -288,6 +316,11 @@
       "types": "./types/hmcts-opal-frontend-common-components-govuk-govuk-heading-with-caption.d.ts",
       "default": "./fesm2022/hmcts-opal-frontend-common-components-govuk-govuk-heading-with-caption.mjs"
     },
+    "./components/govuk/govuk-heading-with-caption/types": {
+      "import": "./fesm2022/hmcts-opal-frontend-common-components-govuk-govuk-heading-with-caption-types.mjs",
+      "types": "./types/hmcts-opal-frontend-common-components-govuk-govuk-heading-with-caption-types.d.ts",
+      "default": "./fesm2022/hmcts-opal-frontend-common-components-govuk-govuk-heading-with-caption-types.mjs"
+    },
     "./components/govuk/govuk-inset-text": {
       "import": "./fesm2022/hmcts-opal-frontend-common-components-govuk-govuk-inset-text.mjs",
       "types": "./types/hmcts-opal-frontend-common-components-govuk-govuk-inset-text.d.ts",
@@ -368,14 +401,16 @@
       "types": "./types/hmcts-opal-frontend-common-components-govuk-govuk-tabs-govuk-tabs-panel.d.ts",
       "default": "./fesm2022/hmcts-opal-frontend-common-components-govuk-govuk-tabs-govuk-tabs-panel.mjs"
     },
-    "./components/govuk/govuk-tags": {
-      "import": "./fesm2022/hmcts-opal-frontend-common-components-govuk-govuk-tags.mjs"
-    },
     "./components/govuk/govuk-task-list": {
       "import": "./fesm2022/hmcts-opal-frontend-common-components-govuk-govuk-task-list.mjs",
       "types": "./types/hmcts-opal-frontend-common-components-govuk-govuk-task-list.d.ts",
       "default": "./fesm2022/hmcts-opal-frontend-common-components-govuk-govuk-task-list.mjs"
     },
+    "./components/govuk/govuk-tag": {
+      "import": "./fesm2022/hmcts-opal-frontend-common-components-govuk-govuk-tag.mjs",
+      "types": "./types/hmcts-opal-frontend-common-components-govuk-govuk-tag.d.ts",
+      "default": "./fesm2022/hmcts-opal-frontend-common-components-govuk-govuk-tag.mjs"
+    },
     "./components/govuk/govuk-text-area": {
       "import": "./fesm2022/hmcts-opal-frontend-common-components-govuk-govuk-text-area.mjs",
       "types": "./types/hmcts-opal-frontend-common-components-govuk-govuk-text-area.d.ts",
@@ -506,6 +541,11 @@
       "types": "./types/hmcts-opal-frontend-common-components-moj-moj-sortable-table.d.ts",
       "default": "./fesm2022/hmcts-opal-frontend-common-components-moj-moj-sortable-table.mjs"
     },
+    "./components/moj/moj-sub-navigation": {
+      "import": "./fesm2022/hmcts-opal-frontend-common-components-moj-moj-sub-navigation.mjs",
+      "types": "./types/hmcts-opal-frontend-common-components-moj-moj-sub-navigation.d.ts",
+      "default": "./fesm2022/hmcts-opal-frontend-common-components-moj-moj-sub-navigation.mjs"
+    },
     "./components/moj/moj-ticket-panel": {
       "import": "./fesm2022/hmcts-opal-frontend-common-components-moj-moj-ticket-panel.mjs",
       "types": "./types/hmcts-opal-frontend-common-components-moj-moj-ticket-panel.d.ts",
@@ -616,6 +656,11 @@
       "types": "./types/hmcts-opal-frontend-common-pages-dashboard-page-interfaces.d.ts",
       "default": "./fesm2022/hmcts-opal-frontend-common-pages-dashboard-page-interfaces.mjs"
     },
+    "./pages": {
+      "import": "./fesm2022/hmcts-opal-frontend-common-pages.mjs",
+      "types": "./types/hmcts-opal-frontend-common-pages.d.ts",
+      "default": "./fesm2022/hmcts-opal-frontend-common-pages.mjs"
+    },
     "./pages/routing": {
       "import": "./fesm2022/hmcts-opal-frontend-common-pages.mjs"
     },
@@ -654,9 +699,6 @@
       "types": "./types/hmcts-opal-frontend-common-resolvers-title.d.ts",
       "default": "./fesm2022/hmcts-opal-frontend-common-resolvers-title.mjs"
     },
-    "./services": {
-      "import": "./fesm2022/hmcts-opal-frontend-common-services.mjs"
-    },
     "./services/app-insights-service": {
       "import": "./fesm2022/hmcts-opal-frontend-common-services-app-insights-service.mjs",
       "types": "./types/hmcts-opal-frontend-common-services-app-insights-service.d.ts",
@@ -672,6 +714,16 @@
       "types": "./types/hmcts-opal-frontend-common-services-transfer-state-service.d.ts",
       "default": "./fesm2022/hmcts-opal-frontend-common-services-transfer-state-service.mjs"
     },
+    "./services/transfer-state-service/interfaces": {
+      "import": "./fesm2022/hmcts-opal-frontend-common-services-transfer-state-service-interfaces.mjs",
+      "types": "./types/hmcts-opal-frontend-common-services-transfer-state-service-interfaces.d.ts",
+      "default": "./fesm2022/hmcts-opal-frontend-common-services-transfer-state-service-interfaces.mjs"
+    },
+    "./services/transfer-state-service/mocks": {
+      "import": "./fesm2022/hmcts-opal-frontend-common-services-transfer-state-service-mocks.mjs",
+      "types": "./types/hmcts-opal-frontend-common-services-transfer-state-service-mocks.d.ts",
+      "default": "./fesm2022/hmcts-opal-frontend-common-services-transfer-state-service-mocks.mjs"
+    },
     "./services/launch-darkly-service": {
       "import": "./fesm2022/hmcts-opal-frontend-common-services-launch-darkly-service.mjs",
       "types": "./types/hmcts-opal-frontend-common-services-launch-darkly-service.d.ts",
@@ -752,9 +804,6 @@
       "types": "./types/hmcts-opal-frontend-common-services-transformation-service-interfaces.d.ts",
       "default": "./fesm2022/hmcts-opal-frontend-common-services-transformation-service-interfaces.mjs"
     },
-    "./services/transformation-service/mocks": {
-      "import": "./fesm2022/hmcts-opal-frontend-common-services-transformation-service-mocks.mjs"
-    },
     "./services/transformation-service/constants": {
       "import": "./fesm2022/hmcts-opal-frontend-common-services-transformation-service-constants.mjs",
       "types": "./types/hmcts-opal-frontend-common-services-transformation-service-constants.d.ts",
@@ -870,6 +919,14 @@
       "types": "./types/hmcts-opal-frontend-common-validators-valid-value.d.ts",
       "default": "./fesm2022/hmcts-opal-frontend-common-validators-valid-value.mjs"
     },
+    "./styles": {
+      "sass": "./styles/styles.scss",
+      "default": "./styles/styles.scss"
+    },
+    "./styles/styles.scss": {
+      "sass": "./styles/styles.scss",
+      "default": "./styles/styles.scss"
+    },
     "./types": {
       "import": "./fesm2022/hmcts-opal-frontend-common-types.mjs",
       "types": "./types/hmcts-opal-frontend-common-types.d.ts",
@@ -877,32 +934,9 @@
     },
     "./package.json": {
       "default": "./package.json"
-    },
-    "./components/govuk/govuk-heading-with-caption/types": {
-      "types": "./types/hmcts-opal-frontend-common-components-govuk-govuk-heading-with-caption-types.d.ts",
-      "default": "./fesm2022/hmcts-opal-frontend-common-components-govuk-govuk-heading-with-caption-types.mjs"
-    },
-    "./components/govuk/govuk-tag": {
-      "types": "./types/hmcts-opal-frontend-common-components-govuk-govuk-tag.d.ts",
-      "default": "./fesm2022/hmcts-opal-frontend-common-components-govuk-govuk-tag.mjs"
-    },
-    "./components/moj/moj-sub-navigation": {
-      "types": "./types/hmcts-opal-frontend-common-components-moj-moj-sub-navigation.d.ts",
-      "default": "./fesm2022/hmcts-opal-frontend-common-components-moj-moj-sub-navigation.mjs"
-    },
-    "./pages": {
-      "types": "./types/hmcts-opal-frontend-common-pages.d.ts",
-      "default": "./fesm2022/hmcts-opal-frontend-common-pages.mjs"
-    },
-    "./services/transfer-state-service/interfaces": {
-      "types": "./types/hmcts-opal-frontend-common-services-transfer-state-service-interfaces.d.ts",
-      "default": "./fesm2022/hmcts-opal-frontend-common-services-transfer-state-service-interfaces.mjs"
-    },
-    "./services/transfer-state-service/mocks": {
-      "types": "./types/hmcts-opal-frontend-common-services-transfer-state-service-mocks.d.ts",
-      "default": "./fesm2022/hmcts-opal-frontend-common-services-transfer-state-service-mocks.mjs"
     }
   },
   "module": "fesm2022/hmcts-opal-frontend-common.mjs",
-  "typings": "types/hmcts-opal-frontend-common.d.ts"
+  "typings": "types/hmcts-opal-frontend-common.d.ts",
+  "type": "module"
 }

package/styles/styles.scss

@@ -5,19 +5,15 @@
    ==========================================================================
    These imports include external styles used across the application.
 */
-@import 'govuk-frontend/dist/govuk/all.scss';
-@import '@ministryofjustice/frontend/moj/all.scss';
+@use 'govuk-frontend/dist/govuk/index' as *;
+@use '@ministryofjustice/frontend/moj/all' as moj;
+@use './custom/_custom-section_break.scss';
+@use './custom/custom-scrollable-panes';
+
+/* Keep @import until home-office-kit migrates to Sass modules. */
 @import 'accessible-autocomplete/dist/accessible-autocomplete.min.css';
 @import 'home-office-kit/sass/_loadingSpinner.scss';
 
-/* ==========================================================================
-   Custom Component Styles
-   ==========================================================================
-   Custom Component Styles authored within the OPAL Frontend Common UI Library.
-*/
-@import './custom/_custom-section_break.scss';
-@import './custom/custom-scrollable-panes';
-
 html,
 body {
   height: 100%;
@@ -73,7 +69,7 @@ opal-lib-govuk-footer {
 }
 
 .govuk-error-colour {
-  color: $govuk-error-colour;
+  color: $govuk-error-colour !important;
 }
 
 .govuk-link-colour {
@@ -90,11 +86,11 @@ opal-lib-govuk-footer {
 }
 
 .govuk-light-grey-background-colour {
-  background-color: govuk-colour('light-grey');
+  background-color: govuk-colour('black', $variant: 'tint-95');
 }
 
 .govuk-lighter-blue-background-colour {
-  background-color: govuk-tint(govuk-colour('light-blue'), 50);
+  background-color: govuk-tint(govuk-colour('blue', $variant: 'tint-25'), 50);
 }
 
 .govuk-blue-background-colour {
@@ -111,11 +107,11 @@ opal-lib-govuk-footer {
 }
 
 .govuk-dark-blue-text-colour {
-  color: govuk-colour('dark-blue');
+  color: govuk-colour('blue', $variant: 'shade-50');
 }
 
 .govuk-dark-grey-text-colour {
-  color: govuk-colour('dark-grey');
+  color: govuk-colour('black', $variant: 'tint-25');
 }
 
 .govuk-white-text-colour {

package/types/hmcts-opal-frontend-common-components-abstract-abstract-form-alias-base.d.ts

@@ -114,8 +114,9 @@ declare abstract class AbstractFormAliasBaseComponent extends AbstractFormBaseCo
      *
      * @param index - The index of the alias to remove.
      * @param formArrayName - The name of the form array.
+     * @param event - The event object from the click event, used to prevent default behavior.
      */
-    removeAlias(index: number, formArrayName: string): void;
+    removeAlias(index: number, formArrayName: string, event?: Event): void;
     ngOnInit(): void;
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AbstractFormAliasBaseComponent, never>;

package/types/hmcts-opal-frontend-common-components-govuk-govuk-cancel-link.d.ts

@@ -5,9 +5,12 @@ declare class GovukCancelLinkComponent {
     cancelLinkText: string;
     linkClickEvent: EventEmitter<boolean>;
     /**
-     * Handles the button click event.
+     * Handles the click event on the cancel link.
+     * Prevents the default action and emits a link click event.
+     *
+     * @param event - Optional DOM event that triggered the click
      */
-    handleClick(): void;
+    handleClick(event?: Event): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<GovukCancelLinkComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<GovukCancelLinkComponent, "opal-lib-govuk-cancel-link", never, { "cancelLinkText": { "alias": "cancelLinkText"; "required": false; }; }, { "linkClickEvent": "linkClickEvent"; }, never, never, true, never>;
 }

package/types/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/hmcts-opal-frontend-common-types.mjs",
+  "typings": "hmcts-opal-frontend-common-types.d.ts"
+}

package/components/abstract/abstract-nested-form-base/README.md

@@ -1,89 +0,0 @@
-# Abstract Nested Form Base Component
-
-This Angular component extends the `AbstractFormBaseComponent` and is designed for **nested sub-form components** that contribute their own controls and field-error messages into a parent form. It provides helpers for installing/removing nested controls, managing conditional validation, and spreading error definitions into the parent’s error maps.
-
-## Table of Contents
-
-- [Installation](#installation)
-- [Usage](#usage)
-- [Responsibilities](#responsibilities)
-- [Methods](#methods)
-- [Error Handling](#error-handling)
-- [Testing](#testing)
-- [Contributing](#contributing)
-
-## Installation
-
-To use the `AbstractNestedFormBaseComponent`, extend it in a nested sub-form component (e.g. Individuals, Companies, Creditors):
-
-```typescript
-import { AbstractNestedFormBaseComponent } from '@hmcts/opal-frontend-common/components/abstract/abstract-nested-form-base/abstract-nested-form-base.component';
-```
-
-## Usage
-
-This component is intended to be extended by **child sub-forms** that plug into a parent form component. It ensures consistent handling of control installation, conditional validation, and error-message registration.
-
-### Example Usage
-
-```ts
-@Component({
-  selector: 'app-child-sub-form',
-  templateUrl: './child-sub-form.component.html',
-})
-export class ChildSubFormComponent extends AbstractNestedFormBaseComponent implements OnInit, OnDestroy {
-  @Input({ required: true }) override form!: FormGroup;
-
-  public override ngOnInit(): void {
-    this.setupChildForm();
-    super.ngOnInit();
-  }
-
-  private setupChildForm(): void {
-    const controlsGroup = this.buildChildControls();
-    this.addControlsToNestedFormGroup(controlsGroup);
-    this.setupConditionalValidation();
-    this.rePopulateForm(/* values from store */);
-    this.handleConditionalValidation();
-  }
-}
-```
-
-## Responsibilities
-
-- Install (and later remove) sub-form controls into an existing parent FormGroup.
-- Provide ergonomic helpers for common validation flows:
-  - Toggle `required` validators.
-  - Reset and revalidate controls/groups.
-  - Subscribe to conditional validation with automatic teardown.
-- Ensure proper cleanup on destroy (removes its own controls).
-
-## Methods
-
-| Method                              | Parameters                                                                             | Description                                                                                               |
-| ----------------------------------- | -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
-| `addControlsToNestedFormGroup`      | `source: FormGroup, target?: FormGroup`                                                | Installs detached controls into target form (defaults to `this.form`).                                    |
-| `removeControlsFromNestedFormGroup` | `source: FormGroup, target?: FormGroup`                                                | Removes controls from target whose names are in `source`.                                                 |
-| `setValidatorPresence`              | `control: AbstractControl, validators: ValidatorFn \| ValidatorFn[], present: boolean` | Adds or removes one or more validators and updates validity.                                              |
-| `hasValue`                          | `v: unknown`                                                                           | Utility to check if a value is considered present (non-null; non-empty string; all non-strings are true). |
-| `resetAndValidateControls`          | `controls: (AbstractControl \| null)[]`                                                | Resets given controls, clears errors, reapplies validators.                                               |
-| `resetAndValidateFormGroup`         | `group: FormGroup`                                                                     | Resets entire group, marks pristine/untouched, updates validity.                                          |
-| `subscribeValidation`               | `handler: () => void, ...controls`                                                     | Subscribes a handler to `valueChanges` of controls with auto-unsubscribe.                                 |
-
-## Error Handling
-
-- Each sub-form is responsible only for its own validators and error state.
-- The parent remains the single source of truth for fieldErrors and merges child error templates as needed.
-- The abstract ensures cleanup by removing its own controls on destroy.
-
-## Testing
-
-Unit tests should verify:
-
-- Controls are installed and removed correctly.
-- Conditional validators are toggled and errors appear/disappear as expected.
-- Lifecycle (`ngOnInit`, `ngOnDestroy`) ensures no leaks.
-
-## Contributing
-
-Contributions should maintain consistency with the base form component and Angular best practices. Add unit tests for any new helpers or changes to validation/error-handling logic.

package/components/abstract/abstract-table-filter/README.md

@@ -1,76 +0,0 @@
-# AbstractTableFilterComponent
-
-The `AbstractTableFilterComponent` is an abstract base class designed for building reactive, filterable table components in Angular. It provides a fully signal-based filtering model using Angular 19's reactivity system, and supports filtering via keyword input and grouped filter tags.
-
-## Features
-
-- Reactive filtering of table data using Angular signals
-- Supports both keyword and tag-based filtering
-- Exposes computed filtered data for consumption
-- Clean override points for matching logic
-- Stateless, testable, and reusable foundation for filterable tables
-
-## Usage
-
-Extend this class in your table wrapper component:
-
-```ts
-@Component({ ... })
-export class MyFilterableTableComponent extends AbstractTableFilterComponent {
-  override matchItemWithFilterOption(item: any, categoryName: string, option: IAbstractTableFilterOption): boolean {
-    // Optional: customise matching logic per field
-    return item?.[categoryName] === option.value;
-  }
-
-  override matchItemWithKeyword(item: any, keyword: string): boolean {
-    return Object.values(item).some(value =>
-      value?.toString().toLowerCase().includes(keyword.toLowerCase())
-    );
-  }
-}
-```
-
-Set filter and table data like so:
-
-```ts
-this.setTableData(tableData);
-this.filterTags.set(filterCategories);
-```
-
-## Signals
-
-| Signal                    | Type                                   | Description                                               |
-| ------------------------- | -------------------------------------- | --------------------------------------------------------- |
-| `displayTableDataSignal`  | Signal<IAbstractTableData[]>           | The full, unfiltered dataset                              |
-| `filterTags`              | Signal<IAbstractTableFilterCategory[]> | Grouped tag filters with selection state                  |
-| `keyword`                 | Signal<string>                         | Keyword used for text-based filtering                     |
-| `abstractSelectedTags`    | Signal<IAbstractTableFilterCategory[]> | Computed from `filterTags`; not used in applied filtering |
-| `filteredTableDataSignal` | Signal<IAbstractTableData[]>           | Computed signal of filtered results                       |
-
-## Public Methods
-
-| Method                                                | Description                                     |
-| ----------------------------------------------------- | ----------------------------------------------- |
-| `onKeywordChange(keyword)`                            | Updates the keyword for filtering               |
-| `onCategoryCheckboxChange(category, value, selected)` | Toggles a specific tag option                   |
-| `removeTag(category, value)`                          | Deselects a tag based on category and value     |
-| `clearAllFilters()`                                   | Clears all tag selections and the keyword input |
-| `setTableData(data)`                                  | Sets the full table data to be filtered         |
-| `resetFiltersTo(tags, keyword?)`                      | Resets filter tags and optionally the keyword   |
-
-## Protected Methods (Override Points)
-
-| Method                             | Description                                                           |
-| ---------------------------------- | --------------------------------------------------------------------- |
-| `matchItemWithFilterOption()`      | Allows overriding how tag filters match table data                    |
-| `matchItemWithKeyword()`           | Allows overriding how keyword filters apply                           |
-| `getSelectedOptionsFromTags(tags)` | Utility method to extract selected tag options from a tag group array |
-
-## Testing
-
-Unit tests should verify:
-
-- Data passed to `displayTableDataSignal` is filtered as expected
-- `filterTags` updates trigger recomputation of `filteredTableDataSignal`
-- Override methods correctly influence filtering behaviour
-- Events like `onKeywordChange()` and `clearAllFilters()` produce expected state

package/components/govuk/govuk-tabs/govuk-tabs-list-item/README.md

@@ -1,74 +0,0 @@
-# GOV.UK Tab List Item Component
-
-This Angular component renders a single list item wrapper with the appropriate GOV.UK class for use within a tabbed
-navigation structure. It renders the `<a>` tab link and projects the link text.
-
-## Table of Contents
-
-- [Installation](#installation)
-- [Usage](#usage)
-- [Testing](#testing)
-- [Contributing](#contributing)
-
-## Installation
-
-Each component in the `govuk-tabs` group is exported individually:
-
-```typescript
-import { GovukTabListItemComponent } from 'opal-frontend-common/components/govuk/govuk-tabs/govuk-tab-list-item';
-```
-
-## Usage
-
-This component renders a list item wrapper with appropriate GOV.UK classes for use within a tabs list.
-
-You must provide the following inputs:
-
-- `tabItemFragment` — a unique string fragment to identify this tab
-- `activeTabItemFragment` — the currently selected fragment (e.g. from the route or state)
-- `tabItemId` — the unique ID for accessibility
-
-The link text inside the `<a>` is projected using `<ng-content>`.
-
-### Example
-
-```html
-<opal-lib-govuk-tabs-list-item
-  [tabItemFragment]="'panel-individuals'"
-  [activeTabItemFragment]="activeTabFragment"
-  [tabItemId]="'tab-individuals'"
->
-  Individuals
-</opal-lib-govuk-tabs-list-item>
-```
-
-This results in:
-
-```html
-<li class="govuk-tabs__list-item govuk-tabs__list-item--selected">
-  <a
-    id="tab-individuals"
-    href="#panel-individuals"
-    class="govuk-tabs__tab"
-    role="tab"
-    aria-controls="panel-individuals"
-    aria-selected="true"
-  >
-    Individuals
-  </a>
-</li>
-```
-
-The `govuk-tabs__list-item--selected` class is applied automatically when `tabItemFragment` matches `activeTabItemFragment`.
-
-## Testing
-
-Unit tests for this component can be found in the `govuk-tab-list-item.component.spec.ts` file. To run the tests:
-
-```bash
-ng test
-```
-
-## Contributing
-
-Feel free to submit issues or pull requests to improve this component.

package/components/govuk/govuk-tabs/govuk-tabs-panel/README.md

@@ -1,52 +0,0 @@
-# GOV.UK Tab Panel Component
-
-This Angular component renders a GOV.UK-styled tab panel, used in conjunction with `govuk-tabs` and `govuk-tab-list-item`. It wraps content in a `<div>` with the appropriate GOV.UK class.
-
-## Table of Contents
-
-- [Installation](#installation)
-- [Usage](#usage)
-- [Testing](#testing)
-- [Contributing](#contributing)
-
-## Installation
-
-Each component in the `govuk-tabs` group is exported individually:
-
-```typescript
-import { GovukTabPanelComponent } from 'opal-frontend-common/components/govuk/govuk-tabs/govuk-tab-panel';
-```
-
-## Usage
-
-Wrap your tab content in this component and provide a unique ID to link it with the corresponding tab.
-
-### Example
-
-```html
-<opal-lib-govuk-tab-panel id="panel-individuals">
-  <h2 class="govuk-heading-m">Individuals</h2>
-  <p>This is content for the Individuals tab.</p>
-</opal-lib-govuk-tab-panel>
-```
-
-This renders:
-
-```html
-<div class="govuk-tabs__panel" id="panel-individuals">
-  <h2 class="govuk-heading-m">Individuals</h2>
-  <p>This is content for the Individuals tab.</p>
-</div>
-```
-
-## Testing
-
-Unit tests for this component can be found in the `govuk-tab-panel.component.spec.ts` file. To run the tests:
-
-```bash
-ng test
-```
-
-## Contributing
-
-Feel free to submit issues or pull requests to improve this component.

package/components/moj/moj-filter/moj-filter-panel/moj-filter-panel-header/README.md

@@ -1,43 +0,0 @@
-# MojFilterPanelHeaderComponent
-
-The `MojFilterPanelHeaderComponent` is a structural header component used within the `MojFilterComponent`. It is designed to render a heading using the [MOJ Design System](https://design-patterns.service.justice.gov.uk/components/filter/) conventions.
-
-This component is intended to be used inside the `[mojFilterPanelHeader]` slot of the `MojFilterComponent`.
-
-## Features
-
-- Renders a section header using MoJ-styled classes.
-- Accepts a `title` input with a default value of `"Filter"`.
-- Compatible with content projection (if needed).
-
-## Usage
-
-### Import
-
-```ts
-import { MojFilterPanelHeaderComponent } from '@hmcts/opal-frontend-common/components/moj/moj-filter';
-```
-
-### In Template
-
-```html
-<opal-lib-moj-filter-panel-header [title]="'Filter offences'"></opal-lib-moj-filter-panel-header>
-```
-
-## Inputs
-
-| Input | Type   | Default  | Description                        |
-| ----- | ------ | -------- | ---------------------------------- |
-| title | string | 'Filter' | The title to display in the header |
-
-## Accessibility
-
-- Uses an `<h2>` element with the `govuk-heading-m` class for screen-reader-friendly headings.
-- You can override the title text using the `title` input to ensure headings remain meaningful and contextual.
-
-## Testing
-
-Unit tests should verify:
-
-- The default title renders as `"Filter"`.
-- The custom title input renders correctly.