@aquera/ngx-smart-table 0.0.17-alpha → 0.0.18-alpha

package/lib/models/column-action.interface.d.ts

@@ -1,86 +0,0 @@
-/**
- * Column action interface - defines actions that can be performed on table columns
- * Similar to RowAction but for column-level operations
- */
-import { ColumnConfig } from './column-config.interface';
-import { TableState } from '../renderer/models/table-state.class';
-/**
- * Defines a single action that can be performed on a column
- */
-export interface ColumnAction {
-    /**
-     * Unique identifier for the action
-     */
-    id: string;
-    /**
-     * Display label for the action
-     */
-    label: string;
-    /**
-     * Optional icon to display with the action
-     */
-    icon?: string;
-    /**
-     * Callback function executed when the action is clicked
-     * @param column - The column config
-     * @param columnIndex - The index of the column
-     */
-    action?: (column: ColumnConfig<any>, columnIndex: number) => void;
-    /**
-     * Whether the action should be hidden
-     * Can be a boolean or a function that returns boolean based on column state
-     */
-    hidden?: boolean | ((column: ColumnConfig<any>, columnIndex: number) => boolean);
-    /**
-     * Whether the action should be disabled
-     * Can be a boolean or a function that returns boolean based on column state
-     */
-    disabled?: boolean | ((column: ColumnConfig<any>, columnIndex: number) => boolean);
-}
-/**
- * Context object passed to the column menu dropdown component
- * Contains all information needed to render and handle column actions
- */
-export interface ColumnActionContext {
-    /**
-     * The column configuration
-     */
-    column: ColumnConfig<any>;
-    /**
-     * The index of the column in the visible columns array
-     */
-    columnIndex: number;
-    /**
-     * Whether this is the first column
-     */
-    isFirstColumn: boolean;
-    /**
-     * Whether this is the last column
-     */
-    isLastColumn: boolean;
-    /**
-     * Table state for accessing sorting, filtering, etc.
-     */
-    tableState?: TableState;
-    /**
-     * Available actions for this column
-     */
-    actions: ColumnAction[];
-}
-/**
- * Event emitted when a column action is clicked
- */
-export interface ColumnActionEvent {
-    /**
-     * The action that was clicked
-     */
-    action: ColumnAction;
-    /**
-     * The column configuration
-     */
-    column: ColumnConfig<any>;
-    /**
-     * The index of the column
-     */
-    columnIndex: number;
-}

package/lib/models/column-config.interface.d.ts

@@ -1,272 +0,0 @@
-/**
- * Column configuration interface - Flyweight pattern
- * This configuration is shared across all cells in a column
- */
-import { CellFormatter, CellValidator, CellEditor, CellParser, CellLifecycleHooks } from './cell-strategies.interface';
-import { CellAlignment, CellVerticalAlignment, EditMode, CellDataType } from './cell-types';
-import { SortDirection, FilterOperator } from '../renderer/models/table-types';
-import { Cell } from '../renderer/models/cell.class';
-import { TemplateRef } from '@angular/core';
-import { ColumnAction } from './column-action.interface';
-/**
- * Filter options configuration for custom dropdown filters
- */
-export interface FilterOptions {
-    /**
-     * Array of data items to display in the dropdown
-     */
-    data: any[];
-    /**
-     * Handler function to transform data items into {label, value} pairs
-     * @param item The data item to transform
-     * @returns Object with label (displayed text) and value (stored value)
-     */
-    handler: (item: any) => {
-        label: string;
-        value: any;
-    };
-    /**
-     * Whether to allow multiple selections
-     * @default false
-     */
-    multiselect?: boolean;
-}
-/**
- * Column configuration - shared immutable config for all cells in a column (Flyweight)
- * Contains behavior, metadata, and strategies but NO state
- */
-export interface ColumnConfig<T = any> {
-    /**
-     * Unique key for the column (maps to row data property)
-     */
-    readonly key: string;
-    /**
-     * Display header text for the column
-     */
-    readonly header?: string;
-    /**
-     * Data type of the column values
-     */
-    readonly dataType?: CellDataType;
-    /**
-     * Formatter strategy for displaying cell values
-     */
-    readonly formatter?: CellFormatter<T>;
-    /**
-     * Validator strategy for validating cell values
-     */
-    readonly validator?: CellValidator<T>;
-    /**
-     * Editor strategy for inline editing
-     */
-    readonly editor?: CellEditor<T>;
-    /**
-     * Parser strategy for converting user input to typed values
-     */
-    readonly parser?: CellParser<T>;
-    /**
-     * Whether cells in this column are editable
-     */
-    readonly editable?: boolean;
-    /**
-     * Edit mode trigger
-     */
-    readonly editMode?: EditMode;
-    /**
-     * Whether this column is sortable
-     */
-    readonly sortable?: boolean;
-    /**
-     * Whether this column is filterable
-     */
-    readonly filterable?: boolean;
-    /**
-     * Whether this column's visibility can be toggled by users
-     */
-    readonly hideable?: boolean;
-    /**
-     * Whether this column can be moved left/right by users
-     * Note: Pinned/sticky columns cannot be moved
-     * @default true
-     */
-    readonly movable?: boolean;
-    /**
-     * Whether this column can be pinned/unpinned by users
-     * @default true
-     */
-    readonly pinnable?: boolean;
-    /**
-     * Whether to show the column menu dropdown for this column
-     * @default true
-     */
-    readonly enableMenu?: boolean;
-    /**
-     * Custom actions for this column (shown in column menu dropdown)
-     * Similar to row actions but for column-level operations
-     * @default []
-     */
-    readonly columnActions?: ColumnAction[];
-    /**
-     * Whether to include built-in actions (sort, filter, pin, move) in the column menu
-     * Set to false to show only custom actions
-     * @default true
-     */
-    readonly includeBuiltInActions?: boolean;
-    /**
-     * Current sort direction for this column
-     * @default 'none'
-     */
-    sortDirection?: SortDirection;
-    /**
-     * Whether sorting is currently active/enabled on this column
-     * @default false
-     */
-    sortEnabled?: boolean;
-    /**
-     * Filter configuration for this column
-     * Contains operator, value, enabled state, and custom dropdown options
-     */
-    filterConfig?: {
-        /**
-         * Filter operator
-         * @default 'contains'
-         */
-        operator?: FilterOperator;
-        /**
-         * Current filter value
-         */
-        value?: any;
-        /**
-         * Whether filtering is currently active/enabled on this column
-         * @default false
-         */
-        enabled?: boolean;
-        /**
-         * Custom filter options for dropdown-based filtering
-         * Both data and handler must be provided together, otherwise falls back to text input
-         */
-        options?: FilterOptions;
-    };
-    /**
-     * Whether this column is resizable
-     */
-    readonly resizable?: boolean;
-    /**
-     * Column width (px, %, or 'auto')
-     */
-    readonly width?: number | string;
-    /**
-     * Minimum column width (px)
-     */
-    readonly minWidth?: number;
-    /**
-     * Maximum column width (px)
-     */
-    readonly maxWidth?: number;
-    /**
-     * Whether this column is sticky (left or right)
-     */
-    readonly sticky?: 'left' | 'right' | false;
-    /**
-     * Calculated offset for sticky positioning (px)
-     * Auto-calculated by table component based on column order
-     */
-    stickyOffset?: number;
-    /**
-     * Whether to show shadow indicator on sticky columns
-     * @default true
-     */
-    readonly showStickyShadow?: boolean;
-    /**
-     * Cell content alignment
-     */
-    readonly alignment?: CellAlignment;
-    /**
-     * Cell vertical alignment
-     */
-    readonly verticalAlignment?: CellVerticalAlignment;
-    /**
-     * Whether to truncate overflowing text
-     */
-    readonly truncate?: boolean;
-    /**
-     * Tooltip configuration
-     */
-    readonly tooltip?: string | ((value: T, rowData: any) => string);
-    /**
-     * CSS class name(s) for cells in this column
-     */
-    readonly className?: string | string[] | ((value: T, rowData: any) => string | string[]);
-    /**
-     * Inline styles for cells in this column
-     */
-    readonly style?: Record<string, any> | ((value: T, rowData: any) => Record<string, any>);
-    /**
-     * Custom cell template (Angular TemplateRef)
-     */
-    readonly cellTemplate?: TemplateRef<any>;
-    /**
-     * Custom header template
-     */
-    readonly headerTemplate?: TemplateRef<any>;
-    /**
-     * Whether column is visible
-     */
-    readonly visible?: boolean;
-    /**
-     * Whether column is pinned (left, right, or none)
-     */
-    readonly pinned?: 'left' | 'right' | false;
-    /**
-     * Sort order priority (for multi-column sort)
-     */
-    readonly sortPriority?: number;
-    /**
-     * Custom comparator for sorting
-     */
-    readonly comparator?: (a: T, b: T) => number;
-    /**
-     * Function to extract value from row data (for nested properties)
-     */
-    readonly valueGetter?: (rowData: any) => T;
-    /**
-     * Function to set value in row data (for nested properties)
-     */
-    readonly valueSetter?: (rowData: any, value: T) => void;
-    /**
-     * Lifecycle hooks for cells in this column
-     */
-    readonly hooks?: CellLifecycleHooks<T>;
-    /**
-     * Whether cells should show loading indicator during async operations
-     */
-    readonly showLoadingIndicator?: boolean;
-    /**
-     * Custom metadata for column
-     */
-    readonly metadata?: Record<string, any>;
-    /**
-     * Factory method to create a cell instance for this column (Factory Pattern)
-     * @param rowData The row data object
-     * @param rowIndex Optional row index
-     * @returns A new Cell instance
-     */
-    createCell(rowData: any, rowIndex?: number): Cell<T>;
-}
-/**
- * Partial column config for extending existing configs
- */
-export declare type PartialColumnConfig<T = any> = Partial<ColumnConfig<T>>;
-/**
- * Column config builder options
- */
-export interface ColumnConfigOptions<T = any> extends Omit<ColumnConfig<T>, 'key' | 'createCell'> {
-}
-/**
- * Helper type for column config with required key
- */
-export declare type ColumnConfigWithKey<T = any> = Required<Pick<ColumnConfig<T>, 'key'>> & Partial<Omit<ColumnConfig<T>, 'key'>>;
-/**
- * Default column configuration values
- */
-export declare const DEFAULT_COLUMN_CONFIG: Partial<ColumnConfig<any>>;

package/lib/models/column-config.utils.d.ts

@@ -1,37 +0,0 @@
-/**
- * Utility functions for column configuration operations
- */
-import { ColumnConfig, PartialColumnConfig } from './column-config.interface';
-/**
- * Helper function to check if a value is a plain object
- * (not an array, null, Date, RegExp, or class instance)
- */
-export declare function isPlainObject(value: any): boolean;
-/**
- * Recursively deep merges multiple column configurations.
- * This function properly clones nested objects and arrays to avoid shared references.
- *
- * @param configs - Variable number of partial column configurations to merge
- * @returns A merged configuration with all nested objects properly cloned
- *
- * @example
- * const merged = deepMergeColumnConfig(
- *   { filterConfig: { operator: 'equals' } },
- *   { filterConfig: { value: 'test' } }
- * );
- * // Result: { filterConfig: { operator: 'equals', value: 'test' } }
- */
-export declare function deepMergeColumnConfig<T>(...configs: Array<Partial<ColumnConfig<T>>>): Partial<ColumnConfig<T>>;
-/**
- * Helper function to merge column configs with defaults
- * @deprecated Use deepMergeColumnConfig instead for proper nested object handling
- */
-export declare function mergeWithDefaults<T>(config: PartialColumnConfig<T>): ColumnConfig<T>;
-/**
- * Helper to create a readonly column config
- */
-export declare function createReadonlyColumn<T>(key: string, options?: PartialColumnConfig<T>): ColumnConfig<T>;
-/**
- * Helper to create an editable column config
- */
-export declare function createEditableColumn<T>(key: string, options?: PartialColumnConfig<T>): ColumnConfig<T>;

package/lib/models/row-action.interface.d.ts

@@ -1,86 +0,0 @@
-/**
- * Row action interfaces for configurable row management features
- */
-/**
- * Defines a single row action that can be performed on a table row
- */
-export interface RowAction {
-    /**
-     * Unique identifier for the action
-     */
-    id: string;
-    /**
-     * Display label for the action
-     */
-    label: string;
-    /**
-     * Optional icon to display (can be emoji, icon class, or SVG)
-     */
-    icon?: string;
-    /**
-     * Function to determine if action should be disabled for a specific row
-     * @param rowData The data for the row
-     * @param rowIndex The index of the row
-     */
-    disabled?: boolean | ((rowData: any, rowIndex: number) => boolean);
-    /**
-     * Function to determine if action should be hidden for a specific row
-     * @param rowData The data for the row
-     * @param rowIndex The index of the row
-     */
-    hidden?: boolean | ((rowData: any, rowIndex: number) => boolean);
-    /**
-     * Callback function to execute when action is clicked
-     * @param rowData The data for the row
-     * @param rowIndex The index of the row
-     */
-    action?: (rowData: any, rowIndex: number) => void;
-}
-/**
- * Configuration for row management features
- */
-export interface RowManagementConfig {
-    /**
-     * Array of actions to display in the dropdown
-     */
-    actions: RowAction[];
-    /**
-     * Position of the settings column
-     * @default 'end'
-     */
-    position?: 'start' | 'end';
-}
-/**
- * Event emitted when a row action is clicked
- */
-export interface RowActionEvent {
-    /**
-     * The action that was clicked
-     */
-    action: RowAction;
-    /**
-     * The row data
-     */
-    rowData: any;
-    /**
-     * The row index
-     */
-    rowIndex: number;
-}
-/**
- * Context object passed to the dropdown component
- */
-export interface RowActionContext {
-    /**
-     * The row data
-     */
-    rowData: any;
-    /**
-     * The row index
-     */
-    rowIndex: number;
-    /**
-     * Available actions for this row
-     */
-    actions: RowAction[];
-}

package/lib/models/row-validator.interface.d.ts

@@ -1,37 +0,0 @@
-import { Cell } from '../renderer/models/cell.class';
-/**
- * Validation result for row-level validation
- */
-export interface RowValidationResult {
-    /** Whether the row is valid */
-    valid: boolean;
-    /** Primary error message */
-    error?: string;
-    /** Array of specific error messages */
-    errors?: string[];
-    /** Warning messages (non-blocking) */
-    warnings?: string[];
-    /** Field-specific errors */
-    fieldErrors?: Record<string, string>;
-}
-/**
- * Row validator interface for validating entire rows
- */
-export interface RowValidator {
-    /**
-     * Validates an entire row
-     * @param rowData The complete row data object
-     * @param cells Array of Cell instances for the row
-     * @param rowIndex The index of the row being validated
-     * @returns Row validation result
-     */
-    validateRow(rowData: any, cells: Cell[], rowIndex: number): RowValidationResult;
-    /**
-     * Optional error message template
-     */
-    errorMessage?: string;
-    /**
-     * Optional validation ID for tracking
-     */
-    validatorId?: string;
-}

package/lib/models/schema-validation.interface.d.ts

@@ -1,42 +0,0 @@
-/**
- * Schema validation error
- */
-export interface SchemaValidationError {
-    /**
-     * JSON path to the error (e.g., "/columns/0/key")
-     */
-    path: string;
-    /**
-     * Human-readable error message
-     */
-    message: string;
-    /**
-     * Error code
-     */
-    code: string;
-    /**
-     * Invalid value (if available)
-     */
-    value?: any;
-    /**
-     * Field name (user-friendly)
-     */
-    field?: string;
-}
-/**
- * Schema validation result
- */
-export interface SchemaValidationResult {
-    /**
-     * Whether the validation passed
-     */
-    valid: boolean;
-    /**
-     * Array of validation errors (empty if valid)
-     */
-    errors: SchemaValidationError[];
-    /**
-     * Whether ajv is available
-     */
-    ajvAvailable: boolean;
-}

package/lib/models/sheet-action.interface.d.ts

@@ -1,59 +0,0 @@
-/**
- * Sheet action interfaces for configurable sheet-level features
- */
-/**
- * Defines a single sheet action that can be performed on a sheet
- */
-export interface SheetAction {
-    /**
-     * Unique identifier for the action
-     */
-    id: string;
-    /**
-     * Display label for the action
-     */
-    label: string;
-    /**
-     * Optional icon to display (nile-icon name)
-     */
-    icon?: string;
-    /**
-     * Function to determine if action should be disabled
-     */
-    disabled?: boolean | (() => boolean);
-    /**
-     * Function to determine if action should be hidden
-     */
-    hidden?: boolean | (() => boolean);
-    /**
-     * Callback function to execute when action is clicked
-     * @param sheetId The ID of the sheet
-     */
-    action?: (sheetId: string) => void;
-}
-/**
- * Event emitted when a sheet action is clicked
- */
-export interface SheetActionEvent {
-    /**
-     * The action that was clicked
-     */
-    action: SheetAction;
-    /**
-     * The sheet ID
-     */
-    sheetId: string;
-}
-/**
- * Context object passed to the sheet actions component
- */
-export interface SheetActionContext {
-    /**
-     * The sheet ID
-     */
-    sheetId: string;
-    /**
-     * Available actions for this sheet
-     */
-    actions: SheetAction[];
-}

package/lib/models/sheet-config.interface.d.ts

@@ -1,41 +0,0 @@
-/**
- * Sheet configuration interface - wraps table with sheet-level settings
- */
-import { TableConfig } from './table-config.interface';
-import { SheetAction } from './sheet-action.interface';
-/**
- * Comprehensive sheet configuration interface
- */
-export interface SheetConfig {
-    /**
-     * Unique identifier for the sheet
-     */
-    id: string;
-    /**
-     * Display name of the sheet
-     */
-    name: string;
-    /**
-     * Table configuration (existing TableConfig)
-     */
-    tableConfig: TableConfig;
-    /**
-     * Sheet-level actions (similar to RowAction pattern)
-     */
-    actions?: SheetAction[];
-    /**
-     * Display configuration
-     */
-    display?: {
-        /**
-         * Show sheet header bar
-         * @default true
-         */
-        showHeader?: boolean;
-        /**
-         * Header variant style
-         * @default 'default'
-         */
-        headerVariant?: 'default' | 'compact';
-    };
-}