feat(clerk): add clerk-facing Cheque Book screen and shell nav wiring

Adds a customer-account-scoped Cheque Book view under Clerk > Account
Facilities (list + leaf detail, with stop-payment/report-lost/mark-used/
return actions), reachable via a new hover dropdown on the Account
Facilities nav item. Also refreshes the Account Facilities page layout,
and carries over a few chequebook service/detail-dialog fixes from the
back-office module (used-leaf display, leaf-lookup dialog polish).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

src/app/chequebook/cheque-book-detail/cheque-book-detail.component.html

@@ -73,6 +73,9 @@
       <button mat-stroked-button color="primary" (click)="startAction('markused')">
         {{ 'labels.buttons.Mark as Used' | translate }}
       </button>
+      <button mat-stroked-button color="warn" (click)="startAction('return')">
+        {{ 'labels.buttons.Flag Returned' | translate }}
+      </button>
     </div>
   }
 
@@ -130,7 +133,9 @@
                   ? 'warn'
                   : l.status === 'LOST'
                     ? 'bad'
-                    : 'neutral'
+                    : l.status === 'RETURNED'
+                      ? 'returned'
+                      : 'neutral'
           "
           (click)="selectLeaf(l)"
         >

src/app/chequebook/cheque-book-detail/cheque-book-detail.component.scss

@@ -118,6 +118,10 @@ mat-form-field {
   &.neutral {
     color: #757575;
   }
+
+  &.returned {
+    color: #9333ea;
+  }
 }
 
 .empty-state {

src/app/chequebook/cheque-book-detail/cheque-book-detail.component.ts

@@ -21,13 +21,14 @@ import { STANDALONE_SHARED_IMPORTS } from 'app/standalone-shared.module';
 import { ChequeBookService } from '../chequebook.service';
 import { LeafDetailDialogComponent } from './leaf-detail-dialog/leaf-detail-dialog.component';
 
-type LeafAction = 'stoppayment' | 'revokestoppayment' | 'reportlost' | 'cancelleaf' | 'markused';
+type LeafAction = 'stoppayment' | 'revokestoppayment' | 'reportlost' | 'cancelleaf' | 'markused' | 'return';
 
 /**
- * One issued cheque book: its leaf register, and the five leaf-range actions (stop-payment, revoke,
- * report-lost, cancel-leaf, mark-used) — each defaults to the whole book when no range is given.
+ * One issued cheque book: its leaf register, and the six leaf-range actions (stop-payment, revoke,
+ * report-lost, cancel-leaf, mark-used, return) — each defaults to the whole book when no range is given.
  * "Mark as used" is a manual record (this CBS has no clearing/presentment integration to detect it itself)
- * — a branch sets it once it sees a leaf clear on the bank/clearing statement.
+ * — a branch sets it once it sees a leaf clear on the bank/clearing statement. "Return" flags a leaf as
+ * presented-and-dishonoured (insufficient funds, signature mismatch, etc.) — terminal, like report-lost.
  */
 @Component({
   selector: 'mifosx-cheque-book-detail',
@@ -112,7 +113,8 @@ export class ChequeBookDetailComponent implements OnInit {
       revokestoppayment: (id, p) => this.chequeBookService.revokeStopPayment(id, p),
       reportlost: (id, p) => this.chequeBookService.reportBookLost(id, p),
       cancelleaf: (id, p) => this.chequeBookService.cancelLeaf(id, p),
-      markused: (id, p) => this.chequeBookService.markUsed(id, p)
+      markused: (id, p) => this.chequeBookService.markUsed(id, p),
+      return: (id, p) => this.chequeBookService.returnBook(id, p)
     };
     const call = actionCalls[this.activeAction](this.bookId, payload);
 

src/app/chequebook/cheque-book-detail/leaf-detail-dialog/leaf-detail-dialog.component.html

@@ -18,7 +18,9 @@
             ? 'warn'
             : data.status === 'LOST'
               ? 'bad'
-              : 'neutral'
+              : data.status === 'RETURNED'
+                ? 'returned'
+                : 'neutral'
     "
     >{{ data.leafSerialNo }}</span
   >
@@ -57,6 +59,12 @@
         ><span>{{ data.usedReason }}</span>
       </div>
     }
+    @if (data.returnReason) {
+      <div>
+        <span class="k">{{ 'labels.inputs.Return Reason' | translate }}</span
+        ><span>{{ data.returnReason }}</span>
+      </div>
+    }
   </div>
 </div>
 <mat-dialog-actions align="end">

src/app/chequebook/chequebook.service.ts

@@ -166,6 +166,11 @@ export class ChequeBookService {
     return this.http.post(`/chequebooks/${bookId}`, payload, { params: new HttpParams().set('command', 'markused') });
   }
 
+  /** Flag leaves as returned/dishonoured (insufficient funds, signature mismatch, etc.) — terminal, like reportlost. */
+  returnBook(bookId: string | number, payload: any): Observable<any> {
+    return this.http.post(`/chequebooks/${bookId}`, payload, { params: new HttpParams().set('command', 'return') });
+  }
+
   // ----- Pending requests (bespoke maker-checker for series/stock/book creation) -----
 
   /**

src/app/chequebook/leaf-lookup/leaf-lookup.component.html

@@ -53,7 +53,9 @@
                     ? 'warn'
                     : result.status === 'LOST'
                       ? 'bad'
-                      : 'neutral'
+                      : result.status === 'RETURNED'
+                        ? 'returned'
+                        : 'neutral'
             "
             >{{ result.status }}</span
           >
@@ -117,6 +119,12 @@
               ><span>{{ result.usedReason }}</span>
             </div>
           }
+          @if (result.status === 'RETURNED') {
+            <div>
+              <span class="k">{{ 'labels.inputs.Return Reason' | translate }}</span
+              ><span>{{ result.returnReason }}</span>
+            </div>
+          }
         </div>
       </mat-card-content>
     </mat-card>

src/app/chequebook/leaf-lookup/leaf-lookup.component.scss

@@ -116,6 +116,11 @@
     background: #e0e0e0;
     color: #757575;
   }
+
+  &.returned {
+    background: #f3e8fd;
+    color: #9333ea;
+  }
 }
 
 .empty-state {