@aquera/ngx-smart-table 0.0.28 → 0.0.31

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "@aquera/ngx-smart-table",
-  "version": "0.0.28",
+  "version": "0.0.31",
   "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
-    "@aquera/nile": "^1.0.0",
-    "@aquera/nile-elements": "^1.4.4",
+    "@aquera/nile": "^1.2.4",
+    "@aquera/nile-elements": "^1.6.9",
     "rxjs": "^7.4.0"
   },
   "dependencies": {

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

@@ -976,6 +976,12 @@ interface ColumnConfig<T = any> {
      * Edit mode trigger
      */
     readonly editMode?: EditMode;
+    /**
+     * When `true` with {@link CellDataType.BOOLEAN}, the cell shows a `nile-checkbox` in display mode (inline toggle).
+     * When `false` or unset on other column setups, display uses the formatter (e.g. Yes/No).
+     * With `Columns.nileCheckbox(...)`, defaults to `true` unless you pass `booleanDisplayAsCheckbox: false`.
+     */
+    readonly booleanDisplayAsCheckbox?: boolean;
     /**
      * Whether this column is sortable
      */
@@ -1081,6 +1087,11 @@ interface ColumnConfig<T = any> {
      * @default true
      */
     readonly showStickyShadow?: boolean;
+    /**
+     * Background for this column’s cells when `sticky` is set (header + body).
+     * Falls back to `TableConfig.display.stickyColumnBackground` when omitted.
+     */
+    readonly stickyBackground?: string;
     /**
      * Cell content alignment
      */
@@ -1361,6 +1372,11 @@ declare class Cell<T = any> {
      * @param newValue The new value from editor
      */
     saveEdit(newValue: T): boolean;
+    /**
+     * Apply a new value from an inline display control (e.g. `nile-checkbox`) without entering edit mode.
+     * Runs the same validation, dirty-state, history, and save hooks as {@link saveEdit}.
+     */
+    commitDisplayValue(newValue: T): boolean;
     /**
      * Cancel edit and revert to previous value
      */
@@ -1958,6 +1974,10 @@ interface RowActionContext {
  * Provides a single source of truth for pagination, sorting, filtering, and display options
  */
 
+/** Context passed to `TableConfig.display.rowBackground`. */
+interface TableRowBackgroundContext {
+    rowIndex: number;
+}
 /**
  * Comprehensive table configuration interface
  */
@@ -2072,10 +2092,47 @@ interface TableConfig {
          */
         hover?: boolean;
         /**
-         * Max height of the table in pixels
+         * Max height of the table body scroll area in pixels (standard / non–virtual-scroll mode).
+         * Applied as `max-height` on the `.st-table` wrapper. Ignored for that sizing when `visibleBodyRows` is set.
+         * The host uses `min-height: 0` so flex parents (e.g. workbook tabs) honor the cap.
          * @default 300
          */
         maxHeight?: number;
+        /**
+         * Number of **data** (body) rows to keep visible before vertical scroll (standard mode only).
+         * Use **`0`** to show **all** rows: no row-count viewport and no `display.maxHeight` cap on `.st-table`
+         * (natural table height; page/parent may still scroll).
+         * For **positive** N, the table measures the header and the sum of the first N body row heights (capped
+         * by actual row count) and sets that viewport; it takes precedence over `maxHeight` for that wrapper.
+         * Not used when virtual scroll is enabled.
+         */
+        visibleBodyRows?: number;
+        /**
+         * Default background for sticky columns (row #, sticky-left / sticky-right cells) when the column has no `stickyBackground`.
+         */
+        stickyColumnBackground?: string;
+        /**
+         * When true, applies the sticky row background to every cell in each row (not only sticky-positioned columns).
+         * Each cell uses `column.stickyBackground` when set, otherwise `stickyColumnBackground`.
+         * @default false
+         */
+        stickyColumnBackgroundFullRow?: boolean;
+        /**
+         * Per-row background from row data. When a non-empty string is returned, it applies to every body cell in that row
+         * (row number, data cells, settings column). Return `undefined` / `null` / `''` to fall back to sticky / default styling.
+         * Not serializable in JSON configs (TypeScript only).
+         */
+        rowBackground?: (rowData: any, context: TableRowBackgroundContext) => string | null | undefined;
+        /**
+         * Customize the keyboard-focused cell outline (`.cell-focused` when keyboard navigation is enabled).
+         * Any property omitted keeps the library default.
+         */
+        focusedCell?: {
+            outlineColor?: string;
+            outlineWidth?: string;
+            boxShadow?: string;
+            editingBoxShadow?: string;
+        };
         /**
          * Virtual scroll configuration for large datasets
          * Enables efficient rendering by only showing visible rows
@@ -4035,6 +4092,8 @@ declare class NileCodeEditor<T = string> implements CellEditor<T> {
     private context?;
     private dialogOpen;
     private expandButtonClicked;
+    /** Pointer is down on a CodeMirror tooltip — skip blur-save so completion clicks are not treated as leaving the cell */
+    private codeMirrorUiPointerDown;
     private documentClickHandler?;
     private trackedValue;
     private syncingFromDialog;
@@ -4042,6 +4101,13 @@ declare class NileCodeEditor<T = string> implements CellEditor<T> {
     private dialogOriginalValue;
     private dialogCurrentValue;
     constructor(options?: NileCodeEditorOptions | undefined);
+    /**
+     * Parent CodeMirror tooltips to `document.body` so autocomplete is not clipped by the table/cell
+     * overflow chain. Uses runtime `import()` only — no extra entries in this library's package.json;
+     * modules resolve from the app via `@aquera/nile-elements` / `codemirror` (unchanged consumer graph).
+     */
+    private attachCodeMirrorTooltipsToBody;
+    private onNileCodeMirrorAfterUpdate;
     edit(context: CellEditorContext<T>): void;
     /**
      * Focus the editor and place cursor
@@ -4102,6 +4168,38 @@ declare class NileCodeEditor<T = string> implements CellEditor<T> {
     getEditorInstance(): any;
 }
 
+/**
+ * Boolean cell editor using `<nile-checkbox>` from @aquera/nile-elements`.
+ *
+ * For display (inline checkbox vs Yes/No text), set `booleanDisplayAsCheckbox` on the column config
+ * (`Columns.nileCheckbox` defaults it to `true`; pass `booleanDisplayAsCheckbox: false` for text until edit).
+ */
+
+interface NileCheckboxEditorOptions {
+    /** Checkbox size (default `small` for compact table cells) */
+    size?: 'small' | 'medium' | 'large';
+    disabled?: boolean;
+    /** Optional label text (Nile `label` attribute); leave empty for icon-only in-cell */
+    label?: string;
+    /** When true (default), each toggle calls `onSave` immediately */
+    saveOnChange?: boolean;
+    autoFocus?: boolean;
+}
+/**
+ * Uses Nile checkbox styling/behavior instead of a native `<input type="checkbox">`.
+ */
+declare class NileCheckboxEditor implements CellEditor<boolean> {
+    private readonly options?;
+    readonly acceptsInitialKeypress = false;
+    private checkbox?;
+    private readonly listeners;
+    constructor(options?: NileCheckboxEditorOptions | undefined);
+    edit(context: CellEditorContext<boolean>): void;
+    destroy(): void;
+    focus(): void;
+    getCurrentValue(): boolean;
+}
+
 /**
  * Column configuration factory
  * Simplifies creation of common column types with sensible defaults
@@ -4141,6 +4239,19 @@ declare class ColumnConfigFactory {
         trueValue?: string;
         falseValue?: string;
     }): ColumnConfig<boolean>;
+    /**
+     * Boolean column using {@link NileCheckboxEditor} (`<nile-checkbox>`) instead of a native checkbox.
+     *
+     * Display mode:
+     * - `booleanDisplayAsCheckbox` omitted or `true` — inline `nile-checkbox` in the cell (toggle without opening editor).
+     * - `booleanDisplayAsCheckbox: false` — show formatted text (`trueValue` / `falseValue`, default Yes/No) until the user edits the cell.
+     */
+    static nileCheckbox(key: string, options?: Partial<ColumnConfig<boolean>> & {
+        trueValue?: string;
+        falseValue?: string;
+        /** Options passed to {@link NileCheckboxEditor} */
+        nileCheckbox?: NileCheckboxEditorOptions;
+    }): ColumnConfig<boolean>;
     /**
      * Create a select/dropdown column
      */
@@ -4205,6 +4316,9 @@ declare class StCellComponent implements OnInit, OnDestroy, AfterViewInit {
         rowData: any;
         rowIndex: number | undefined;
     } | null>;
+    /** Boolean column: show `nile-checkbox` in display mode instead of Yes/No text */
+    readonly showBooleanCheckboxDisplay: _angular_core.Signal<boolean>;
+    readonly booleanCheckboxChecked: _angular_core.Signal<boolean>;
     ngOnInit(): void;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
@@ -4215,6 +4329,7 @@ declare class StCellComponent implements OnInit, OnDestroy, AfterViewInit {
     private startEditWithKey;
     onCellClick(): void;
     onCellDoubleClick(): void;
+    onBooleanCheckboxDisplayChange(event: Event): void;
     private startEdit;
     private renderEditor;
     private saveEdit;
@@ -4314,6 +4429,7 @@ declare class VirtualScrollService {
 
 declare class StTableComponent implements OnInit, OnChanges, OnDestroy, AfterViewInit {
     private destroyRef;
+    private injector;
     private schemaValidator;
     private logger;
     private virtualScrollService;
@@ -4383,12 +4499,12 @@ declare class StTableComponent implements OnInit, OnChanges, OnDestroy, AfterVie
         };
         context: ColumnActionContext | null;
     }>;
+    skeletonColumns?: number[];
+    skeletonRows?: number[];
     readonly virtualScrollTotalHeight$: BehaviorSubject<number>;
     readonly virtualScrollOffsetY$: BehaviorSubject<number>;
     readonly virtualScrollOffsetYNeg$: BehaviorSubject<number>;
     readonly visibleRows$: BehaviorSubject<Cell<any>[][]>;
-    skeletonColumns?: number[];
-    skeletonRows?: number[];
     private internalTableState?;
     private internalCellGrid?;
     private stateSubscription?;
@@ -4401,6 +4517,12 @@ declare class StTableComponent implements OnInit, OnChanges, OnDestroy, AfterVie
     private scrollContainer?;
     private scrollSubscription?;
     scrollViewport?: ElementRef<HTMLElement>;
+    /** Pixel height for `.st-table` when `display.visibleBodyRows` is set (measured from DOM). */
+    private readonly scrollViewportHeightPx;
+    private viewportMeasureRaf;
+    private tableResizeObserver;
+    private observedTableElement;
+    private readonly fallbackBodyRowPx;
     constructor();
     ngOnInit(): void;
     ngAfterViewInit(): void;
@@ -4470,6 +4592,43 @@ declare class StTableComponent implements OnInit, OnChanges, OnDestroy, AfterVie
     scrollToLastRow(focusFirstCell?: boolean): void;
     private getScrollContainerElement;
     private calculateStickyWidths;
+    /**
+     * Resolved CSS color from `display.rowBackground` for this row index, if any.
+     */
+    resolveRowBackground(rowIndex: number): string | undefined;
+    /**
+     * Body cell background: `rowBackground` wins when set; otherwise sticky / full-row tint via `stickyColumnBackground`.
+     */
+    bodyCellBackground(column: ColumnConfig | undefined, rowIndex: number): string | undefined;
+    /**
+     * Row-number cell background: conditional row color, else table sticky row-number tint.
+     */
+    rowNumberCellBackground(rowIndex: number): string | undefined;
+    /**
+     * Trailing settings / row-actions body cell background.
+     */
+    settingsColumnBodyBackground(rowIndex: number): string | undefined;
+    /**
+     * Cell background from sticky styling: per-column `stickyBackground`, else `display.stickyColumnBackground`.
+     * When `display.stickyColumnBackgroundFullRow` is true, applies to every data cell (not only sticky columns).
+     */
+    stickyColumnBackground(column: ColumnConfig | undefined): string | undefined;
+    /** Row # column is sticky-left; uses table-level `display.stickyColumnBackground` only. */
+    rowNumberStickyBackground(): string | undefined;
+    /** Positive row counts only (caller must ensure `raw > 0`). */
+    private clampPositiveVisibleBodyRows;
+    private fallbackViewportPxForRowCount;
+    /** Effective body rows for viewport math: never more than rows actually rendered. */
+    private effectiveVisibleBodyRows;
+    private scheduleScrollViewportMeasure;
+    /**
+     * Sets `scrollViewportHeightPx` from measured thead/tbody row heights so `visibleBodyRows` maps to real pixels.
+     */
+    private updateScrollViewportMeasurement;
+    private ensureTableResizeObserver;
+    private detachTableResizeObserver;
+    /** Host styles: max-height plus CSS variables for keyboard-focused cell (see `display.focusedCell`). */
+    tableWrapperStyle(): Record<string, string | number | null>;
     onCellClick(rowIndex: number, columnIndex: number): void;
     onCellEdit(event: CellEditEvent): void;
     onCellSave(event: CellSaveEvent): void;
@@ -5273,6 +5432,7 @@ declare class StWorkbookComponent implements OnInit, OnChanges, OnDestroy {
     private destroyRef;
     private autosaveService;
     private cdr;
+    private injector;
     readonly config: _angular_core.InputSignal<WorkbookConfig>;
     readonly sheetsData: _angular_core.InputSignal<BehaviorSubject<Map<string, any[]>>>;
     readonly state: _angular_core.InputSignal<WorkbookState | undefined>;
@@ -5289,6 +5449,7 @@ declare class StWorkbookComponent implements OnInit, OnChanges, OnDestroy {
         focusColumn?: number;
     }>;
     tableComponent?: StTableComponent;
+    workbookTabGroup?: ElementRef<HTMLElement>;
     readonly sheets: _angular_core.WritableSignal<WorkbookSheetConfig[]>;
     readonly activeSheetIndex: _angular_core.WritableSignal<number>;
     readonly currentTableConfig: _angular_core.WritableSignal<TableConfig | null>;
@@ -5319,6 +5480,17 @@ declare class StWorkbookComponent implements OnInit, OnChanges, OnDestroy {
     get activeState(): WorkbookState;
     onTabChange(event: any): void;
     private updateActiveSheet;
+    /**
+     * After a new sheet is appended, scroll the tab strip so the new tab clears the sticky toolbar overlay
+     * and move keyboard focus to that tab.
+     */
+    private scheduleScrollAndFocusNewSheetTab;
+    /**
+     * Scroll the active sheet tab into the visible part of the nav (left of the sticky toolbar).
+     * No extra flex margin — avoids a permanent gap between the last sheet tab and the toolbar.
+     */
+    private queueScrollActiveSheetTabClearOfToolbar;
+    private scrollSheetTabIntoNav;
     onAddSheet(): void;
     trackByKey(index: number, key: string): string;
     get canAddSheet(): boolean;
@@ -5333,7 +5505,12 @@ declare class StWorkbookComponent implements OnInit, OnChanges, OnDestroy {
     isActionDisabled(action: WorkbookAction): boolean;
     onWorkbookActionClick(action: WorkbookAction, event: Event): void;
     toggleFullscreen(): void;
+    /**
+     * Keeps `sheetsData` in sync with the grid: patches `row[columnKey]` from the cell event then `next()`s the map.
+     * Initial rows still come from the host (e.g. demo `loadSheetsData`); edits persist here in memory.
+     */
     onCellChange(event: CellChangeEvent): void;
+    /** Same row patch as {@link onCellChange}; host apps receive this output after data is updated. */
     onCellSave(event: any): void;
     onTableStateChange(event: TableStateChangeEvent): void;
     onRequestAddRow(event: {
@@ -6278,5 +6455,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, NileChipEditor, NileCodeEditor, NileDatePickerEditor, NileInputEditor, NileSelectEditor, NumberEditor, NumberFormatter, OUFormatter, 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, dnToHumanReadable, isCellValid, isDisplayMode, isNullOrUndefined, isValidDate, isValidationSuccess, mergeTableConfig, registerFormatter, resolveFormatter, 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, ChipOption, CodeEditorCompletion, ColumnAction, ColumnActionContext, ColumnActionEvent, ColumnAddEvent, ColumnConfig, ColumnConfigOptions, ColumnConfigWithKey, ColumnFilterEvent, ColumnFilterState, ColumnMoveEvent, ColumnResizeEvent, ColumnSortEvent, ColumnSortState, CompositeValidator, DataChangeEvent, DateRange, ExportOptions, FilterContext, FilterOptions, ImportResult, NileAutoCompleteEditorOptions, NileCalendarEditorOptions, NileChipEditorOptions, NileCodeEditorOptions, NileDatePickerEditorOptions, NileInputEditorOptions, NileSelectEditorOptions, OUFormatterOptions, 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, NileCheckboxEditor, NileChipEditor, NileCodeEditor, NileDatePickerEditor, NileInputEditor, NileSelectEditor, NumberEditor, NumberFormatter, OUFormatter, 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, dnToHumanReadable, isCellValid, isDisplayMode, isNullOrUndefined, isValidDate, isValidationSuccess, mergeTableConfig, registerFormatter, resolveFormatter, 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, ChipOption, CodeEditorCompletion, ColumnAction, ColumnActionContext, ColumnActionEvent, ColumnAddEvent, ColumnConfig, ColumnConfigOptions, ColumnConfigWithKey, ColumnFilterEvent, ColumnFilterState, ColumnMoveEvent, ColumnResizeEvent, ColumnSortEvent, ColumnSortState, CompositeValidator, DataChangeEvent, DateRange, ExportOptions, FilterContext, FilterOptions, ImportResult, NileAutoCompleteEditorOptions, NileCalendarEditorOptions, NileCheckboxEditorOptions, NileChipEditorOptions, NileCodeEditorOptions, NileDatePickerEditorOptions, NileInputEditorOptions, NileSelectEditorOptions, OUFormatterOptions, PaginationState, PartialColumnConfig, RowAction, RowActionContext, RowActionEvent, RowManagementConfig, RowValidationState, SelectOption, SheetAction, SheetActionContext, SheetActionEvent, SheetConfig, SheetMetadata, SheetStateConfig, SheetStateSnapshot, SheetTabAction, SheetTabActionEvent, TableConfig, TableRowBackgroundContext, TableStateChangeEvent, TableStateConfig, TableStateSnapshot, TableValidationState, ValidationError, ValidationLogEntry, ValidationResult, VirtualScrollState, WorkbookAction, WorkbookActionEvent, WorkbookConfig, WorkbookMetadata, WorkbookSheetConfig, WorkbookStateConfig, WorkbookStateSnapshot };