cat-documents-ng 0.2.94 → 0.2.96

package/lib/document/components/document-container/document-container.component.d.ts

@@ -1,5 +1,4 @@
-import { OnInit, OnDestroy, OnChanges, SimpleChanges } from '@angular/core';
-import { DocumentService } from '../../state/document.service';
+import { OnInit, OnDestroy, OnChanges, SimpleChanges, ElementRef } from '@angular/core';
 import { Subscription } from 'rxjs';
 import { DocumentHttpService } from '../../services/document-http.service';
 import { DocumentQuery } from '../../state/document.query';
@@ -16,19 +15,49 @@ import * as i0 from "@angular/core";
  * @typedef {DocumentContainerComponent}
  */
 export declare class DocumentContainerComponent implements OnInit, OnDestroy, OnChanges {
-    documentStore: DocumentStore;
-    documentService: DocumentService;
-    documentQuery: DocumentQuery;
-    documentHttpService: DocumentHttpService;
-    documentHelperService: DocumentHelperService;
+    private documentHttpService;
+    private documentHelperService;
+    private documentQuery;
+    private documentStore;
+    /**
+     * The document list response data
+     * @type {DocumentListResponse[] | null}
+     */
+    documentListResponse: DocumentListResponse[] | null;
+    /**
+     * Status data for the current selection
+     * @type {StatusDataModel[]}
+     */
+    statusData: StatusDataModel[];
+    /**
+     * The currently selected menu item ID for scrolling
+     */
+    selectedMenuItemId: string | null;
+    /**
+     * Additional navigation information for better scrolling
+     */
+    navigationInfo: {
+        menuItemId: string;
+        menuItemLabel: string;
+        categoryLabel: string;
+        categoryIndex: number;
+    } | null;
+    /**
+     * Reference to the content scroll container
+     */
+    contentScrollContainer: ElementRef;
+    /**
+     * Subscription to track selected menu item changes
+     */
+    private selectedMenuItemSubscription;
     /**
      * Creates an instance of DocumentContainerComponent.
-     * @param {DocumentStore} documentStore - Query Store service to manage store document-related state.
-     * @param {DocumentService} documentService - Service to manage document-related operations.
-     * @param {DocumentQuery} documentQuery - Query service to manage document-related state.
-     * @param {DocumentHttpService} documentHttpService - Service to make HTTP requests related to documents.
+     * @param {DocumentHttpService} documentHttpService - Service for HTTP operations
+     * @param {DocumentHelperService} documentHelperService - Service for document operations
+     * @param {DocumentQuery} documentQuery - Query service for document state
+     * @param {DocumentStore} documentStore - Store service for document state
      */
-    constructor(documentStore: DocumentStore, documentService: DocumentService, documentQuery: DocumentQuery, documentHttpService: DocumentHttpService, documentHelperService: DocumentHelperService);
+    constructor(documentHttpService: DocumentHttpService, documentHelperService: DocumentHelperService, documentQuery: DocumentQuery, documentStore: DocumentStore);
     /**
      * Get contextId in input.
      * @type {string}
@@ -41,19 +70,8 @@ export declare class DocumentContainerComponent implements OnInit, OnDestroy, On
     applicationNumber: string;
     catagories: DocumentCategory[];
     userList: UserListModel[];
-    /**
-     * Status data for the current selection
-     * @type {StatusDataModel[]}
-     */
-    statusData: StatusDataModel[];
-    /**
-     * Document list response from API
-     * @type {DocumentListResponse | null}
-     */
-    documentListResponse: DocumentListResponse[] | null;
     /**
      * Holds the subscription to manage observable cleanup.
-     * @
      * @type {Subscription}
      */
     subscription: Subscription;
@@ -62,10 +80,31 @@ export declare class DocumentContainerComponent implements OnInit, OnDestroy, On
      */
     ngOnChanges(changes: SimpleChanges): void;
     /**
-     * Fetches the folder and document data on initialization.
-     * @returns {void}
+     * Initializes the component
      */
     ngOnInit(): void;
+    /**
+     * Sets up subscription to track selected menu item changes
+     */
+    setupSelectedMenuItemSubscription(): void;
+    /**
+     * Handles menu item selection events from the documents menu
+     * @param event - The menu item selection event
+     */
+    onMenuItemSelected(event: {
+        item: any;
+        category: any;
+        navigationInfo?: {
+            menuItemId: string;
+            menuItemLabel: string;
+            categoryLabel: string;
+            categoryIndex: number;
+        };
+    }): void;
+    /**
+     * Resets the content scroll container to the top
+     */
+    private resetContentScrollToTop;
     /**
      * Initialize all data with proper sequencing to avoid duplicate API calls
      */

package/lib/document/components/document-list/document-list.component.d.ts

@@ -1,4 +1,4 @@
-import { OnInit, OnDestroy, OnChanges, SimpleChanges } from '@angular/core';
+import { OnInit, OnDestroy, OnChanges, SimpleChanges, ElementRef, AfterViewInit } from '@angular/core';
 import { DocumentListItem, DocumentListResponse } from '../../models/document-list-response.model';
 import { TableData } from '../../../../Shared/components/table-primary/table-primary.model';
 import { DocumentListService } from '../../services/document-list.service';
@@ -9,7 +9,7 @@ import * as i0 from "@angular/core";
  * Provides functionality for file upload, document selection, and dialog management.
  * @class DocumentListComponent
  */
-export declare class DocumentListComponent implements OnInit, OnDestroy, OnChanges {
+export declare class DocumentListComponent implements OnInit, OnDestroy, OnChanges, AfterViewInit {
     private documentListService;
     /**
      * Represents the context ID for the document list.
@@ -24,6 +24,27 @@ export declare class DocumentListComponent implements OnInit, OnDestroy, OnChang
      * @memberof DocumentListComponent
      */
     documentListResponse: DocumentListResponse[] | null;
+    /**
+     * The selected menu item ID for scrolling to specific sections
+     * @type {string | null}
+     * @memberof DocumentListComponent
+     */
+    selectedMenuItemId: string | null;
+    /**
+     * Additional navigation information for precise scrolling
+     * @type {object | null}
+     * @memberof DocumentListComponent
+     */
+    navigationInfo: {
+        menuItemId: string;
+        menuItemLabel: string;
+        categoryLabel: string;
+        categoryIndex: number;
+    } | null;
+    /**
+     * Reference to the document categories container for scrolling
+     */
+    documentCategoriesContainer: ElementRef;
     /**
      * Subscription to document list response from store
      */
@@ -108,6 +129,10 @@ export declare class DocumentListComponent implements OnInit, OnDestroy, OnChang
      * Initializes the component by setting up document list subscription.
      */
     ngOnInit(): void;
+    /**
+     * Called after the view is initialized
+     */
+    ngAfterViewInit(): void;
     /**
      * Handles the visibility of the sidebar.
      * @param {boolean} isVisible - Indicates whether the sidebar should be visible or not.
@@ -140,10 +165,31 @@ export declare class DocumentListComponent implements OnInit, OnDestroy, OnChang
      * @param {boolean} isDeleteAction - Optional flag indicating if this refresh is due to a delete action
      */
     refreshDocumentList(isDeleteAction?: boolean): void;
+    /**
+     * Scrolls to the category section that matches the selected menu item
+     * @param menuItemId - The ID of the selected menu item
+     */
+    scrollToCategorySection(menuItemId: string): void;
+    /**
+     * Scrolls to the category section using navigationInfo
+     * @param navigationInfo - The navigation info object containing menuItemId
+     */
+    private scrollToCategorySectionWithNavigationInfo;
+    /**
+     * Adds a temporary highlight effect to the scrolled category
+     * @param categoryElement - The DOM element of the category to highlight
+     */
+    private highlightCategory;
+    /**
+     * Alternative scrolling method using IntersectionObserver for better performance
+     * This method can be used as a fallback or alternative to the current approach
+     * @param navigationInfo - The navigation info object
+     */
+    private scrollToCategorySectionWithIntersectionObserver;
     /**
      * Cleanup subscriptions on component destroy
      */
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<DocumentListComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DocumentListComponent, "lib-document-list", never, { "contextId": { "alias": "contextId"; "required": false; }; "documentListResponse": { "alias": "documentListResponse"; "required": false; }; "documentList": { "alias": "documentList"; "required": false; }; }, {}, never, ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DocumentListComponent, "lib-document-list", never, { "contextId": { "alias": "contextId"; "required": false; }; "documentListResponse": { "alias": "documentListResponse"; "required": false; }; "selectedMenuItemId": { "alias": "selectedMenuItemId"; "required": false; }; "navigationInfo": { "alias": "navigationInfo"; "required": false; }; "documentList": { "alias": "documentList"; "required": false; }; }, {}, never, ["*"], false, never>;
 }

package/lib/document/components/documents-menu/documents-menu.component.d.ts

@@ -1,4 +1,4 @@
-import { OnInit, OnChanges, SimpleChanges } from '@angular/core';
+import { OnInit, OnChanges, SimpleChanges, EventEmitter } from '@angular/core';
 import { DocumentStore } from '../../state/document.store';
 import { DocumentQuery } from '../../state/document.query';
 import { DocumentCategory, DocumentCategoryItem } from '../../models/document-category.model';
@@ -13,6 +13,16 @@ export declare class DocumentsMenuComponent implements OnInit, OnChanges {
     catagories: DocumentCategory[];
     applicationNumber: string;
     contextId: string;
+    menuItemSelected: EventEmitter<{
+        item: DocumentCategoryItem;
+        category: DocumentCategory;
+        navigationInfo?: {
+            menuItemId: string;
+            menuItemLabel: string;
+            categoryLabel: string;
+            categoryIndex: number;
+        };
+    }>;
     selectedMenuItem: string | null;
     selectedMenuItemId: string | null;
     private storeCategories;
@@ -41,20 +51,22 @@ export declare class DocumentsMenuComponent implements OnInit, OnChanges {
      * @returns The label of the menu item or null if not found
      */
     private findMenuItemLabelById;
+    /**
+     * Finds the category for a menu item by its _id
+     * @param id The _id to search for
+     * @returns The category or null if not found
+     */
+    private findMenuItemCategoryById;
     /**
      * Update menu use catagories
      */
     private updateMenuItemsData;
     /**
-     * Handle the menu item click
+     * Handle the menu item click for navigation
      * @param {*} event - Event
      * @param {DocumentCategoryItem} item - catagory item
      */
     onMenuItemClick(event: any, item: DocumentCategoryItem): void;
-    /**
-     * Handle deselection to ensure immediate visual feedback
-     */
-    private handleDeselection;
     /**
      * Handle the menu item selection
      * @param {string} menuItemId - The ID of the menu item to select
@@ -70,7 +82,7 @@ export declare class DocumentsMenuComponent implements OnInit, OnChanges {
      */
     getSelectedMenuItem(): string | null;
     /**
-     * Handles contextId changes by clearing current selection and refreshing data
+     * Handles contextId changes by clearing current selection
      */
     private handleContextIdChange;
     /**
@@ -79,5 +91,5 @@ export declare class DocumentsMenuComponent implements OnInit, OnChanges {
      */
     getSelectedMenuItemId(): string | null;
     static ɵfac: i0.ɵɵFactoryDeclaration<DocumentsMenuComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DocumentsMenuComponent, "lib-documents-menu", never, { "catagories": { "alias": "catagories"; "required": false; }; "applicationNumber": { "alias": "applicationNumber"; "required": false; }; "contextId": { "alias": "contextId"; "required": false; }; }, {}, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DocumentsMenuComponent, "lib-documents-menu", never, { "catagories": { "alias": "catagories"; "required": false; }; "applicationNumber": { "alias": "applicationNumber"; "required": false; }; "contextId": { "alias": "contextId"; "required": false; }; }, { "menuItemSelected": "menuItemSelected"; }, never, never, false, never>;
 }

package/lib/document/services/document-http.service.d.ts

@@ -89,10 +89,11 @@ export declare class DocumentHttpService {
      */
     getStatusDocumentCount(applicationId: string, contextId?: string | null, categoryId?: string | null): Observable<StatusDataModel[]>;
     /**
-     * Fetches documents based on selection criteria (menu item, user ID, status, and search key).
+     * Fetches documents based on selection criteria (user ID, status, and search key).
      * This method sends an HTTP GET request with query parameters for the selected filters.
+     * Note: Menu item filtering has been removed - menu items are now used for navigation only.
      * @param {string} contextId - The context ID (applicationId or applicantId).
-     * @param {string | null} menuItem - The selected menu item filter.
+     * @param {string | null} menuItem - Reserved parameter (no longer used for filtering).
      * @param {string | null} userId - The selected user ID filter.
      * @param {string | null} status - The selected status filter.
      * @param {string | null} searchKey - The search key filter.

package/lib/document/services/document.service.d.ts

@@ -135,15 +135,15 @@ export declare class DocumentHelperService {
      *
      * This method ensures that after a document action (accept/reject/delete):
      * 1. Document categories are refreshed
-     * 2. Status counts are refreshed with current menu item and user filters
+     * 2. Status counts are refreshed with current user filters
      * 3. User list is refreshed with current filters (if applicable)
-     * 4. Document list is refreshed with all current filters (menu item, user, status, search)
+     * 4. Document list is refreshed with current filters (user, status, search)
      *
      * Filter application:
      * - Document categories: Uses base contextId
-     * - Status data: Uses userId as contextId and menuItem as categoryId
+     * - Status data: Uses userId as contextId (no category filtering)
      * - User list: Uses base contextId (can be enhanced with additional filters if API supports)
-     * - Document list: Uses all current filters (menuItem, userId, status, searchKey)
+     * - Document list: Uses current filters (userId, status, searchKey)
      *
      * @param contextId - The context ID to use for the API calls
      */

package/lib/document/services/user-list.service.d.ts

@@ -11,13 +11,6 @@ export declare class UserListService {
     getColorByIndex(index: number): string;
     getColorValue(colorName: string): string;
     processUserData(userList: UserListModel[]): UserListModel[];
-    /**
-     * Finds the selected menu item from categories
-     * @param selectedMenuItemId - The ID of the selected menu item
-     * @param categories - The document categories
-     * @returns The selected menu item or null
-     */
-    private findSelectedMenuItem;
     /**
      * Filters user list based on selected menu item category
      * @param userList - The complete user list

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cat-documents-ng",
-  "version": "0.2.94",
+  "version": "0.2.96",
   "peerDependencies": {
     "@angular/common": "^19.0.0",
     "@angular/core": "^19.0.0"