@hmcts/opal-frontend-common 0.0.91 → 0.0.92

package/fesm2022/hmcts-opal-frontend-common-components-abstract-abstract-report-instances-table-base.mjs

@@ -0,0 +1,30 @@
+import * as i0 from '@angular/core';
+import { computed, Input, Component } from '@angular/core';
+import { AbstractSortableTablePaginationComponent } from '@hmcts/opal-frontend-common/components/abstract/abstract-sortable-table-pagination';
+
+class AbstractReportInstancesTableBaseComponent extends AbstractSortableTablePaginationComponent {
+    set tableData(tableData) {
+        this.setTableData(tableData);
+        this.onApplyFilters();
+    }
+    paginatedTableDataComputed = computed(() => {
+        const data = this.sortedTableDataSignal();
+        return data.slice(this.startIndexComputed() - 1, this.endIndexComputed());
+    }, ...(ngDevMode ? [{ debugName: "paginatedTableDataComputed" }] : /* istanbul ignore next */ []));
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.18", ngImport: i0, type: AbstractReportInstancesTableBaseComponent, deps: null, target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.2.18", type: AbstractReportInstancesTableBaseComponent, isStandalone: true, selector: "ng-component", inputs: { tableData: "tableData" }, usesInheritance: true, ngImport: i0, template: '', isInline: true });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.18", ngImport: i0, type: AbstractReportInstancesTableBaseComponent, decorators: [{
+            type: Component,
+            args: [{ template: '' }]
+        }], propDecorators: { tableData: [{
+                type: Input,
+                args: [{ required: true }]
+            }] } });
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { AbstractReportInstancesTableBaseComponent };
+//# sourceMappingURL=hmcts-opal-frontend-common-components-abstract-abstract-report-instances-table-base.mjs.map

package/fesm2022/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base-constants.mjs

@@ -0,0 +1,26 @@
+const ABSTRACT_REPORT_SUMMARY_LIST_LAST_7_DAYS = 'last7Days';
+const ABSTRACT_REPORT_SUMMARY_LIST_CUSTOM_DAYS = 'customDays';
+const ABSTRACT_REPORT_SUMMARY_LIST_DATE_RANGE = 'dateRange';
+const ABSTRACT_REPORT_SUMMARY_LIST_FILTER_STATE = {
+    dateFilter: ABSTRACT_REPORT_SUMMARY_LIST_LAST_7_DAYS,
+    days: '',
+    dateFrom: '',
+    dateTo: '',
+};
+
+const ABSTRACT_REPORT_SUMMARY_LIST_STATUS = {
+    requested: 'REQUESTED',
+    ready: 'READY',
+    inProgress: 'IN_PROGRESS',
+};
+const ABSTRACT_REPORT_SUMMARY_LIST_STATUS_DISPLAY = {
+    inProgress: 'In progress',
+    noContent: 'No content',
+};
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { ABSTRACT_REPORT_SUMMARY_LIST_CUSTOM_DAYS, ABSTRACT_REPORT_SUMMARY_LIST_DATE_RANGE, ABSTRACT_REPORT_SUMMARY_LIST_FILTER_STATE, ABSTRACT_REPORT_SUMMARY_LIST_LAST_7_DAYS, ABSTRACT_REPORT_SUMMARY_LIST_STATUS, ABSTRACT_REPORT_SUMMARY_LIST_STATUS_DISPLAY };
+//# sourceMappingURL=hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base-constants.mjs.map

package/fesm2022/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base-interfaces.mjs

@@ -0,0 +1,4 @@
+/**
+ * Generated bundle index. Do not edit.
+ */
+//# sourceMappingURL=hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base-interfaces.mjs.map

package/fesm2022/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base-types.mjs

@@ -0,0 +1,4 @@
+/**
+ * Generated bundle index. Do not edit.
+ */
+//# sourceMappingURL=hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base-types.mjs.map

package/fesm2022/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base.mjs

@@ -0,0 +1,282 @@
+import * as i0 from '@angular/core';
+import { inject, signal, computed, Component } from '@angular/core';
+import { DateService } from '@hmcts/opal-frontend-common/services/date-service';
+
+const ABSTRACT_REPORT_SUMMARY_LIST_LAST_7_DAYS = 'last7Days';
+const ABSTRACT_REPORT_SUMMARY_LIST_CUSTOM_DAYS = 'customDays';
+const ABSTRACT_REPORT_SUMMARY_LIST_DATE_RANGE = 'dateRange';
+const ABSTRACT_REPORT_SUMMARY_LIST_FILTER_STATE = {
+    dateFilter: ABSTRACT_REPORT_SUMMARY_LIST_LAST_7_DAYS,
+    days: '',
+    dateFrom: '',
+    dateTo: '',
+};
+
+const ABSTRACT_REPORT_SUMMARY_LIST_STATUS = {
+    requested: 'REQUESTED',
+    ready: 'READY',
+    inProgress: 'IN_PROGRESS',
+};
+const ABSTRACT_REPORT_SUMMARY_LIST_STATUS_DISPLAY = {
+    inProgress: 'In progress',
+    noContent: 'No content',
+};
+
+const ABSTRACT_REPORT_SUMMARY_LIST_DATE_FORMATS = {
+    input: 'dd/MM/yyyy',
+    output: 'yyyy-MM-dd',
+};
+class AbstractReportSummaryListBaseComponent {
+    dateService = inject(DateService);
+    fieldErrors = signal({}, ...(ngDevMode ? [{ debugName: "fieldErrors" }] : /* istanbul ignore next */ []));
+    dateFormats = ABSTRACT_REPORT_SUMMARY_LIST_DATE_FORMATS;
+    dateFilterLast7Days = ABSTRACT_REPORT_SUMMARY_LIST_LAST_7_DAYS;
+    dateFilterCustomDays = ABSTRACT_REPORT_SUMMARY_LIST_CUSTOM_DAYS;
+    dateFilterDateRange = ABSTRACT_REPORT_SUMMARY_LIST_DATE_RANGE;
+    dateFilter = signal(ABSTRACT_REPORT_SUMMARY_LIST_FILTER_STATE.dateFilter, ...(ngDevMode ? [{ debugName: "dateFilter" }] : /* istanbul ignore next */ []));
+    errorSummaryMessages = computed(() => Object.entries(this.fieldErrors()).map(([fieldId, message]) => ({ fieldId, message })), ...(ngDevMode ? [{ debugName: "errorSummaryMessages" }] : /* istanbul ignore next */ []));
+    /**
+     * Builds the default report query for the last 7 days.
+     *
+     * @param dateService - The date service used to calculate and format the date range.
+     * @param dateFormats - The input and output date formats used by the consuming application.
+     * @returns A report query state with a last 7 days date range.
+     */
+    static getDefaultReportQuery(dateService, dateFormats = ABSTRACT_REPORT_SUMMARY_LIST_DATE_FORMATS) {
+        const dateRange = dateService.getDateRange(6, 0, dateFormats.output);
+        return {
+            fromDate: dateRange.from,
+            toDate: dateRange.to,
+        };
+    }
+    /**
+     * Builds a report query from the selected report filter state.
+     *
+     * @param filters - The selected report filter state.
+     * @param dateService - The date service used to calculate and format date values.
+     * @param dateFormats - The input and output date formats used by the consuming application.
+     * @returns A report query state suitable for report instance API requests.
+     */
+    static getReportQueryFromFilters(filters, dateService, dateFormats = ABSTRACT_REPORT_SUMMARY_LIST_DATE_FORMATS) {
+        if (filters.dateFilter === ABSTRACT_REPORT_SUMMARY_LIST_CUSTOM_DAYS) {
+            const days = Number(filters.days);
+            const dateRange = dateService.getDateRange(days - 1, 0, dateFormats.output);
+            return {
+                fromDate: dateRange.from,
+                toDate: dateRange.to,
+            };
+        }
+        if (filters.dateFilter === ABSTRACT_REPORT_SUMMARY_LIST_DATE_RANGE) {
+            return {
+                fromDate: filters.dateFrom
+                    ? dateService.getFromFormatToFormat(filters.dateFrom, dateFormats.input, dateFormats.output)
+                    : null,
+                toDate: filters.dateTo
+                    ? dateService.getFromFormatToFormat(filters.dateTo, dateFormats.input, dateFormats.output)
+                    : null,
+            };
+        }
+        return AbstractReportSummaryListBaseComponent.getDefaultReportQuery(dateService, dateFormats);
+    }
+    /**
+     * Gets the display status for a report instance.
+     *
+     * @param status - The report instance status code.
+     * @param records - The number of records in the report instance, where available.
+     * @param displayName - The API-provided status display name, where available.
+     * @returns The display status for the report instance.
+     */
+    static getReportInstanceDisplayStatus(status, records, displayName) {
+        if (status === ABSTRACT_REPORT_SUMMARY_LIST_STATUS.requested) {
+            return ABSTRACT_REPORT_SUMMARY_LIST_STATUS_DISPLAY.inProgress;
+        }
+        if (status === ABSTRACT_REPORT_SUMMARY_LIST_STATUS.ready && records === 0) {
+            return ABSTRACT_REPORT_SUMMARY_LIST_STATUS_DISPLAY.noContent;
+        }
+        if (status === ABSTRACT_REPORT_SUMMARY_LIST_STATUS.inProgress) {
+            return ABSTRACT_REPORT_SUMMARY_LIST_STATUS_DISPLAY.inProgress;
+        }
+        return displayName || AbstractReportSummaryListBaseComponent.toReportDisplayStatus(status);
+    }
+    /**
+     * Converts a report status code into title case display text.
+     *
+     * @param status - The report status code to convert.
+     * @returns A display-friendly status value.
+     */
+    static toReportDisplayStatus(status) {
+        return status ? status.charAt(0).toUpperCase() + status.slice(1).toLowerCase() : '';
+    }
+    /**
+     * Builds the default report query for the current component instance.
+     *
+     * @returns A report query state with a last 7 days date range.
+     */
+    getDefaultReportQuery() {
+        return AbstractReportSummaryListBaseComponent.getDefaultReportQuery(this.dateService, this.dateFormats);
+    }
+    /**
+     * Builds a report query from the selected report filter state for the current component instance.
+     *
+     * @param filters - The selected report filter state.
+     * @returns A report query state suitable for report instance API requests.
+     */
+    getReportQueryFromFilters(filters) {
+        return AbstractReportSummaryListBaseComponent.getReportQueryFromFilters(filters, this.dateService, this.dateFormats);
+    }
+    /**
+     * Builds validation messages for the active report date filter fields.
+     *
+     * @param filters - The selected report filter state.
+     * @param fieldIds - The field ids used by the consuming application template.
+     * @returns A field error map keyed by field id.
+     */
+    buildReportDateFieldErrors(filters, fieldIds) {
+        if (filters.dateFilter === ABSTRACT_REPORT_SUMMARY_LIST_CUSTOM_DAYS) {
+            return this.buildCustomDaysFieldErrors(filters, fieldIds);
+        }
+        if (filters.dateFilter === ABSTRACT_REPORT_SUMMARY_LIST_DATE_RANGE) {
+            return this.buildDateRangeFieldErrors(filters, fieldIds);
+        }
+        return {};
+    }
+    /**
+     * Builds validation messages for the custom days report date filter.
+     *
+     * @param filters - The selected report filter state.
+     * @param fieldIds - The field ids used by the consuming application template.
+     * @returns A field error map keyed by field id.
+     */
+    buildCustomDaysFieldErrors(filters, fieldIds) {
+        const days = Number(filters.days);
+        if (!filters.days || !Number.isFinite(days) || !Number.isInteger(days) || days < 1) {
+            return { [fieldIds.days]: this.dateValidationMessages.customDaysRequired };
+        }
+        return {};
+    }
+    /**
+     * Builds validation messages for the date range report date filter.
+     *
+     * @param filters - The selected report filter state.
+     * @param fieldIds - The field ids used by the consuming application template.
+     * @returns A field error map keyed by field id.
+     */
+    buildDateRangeFieldErrors(filters, fieldIds) {
+        const errors = {};
+        this.addRequiredDateRangeError(errors, filters, fieldIds);
+        this.addDateFormatErrors(errors, filters, fieldIds);
+        this.addFutureDateErrors(errors, filters, fieldIds);
+        this.addDateOrderError(errors, filters, fieldIds);
+        return errors;
+    }
+    /**
+     * Adds a validation message when no date range boundary has been entered.
+     *
+     * @param errors - The field error map to update.
+     * @param filters - The selected report filter state.
+     * @param fieldIds - The field ids used by the consuming application template.
+     */
+    addRequiredDateRangeError(errors, filters, fieldIds) {
+        if (!filters.dateFrom && !filters.dateTo) {
+            errors[fieldIds.dateFrom] = this.dateValidationMessages.dateRangeRequired;
+        }
+    }
+    /**
+     * Adds validation messages for date values with an invalid format.
+     *
+     * @param errors - The field error map to update.
+     * @param filters - The selected report filter state.
+     * @param fieldIds - The field ids used by the consuming application template.
+     */
+    addDateFormatErrors(errors, filters, fieldIds) {
+        if (filters.dateFrom && this.isReportDateInvalid(filters.dateFrom)) {
+            errors[fieldIds.dateFrom] = this.dateValidationMessages.invalidDate;
+        }
+        if (filters.dateTo && this.isReportDateInvalid(filters.dateTo)) {
+            errors[fieldIds.dateTo] = this.dateValidationMessages.invalidDate;
+        }
+    }
+    /**
+     * Adds validation messages for date values in the future.
+     *
+     * @param errors - The field error map to update.
+     * @param filters - The selected report filter state.
+     * @param fieldIds - The field ids used by the consuming application template.
+     */
+    addFutureDateErrors(errors, filters, fieldIds) {
+        if (!errors[fieldIds.dateFrom] && filters.dateFrom && this.isReportDateInFuture(filters.dateFrom)) {
+            errors[fieldIds.dateFrom] = this.dateValidationMessages.futureDate;
+        }
+        if (!errors[fieldIds.dateTo] && filters.dateTo && this.isReportDateInFuture(filters.dateTo)) {
+            errors[fieldIds.dateTo] = this.dateValidationMessages.futureDate;
+        }
+    }
+    /**
+     * Adds a validation message when date from is after date to.
+     *
+     * @param errors - The field error map to update.
+     * @param filters - The selected report filter state.
+     * @param fieldIds - The field ids used by the consuming application template.
+     */
+    addDateOrderError(errors, filters, fieldIds) {
+        if (errors[fieldIds.dateFrom] || errors[fieldIds.dateTo] || !filters.dateFrom || !filters.dateTo) {
+            return;
+        }
+        if (this.isReportDateFromAfterDateTo(filters.dateFrom, filters.dateTo)) {
+            errors[fieldIds.dateFrom] = this.dateValidationMessages.dateFromAfterDateTo;
+        }
+    }
+    /**
+     * Checks whether a report date string is invalid.
+     *
+     * @param value - The date value to validate.
+     * @returns True when the date value is invalid, otherwise false.
+     */
+    isReportDateInvalid(value) {
+        return !this.dateService.isValidDate(value, this.dateFormats.input);
+    }
+    /**
+     * Checks whether a report date string is in the future.
+     *
+     * @param value - The date value to validate.
+     * @returns True when the date value is valid and in the future, otherwise false.
+     */
+    isReportDateInFuture(value) {
+        return (this.dateService.isValidDate(value, this.dateFormats.input) &&
+            this.dateService.isDateInTheFuture(value, undefined, this.dateFormats.input));
+    }
+    /**
+     * Checks whether the report date from value is after the report date to value.
+     *
+     * @param dateFrom - The start date value.
+     * @param dateTo - The end date value.
+     * @returns True when both dates are valid and date from is after date to, otherwise false.
+     */
+    isReportDateFromAfterDateTo(dateFrom, dateTo) {
+        const from = this.dateService.getFromFormat(dateFrom, this.dateFormats.input).startOf('day');
+        const to = this.dateService.getFromFormat(dateTo, this.dateFormats.input).startOf('day');
+        return from.isValid && to.isValid && from > to;
+    }
+    /**
+     * Returns the current validation message for a field.
+     *
+     * @param fieldId - The field id to get an error for.
+     * @returns The field error message, or null when there is no error.
+     */
+    getFieldError(fieldId) {
+        return this.fieldErrors()[fieldId] ?? null;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.18", ngImport: i0, type: AbstractReportSummaryListBaseComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.2.18", type: AbstractReportSummaryListBaseComponent, isStandalone: true, selector: "ng-component", ngImport: i0, template: '', isInline: true });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.18", ngImport: i0, type: AbstractReportSummaryListBaseComponent, decorators: [{
+            type: Component,
+            args: [{ template: '' }]
+        }] });
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { AbstractReportSummaryListBaseComponent };
+//# sourceMappingURL=hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base.mjs.map

package/fesm2022/hmcts-opal-frontend-common-components-abstract-abstract-sortable-table-pagination.mjs

@@ -1,8 +1,17 @@
 import * as i0 from '@angular/core';
-import { signal, computed, Component } from '@angular/core';
+import { effect, signal, computed, Component } from '@angular/core';
 import { AbstractSortableTableComponent } from '@hmcts/opal-frontend-common/components/abstract/abstract-sortable-table';
 
 class AbstractSortableTablePaginationComponent extends AbstractSortableTableComponent {
+    /**
+     * Keeps the current page within the available range when the data set or page size changes.
+     */
+    clampCurrentPageEffect = effect(() => {
+        const totalPages = Math.max(1, Math.ceil(this.sortedTableDataSignal().length / this.itemsPerPageSignal()));
+        if (this.currentPageSignal() > totalPages) {
+            this.currentPageSignal.set(totalPages);
+        }
+    }, ...(ngDevMode ? [{ debugName: "clampCurrentPageEffect" }] : /* istanbul ignore next */ []));
     // Signal for the current page. Used to calculate the start and end indices for pagination.
     currentPageSignal = signal(1, ...(ngDevMode ? [{ debugName: "currentPageSignal" }] : /* istanbul ignore next */ []));
     // Signal for the number of items per page. Determines how many items are displayed on each page.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hmcts/opal-frontend-common",
-  "version": "0.0.91",
+  "version": "0.0.92",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -26,7 +26,7 @@
   },
   "dependencies": {
     "@microsoft/applicationinsights-web": "^3.3.6",
-    "@ministryofjustice/frontend": "^9.0.0",
+    "@ministryofjustice/frontend": "^10.0.0",
     "accessible-autocomplete": "^3.0.1",
     "fast-sort": "^3.4.1",
     "govuk-frontend": "^6.0.0",
@@ -126,6 +126,31 @@
       "types": "./types/hmcts-opal-frontend-common-components-abstract-abstract-sortable-table-pagination.d.ts",
       "default": "./fesm2022/hmcts-opal-frontend-common-components-abstract-abstract-sortable-table-pagination.mjs"
     },
+    "./components/abstract/abstract-report-instances-table-base": {
+      "import": "./fesm2022/hmcts-opal-frontend-common-components-abstract-abstract-report-instances-table-base.mjs",
+      "types": "./types/hmcts-opal-frontend-common-components-abstract-abstract-report-instances-table-base.d.ts",
+      "default": "./fesm2022/hmcts-opal-frontend-common-components-abstract-abstract-report-instances-table-base.mjs"
+    },
+    "./components/abstract/abstract-report-summary-list-base": {
+      "import": "./fesm2022/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base.mjs",
+      "types": "./types/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base.d.ts",
+      "default": "./fesm2022/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base.mjs"
+    },
+    "./components/abstract/abstract-report-summary-list-base/constants": {
+      "import": "./fesm2022/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base-constants.mjs",
+      "types": "./types/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base-constants.d.ts",
+      "default": "./fesm2022/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base-constants.mjs"
+    },
+    "./components/abstract/abstract-report-summary-list-base/interfaces": {
+      "import": "./fesm2022/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base-interfaces.mjs",
+      "types": "./types/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base-interfaces.d.ts",
+      "default": "./fesm2022/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base-interfaces.mjs"
+    },
+    "./components/abstract/abstract-report-summary-list-base/types": {
+      "import": "./fesm2022/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base-types.mjs",
+      "types": "./types/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base-types.d.ts",
+      "default": "./fesm2022/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base-types.mjs"
+    },
     "./components/abstract/abstract-tab-data": {
       "import": "./fesm2022/hmcts-opal-frontend-common-components-abstract-abstract-tab-data.mjs",
       "types": "./types/hmcts-opal-frontend-common-components-abstract-abstract-tab-data.d.ts",

package/types/hmcts-opal-frontend-common-components-abstract-abstract-report-instances-table-base.d.ts

@@ -0,0 +1,13 @@
+import * as i0 from '@angular/core';
+import { IAbstractTableData } from '@hmcts/opal-frontend-common/components/abstract/abstract-sortable-table/interfaces';
+import { SortableValuesType } from '@hmcts/opal-frontend-common/components/abstract/abstract-sortable-table/types';
+import { AbstractSortableTablePaginationComponent } from '@hmcts/opal-frontend-common/components/abstract/abstract-sortable-table-pagination';
+
+declare abstract class AbstractReportInstancesTableBaseComponent<TTableData extends IAbstractTableData<SortableValuesType>> extends AbstractSortableTablePaginationComponent {
+    set tableData(tableData: TTableData[]);
+    paginatedTableDataComputed: i0.Signal<TTableData[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AbstractReportInstancesTableBaseComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AbstractReportInstancesTableBaseComponent<any>, "ng-component", never, { "tableData": { "alias": "tableData"; "required": true; }; }, {}, never, never, true, never>;
+}
+
+export { AbstractReportInstancesTableBaseComponent };

package/types/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base-constants.d.ts

@@ -0,0 +1,21 @@
+declare const ABSTRACT_REPORT_SUMMARY_LIST_LAST_7_DAYS = "last7Days";
+declare const ABSTRACT_REPORT_SUMMARY_LIST_CUSTOM_DAYS = "customDays";
+declare const ABSTRACT_REPORT_SUMMARY_LIST_DATE_RANGE = "dateRange";
+declare const ABSTRACT_REPORT_SUMMARY_LIST_FILTER_STATE: {
+    readonly dateFilter: "last7Days";
+    readonly days: "";
+    readonly dateFrom: "";
+    readonly dateTo: "";
+};
+
+declare const ABSTRACT_REPORT_SUMMARY_LIST_STATUS: {
+    readonly requested: "REQUESTED";
+    readonly ready: "READY";
+    readonly inProgress: "IN_PROGRESS";
+};
+declare const ABSTRACT_REPORT_SUMMARY_LIST_STATUS_DISPLAY: {
+    readonly inProgress: "In progress";
+    readonly noContent: "No content";
+};
+
+export { ABSTRACT_REPORT_SUMMARY_LIST_CUSTOM_DAYS, ABSTRACT_REPORT_SUMMARY_LIST_DATE_RANGE, ABSTRACT_REPORT_SUMMARY_LIST_FILTER_STATE, ABSTRACT_REPORT_SUMMARY_LIST_LAST_7_DAYS, ABSTRACT_REPORT_SUMMARY_LIST_STATUS, ABSTRACT_REPORT_SUMMARY_LIST_STATUS_DISPLAY };

package/types/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base-interfaces.d.ts

@@ -0,0 +1,34 @@
+import { AbstractReportSummaryListDateFilter } from '@hmcts/opal-frontend-common/components/abstract/abstract-report-summary-list-base/types';
+
+interface IAbstractReportSummaryListDateFieldIds {
+    days: string;
+    dateFrom: string;
+    dateTo: string;
+}
+
+interface IAbstractReportSummaryListDateFormats {
+    input: string;
+    output: string;
+}
+
+interface IAbstractReportSummaryListDateValidationMessages {
+    customDaysRequired: string;
+    dateRangeRequired: string;
+    invalidDate: string;
+    futureDate: string;
+    dateFromAfterDateTo: string;
+}
+
+interface IAbstractReportSummaryListFilterState {
+    dateFilter: AbstractReportSummaryListDateFilter;
+    days: string;
+    dateFrom: string;
+    dateTo: string;
+}
+
+interface IAbstractReportSummaryListQueryState {
+    fromDate: string | null;
+    toDate: string | null;
+}
+
+export type { IAbstractReportSummaryListDateFieldIds, IAbstractReportSummaryListDateFormats, IAbstractReportSummaryListDateValidationMessages, IAbstractReportSummaryListFilterState, IAbstractReportSummaryListQueryState };

package/types/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base-types.d.ts

@@ -0,0 +1,3 @@
+type AbstractReportSummaryListDateFilter = 'last7Days' | 'customDays' | 'dateRange';
+
+export type { AbstractReportSummaryListDateFilter };

package/types/hmcts-opal-frontend-common-components-abstract-abstract-report-summary-list-base.d.ts

@@ -0,0 +1,198 @@
+import * as _angular_core from '@angular/core';
+import { DateService } from '@hmcts/opal-frontend-common/services/date-service';
+import { IAbstractFormBaseFormErrorSummaryMessage } from '@hmcts/opal-frontend-common/components/abstract/interfaces';
+import { AbstractReportSummaryListDateFilter as AbstractReportSummaryListDateFilter$1 } from '@hmcts/opal-frontend-common/components/abstract/abstract-report-summary-list-base/types';
+
+interface IAbstractReportSummaryListDateFieldIds {
+    days: string;
+    dateFrom: string;
+    dateTo: string;
+}
+
+interface IAbstractReportSummaryListDateFormats {
+    input: string;
+    output: string;
+}
+
+interface IAbstractReportSummaryListDateValidationMessages {
+    customDaysRequired: string;
+    dateRangeRequired: string;
+    invalidDate: string;
+    futureDate: string;
+    dateFromAfterDateTo: string;
+}
+
+interface IAbstractReportSummaryListFilterState {
+    dateFilter: AbstractReportSummaryListDateFilter$1;
+    days: string;
+    dateFrom: string;
+    dateTo: string;
+}
+
+interface IAbstractReportSummaryListQueryState {
+    fromDate: string | null;
+    toDate: string | null;
+}
+
+type AbstractReportSummaryListDateFilter = 'last7Days' | 'customDays' | 'dateRange';
+
+declare abstract class AbstractReportSummaryListBaseComponent<TFilterForm = unknown> {
+    protected readonly dateService: DateService;
+    protected readonly fieldErrors: _angular_core.WritableSignal<Record<string, string>>;
+    protected abstract readonly dateValidationMessages: IAbstractReportSummaryListDateValidationMessages;
+    protected readonly dateFormats: IAbstractReportSummaryListDateFormats;
+    readonly dateFilterLast7Days = "last7Days";
+    readonly dateFilterCustomDays = "customDays";
+    readonly dateFilterDateRange = "dateRange";
+    readonly dateFilter: _angular_core.WritableSignal<AbstractReportSummaryListDateFilter>;
+    readonly errorSummaryMessages: _angular_core.Signal<IAbstractFormBaseFormErrorSummaryMessage[]>;
+    /**
+     * Builds the default report query for the last 7 days.
+     *
+     * @param dateService - The date service used to calculate and format the date range.
+     * @param dateFormats - The input and output date formats used by the consuming application.
+     * @returns A report query state with a last 7 days date range.
+     */
+    static getDefaultReportQuery(dateService: DateService, dateFormats?: IAbstractReportSummaryListDateFormats): IAbstractReportSummaryListQueryState;
+    /**
+     * Builds a report query from the selected report filter state.
+     *
+     * @param filters - The selected report filter state.
+     * @param dateService - The date service used to calculate and format date values.
+     * @param dateFormats - The input and output date formats used by the consuming application.
+     * @returns A report query state suitable for report instance API requests.
+     */
+    static getReportQueryFromFilters(filters: IAbstractReportSummaryListFilterState, dateService: DateService, dateFormats?: IAbstractReportSummaryListDateFormats): IAbstractReportSummaryListQueryState;
+    /**
+     * Gets the display status for a report instance.
+     *
+     * @param status - The report instance status code.
+     * @param records - The number of records in the report instance, where available.
+     * @param displayName - The API-provided status display name, where available.
+     * @returns The display status for the report instance.
+     */
+    static getReportInstanceDisplayStatus(status: string, records?: number | null, displayName?: string | null): string;
+    /**
+     * Converts a report status code into title case display text.
+     *
+     * @param status - The report status code to convert.
+     * @returns A display-friendly status value.
+     */
+    static toReportDisplayStatus(status: string): string;
+    /**
+     * Builds the default report query for the current component instance.
+     *
+     * @returns A report query state with a last 7 days date range.
+     */
+    protected getDefaultReportQuery(): IAbstractReportSummaryListQueryState;
+    /**
+     * Builds a report query from the selected report filter state for the current component instance.
+     *
+     * @param filters - The selected report filter state.
+     * @returns A report query state suitable for report instance API requests.
+     */
+    protected getReportQueryFromFilters(filters: IAbstractReportSummaryListFilterState): IAbstractReportSummaryListQueryState;
+    /**
+     * Reads the consuming application's report filter form into a normalized filter state object.
+     *
+     * @param filtersForm - The consuming application's report filter form to read from.
+     * @returns A normalized report filter state.
+     */
+    protected abstract getFiltersFromForm(filtersForm: TFilterForm): IAbstractReportSummaryListFilterState;
+    /**
+     * Clears consuming application form fields that do not apply to the selected date filter.
+     *
+     * @param filtersForm - The consuming application's report filter form to update.
+     * @param dateFilter - The selected date filter.
+     */
+    protected abstract clearInactiveDateFilterFields(filtersForm: TFilterForm, dateFilter: AbstractReportSummaryListDateFilter | null): void;
+    /**
+     * Builds validation messages for the active report date filter fields.
+     *
+     * @param filters - The selected report filter state.
+     * @param fieldIds - The field ids used by the consuming application template.
+     * @returns A field error map keyed by field id.
+     */
+    protected buildReportDateFieldErrors(filters: IAbstractReportSummaryListFilterState, fieldIds: IAbstractReportSummaryListDateFieldIds): Record<string, string>;
+    /**
+     * Builds validation messages for the custom days report date filter.
+     *
+     * @param filters - The selected report filter state.
+     * @param fieldIds - The field ids used by the consuming application template.
+     * @returns A field error map keyed by field id.
+     */
+    protected buildCustomDaysFieldErrors(filters: IAbstractReportSummaryListFilterState, fieldIds: IAbstractReportSummaryListDateFieldIds): Record<string, string>;
+    /**
+     * Builds validation messages for the date range report date filter.
+     *
+     * @param filters - The selected report filter state.
+     * @param fieldIds - The field ids used by the consuming application template.
+     * @returns A field error map keyed by field id.
+     */
+    protected buildDateRangeFieldErrors(filters: IAbstractReportSummaryListFilterState, fieldIds: IAbstractReportSummaryListDateFieldIds): Record<string, string>;
+    /**
+     * Adds a validation message when no date range boundary has been entered.
+     *
+     * @param errors - The field error map to update.
+     * @param filters - The selected report filter state.
+     * @param fieldIds - The field ids used by the consuming application template.
+     */
+    protected addRequiredDateRangeError(errors: Record<string, string>, filters: IAbstractReportSummaryListFilterState, fieldIds: IAbstractReportSummaryListDateFieldIds): void;
+    /**
+     * Adds validation messages for date values with an invalid format.
+     *
+     * @param errors - The field error map to update.
+     * @param filters - The selected report filter state.
+     * @param fieldIds - The field ids used by the consuming application template.
+     */
+    protected addDateFormatErrors(errors: Record<string, string>, filters: IAbstractReportSummaryListFilterState, fieldIds: IAbstractReportSummaryListDateFieldIds): void;
+    /**
+     * Adds validation messages for date values in the future.
+     *
+     * @param errors - The field error map to update.
+     * @param filters - The selected report filter state.
+     * @param fieldIds - The field ids used by the consuming application template.
+     */
+    protected addFutureDateErrors(errors: Record<string, string>, filters: IAbstractReportSummaryListFilterState, fieldIds: IAbstractReportSummaryListDateFieldIds): void;
+    /**
+     * Adds a validation message when date from is after date to.
+     *
+     * @param errors - The field error map to update.
+     * @param filters - The selected report filter state.
+     * @param fieldIds - The field ids used by the consuming application template.
+     */
+    protected addDateOrderError(errors: Record<string, string>, filters: IAbstractReportSummaryListFilterState, fieldIds: IAbstractReportSummaryListDateFieldIds): void;
+    /**
+     * Checks whether a report date string is invalid.
+     *
+     * @param value - The date value to validate.
+     * @returns True when the date value is invalid, otherwise false.
+     */
+    protected isReportDateInvalid(value: string): boolean;
+    /**
+     * Checks whether a report date string is in the future.
+     *
+     * @param value - The date value to validate.
+     * @returns True when the date value is valid and in the future, otherwise false.
+     */
+    protected isReportDateInFuture(value: string): boolean;
+    /**
+     * Checks whether the report date from value is after the report date to value.
+     *
+     * @param dateFrom - The start date value.
+     * @param dateTo - The end date value.
+     * @returns True when both dates are valid and date from is after date to, otherwise false.
+     */
+    protected isReportDateFromAfterDateTo(dateFrom: string, dateTo: string): boolean;
+    /**
+     * Returns the current validation message for a field.
+     *
+     * @param fieldId - The field id to get an error for.
+     * @returns The field error message, or null when there is no error.
+     */
+    getFieldError(fieldId: string): string | null;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AbstractReportSummaryListBaseComponent<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AbstractReportSummaryListBaseComponent<any>, "ng-component", never, {}, {}, never, never, true, never>;
+}
+
+export { AbstractReportSummaryListBaseComponent };

package/types/hmcts-opal-frontend-common-components-abstract-abstract-sortable-table-pagination.d.ts

@@ -4,6 +4,10 @@ import * as _angular_core from '@angular/core';
 import { AbstractSortableTableComponent } from '@hmcts/opal-frontend-common/components/abstract/abstract-sortable-table';
 
 declare abstract class AbstractSortableTablePaginationComponent extends AbstractSortableTableComponent {
+    /**
+     * Keeps the current page within the available range when the data set or page size changes.
+     */
+    private readonly clampCurrentPageEffect;
     currentPageSignal: _angular_core.WritableSignal<number>;
     itemsPerPageSignal: _angular_core.WritableSignal<number>;
     startIndexComputed: _angular_core.Signal<number>;