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

package/lib/renderer/components/st-workbook/st-workbook.component.d.ts

@@ -1,275 +0,0 @@
-import { EventEmitter, OnInit, OnChanges, OnDestroy, SimpleChanges, ChangeDetectorRef } from '@angular/core';
-import { StTableComponent } from '../st-table/st-table.component';
-import { BehaviorSubject } from 'rxjs';
-import { WorkbookConfig, WorkbookSheetConfig } from '../../../models/workbook-config.interface';
-import { WorkbookAction, WorkbookActionEvent, SheetTabActionEvent } from '../../../models/workbook-action.interface';
-import { WorkbookState } from '../../models/workbook-state.class';
-import { TableState } from '../../models/table-state.class';
-import { TableConfig } from '../../../models/table-config.interface';
-import { CellChangeEvent } from '../../../models/cell-types';
-import { TableStateChangeEvent } from '../../models/table-types';
-import { AutosaveService } from '../../../services/autosave.service';
-import * as i0 from "@angular/core";
-export declare class StWorkbookComponent implements OnInit, OnChanges, OnDestroy {
-    private autosaveService;
-    private cdr;
-    /**
-     * Workbook configuration
-     */
-    config: WorkbookConfig;
-    /**
-     * Map of sheet ID to data array
-     */
-    sheetsData: BehaviorSubject<Map<string, any[]>>;
-    /**
-     * Optional external state management
-     */
-    state?: WorkbookState;
-    /**
-     * Emitted when active sheet changes
-     */
-    sheetChanged: EventEmitter<number>;
-    /**
-     * Emitted when add sheet button is clicked
-     */
-    addSheet: EventEmitter<void>;
-    /**
-     * Emitted when a sheet tab action is clicked
-     */
-    sheetTabAction: EventEmitter<SheetTabActionEvent>;
-    /**
-     * Emitted when a workbook action is clicked
-     */
-    workbookAction: EventEmitter<WorkbookActionEvent>;
-    /**
-     * Emitted when cell value changes
-     */
-    cellChange: EventEmitter<CellChangeEvent<any>>;
-    /**
-     * Emitted when cell is saved
-     */
-    cellSave: EventEmitter<any>;
-    /**
-     * Emitted when table state changes
-     */
-    tableStateChange: EventEmitter<TableStateChangeEvent>;
-    /**
-     * Emitted when fullscreen is toggled
-     */
-    fullscreenToggle: EventEmitter<boolean>;
-    /**
-     * Emitted when user navigates past last row (arrow down at bottom)
-     * Only emitted if addRowOnNavigatePastEnd is enabled in tableConfig
-     */
-    requestAddRow: EventEmitter<{
-        sheetId: string;
-        focusColumn?: number | undefined;
-    }>;
-    /**
-     * Reference to the st-table component for programmatic control
-     */
-    tableComponent?: StTableComponent;
-    /**
-     * Array of sheets
-     */
-    sheets: WorkbookSheetConfig[];
-    /**
-     * Active sheet index
-     */
-    activeSheetIndex: number;
-    /**
-     * Current table config (for active sheet)
-     */
-    currentTableConfig: TableConfig | null;
-    /**
-     * Current table data (for active sheet) - using BehaviorSubject for reactive updates
-     */
-    currentTableData$: BehaviorSubject<any[]>;
-    /**
-     * Current table state (for active sheet)
-     */
-    currentTableState: TableState | null;
-    /**
-     * Unique key for table component (changes on sheet switch to force reinitialization)
-     */
-    tableComponentKey: string;
-    /**
-     * Internal state instance
-     */
-    internalState?: WorkbookState;
-    /**
-     * Fullscreen state observable
-     */
-    isFullscreen$: BehaviorSubject<boolean>;
-    /**
-     * Tab actions dropdown state
-     */
-    tabActionsOpen: boolean;
-    selectedSheet: WorkbookSheetConfig | null;
-    selectedSheetIndex: number;
-    tabActionsPosition: any;
-    /**
-     * Workbook actions dropdown state
-     */
-    workbookActionsOpen: boolean;
-    workbookActionsPosition: any;
-    /**
-     * Visible workbook actions for dropdown (filtered by hidden and showInToolbar)
-     */
-    visibleWorkbookActions: WorkbookAction[];
-    /**
-     * Workbook actions to show directly in toolbar
-     */
-    toolbarWorkbookActions: WorkbookAction[];
-    /**
-     * Destroy subject for cleanup
-     */
-    private destroy$;
-    /**
-     * Autosave enabled flag
-     */
-    autosaveEnabled: boolean;
-    /**
-     * Autosave strategy
-     */
-    private autosaveStrategy;
-    /**
-     * Last save timestamp
-     */
-    lastSaveTime: Date | null;
-    /**
-     * Saving indicator
-     */
-    isSaving: boolean;
-    /**
-     * Beforeunload handler reference
-     */
-    private beforeUnloadHandler;
-    constructor(autosaveService: AutosaveService, cdr: ChangeDetectorRef);
-    ngOnInit(): void;
-    ngOnChanges(changes: SimpleChanges): void;
-    /**
-     * Initialize component state
-     * @param isFirstInit Whether this is the first initialization (true) or a config update (false)
-     */
-    private initializeComponent;
-    /**
-     * Get active state (external or internal)
-     */
-    get activeState(): WorkbookState;
-    /**
-     * Handle tab change event from nile-tab-group
-     */
-    onTabChange(event: any): void;
-    /**
-     * Update active sheet data (triggers table re-initialization with new config/state)
-     */
-    private updateActiveSheet;
-    /**
-     * Add new sheet
-     */
-    onAddSheet(): void;
-    /**
-     * TrackBy function to force component recreation when key changes
-     */
-    trackByKey(index: number, key: string): string;
-    /**
-     * Check if can add more sheets
-     */
-    get canAddSheet(): boolean;
-    /**
-     * Get minimum sheets required
-     */
-    get minSheets(): number;
-    /**
-     * Open tab actions dropdown
-     */
-    openTabActions(event: MouseEvent, sheet: WorkbookSheetConfig, index: number): void;
-    /**
-     * Close tab actions dropdown
-     */
-    closeTabActions(): void;
-    /**
-     * Check if sheet has tab actions
-     */
-    hasTabActions(sheet: WorkbookSheetConfig): boolean;
-    /**
-     * Handle tab action click
-     */
-    onTabActionClick(action: any, event: Event): void;
-    /**
-     * Toggle workbook actions dropdown
-     */
-    toggleWorkbookActions(event: MouseEvent): void;
-    /**
-     * Close workbook actions dropdown
-     */
-    closeWorkbookActions(): void;
-    /**
-     * Update visible workbook actions
-     */
-    private updateVisibleWorkbookActions;
-    /**
-     * Check if workbook action is disabled
-     */
-    isActionDisabled(action: WorkbookAction): boolean;
-    /**
-     * Handle workbook action click
-     */
-    onWorkbookActionClick(action: WorkbookAction, event: Event): void;
-    /**
-     * Toggle fullscreen mode
-     */
-    toggleFullscreen(): void;
-    /**
-     * Handle cell change from table - update internal data and pass through to parent
-     */
-    onCellChange(event: CellChangeEvent): void;
-    /**
-     * Handle cell save from table - update internal data and pass through to parent
-     */
-    onCellSave(event: any): void;
-    /**
-     * Handle table state change - pass through to parent
-     */
-    onTableStateChange(event: TableStateChangeEvent): void;
-    /**
-     * Handle request to add a new row - emitted when navigating past last row
-     */
-    onRequestAddRow(event: {
-        focusColumn?: number;
-    }): void;
-    /**
-     * Component cleanup
-     */
-    ngOnDestroy(): void;
-    /**
-     * Initialize autosave subscription
-     */
-    private initializeAutosave;
-    /**
-     * Perform autosave operation
-     */
-    private performAutosave;
-    /**
-     * Setup auto-restore from autosave
-     */
-    private setupAutoRestore;
-    /**
-     * Setup beforeunload warning for unsaved changes
-     */
-    private setupBeforeUnloadWarning;
-    /**
-     * Scroll to a specific row in the current table
-     * @param rowIndex - The index of the row to scroll to
-     * @param focusFirstCell - Whether to focus the first editable cell (default: false)
-     */
-    scrollToRow(rowIndex: number, focusFirstCell?: boolean): void;
-    /**
-     * Scroll to the last row in the current table
-     * @param focusFirstCell - Whether to focus the first editable cell (default: true)
-     */
-    scrollToLastRow(focusFirstCell?: boolean): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<StWorkbookComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<StWorkbookComponent, "st-workbook", never, { "config": "config"; "sheetsData": "sheetsData"; "state": "state"; }, { "sheetChanged": "sheetChanged"; "addSheet": "addSheet"; "sheetTabAction": "sheetTabAction"; "workbookAction": "workbookAction"; "cellChange": "cellChange"; "cellSave": "cellSave"; "tableStateChange": "tableStateChange"; "fullscreenToggle": "fullscreenToggle"; "requestAddRow": "requestAddRow"; }, never, never>;
-}

package/lib/renderer/directives/click-outside.directive.d.ts

@@ -1,10 +0,0 @@
-import { ElementRef, EventEmitter } from '@angular/core';
-import * as i0 from "@angular/core";
-export declare class ClickOutsideDirective {
-    private el;
-    clickOutside: EventEmitter<void>;
-    constructor(el: ElementRef);
-    onClick(target: HTMLElement): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ClickOutsideDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<ClickOutsideDirective, "[clickOutside]", never, {}, { "clickOutside": "clickOutside"; }, never>;
-}

package/lib/renderer/directives/st-column-resize.directive.d.ts

@@ -1,44 +0,0 @@
-/**
- * Column Resize Directive
- * Handles column resizing when applied to th/td elements
- */
-import { ElementRef, EventEmitter, OnDestroy } from '@angular/core';
-import { ColumnConfig } from '../../models/column-config.interface';
-import { ColumnResizeEvent } from '../models/table-types';
-import * as i0 from "@angular/core";
-export declare class StColumnResizeDirective implements OnDestroy {
-    private el;
-    /**
-     * Column configuration
-     */
-    column: ColumnConfig<any>;
-    /**
-     * Emits when column is resized
-     */
-    columnResized: EventEmitter<ColumnResizeEvent>;
-    /**
-     * Resize state
-     */
-    private isResizing;
-    private startX;
-    private startWidth;
-    constructor(el: ElementRef<HTMLElement>);
-    /**
-     * Start resize on mousedown
-     */
-    onResizeStart(event: MouseEvent): void;
-    /**
-     * Track mouse movement during resize
-     */
-    private onResizeMove;
-    /**
-     * End resize on mouseup
-     */
-    private onResizeEnd;
-    /**
-     * Cleanup on destroy
-     */
-    ngOnDestroy(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<StColumnResizeDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<StColumnResizeDirective, "[stColumnResize]", never, { "column": "column"; }, { "columnResized": "columnResized"; }, never>;
-}

package/lib/renderer/directives/st-keyboard-navigation.directive.d.ts

@@ -1,19 +0,0 @@
-import { TableState } from '../models/table-state.class';
-import * as i0 from "@angular/core";
-/**
- * Directive to handle keyboard navigation in table cells
- */
-export declare class StKeyboardNavigationDirective {
-    tableState: TableState;
-    /**
-     * When enabled, pressing arrow down at the last row will emit requestAddRow event
-     */
-    addRowOnNavigatePastEnd: boolean;
-    onKeyDown(event: KeyboardEvent): void;
-    /**
-     * Convert navigation key to direction using enums
-     */
-    private getDirection;
-    static ɵfac: i0.ɵɵFactoryDeclaration<StKeyboardNavigationDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<StKeyboardNavigationDirective, "[stKeyboardNavigation]", never, { "tableState": "tableState"; "addRowOnNavigatePastEnd": "addRowOnNavigatePastEnd"; }, {}, never>;
-}

package/lib/renderer/models/cell-state.interface.d.ts

@@ -1,118 +0,0 @@
-/**
- * Cell state interface - represents unique state per cell instance
- * This is the "Context" in the Flyweight pattern
- */
-import { CellLifecycleState } from '../../models/cell-types';
-/**
- * Cell state containing all unique state per cell instance
- * This is stored individually per cell, while ColumnConfig is shared (Flyweight)
- */
-export interface CellState<T = any> {
-    /**
-     * Current cell value
-     */
-    value: T;
-    /**
-     * Whether the cell is currently in edit mode
-     */
-    isEditing: boolean;
-    /**
-     * Whether the cell value has been modified
-     */
-    isDirty: boolean;
-    /**
-     * Previous value before current edit (for undo/cancel)
-     */
-    previousValue?: T;
-    /**
-     * Original value when cell was initialized (for reset)
-     */
-    originalValue?: T;
-    /**
-     * Validation error message if validation failed
-     */
-    error?: string;
-    /**
-     * Multiple validation errors (field-specific)
-     */
-    errors?: Record<string, string>;
-    /**
-     * Warning messages (non-blocking)
-     */
-    warnings?: string[];
-    /**
-     * Current lifecycle state of the cell
-     */
-    lifecycleState: CellLifecycleState;
-    /**
-     * Whether the cell is currently loading (async operations)
-     */
-    isLoading?: boolean;
-    /**
-     * Whether the cell is disabled
-     */
-    isDisabled?: boolean;
-    /**
-     * Whether the cell is readonly
-     */
-    isReadonly?: boolean;
-    /**
-     * Whether the cell is selected
-     */
-    isSelected?: boolean;
-    /**
-     * Whether the cell is focused
-     */
-    isFocused?: boolean;
-    /**
-     * Whether the cell is hovered
-     */
-    isHovered?: boolean;
-    /**
-     * Custom metadata for cell-specific data
-     */
-    metadata?: Record<string, any>;
-    /**
-     * Timestamp of last modification
-     */
-    lastModified?: Date;
-    /**
-     * Timestamp of last validation
-     */
-    lastValidated?: Date;
-}
-/**
- * Factory function to create initial cell state with defaults
- */
-export declare function createCellState<T>(value: T, overrides?: Partial<CellState<T>>): CellState<T>;
-/**
- * Cell state memento for save/restore operations (Memento pattern)
- * Contains minimal state needed for undo/redo
- */
-export interface CellStateMemento<T = any> {
-    value: T;
-    isDirty: boolean;
-    error?: string;
-    metadata?: Record<string, any>;
-    timestamp: Date;
-}
-/**
- * Create a memento snapshot of cell state
- */
-export declare function createMemento<T>(state: CellState<T>): CellStateMemento<T>;
-/**
- * Restore cell state from memento
- */
-export declare function restoreFromMemento<T>(currentState: CellState<T>, memento: CellStateMemento<T>): CellState<T>;
-/**
- * Helper to check if cell is in valid state
- */
-export declare function isCellValid<T>(state: CellState<T>): boolean;
-/**
- * Helper to check if cell can be edited
- */
-export declare function canEdit<T>(state: CellState<T>): boolean;
-/**
- * Helper to check if cell is in display mode
- */
-export declare function isDisplayMode<T>(state: CellState<T>): boolean;

package/lib/renderer/models/cell.class.d.ts

@@ -1,174 +0,0 @@
-/**
- * Cell class - represents individual cell instances
- * Combines ColumnConfig (Flyweight) with CellState (unique per instance)
- */
-import { ColumnConfig } from '../../models/column-config.interface';
-import { CellState } from './cell-state.interface';
-import { ValidationResult } from '../../models/cell-types';
-/**
- * Cell class implementing the Flyweight pattern
- * - References shared ColumnConfig (Flyweight)
- * - Owns unique CellState (Flyweight Context)
- */
-export declare class Cell<T = any> {
-    /**
-     * Shared column configuration (Flyweight - reference only, not owned)
-     */
-    private readonly columnConfig;
-    /**
-     * Unique cell state (owned by this instance)
-     */
-    private state;
-    /**
-     * Row data context (reference to parent row data)
-     */
-    private rowData?;
-    /**
-     * Row index in table
-     */
-    private rowIndex?;
-    /**
-     * History of state mementos for undo/redo
-     */
-    private history;
-    /**
-     * Current position in history
-     */
-    private historyIndex;
-    /**
-     * Maximum history size
-     */
-    private readonly maxHistorySize;
-    constructor(columnConfig: ColumnConfig<T>, initialValue: T, rowData?: any, rowIndex?: number);
-    /**
-     * Get current cell value
-     */
-    getValue(): T;
-    /**
-     * Set cell value
-     * @param value New value
-     * @param skipValidation Skip validation (useful for programmatic sets)
-     */
-    setValue(value: T, skipValidation?: boolean): boolean;
-    /**
-     * Render cell value as formatted string (delegates to formatter strategy)
-     */
-    render(): string;
-    /**
-     * Validate cell value (delegates to validator strategy)
-     */
-    validate(): ValidationResult;
-    /**
-     * Start edit mode
-     */
-    startEdit(): boolean;
-    /**
-     * Save edited value
-     * @param newValue The new value from editor
-     */
-    saveEdit(newValue: T): boolean;
-    /**
-     * Cancel edit and revert to previous value
-     */
-    cancelEdit(): void;
-    /**
-     * Reset cell to original value
-     */
-    reset(): void;
-    /**
-     * Check if cell can be edited
-     */
-    canEdit(): boolean;
-    /**
-     * Check if cell is valid
-     */
-    isValid(): boolean;
-    /**
-     * Check if cell is dirty (modified)
-     */
-    isDirty(): boolean;
-    /**
-     * Check if cell is in edit mode
-     */
-    isEditing(): boolean;
-    /**
-     * Set focus state on this cell
-     */
-    focus(): void;
-    /**
-     * Remove focus from this cell
-     */
-    blur(): void;
-    /**
-     * Check if this cell is focused
-     */
-    isFocused(): boolean;
-    /**
-     * Get current cell state (Memento pattern)
-     */
-    getState(): CellState<T>;
-    /**
-     * Restore cell state from snapshot (Memento pattern)
-     */
-    restoreState(state: CellState<T>): void;
-    /**
-     * Get column configuration (readonly access)
-     */
-    getColumnConfig(): Readonly<ColumnConfig<T>>;
-    /**
-     * Get row data context
-     */
-    getRowData(): any;
-    /**
-     * Get row index
-     */
-    getRowIndex(): number | undefined;
-    /**
-     * Set loading state
-     */
-    setLoading(isLoading: boolean): void;
-    /**
-     * Set disabled state
-     */
-    setDisabled(isDisabled: boolean): void;
-    /**
-     * Set readonly state
-     */
-    setReadonly(isReadonly: boolean): void;
-    /**
-     * Save current state to history
-     */
-    private saveToHistory;
-    /**
-     * Undo last change
-     */
-    undo(): boolean;
-    /**
-     * Redo last undone change
-     */
-    redo(): boolean;
-    /**
-     * Check if undo is available
-     */
-    canUndo(): boolean;
-    /**
-     * Check if redo is available
-     */
-    canRedo(): boolean;
-    /**
-     * Create cell event for hooks
-     */
-    private createEvent;
-    /**
-     * Get cell metadata
-     */
-    getMetadata(key: string): any;
-    /**
-     * Set cell metadata
-     */
-    setMetadata(key: string, value: any): void;
-    /**
-     * Clear all metadata
-     */
-    clearMetadata(): void;
-}

package/lib/renderer/models/row-validation-state.interface.d.ts

@@ -1,27 +0,0 @@
-/**
- * Row validation state interface
- * Represents an INVALID row with accumulated cell errors
- * Note: Valid rows are not stored - absence of a row state means the row is valid
- */
-export interface RowValidationState {
-    /**
-     * Index of the row in the table
-     */
-    rowIndex: number;
-    /**
-     * Always false for stored states (only invalid rows are stored)
-     */
-    isValid: false;
-    /**
-     * Number of invalid cells in the row
-     */
-    invalidCellCount: number;
-    /**
-     * Map of column keys to validation error messages
-     */
-    cellErrors: Map<string, string>;
-    /**
-     * Timestamp of the last validation
-     */
-    lastValidated: Date;
-}