@kodaris/krubble-components 1.0.8 → 1.0.10

package/dist/table/table.d.ts

@@ -0,0 +1,253 @@
+import { LitElement, TemplateResult } from 'lit';
+import '../button/button.js';
+export interface KRSolrSort {
+    sortBy: string;
+    sortDirection: 'asc' | 'desc';
+}
+export interface KRSolrFilter {
+    name: string;
+    compare?: string;
+    value?: string;
+    values?: string[];
+    boost?: number;
+    fuzzy?: number;
+    operation: 'EXPRESSION' | 'AND' | 'OR' | string;
+    not?: boolean;
+    tagged?: boolean;
+    and?: boolean;
+}
+export interface KRSolrFacet {
+    name: string;
+    limit?: number;
+    sort?: 'count' | 'index';
+    offset?: number;
+    minimumCount?: number;
+    start?: string;
+    end?: string;
+    gap?: string;
+    hardened?: string;
+    include?: string;
+    other?: string;
+    missing?: boolean;
+    type?: 'FIELD' | 'RANGE' | 'QUERY';
+    contains?: string;
+}
+export interface KRSolrRequest {
+    page: number;
+    size: number;
+    sorts?: KRSolrSort[];
+    filterFields?: KRSolrFilter[];
+    queryFields?: KRSolrFilter[];
+    facetFields?: KRSolrFacet[];
+}
+export interface KRSolrResponse {
+    success: boolean;
+    code: number;
+    messages?: string[];
+    errors?: string[];
+    data: {
+        size: number;
+        number: number;
+        totalElements: number;
+        totalPages: number;
+        isLast: boolean;
+        isFirst: boolean;
+        hasPrevious: boolean;
+        hasNext: boolean;
+        numberOfElements: number;
+        offset: number;
+        content: Record<string, any>[];
+    };
+}
+export type KRTableDataSourceMode = 'solr' | 'db' | 'opensearch';
+/** Configuration for the table's data source. */
+export interface KRTableDataSource {
+    /** Data source mode (solr, db, or opensearch) */
+    mode?: KRTableDataSourceMode;
+    /** Function to fetch data from the server */
+    fetch: (params: any) => Promise<any>;
+    /** Function to create a new row */
+    create?: (row: Record<string, any>) => Promise<Record<string, any>>;
+    /** Function to update an existing row */
+    update?: (row: Record<string, any>) => Promise<Record<string, any>>;
+    /** Function to delete a row */
+    delete?: (row: Record<string, any>) => Promise<void>;
+}
+/** Configuration for a table column. */
+export interface KRTableColumn {
+    /** Unique column identifier */
+    id: string;
+    /** Column header text */
+    label?: string;
+    /** Column width (e.g., '150px', '20%') */
+    width?: string;
+    /** Minimum column width */
+    minWidth?: string;
+    /** Sticky position for horizontal scrolling */
+    sticky?: 'left' | 'right';
+    /** Whether the column is sortable */
+    sortable?: boolean;
+    /** Whether the column is included in search */
+    searchable?: boolean;
+    /** Cell content alignment */
+    align?: 'left' | 'center' | 'right';
+    /** Data type for automatic formatting */
+    type?: 'text' | 'number' | 'date' | 'currency' | 'boolean';
+    /** Custom render function for cell content */
+    render?: (row: any) => TemplateResult;
+}
+/** Configuration for a table action button. */
+export interface KRTableAction {
+    /** Unique action identifier */
+    id: string;
+    /** Action button label */
+    label: string;
+}
+/** Main configuration object for the table component. */
+export interface KRTableDef {
+    /** Table title displayed in the header */
+    title?: string;
+    /** Action buttons in the header dropdown */
+    actions?: KRTableAction[];
+    /** Column definitions (required) */
+    columns: KRTableColumn[];
+    /** Column IDs to display initially */
+    displayedColumns?: string[];
+    /** Static data array (alternative to dataSource) */
+    data?: Record<string, any>[];
+    /** Data source configuration for server-side data */
+    dataSource?: KRTableDataSource;
+    /** Auto-refresh interval in milliseconds */
+    refreshInterval?: number;
+    /** Number of rows per page */
+    pageSize?: number;
+}
+export declare class KRTable extends LitElement {
+    static styles: import("lit").CSSResult[];
+    /**
+     * Internal flag to switch between scroll edge modes:
+     * - 'overlay': Fixed padding with overlay elements that hide content at edges (scrollbar at viewport edge)
+     * - 'edge': Padding scrolls with content, allowing table to reach edges when scrolling
+     */
+    private _scrollStyle;
+    private _refreshTimer?;
+    private _data;
+    private _dataState;
+    private _page;
+    private _pageSize;
+    private _totalItems;
+    private _totalPages;
+    private _searchQuery;
+    private _canScrollLeft;
+    private _canScrollRight;
+    private _canScrollHorizontal;
+    private _columnPickerOpen;
+    private _displayedColumns;
+    private _columnWidths;
+    private _resizing;
+    private _resizeObserver;
+    private _searchPositionLocked;
+    def: KRTableDef;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    updated(changedProperties: Map<string, unknown>): void;
+    refresh(): void;
+    goToPrevPage(): void;
+    goToNextPage(): void;
+    goToPage(page: number): void;
+    /**
+     * Fetches data from the API and updates the table.
+     * Shows a loading spinner while fetching, then displays rows on success
+     * or an error snackbar on failure.
+     * Request/response format depends on dataSource.mode (solr, opensearch, db).
+     */
+    private _fetch;
+    /**
+     * Sets up auto-refresh so the table automatically fetches fresh data
+     * at a regular interval (useful for dashboards, monitoring views).
+     * Configured via def.refreshInterval in milliseconds.
+     */
+    private _initRefresh;
+    private _handleSearch;
+    /**
+     * Updates search position to be centered with equal gaps from title and tools.
+     * On first call: resets to flex centering, measures position, then locks with fixed margin.
+     * Subsequent calls are ignored unless _searchPositionLocked is reset (e.g., on resize).
+     */
+    private _updateSearchPosition;
+    private _toggleColumnPicker;
+    private _toggleColumn;
+    private _handleClickOutsideColumnPicker;
+    getDisplayedColumns(): KRTableColumn[];
+    /**
+     * Scroll event handler that updates scroll flags in real-time as user scrolls.
+     * Updates shadow indicators to show if more content exists left/right.
+     */
+    private _handleScroll;
+    /**
+     * Updates scroll state flags for the table content container.
+     * - _canScrollLeft: true if scrolled right (can scroll back left)
+     * - _canScrollRight: true if more content exists to the right
+     * - _canScrollHorizontal: true if content is wider than container
+     * These flags control scroll shadow indicators and CSS classes.
+     */
+    private _updateScrollFlags;
+    private _handleResizeStart;
+    private _handleResizeMove;
+    private _handleResizeEnd;
+    private _handleAction;
+    private _renderCellContent;
+    /**
+     * Returns CSS classes for a header cell based on column config.
+     */
+    private _getHeaderCellClasses;
+    /**
+     * Returns CSS classes for a table cell based on column config:
+     * - Alignment (center, right)
+     * - Sticky positioning (left, right)
+     * - Border classes for the last left-sticky or first right-sticky column
+     */
+    private _getCellClasses;
+    /**
+     * Returns inline styles for a table cell:
+     * - Width (from column config or default 150px)
+     * - Min-width (if specified)
+     * - Left/right offset for sticky columns (calculated from widths of preceding sticky columns)
+     */
+    private _getCellStyle;
+    /**
+     * Renders the pagination controls:
+     * - Previous page arrow (disabled on first page)
+     * - Range text showing "1-50 of 150" format
+     * - Next page arrow (disabled on last page)
+     *
+     * Hidden when there's no data or all data fits on one page.
+     */
+    private _renderPagination;
+    /**
+     * Renders the header toolbar containing:
+     * - Title (left)
+     * - Search bar with view selector dropdown (center)
+     * - Tools (right): page navigation, refresh button, column visibility picker, actions dropdown
+     *
+     * Hidden when there's no title, no actions, and data fits on one page.
+     */
+    private _renderHeader;
+    /** Renders status message (loading, error, empty) */
+    private _renderStatus;
+    /** Renders the scrollable data grid with column headers and rows. */
+    private _renderTable;
+    /**
+     * Renders a data table with:
+     * - Header bar with title, search input with view selector, and tools (pagination, refresh, column visibility, actions dropdown)
+     * - Scrollable grid with sticky header row and optional sticky left/right columns
+     * - Loading, error message, or empty state when no data
+     */
+    render(): TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'kr-table': KRTable;
+    }
+}
+//# sourceMappingURL=table.d.ts.map

package/dist/table/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/table/table.ts"],"names":[],"mappings":"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"}