@hmcts/opal-frontend-common 0.0.67 → 0.0.68

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 HM Courts & Tribunals Service
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -12,11 +12,11 @@ This is an [Angular Library](https://angular.dev/tools/libraries).
 - [Getting Started](#getting-started)
 - [Development server](#development-server)
 - [Build](#build)
+- [Using This Library](#using-this-library-in-an-angular-application-eg-opal-frontend)
 - [Switching Between Local and Published Versions](#switching-between-local-and-published-versions)
 - [Running unit tests](#running-unit-tests)
 - [Angular code scaffolding](#angular-code-scaffolding)
 - [Commonly Used Commands](#commonly-used-commands)
-- [Using This Library](#using-this-library-in-an-angular-application-eg-opal-frontend)
 - [Publishing the Library](#publishing-the-library)
 
 ## Getting Started
@@ -25,7 +25,7 @@ This is an [Angular Library](https://angular.dev/tools/libraries).
 
 Running the application requires the following tools to be installed in your environment:
 
-- [Node.js](https://nodejs.org/) v23.7.0 or later
+- [Node.js](https://nodejs.org/) v18 or later
 
 - [yarn](https://yarnpkg.com/) v4
 
@@ -41,7 +41,42 @@ yarn
 
 ## Build
 
-Run `yarn ng build` to build the project. The build artifacts will be stored in the `dist/` directory.
+Run `yarn build` to build the project. The build artifacts will be stored in the `dist/` directory.
+
+## Development server
+
+Run `yarn start` to serve the local harness app via Angular dev server.
+
+## Using This Library in an Angular Application (e.g. opal-frontend)
+
+Install in the consuming application:
+
+```bash
+yarn add @hmcts/opal-frontend-common
+```
+
+Import from the package root only for the root public API:
+
+```ts
+import { HEADER_LINKS, routing, type HeadingLevel } from '@hmcts/opal-frontend-common';
+```
+
+Import components/services/guards/validators from explicit subpaths:
+
+```ts
+import { GovukTextInputComponent } from '@hmcts/opal-frontend-common/components/govuk/govuk-text-input';
+import { GovukTagComponent } from '@hmcts/opal-frontend-common/components/govuk/govuk-tag';
+import { DateService } from '@hmcts/opal-frontend-common/services/date-service';
+import { hasFlowStateGuard } from '@hmcts/opal-frontend-common/guards/has-flow-state';
+```
+
+Import global styles through the exported style entrypoint:
+
+```scss
+@use '@hmcts/opal-frontend-common/styles';
+```
+
+Do not deep-import from `dist/`, `fesm2022/`, `types/`, or internal source folders.
 
 ## Switching Between Local and Published Versions
 
@@ -58,17 +93,19 @@ To use a published version of this library during development in another project
 
 To use a local version of this library during development in another project:
 
-1. Build this library:
+1. Build and pack this library:
 
    ```bash
-   yarn build
+   yarn pack:local
    ```
 
-2. In your consuming project (e.g. `opal-frontend`), ensure you have set an environment variable pointing to the local build:
+   This generates a local `.tgz` artifact in this repository root (e.g. `hmcts-opal-frontend-common-X.Y.Z.tgz`).
+
+2. In your consuming project (e.g. `opal-frontend`), ensure you have set an environment variable pointing to this repository root:
 
    ```bash
    # In your shell config file (.zshrc, .bash_profile, or .bashrc)
-   export COMMON_UI_LIB_PATH="[INSERT PATH TO COMMON UI LIB FOLDER]"
+   export COMMON_UI_LIB_PATH="[INSERT PATH TO COMMON UI LIB REPOSITORY ROOT]"
    ```
 
 3. In the consuming project (e.g. `opal-frontend`), run:
@@ -77,7 +114,7 @@ To use a local version of this library during development in another project:
    yarn import:local:common-ui-lib
    ```
 
-   This will remove the published version and install the local build using the path provided.
+   This will remove the published version and install the locally packed `.tgz` artifact from the path provided.
 
 4. To switch back to the published version:
    ```bash
@@ -149,6 +186,15 @@ The following commands are available in the `package.json`:
 - `yarn build`  
   Builds the Angular library and outputs to the `dist/` folder.
 
+- `yarn exports:check`  
+  Validates that source `exports` and local `tsconfig` path aliases stay in sync.
+
+- `yarn pack:check`  
+  Validates the publish surface using `npm pack --dry-run`.
+
+- `yarn pack:local`  
+  Builds and packages the library into a root-level `.tgz` file for local consumer testing.
+
 - `yarn test`  
   Executes unit tests via Vitest.
 

package/package.json

@@ -1,19 +1,50 @@
 {
   "name": "@hmcts/opal-frontend-common",
-  "version": "0.0.67",
+  "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,30 +934,6 @@
     },
     "./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",

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%;
@@ -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/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.