[dspace-7_x] Add paginated vocabulary search with 'Show previous/next results' controls in hierarchical browse

[ZahraaChreim-Atmire]

References

• Fixes Hierarchical browse returns only first 20 results when searching/filtering #4500
• Main port is available at [main] Add paginated vocabulary search with 'Show previous/next results' controls in hierarchical browse #4508

Description

Added paging state management to the vocabulary treeview service, updating after each query based on whether previous or next pages exist; this state is exposed to the component to conditionally render navigation buttons in the hierarchical vocabulary browse.

Instructions for Reviewers

List of changes in this PR:

• First, added currentPage, totalPages, showNextPageSubject, and showPreviousPageSubject to the vocabulary-treeview.service to manage and expose pagination state.
• Second, created a new method searchByQueryAndPage(query, selectedItems, page) to support page-specific vocabulary search requests. The existing searchByQuery method was updated to call this with page 1 by default.
• Third, updated searchByQueryAndPage to extract pagination info from the search response and update the showNextPageSubject and showPreviousPageSubject based on whether more pages are available.
• Fourth, exposed showNextPage$ and showPreviousPage$ in the component, derived from showNextPageSubject, and showPreviousPageSubject, to reactively control the display of pagination buttons.
• Fifth, added conditional rendering of “Show next results” and “Show previous results” buttons in the template, along with loadNextPage and `loadPreviousPage to trigger paging behavior.

To test this PR:

1. Create a custom vocabulary XML file containing more than 20 nodes. Example: nodes with label="label1" through label="label100" and corresponding values like "value test 1" to "value test 100".
2. Deploy the vocabulary to your backend instance.
3. Navigate to the hierarchical browse interface in the UI (e.g., /browse/srsc).
4. Enter the query label.

Expected behavior after applying this PR:

• Only the first 20 matching entries are displayed initially.
• A “Show next results” button appears below the filtered tree.
• Clicking it displays the next 20 results and replaces the tree content.
• When on subsequent pages, a “Show previous results” button also appears to navigate back.
• On the final page, only the “Show previous results” button should be visible (no “Show next”).
• On the first page, only the “Show next results” button should be visible.

First page:

Intermediate page:

Last page:

Checklist

This checklist provides a reminder of what we are going to look for when reviewing your PR. You do not need to complete this checklist prior creating your PR (draft PRs are always welcome).
However, reviewers may request that you complete any actions in this list if you have not done so. If you are unsure about an item in the checklist, don't hesitate to ask. We're here to help!

• My PR is created against the main branch of code (unless it is a backport or is fixing an issue specific to an older branch).
• My PR is small in size (e.g. less than 1,000 lines of code, not including comments & specs/tests), or I have provided reasons as to why that's not possible.
• My PR passes ESLint validation using npm run lint
• My PR doesn't introduce circular dependencies (verified via npm run check-circ-deps)
• My PR includes TypeDoc comments for all new (or modified) public methods and classes. It also includes TypeDoc for large or complex private methods.
• My PR passes all specs/tests and includes new/updated specs or tests based on the Code Testing Guide.
• My PR aligns with Accessibility guidelines if it makes changes to the user interface.
• My PR uses i18n (internationalization) keys instead of hardcoded English text, to allow for translations.
• My PR includes details on how to test it. I've provided clear instructions to reviewers on how to successfully test this fix or feature.
• If my PR includes new libraries/dependencies (in package.json), I've made sure their licenses align with the DSpace BSD License based on the Licensing of Contributions documentation.
• If my PR includes new features or configurations, I've provided basic technical documentation in the PR itself.
• If my PR fixes an issue ticket, I've linked them together.

[tdonohue]

@ZahraaChreim-Atmire : Could you please create a main version of this PR? Reviewers would need to also be able to test this against main because the main branch has stricter development standards, etc.

[ZahraaChreim-Atmire]

@ZahraaChreim-Atmire : Could you please create a main version of this PR? Reviewers would need to also be able to test this against main because the main branch has stricter development standards, etc.

@tdonohue main version of this PR: #4508

[github-actions]

Hi @ZahraaChreim-Atmire,
Conflicts have been detected against the base branch.
Please resolve these conflicts as soon as you can. Thanks!

[tdonohue]

Closing & reopening to get tests to run again.

[dspace-bot]

Backport failed for dspace-8_x, because it was unable to cherry-pick the commit(s).

Please cherry-pick the changes locally and resolve any conflicts.

git fetch origin dspace-8_x
git worktree add -d .worktree/backport-4504-to-dspace-8_x origin/dspace-8_x
cd .worktree/backport-4504-to-dspace-8_x
git switch --create backport-4504-to-dspace-8_x
git cherry-pick -x 1982f7593f84e57b52cb24bed2f5417ffabc4644 231da9c2c50f9043a1f5090833aa8429b7d71db2 9aacba60b4c296b9b0e9561d4d15b83d006193d1