@aquera/ngx-smart-table 0.0.24 → 0.0.25

package/package.json

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

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

@@ -951,9 +951,11 @@ interface ColumnConfig<T = any> {
      */
     readonly dataType?: CellDataType;
     /**
-     * Formatter strategy for displaying cell values
+     * Formatter strategy for displaying cell values.
+     * Can be a CellFormatter instance or a predefined formatter name string
+     * (e.g. 'ouFormatter'). Use registerFormatter() to add custom named formatters.
      */
-    readonly formatter?: CellFormatter<T>;
+    readonly formatter?: CellFormatter<T> | string;
     /**
      * Validator strategy for validating cell values
      */
@@ -2845,7 +2847,7 @@ declare abstract class BaseColumnConfig<T = any> implements ColumnConfig<T> {
     readonly key: string;
     readonly header?: string;
     readonly dataType?: CellDataType;
-    readonly formatter?: CellFormatter<T>;
+    readonly formatter?: CellFormatter<T> | string;
     readonly validator?: CellValidator<T>;
     readonly editor?: CellEditor<T>;
     readonly parser?: CellParser<T>;
@@ -3062,6 +3064,63 @@ declare class DefaultFormatter implements CellFormatter<any> {
     format(value: any): string;
 }
 
+/**
+ * Convert an LDAP Distinguished Name (DN) string to a human-readable path.
+ *
+ * @example
+ * "OU=Engineering,OU=India,DC=company,DC=com"
+ *   → "Engineering / India (company.com)"
+ *
+ * "CN=John Smith,OU=Admins,OU=Engineering,DC=company,DC=com"
+ *   → "John Smith / Admins / Engineering (company.com)"
+ *
+ * "OU=R\\,D,OU=Teams,DC=example,DC=org"
+ *   → "R,D / Teams (example.org)"
+ */
+declare function dnToHumanReadable(dn: string): string;
+interface OUFormatterOptions {
+    /** Separator between OU components (default: ' / ') */
+    separator?: string;
+    /** Whether to show the domain suffix from DC components (default: true) */
+    showDomain?: boolean;
+    /** Fallback text when value is empty or not a valid DN (default: '') */
+    emptyText?: string;
+    /** Separator between multiple formatted DNs when value is an array (default: ', ') */
+    arraySeparator?: string;
+}
+/**
+ * Cell formatter that converts LDAP Distinguished Name (DN) strings
+ * into human-readable OU paths with optional domain suffix.
+ *
+ * @example
+ * // In column config:
+ * formatter: new OUFormatter()
+ *
+ * // With options:
+ * formatter: new OUFormatter({ separator: ' > ', showDomain: false })
+ *
+ * // Handles arrays from multiselect:
+ * // ['OU=Eng,DC=co,DC=com', 'OU=HR,DC=co,DC=com'] → "Eng (co.com), HR (co.com)"
+ */
+declare class OUFormatter implements CellFormatter<string | string[]> {
+    private readonly options?;
+    constructor(options?: OUFormatterOptions | undefined);
+    format(value: string | string[]): string;
+    private formatSingle;
+}
+
+type FormatterFactory = () => CellFormatter<any>;
+/**
+ * Resolve a formatter by name. Looks up custom formatters first, then built-in.
+ * Returns undefined if the name is not registered.
+ */
+declare function resolveFormatter(name: string): CellFormatter<any> | undefined;
+/**
+ * Register a custom formatter so it can be referenced by string name
+ * in column configs (e.g. `formatter: 'myFormatter'`).
+ */
+declare function registerFormatter(name: string, factory: FormatterFactory): void;
+
 /**
  * Default validator implementations
  */
@@ -6104,5 +6163,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, 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 };
+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, 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, 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, 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 };