@memberjunction/ng-entity-viewer 0.0.1 → 2.122.0

package/dist/lib/types.d.ts

@@ -0,0 +1,316 @@
+import { EntityInfo, CompositeKey } from '@memberjunction/core';
+import { BaseEntity } from '@memberjunction/core';
+/**
+ * View modes supported by the EntityViewer component
+ */
+export type EntityViewMode = 'grid' | 'cards';
+/**
+ * Behavior when a record is selected
+ */
+export type RecordSelectionBehavior = 'emit-only' | 'show-detail' | 'emit-and-detail';
+/**
+ * Field display type for smart rendering in cards
+ */
+export type CardFieldType = 'number' | 'boolean' | 'text' | 'date';
+/**
+ * Color categories for status pills based on semantic meaning
+ */
+export type PillColorType = 'success' | 'warning' | 'danger' | 'info' | 'neutral';
+/**
+ * Metadata for a field to display in a card
+ */
+export interface CardDisplayField {
+    /** Field name from the entity */
+    name: string;
+    /** Display type for rendering */
+    type: CardFieldType;
+    /** Human-readable label */
+    label: string;
+}
+/**
+ * Auto-generated card template based on entity metadata
+ */
+export interface CardTemplate {
+    /** Primary title field name */
+    titleField: string;
+    /** Secondary subtitle field name */
+    subtitleField: string | null;
+    /** Description/notes field name */
+    descriptionField: string | null;
+    /** Display fields with type information for smart rendering */
+    displayFields: CardDisplayField[];
+    /**
+     * Array of thumbnail field names in priority order
+     * Per-record fallback: if the first field is empty, try the next, etc.
+     */
+    thumbnailFields: string[];
+    /** Badge/priority field name */
+    badgeField: string | null;
+}
+/**
+ * Column definition for the grid view
+ */
+export interface GridColumnDef {
+    /** Field name from the entity */
+    field: string;
+    /** Column header text */
+    headerName: string;
+    /** Column width in pixels */
+    width?: number;
+    /** Minimum column width */
+    minWidth?: number;
+    /** Maximum column width */
+    maxWidth?: number;
+    /** Whether column is sortable */
+    sortable?: boolean;
+    /** Whether column is filterable */
+    filter?: boolean;
+    /** Whether column is resizable */
+    resizable?: boolean;
+    /** Whether to hide this column */
+    hide?: boolean;
+    /** Custom cell renderer type */
+    cellRenderer?: string;
+    /** Value formatter function name */
+    valueFormatter?: string;
+}
+/**
+ * Event emitted when a record is selected (clicked)
+ */
+export interface RecordSelectedEvent {
+    /** The selected entity record */
+    record: BaseEntity;
+    /** The entity metadata */
+    entity: EntityInfo;
+    /** The composite key of the record */
+    compositeKey: CompositeKey;
+}
+/**
+ * Event emitted when a record should be opened (double-click or open button)
+ */
+export interface RecordOpenedEvent {
+    /** The entity record to open */
+    record: BaseEntity;
+    /** The entity metadata */
+    entity: EntityInfo;
+    /** The composite key of the record */
+    compositeKey: CompositeKey;
+}
+/**
+ * Event emitted when data is loaded
+ */
+export interface DataLoadedEvent {
+    /** Total number of records available */
+    totalRowCount: number;
+    /** Number of records currently loaded */
+    loadedRowCount: number;
+    /** Time taken to load in milliseconds */
+    loadTime: number;
+    /** The loaded records - allows parent to access records for state restoration */
+    records: BaseEntity[];
+}
+/**
+ * Event emitted when filtered count changes
+ */
+export interface FilteredCountChangedEvent {
+    /** Number of records after filtering */
+    filteredCount: number;
+    /** Total number of records before filtering */
+    totalCount: number;
+}
+/**
+ * Sort direction for server-side sorting
+ */
+export type SortDirection = 'asc' | 'desc' | null;
+/**
+ * Sort state for a column
+ */
+export interface SortState {
+    /** Field name to sort by */
+    field: string;
+    /** Sort direction */
+    direction: SortDirection;
+}
+/**
+ * Event emitted when sort changes in the grid
+ */
+export interface SortChangedEvent {
+    /** The new sort state (null if no sorting) */
+    sort: SortState | null;
+}
+/**
+ * Pagination state for server-side paging
+ */
+export interface PaginationState {
+    /** Current page number (0-based) */
+    currentPage: number;
+    /** Number of records per page */
+    pageSize: number;
+    /** Total number of records available (from server) */
+    totalRecords: number;
+    /** Whether there are more records to load */
+    hasMore: boolean;
+    /** Whether data is currently being loaded */
+    isLoading: boolean;
+}
+/**
+ * Event emitted when pagination changes
+ */
+export interface PaginationChangedEvent {
+    /** The new pagination state */
+    pagination: PaginationState;
+}
+/**
+ * Event emitted when requesting to load more data
+ */
+export interface LoadMoreEvent {
+    /** Current page being requested (0-based) */
+    page: number;
+    /** Page size */
+    pageSize: number;
+}
+/**
+ * Column configuration from a User View's GridState
+ * Matches the format stored in UserView.GridState JSON
+ */
+export interface ViewColumnConfig {
+    /** Entity field ID */
+    ID?: string;
+    /** Field name */
+    Name: string;
+    /** Display name for column header */
+    DisplayName?: string;
+    /** Whether the column is hidden */
+    hidden?: boolean;
+    /** Column width in pixels */
+    width?: number;
+    /** Column order index */
+    orderIndex?: number;
+}
+/**
+ * Sort configuration from a User View's GridState
+ * Matches the format stored in UserView.GridState.sortSettings
+ */
+export interface ViewSortConfig {
+    /** Field name to sort by */
+    field: string;
+    /** Sort direction - 'asc' or 'desc' */
+    dir: 'asc' | 'desc';
+}
+/**
+ * Grid state configuration from a User View
+ * Matches the JSON structure stored in UserView.GridState
+ */
+export interface ViewGridStateConfig {
+    /** Column visibility, width, and order settings */
+    columnSettings?: ViewColumnConfig[];
+    /** Sort settings */
+    sortSettings?: ViewSortConfig[];
+    /** Filter settings (Kendo format) */
+    filter?: object;
+}
+/**
+ * Event emitted when grid state changes (column resize, reorder, etc.)
+ */
+export interface GridStateChangedEvent {
+    /** The updated grid state */
+    gridState: ViewGridStateConfig;
+    /** What changed: 'columns', 'sort', 'filter' */
+    changeType: 'columns' | 'sort' | 'filter';
+}
+/**
+ * Configuration options for the EntityViewer component
+ */
+export interface EntityViewerConfig {
+    /**
+     * Whether to show the filter input box
+     * @default true
+     */
+    showFilter?: boolean;
+    /**
+     * Whether to show the view mode toggle (grid/cards)
+     * @default true
+     */
+    showViewModeToggle?: boolean;
+    /**
+     * Behavior when a record is selected
+     * @default 'emit-only'
+     */
+    selectionBehavior?: RecordSelectionBehavior;
+    /**
+     * Initial view mode
+     * @default 'grid'
+     */
+    defaultViewMode?: EntityViewMode;
+    /**
+     * Whether to enable multi-select
+     * @default false
+     */
+    enableMultiSelect?: boolean;
+    /**
+     * Maximum number of records to load per page
+     * @default 100
+     */
+    pageSize?: number;
+    /**
+     * Whether to show record count in header
+     * @default true
+     */
+    showRecordCount?: boolean;
+    /**
+     * Placeholder text for the filter input
+     * @default 'Filter records...'
+     */
+    filterPlaceholder?: string;
+    /**
+     * Debounce time for filter input in milliseconds
+     * @default 250
+     */
+    filterDebounceMs?: number;
+    /**
+     * Custom grid column definitions (optional - auto-generated if not provided)
+     */
+    gridColumns?: GridColumnDef[];
+    /**
+     * Custom card template (optional - auto-generated if not provided)
+     */
+    cardTemplate?: CardTemplate;
+    /**
+     * Height of the component (CSS value)
+     * @default '100%'
+     */
+    height?: string;
+    /**
+     * Whether to use server-side filtering via UserSearchString
+     * When true, filter text is sent to the server for SQL-based filtering
+     * When false, filtering is done client-side on loaded records
+     * @default true
+     */
+    serverSideFiltering?: boolean;
+    /**
+     * Whether to use server-side sorting via OrderBy
+     * When true, sort changes trigger a new server request
+     * When false, sorting is done client-side by AG Grid
+     * @default true
+     */
+    serverSideSorting?: boolean;
+    /**
+     * Whether to show pagination controls
+     * @default true
+     */
+    showPagination?: boolean;
+    /**
+     * Default sort field when loading data
+     */
+    defaultSortField?: string;
+    /**
+     * Default sort direction when loading data
+     * @default 'asc'
+     */
+    defaultSortDirection?: SortDirection;
+}
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_VIEWER_CONFIG: Required<EntityViewerConfig>;
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

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

package/dist/lib/types.js

@@ -0,0 +1,30 @@
+/**
+ * Default configuration values
+ */
+export const DEFAULT_VIEWER_CONFIG = {
+    showFilter: true,
+    showViewModeToggle: true,
+    selectionBehavior: 'emit-only',
+    defaultViewMode: 'grid',
+    enableMultiSelect: false,
+    pageSize: 100,
+    showRecordCount: true,
+    filterPlaceholder: 'Filter records...',
+    filterDebounceMs: 250,
+    gridColumns: [],
+    cardTemplate: {
+        titleField: '',
+        subtitleField: null,
+        descriptionField: null,
+        displayFields: [],
+        thumbnailFields: [],
+        badgeField: null
+    },
+    height: '100%',
+    serverSideFiltering: true,
+    serverSideSorting: true,
+    showPagination: true,
+    defaultSortField: '',
+    defaultSortDirection: 'asc'
+};
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAiWA;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAiC;IACjE,UAAU,EAAE,IAAI;IAChB,kBAAkB,EAAE,IAAI;IACxB,iBAAiB,EAAE,WAAW;IAC9B,eAAe,EAAE,MAAM;IACvB,iBAAiB,EAAE,KAAK;IACxB,QAAQ,EAAE,GAAG;IACb,eAAe,EAAE,IAAI;IACrB,iBAAiB,EAAE,mBAAmB;IACtC,gBAAgB,EAAE,GAAG;IACrB,WAAW,EAAE,EAAE;IACf,YAAY,EAAE;QACZ,UAAU,EAAE,EAAE;QACd,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,IAAI;QACtB,aAAa,EAAE,EAAE;QACjB,eAAe,EAAE,EAAE;QACnB,UAAU,EAAE,IAAI;KACjB;IACD,MAAM,EAAE,MAAM;IACd,mBAAmB,EAAE,IAAI;IACzB,iBAAiB,EAAE,IAAI;IACvB,cAAc,EAAE,IAAI;IACpB,gBAAgB,EAAE,EAAE;IACpB,oBAAoB,EAAE,KAAK;CAC5B,CAAC"}

package/dist/lib/utils/highlight.util.d.ts

@@ -0,0 +1,69 @@
+/**
+ * HighlightUtil - Utility class for highlighting search matches in text
+ *
+ * This class provides methods to:
+ * 1. Check if text matches a search term (with SQL-style % wildcard support)
+ * 2. Highlight matching portions of text with HTML markup
+ *
+ * The key distinction is that highlighting should only occur when the text
+ * actually matches the search pattern. For wildcard searches like "food%ass",
+ * the text must contain "food" followed by "ass" in order - we shouldn't
+ * highlight partial matches that don't satisfy the full pattern.
+ */
+export declare class HighlightUtil {
+    /**
+     * Check if a value matches the search term (supports SQL-style % wildcards)
+     * This is used for filtering records.
+     *
+     * @param value The text value to check
+     * @param searchTerm The search term (may include % wildcards)
+     * @returns true if the value matches the search pattern
+     */
+    static matches(value: string, searchTerm: string): boolean;
+    /**
+     * Highlight matching text in a string based on the filter text.
+     * IMPORTANT: Only highlights if the text actually matches the pattern.
+     * For wildcard searches, all segments must be present in order.
+     *
+     * @param text The text to highlight
+     * @param searchTerm The search term (may include % wildcards)
+     * @param escapeHtml Whether to escape HTML characters (default: true)
+     * @returns HTML string with highlighted matches, or the original text if no match
+     */
+    static highlight(text: string, searchTerm: string, escapeHtml?: boolean): string;
+    /**
+     * Highlight a simple (non-wildcard) search term
+     */
+    private static highlightSimple;
+    /**
+     * Highlight a wildcard search term (segments separated by %)
+     * Only highlights segments that appear in the correct order
+     */
+    private static highlightWildcard;
+    /**
+     * Find all positions of segments in text (for simple highlighting)
+     */
+    private static findMatchPositions;
+    /**
+     * Find positions of segments that appear in order (for wildcard highlighting)
+     * This ensures we only highlight the segments that form the actual match
+     */
+    private static findOrderedMatchPositions;
+    /**
+     * Merge overlapping or adjacent ranges
+     */
+    private static mergeOverlappingRanges;
+    /**
+     * Build the final highlighted string from match ranges
+     */
+    private static buildHighlightedString;
+    /**
+     * Escape special regex characters
+     */
+    private static escapeRegex;
+    /**
+     * Escape HTML special characters to prevent XSS
+     */
+    static escapeHtml(text: string): string;
+}
+//# sourceMappingURL=highlight.util.d.ts.map

package/dist/lib/utils/highlight.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.util.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/highlight.util.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IACxB;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAgC1D;;;;;;;;;OASG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAE,OAAc,GAAG,MAAM;IAwBtF;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAa9B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAgBhC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAkBjC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAmBxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAmBrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAyBrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAI1B;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAcxC"}

package/dist/lib/utils/highlight.util.js

@@ -0,0 +1,214 @@
+/**
+ * HighlightUtil - Utility class for highlighting search matches in text
+ *
+ * This class provides methods to:
+ * 1. Check if text matches a search term (with SQL-style % wildcard support)
+ * 2. Highlight matching portions of text with HTML markup
+ *
+ * The key distinction is that highlighting should only occur when the text
+ * actually matches the search pattern. For wildcard searches like "food%ass",
+ * the text must contain "food" followed by "ass" in order - we shouldn't
+ * highlight partial matches that don't satisfy the full pattern.
+ */
+export class HighlightUtil {
+    /**
+     * Check if a value matches the search term (supports SQL-style % wildcards)
+     * This is used for filtering records.
+     *
+     * @param value The text value to check
+     * @param searchTerm The search term (may include % wildcards)
+     * @returns true if the value matches the search pattern
+     */
+    static matches(value, searchTerm) {
+        if (!value || !searchTerm)
+            return false;
+        const lowerValue = value.toLowerCase();
+        const lowerTerm = searchTerm.toLowerCase().trim();
+        if (!lowerTerm.includes('%')) {
+            // No wildcards - simple substring match
+            return lowerValue.includes(lowerTerm);
+        }
+        // Split by % to get fragments that must appear in order
+        const fragments = lowerTerm.split('%').filter(s => s.length > 0);
+        if (fragments.length === 0) {
+            // Just wildcards, matches everything
+            return true;
+        }
+        // Each fragment must appear in the value, in order
+        let searchStartIndex = 0;
+        for (const fragment of fragments) {
+            const foundIndex = lowerValue.indexOf(fragment, searchStartIndex);
+            if (foundIndex === -1) {
+                return false;
+            }
+            searchStartIndex = foundIndex + fragment.length;
+        }
+        return true;
+    }
+    /**
+     * Highlight matching text in a string based on the filter text.
+     * IMPORTANT: Only highlights if the text actually matches the pattern.
+     * For wildcard searches, all segments must be present in order.
+     *
+     * @param text The text to highlight
+     * @param searchTerm The search term (may include % wildcards)
+     * @param escapeHtml Whether to escape HTML characters (default: true)
+     * @returns HTML string with highlighted matches, or the original text if no match
+     */
+    static highlight(text, searchTerm, escapeHtml = true) {
+        if (!text)
+            return '';
+        if (!searchTerm || searchTerm.trim() === '') {
+            return escapeHtml ? this.escapeHtml(text) : text;
+        }
+        const trimmedSearch = searchTerm.trim();
+        // First check if this text actually matches the pattern
+        if (!this.matches(text, trimmedSearch)) {
+            // No match - return text without highlighting
+            return escapeHtml ? this.escapeHtml(text) : text;
+        }
+        // Text matches - now apply highlighting
+        if (!trimmedSearch.includes('%')) {
+            // Simple case: no wildcards, highlight the exact match
+            return this.highlightSimple(text, trimmedSearch, escapeHtml);
+        }
+        // Wildcard case: highlight each segment that appears in order
+        return this.highlightWildcard(text, trimmedSearch, escapeHtml);
+    }
+    /**
+     * Highlight a simple (non-wildcard) search term
+     */
+    static highlightSimple(text, searchTerm, escapeHtml) {
+        const regex = new RegExp(`(${this.escapeRegex(searchTerm)})`, 'gi');
+        if (escapeHtml) {
+            // Need to escape HTML first, then apply highlighting
+            // Find all match positions first
+            const matches = this.findMatchPositions(text, [searchTerm]);
+            return this.buildHighlightedString(text, matches, true);
+        }
+        else {
+            return text.replace(regex, '<span class="highlight-match">$1</span>');
+        }
+    }
+    /**
+     * Highlight a wildcard search term (segments separated by %)
+     * Only highlights segments that appear in the correct order
+     */
+    static highlightWildcard(text, searchTerm, escapeHtml) {
+        const segments = searchTerm.split('%').filter(s => s.length > 0);
+        if (segments.length === 0) {
+            return escapeHtml ? this.escapeHtml(text) : text;
+        }
+        // Find positions of each segment in order (only the first occurrence that maintains order)
+        const matches = this.findOrderedMatchPositions(text, segments);
+        if (matches.length === 0) {
+            return escapeHtml ? this.escapeHtml(text) : text;
+        }
+        return this.buildHighlightedString(text, matches, escapeHtml);
+    }
+    /**
+     * Find all positions of segments in text (for simple highlighting)
+     */
+    static findMatchPositions(text, segments) {
+        const matches = [];
+        const lowerText = text.toLowerCase();
+        for (const segment of segments) {
+            const lowerSegment = segment.toLowerCase();
+            let searchStart = 0;
+            while (searchStart < lowerText.length) {
+                const idx = lowerText.indexOf(lowerSegment, searchStart);
+                if (idx === -1)
+                    break;
+                matches.push({ start: idx, end: idx + segment.length });
+                searchStart = idx + 1;
+            }
+        }
+        return this.mergeOverlappingRanges(matches);
+    }
+    /**
+     * Find positions of segments that appear in order (for wildcard highlighting)
+     * This ensures we only highlight the segments that form the actual match
+     */
+    static findOrderedMatchPositions(text, segments) {
+        const matches = [];
+        const lowerText = text.toLowerCase();
+        let searchStart = 0;
+        for (const segment of segments) {
+            const lowerSegment = segment.toLowerCase();
+            const idx = lowerText.indexOf(lowerSegment, searchStart);
+            if (idx === -1) {
+                // This shouldn't happen if matches() returned true, but be safe
+                return [];
+            }
+            matches.push({ start: idx, end: idx + segment.length });
+            searchStart = idx + segment.length;
+        }
+        return this.mergeOverlappingRanges(matches);
+    }
+    /**
+     * Merge overlapping or adjacent ranges
+     */
+    static mergeOverlappingRanges(matches) {
+        if (matches.length === 0)
+            return [];
+        // Sort by start position
+        matches.sort((a, b) => a.start - b.start);
+        const merged = [];
+        for (const match of matches) {
+            if (merged.length === 0 || merged[merged.length - 1].end < match.start) {
+                merged.push({ ...match });
+            }
+            else {
+                // Extend the previous range if overlapping
+                merged[merged.length - 1].end = Math.max(merged[merged.length - 1].end, match.end);
+            }
+        }
+        return merged;
+    }
+    /**
+     * Build the final highlighted string from match ranges
+     */
+    static buildHighlightedString(text, ranges, escapeHtml) {
+        let result = '';
+        let lastEnd = 0;
+        for (const range of ranges) {
+            // Add text before this match
+            const before = text.substring(lastEnd, range.start);
+            result += escapeHtml ? this.escapeHtml(before) : before;
+            // Add highlighted match
+            const match = text.substring(range.start, range.end);
+            result += '<span class="highlight-match">';
+            result += escapeHtml ? this.escapeHtml(match) : match;
+            result += '</span>';
+            lastEnd = range.end;
+        }
+        // Add remaining text
+        const remaining = text.substring(lastEnd);
+        result += escapeHtml ? this.escapeHtml(remaining) : remaining;
+        return result;
+    }
+    /**
+     * Escape special regex characters
+     */
+    static escapeRegex(str) {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+    /**
+     * Escape HTML special characters to prevent XSS
+     */
+    static escapeHtml(text) {
+        if (typeof document !== 'undefined') {
+            const div = document.createElement('div');
+            div.textContent = text;
+            return div.innerHTML;
+        }
+        // Fallback for SSR
+        return text
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&#039;');
+    }
+}
+//# sourceMappingURL=highlight.util.js.map

package/dist/lib/utils/highlight.util.js.map

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