Avoid unintended side-effects on non-interactive library disassociations (PP-2408) (#171)

## Description

Use newly-added `isLibraryRemovalPermitted` (instead of `removeLibrary`)
to confirm interactive removals of library associations from
collections.

NB: This PR is ready for review; however, it depends on #170 for
`isLibraryRemovalPermitted`, so this PR should not be merged until that
one is landed.

## Motivation and Context

Confirmation popups were rendering for each associated library when the
`CollectionEditForm` was being cleared. This is because `removeLibrary`
is used both interactively -- when library `Delete` button is clicked --
and non-interactively, when the form is cleared.

[Jira PP-2408]

## How Has This Been Tested?

- Testing in local environment.
- All tests pass locally.
- [CI
tests](https://github.com/ThePalaceProject/circulation-admin/actions/runs/17103881259)
pass.

## Checklist:

- [x] I have updated the documentation accordingly.
- [x] All new and existing tests passed.

Author: tdilauro

src/components/Collections.tsx

@@ -39,19 +39,17 @@ export class CollectionEditForm extends ServiceWithRegistrationsEditForm<
 > {
   /**
    * Override to display a confirmation message before removing a library
-   * association. We display the confirmation and, if successful, call the
-   * superclass method to actually remove the library from our state.
-   * @param library
+   * association. We display the confirmation and return `true` if the
+   * action is confirmed or `false` otherwise.
+   * @param library The library to remove.
    */
-  removeLibrary(library: LibraryWithSettingsData) {
+  isLibraryRemovalPermitted(library: LibraryWithSettingsData): boolean {
     const libraryData = this.getLibrary(library.short_name);
     const libraryName = libraryData ? libraryData.name : library.short_name;
     const confirmationMessage =
       `Disassociating library "${libraryName}" from this collection will ` +
       "remove all loans and holds for its patrons. Do you wish to continue?";
-    if (window.confirm(confirmationMessage)) {
-      super.removeLibrary(library);
-    }
+    return window.confirm(confirmationMessage);
   }
 }
 

src/components/__tests__/Collections-test.tsx

@@ -133,6 +133,7 @@ describe("Collections", () => {
     describe("confirm before disassociating libraries", () => {
       let wrapper: ReactWrapper;
       let confirmStub: sinon.SinonStub;
+      let instance: CollectionEditForm;
 
       const initialLibraries = [
         { short_name: "palace", name: "Palace" },
@@ -142,13 +143,11 @@ describe("Collections", () => {
         id: 7,
         name: "An OPDS Collection",
         protocol: "OPDS Import",
-
         libraries: [...initialLibraries],
       };
 
       beforeEach(() => {
         confirmStub = sinon.stub(window, "confirm");
-
         wrapper = mount(
           <CollectionEditForm
             disabled={false}
@@ -162,40 +161,64 @@ describe("Collections", () => {
             listDataKey="collections"
           />
         );
+        instance = wrapper.instance() as CollectionEditForm;
       });
 
       afterEach(() => {
         confirmStub.restore();
       });
 
-      it("calls window.confirm when delete button is clicked", () => {
+      it("prompts for confirmation before removing a library", () => {
         confirmStub.returns(false);
 
         // The confirmation dialog should not be invoked before we click.
-        expect(confirmStub.calledOnce).to.be.false;
+        expect(confirmStub.called).to.be.false;
 
         wrapper.find("button.remove-btn").at(0).simulate("click");
         expect(confirmStub.calledOnce).to.be.true;
-        expect(confirmStub.firstCall.args.length).to.equal(1);
         const message: string = confirmStub.firstCall.args[0];
         expect(message).to.equal(
           'Disassociating library "Palace" from this collection will ' +
             "remove all loans and holds for its patrons. Do you wish to continue?"
         );
       });
 
-      it("does not delete library if confirmation is canceled", () => {
+      it("removes library if confirmation is accepted", () => {
+        confirmStub.returns(true);
+        wrapper.find("button.remove-btn").at(0).simulate("click");
+
+        // Ensure confirmation was sought.
+        expect(confirmStub.calledOnce).to.be.true;
+
+        // We deleted the first library, so it should be gone from the state.
+        expect(wrapper.state("libraries")).to.deep.equal([initialLibraries[1]]);
+      });
+
+      it("does not remove library if confirmation is canceled", () => {
         confirmStub.returns(false);
         wrapper.find("button.remove-btn").at(0).simulate("click");
+
+        // Ensure confirmation was sought.
+        expect(confirmStub.calledOnce).to.be.true;
+
         // We didn't delete, so we should still have the originals.
         expect(wrapper.state("libraries")).to.deep.equal(initialLibraries);
       });
 
-      it("deletes library if confirmation is accepted", () => {
-        confirmStub.returns(true);
+      it("uses library short_name in confirmation when full name is not available", () => {
+        const getLibraryStub = stub(instance, "getLibrary").returns(null);
+        confirmStub.returns(false);
+
         wrapper.find("button.remove-btn").at(0).simulate("click");
-        // We deleted the first library, so it should be gone from the state.
-        expect(wrapper.state("libraries")).to.deep.equal([initialLibraries[1]]);
+
+        expect(confirmStub.calledOnce).to.be.true;
+        const message: string = confirmStub.firstCall.args[0];
+        const libraryShortName = initialLibraries[0].short_name;
+        expect(message).to.equal(
+          `Disassociating library "${libraryShortName}" from this collection will ` +
+            "remove all loans and holds for its patrons. Do you wish to continue?"
+        );
+        getLibraryStub.restore();
       });
     });
   });