@lesterarte/sefin-ui 0.0.20-dev.13 → 0.0.20-dev.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lesterarte/sefin-ui",
-  "version": "0.0.20-dev.13",
+  "version": "0.0.20-dev.15",
   "description": "Sefin Design System - A comprehensive Angular UI library based on Atomic Design and design tokens",
   "keywords": [
     "angular",

package/types/lesterarte-sefin-ui.d.ts

@@ -1918,25 +1918,127 @@ declare class TableComponent implements OnInit, OnChanges {
     readonly totalColspan: i0.Signal<number>;
     readonly isAllSelected: i0.Signal<boolean>;
     readonly isIndeterminate: i0.Signal<boolean>;
+    readonly sortIcons: {
+        readonly unsorted: "M3 4.5L6 1.5L9 4.5M3 7.5L6 10.5L9 7.5";
+        readonly ascending: "M3 7.5L6 4.5L9 7.5";
+        readonly descending: "M3 4.5L6 7.5L9 4.5";
+    };
     constructor(cdr: ChangeDetectorRef);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
+    /**
+     * Validates component inputs and logs warnings for invalid configurations
+     * @private
+     */
+    private validateInputs;
     trackByFn(index: number, item: any): any;
+    /**
+     * Gets the cell value from a row, supporting nested property paths (e.g., 'user.name')
+     * @param row - The row data object
+     * @param column - The column definition
+     * @returns The cell value or undefined if not found
+     */
     getCellValue(row: any, column: TableColumn): any;
-    formatCellValue(value: any, type?: TableColumnType): string;
+    /**
+     * Formats a cell value based on its type
+     * @param value - The value to format
+     * @param type - The column type
+     * @param column - Optional column definition for additional formatting options
+     * @returns Formatted string representation
+     */
+    formatCellValue(value: any, type?: TableColumnType, column?: TableColumn): string;
+    /**
+     * Parses a value into a Date object
+     * @param value - The value to parse (Date, string, or number timestamp)
+     * @returns A Date object
+     */
     private parseDate;
     onRowClick(row: any): void;
-    onSort(column: TableColumn): void;
+    /**
+     * Handles column sorting when header is clicked
+     * @param column - The column to sort by
+     * @param event - Optional keyboard event for accessibility
+     */
+    onSort(column: TableColumn, event?: KeyboardEvent): void;
     onPageChange(page: number): void;
     isSelected(row: any): boolean;
+    /**
+     * Toggles the selection state of a row
+     * @param checked - Whether the row should be selected
+     * @param row - The row to toggle selection for
+     */
     toggleRowSelection(checked: boolean, row?: any): void;
+    /**
+     * Toggles selection for all rows on the current page
+     * @param checked - Whether all rows should be selected
+     */
     toggleSelectAll(checked: boolean): void;
+    /**
+     * Gets the unique identifier for an item using the trackByKey
+     * @param item - The item to get the ID for
+     * @returns The item's ID or the item itself if no ID property exists
+     * @private
+     */
     private getItemId;
+    /**
+     * Gets CSS classes for a column cell
+     * @param column - The column definition
+     * @returns Space-separated string of CSS classes
+     */
     getColumnClass(column: TableColumn): string;
+    /**
+     * Gets CSS classes for the table element
+     * @returns Space-separated string of CSS classes
+     */
     getTableClasses(): string;
+    /**
+     * Gets the width CSS value for a column
+     * @param column - The column definition
+     * @returns The width value or undefined
+     */
     getColumnWidth(column: TableColumn): string | undefined;
+    /**
+     * Gets the appropriate sort icon path for a column
+     * @param column - The column to get the icon for
+     * @returns The SVG path string for the sort icon
+     */
+    getSortIconPath(column: TableColumn): string;
+    /**
+     * Determines if a column should show the unsorted icon
+     * @param column - The column to check
+     * @returns True if unsorted icon should be shown
+     */
+    showUnsortedIcon(column: TableColumn): boolean;
+    /**
+     * Determines if a column should show the ascending icon
+     * @param column - The column to check
+     * @returns True if ascending icon should be shown
+     */
+    showAscendingIcon(column: TableColumn): boolean;
+    /**
+     * Determines if a column should show the descending icon
+     * @param column - The column to check
+     * @returns True if descending icon should be shown
+     */
+    showDescendingIcon(column: TableColumn): boolean;
+    /**
+     * Gets the ARIA sort state for a column
+     * @param column - The column to get the sort state for
+     * @returns The ARIA sort value ('ascending', 'descending', or 'none')
+     */
+    getAriaSort(column: TableColumn): string;
+    /**
+     * Gets the ARIA label for a sortable column header
+     * @param column - The column to get the label for
+     * @returns The ARIA label string or null if not sortable
+     */
+    getSortAriaLabel(column: TableColumn): string | null;
+    /**
+     * Generates page numbers array for pagination display
+     * This method is currently not used in the template but kept for potential future use
+     * @returns Array of page numbers and ellipsis strings
+     */
     getPageNumbers(): (number | string)[];
-    Math: Math;
     static ɵfac: i0.ɵɵFactoryDeclaration<TableComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<TableComponent, "sefin-table", never, { "columns": { "alias": "columns"; "required": false; }; "data": { "alias": "data"; "required": false; }; "trackByKey": { "alias": "trackByKey"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "emptyText": { "alias": "emptyText"; "required": false; }; "density": { "alias": "density"; "required": false; }; "striped": { "alias": "striped"; "required": false; }; "hover": { "alias": "hover"; "required": false; }; "selectable": { "alias": "selectable"; "required": false; }; "selectionMode": { "alias": "selectionMode"; "required": false; }; "pagination": { "alias": "pagination"; "required": false; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "total": { "alias": "total"; "required": false; }; "sort": { "alias": "sort"; "required": false; }; "serverSide": { "alias": "serverSide"; "required": false; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; }; "headerActionsTemplate": { "alias": "headerActionsTemplate"; "required": false; }; "emptyIconTemplate": { "alias": "emptyIconTemplate"; "required": false; }; }, { "rowClicked": "rowClicked"; "selectionChanged": "selectionChanged"; "pageChanged": "pageChanged"; "sortChanged": "sortChanged"; }, never, ["[actions]", "[actions]"], true, never>;
 }