@aquera/ngx-smart-table 0.0.22 → 0.0.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aquera/ngx-smart-table",
-  "version": "0.0.22",
+  "version": "0.0.23",
   "license": "MIT",
   "peerDependencies": {
     "@angular/common": "^21.0.0",

package/types/aquera-ngx-smart-table.d.ts

@@ -1415,10 +1415,27 @@ declare class Cell<T = any> {
      * Get row index
      */
     getRowIndex(): number | undefined;
+    private stateChangeCallback?;
     /**
-     * Set loading state
+     * When the data source refreshes, the table recreates Cell objects.
+     * This field lets the old (stale) Cell forward calls to its replacement
+     * so that async operations (e.g. setLoading from an API callback)
+     * still reach the live component.
+     */
+    private replacementCell?;
+    /**
+     * Link this cell to its replacement so future state mutations forward.
+     */
+    setReplacement(replacement: Cell<any>): void;
+    onStateChange(callback: () => void): void;
+    /**
+     * Set loading state. Forwards to replacement cell if this cell was replaced.
      */
     setLoading(isLoading: boolean): void;
+    /**
+     * Set cell value (public API, forwards to replacement if replaced).
+     */
+    setValueExternal(value: T): boolean;
     /**
      * Set disabled state
      */
@@ -3740,6 +3757,166 @@ declare class NileDatePickerEditor<T = string> implements CellEditor<T> {
     focus(): void;
 }
 
+/**
+ * Custom editor using NileCodeEditor from @aquera/nile-elements
+ * This provides code editing capabilities with syntax highlighting for table cells
+ */
+
+/**
+ * Autocompletion item configuration
+ */
+interface CodeEditorCompletion {
+    /** The completion label shown in dropdown */
+    label: string;
+    /** The value to insert */
+    value?: string;
+    /** Optional description */
+    detail?: string;
+}
+/**
+ * Autocomplete style configuration
+ */
+interface AutoCompleteStyle {
+    /** Width of the autocomplete dropdown */
+    width?: string;
+    /** Enable multiline content in autocomplete */
+    multiline?: boolean;
+}
+/**
+ * Options interface for NileCodeEditor
+ */
+interface NileCodeEditorOptions {
+    /** Language mode for syntax highlighting */
+    language?: 'javascript' | 'sql' | 'json' | 'html';
+    /** Disable syntax highlighting */
+    disableSyntaxHighlighting?: boolean;
+    /** Placeholder text when empty */
+    placeholder?: string;
+    /** Show line numbers (single-line mode) */
+    lineNumbers?: boolean;
+    /** Show line numbers in multiline mode */
+    lineNumbersMultiline?: boolean;
+    /** Allow multi-line editing */
+    multiline?: boolean;
+    /** Render without border */
+    noborder?: boolean;
+    /** Use default font instead of inherit */
+    defaultFont?: boolean;
+    /** Auto focus on edit */
+    autoFocus?: boolean;
+    /** Read-only mode */
+    readonly?: boolean;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Enable Tab-to-complete */
+    tabCompletion?: boolean;
+    /** Enable search keymap */
+    enableSearch?: boolean;
+    /** Show code folding gutters */
+    enableFoldGutters?: boolean;
+    /** Internal scroll container */
+    hasScroller?: boolean;
+    /** Show expand control (native nile-code-editor expand) */
+    expandable?: boolean;
+    /** Icon for expand control */
+    expandIcon?: string;
+    /** Show expand button to open full editor dialog (default: true) */
+    showExpandButton?: boolean;
+    /** Dialog title (default: 'Edit Code') */
+    dialogTitle?: string;
+    /** Dialog width (default: '600px') */
+    dialogWidth?: string;
+    /** Dialog max height (default: '80vh') */
+    dialogMaxHeight?: string;
+    /** Dialog editor min height (default: '300px') */
+    dialogEditorHeight?: string;
+    /** Minimum number of visible lines in the dialog editor (default: 20) */
+    dialogMinLines?: number;
+    /** Inline completion dataset */
+    customAutoCompletions?: Record<string, CodeEditorCompletion[]> | CodeEditorCompletion[];
+    /** Paths to fetch completion datasets from */
+    customCompletionsPaths?: string[];
+    /** Enable variables in suggestions */
+    allowVariableInCustomSuggestion?: boolean;
+    /** Show autocomplete above cursor */
+    aboveCursor?: boolean;
+    /** Style config for autocomplete dropdown */
+    autoCompleteStyle?: AutoCompleteStyle;
+    /** Debounce change events */
+    debounce?: boolean;
+    /** Debounce delay in ms */
+    debounceTimeout?: number;
+    /** Error state */
+    error?: boolean;
+    /** Error message to display */
+    errorMessage?: string;
+    /** Custom theme CSS object */
+    customThemeCSS?: Record<string, Record<string, string>>;
+    /** Validate before saving (default: true) */
+    validateOnSave?: boolean;
+}
+/**
+ * Custom editor that uses NileCodeEditor component
+ * Provides code editing with syntax highlighting for table cells
+ * @template T The value type (typically string)
+ */
+declare class NileCodeEditor<T = string> implements CellEditor<T> {
+    private readonly options?;
+    private editor?;
+    private wrapper?;
+    private expandButton?;
+    private dialog?;
+    private dialogEditor?;
+    private eventListeners;
+    private context?;
+    private dialogOpen;
+    private expandButtonClicked;
+    private documentClickHandler?;
+    private trackedValue;
+    constructor(options?: NileCodeEditorOptions | undefined);
+    edit(context: CellEditorContext<T>): void;
+    /**
+     * Focus the editor and place cursor
+     */
+    private focusEditor;
+    /**
+     * Read the live value directly from CodeMirror's internal state,
+     * bypassing debounced nile-change events and the possibly-stale .value property.
+     */
+    private getLiveEditorValue;
+    /**
+     * Open the full editor dialog
+     */
+    private openDialog;
+    /**
+     * Close the dialog and optionally save/exit edit mode
+     */
+    private closeDialog;
+    /**
+     * Apply all configuration options to the NileCodeEditor element
+     */
+    private applyOptions;
+    /**
+     * Set up all event listeners with proper cleanup tracking
+     */
+    private setupEventListeners;
+    /**
+     * Save value with optional validation
+     */
+    private saveValue;
+    destroy(): void;
+    focus(): void;
+    getCurrentValue(): T;
+    /**
+     * Set value programmatically
+     */
+    setValue(value: T): void;
+    /**
+     * Get the CodeMirror instance (if needed for advanced usage)
+     */
+    getEditorInstance(): any;
+}
+
 /**
  * Column configuration factory
  * Simplifies creation of common column types with sensible defaults
@@ -3830,7 +4007,9 @@ declare class StCellComponent implements OnInit, OnDestroy, AfterViewInit {
         direction: NavigationDirection;
     }>;
     editorContainer?: ElementRef;
+    cellLoading: boolean;
     private editorCleanup?;
+    private cdr;
     readonly isEditable: _angular_core.Signal<boolean>;
     readonly validationError: _angular_core.Signal<string | undefined>;
     readonly hasCellTemplate: _angular_core.Signal<boolean>;
@@ -5906,5 +6085,5 @@ declare class AutosaveService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AutosaveService>;
 }
 
-export { ArrayFormatter, AutosaveService, BaseColumnConfig, BooleanEditor, BooleanFormatter, BuilderPreviewComponent, BuilderToolbarComponent, Cell, CellAlignment, CellDataType, CellLifecycleState, CellVerticalAlignment, ChainValidator, ClickOutsideDirective, ColumnConfigFactory, ColumnEditorComponent, ColumnListComponent, Columns, CurrencyFormatter, DEFAULT_AUTOSAVE_CONFIG, DEFAULT_COLUMN_CONFIG, DEFAULT_TABLE_CONFIG, DateEditor, DateFormatter, DateRangeValidator, DefaultFormatter, DefinitionBuilderComponent, DefinitionBuilderModule, DefinitionBuilderService, DefinitionExportService, DefinitionImportService, EditMode, EmailValidator, FilterOperator, FunctionFormatter, FunctionValidator, JsonSchemaValidatorService, LengthValidator, NavigationDirection, NavigationKey, NileAutoCompleteEditor, NileCalendarEditor, NileDatePickerEditor, NileInputEditor, NileSelectEditor, NumberEditor, NumberFormatter, PatternValidators, PercentageFormatter, RangeValidator, RegexValidator, RequiredValidator, RowValidationService, SampleDataGeneratorService, SelectEditor, SharedTableComponentsModule, SheetState, SimpleColumnConfig, SmartTableModule, SortDirection, StAddColumnButtonComponent, StCellComponent, StColumnEditorModalComponent, StColumnFilterComponent, StColumnMenuDropdownComponent, StColumnResizeDirective, StColumnVisibilityComponent, StHeaderComponent, StKeyboardNavigationDirective, StPaginationComponent, StRowActionsDropdownComponent, StSheetActionsComponent, StSheetComponent, StTableActionsComponent, StTableComponent, StWorkbookComponent, StringFormatter, TableConfigEditorComponent, TableState, TableZIndex, TemplateFormatter, TextAreaEditor, TextEditor, UrlValidator, ValidationLoggerService, VirtualScrollService, WorkbookState, canEdit, createCellState, createMemento, isCellValid, isDisplayMode, isNullOrUndefined, isValidDate, isValidationSuccess, mergeTableConfig, restoreFromMemento };
-export type { AllowedDatesRange, AsyncCellValidator, AutoCompleteOption, AutosaveConfig, AutosaveData, AutosaveStrategy, BuilderState, CellCancelEvent, CellChangeEvent, CellEditEvent, CellEditor, CellEditorContext, CellEvent, CellEventHandler, CellFocusPosition, CellFormatter, CellLifecycleHooks, CellParser, CellSaveEvent, CellState, CellStateMemento, CellValidator, CellValue, ColumnAction, ColumnActionContext, ColumnActionEvent, ColumnAddEvent, ColumnConfig, ColumnConfigOptions, ColumnConfigWithKey, ColumnFilterEvent, ColumnFilterState, ColumnMoveEvent, ColumnResizeEvent, ColumnSortEvent, ColumnSortState, CompositeValidator, DataChangeEvent, DateRange, ExportOptions, FilterContext, FilterOptions, ImportResult, NileAutoCompleteEditorOptions, NileCalendarEditorOptions, NileDatePickerEditorOptions, NileInputEditorOptions, NileSelectEditorOptions, PaginationState, PartialColumnConfig, RowAction, RowActionContext, RowActionEvent, RowManagementConfig, RowValidationState, SelectOption, SheetAction, SheetActionContext, SheetActionEvent, SheetConfig, SheetMetadata, SheetStateConfig, SheetStateSnapshot, SheetTabAction, SheetTabActionEvent, TableConfig, TableStateChangeEvent, TableStateConfig, TableStateSnapshot, TableValidationState, ValidationError, ValidationLogEntry, ValidationResult, VirtualScrollState, WorkbookAction, WorkbookActionEvent, WorkbookConfig, WorkbookMetadata, WorkbookSheetConfig, WorkbookStateConfig, WorkbookStateSnapshot };
+export { ArrayFormatter, AutosaveService, BaseColumnConfig, BooleanEditor, BooleanFormatter, BuilderPreviewComponent, BuilderToolbarComponent, Cell, CellAlignment, CellDataType, CellLifecycleState, CellVerticalAlignment, ChainValidator, ClickOutsideDirective, ColumnConfigFactory, ColumnEditorComponent, ColumnListComponent, Columns, CurrencyFormatter, DEFAULT_AUTOSAVE_CONFIG, DEFAULT_COLUMN_CONFIG, DEFAULT_TABLE_CONFIG, DateEditor, DateFormatter, DateRangeValidator, DefaultFormatter, DefinitionBuilderComponent, DefinitionBuilderModule, DefinitionBuilderService, DefinitionExportService, DefinitionImportService, EditMode, EmailValidator, FilterOperator, FunctionFormatter, FunctionValidator, JsonSchemaValidatorService, LengthValidator, NavigationDirection, NavigationKey, NileAutoCompleteEditor, NileCalendarEditor, NileCodeEditor, NileDatePickerEditor, NileInputEditor, NileSelectEditor, NumberEditor, NumberFormatter, PatternValidators, PercentageFormatter, RangeValidator, RegexValidator, RequiredValidator, RowValidationService, SampleDataGeneratorService, SelectEditor, SharedTableComponentsModule, SheetState, SimpleColumnConfig, SmartTableModule, SortDirection, StAddColumnButtonComponent, StCellComponent, StColumnEditorModalComponent, StColumnFilterComponent, StColumnMenuDropdownComponent, StColumnResizeDirective, StColumnVisibilityComponent, StHeaderComponent, StKeyboardNavigationDirective, StPaginationComponent, StRowActionsDropdownComponent, StSheetActionsComponent, StSheetComponent, StTableActionsComponent, StTableComponent, StWorkbookComponent, StringFormatter, TableConfigEditorComponent, TableState, TableZIndex, TemplateFormatter, TextAreaEditor, TextEditor, UrlValidator, ValidationLoggerService, VirtualScrollService, WorkbookState, canEdit, createCellState, createMemento, isCellValid, isDisplayMode, isNullOrUndefined, isValidDate, isValidationSuccess, mergeTableConfig, restoreFromMemento };
+export type { AllowedDatesRange, AsyncCellValidator, AutoCompleteOption, AutoCompleteStyle, AutosaveConfig, AutosaveData, AutosaveStrategy, BuilderState, CellCancelEvent, CellChangeEvent, CellEditEvent, CellEditor, CellEditorContext, CellEvent, CellEventHandler, CellFocusPosition, CellFormatter, CellLifecycleHooks, CellParser, CellSaveEvent, CellState, CellStateMemento, CellValidator, CellValue, CodeEditorCompletion, ColumnAction, ColumnActionContext, ColumnActionEvent, ColumnAddEvent, ColumnConfig, ColumnConfigOptions, ColumnConfigWithKey, ColumnFilterEvent, ColumnFilterState, ColumnMoveEvent, ColumnResizeEvent, ColumnSortEvent, ColumnSortState, CompositeValidator, DataChangeEvent, DateRange, ExportOptions, FilterContext, FilterOptions, ImportResult, NileAutoCompleteEditorOptions, NileCalendarEditorOptions, NileCodeEditorOptions, NileDatePickerEditorOptions, NileInputEditorOptions, NileSelectEditorOptions, PaginationState, PartialColumnConfig, RowAction, RowActionContext, RowActionEvent, RowManagementConfig, RowValidationState, SelectOption, SheetAction, SheetActionContext, SheetActionEvent, SheetConfig, SheetMetadata, SheetStateConfig, SheetStateSnapshot, SheetTabAction, SheetTabActionEvent, TableConfig, TableStateChangeEvent, TableStateConfig, TableStateSnapshot, TableValidationState, ValidationError, ValidationLogEntry, ValidationResult, VirtualScrollState, WorkbookAction, WorkbookActionEvent, WorkbookConfig, WorkbookMetadata, WorkbookSheetConfig, WorkbookStateConfig, WorkbookStateSnapshot };