@aquera/ngx-smart-table 0.0.17-patch-0.4 → 0.0.17-patch-0.6

package/lib/editors/index.d.ts

@@ -6,4 +6,5 @@ export { NileSelectEditor, NileSelectEditorOptions, SelectOption } from './nile-
 export { NileAutoCompleteEditor, NileAutoCompleteEditorOptions, AutoCompleteOption } from './nile-autocomplete-editor';
 export { NileCalendarEditor, NileCalendarEditorOptions, AllowedDatesRange } from './nile-calendar-editor';
 export { NileDatePickerEditor, NileDatePickerEditorOptions, DateRange } from './nile-date-picker-editor';
+export { NileChipEditor, NileChipEditorOptions, ChipOption } from './nile-chip-editor';
 export { NileCodeEditor, NileCodeEditorOptions, CodeEditorCompletion, AutoCompleteStyle } from './nile-code-editor';

package/lib/editors/nile-chip-editor.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Custom editor using NileChip from @aquera/nile-elements
+ * Renders the chip input in a floating popover below the cell to avoid row height mismatch.
+ *
+ * @see https://nile.aqueralabs.com/1.6.3/chip?theme=enterprise
+ */
+import { CellEditor, CellEditorContext } from '../models/cell-strategies.interface';
+/**
+ * Chip option for autocomplete suggestions
+ */
+export interface ChipOption {
+    /** The option's value */
+    value: string;
+    /** Display label for the option (defaults to value if omitted) */
+    label?: string;
+}
+/**
+ * Options interface for NileChipEditor
+ */
+export interface NileChipEditorOptions {
+    /** Autocomplete suggestion list (full set) */
+    autoCompleteOptions?: ChipOption[] | string[];
+    /** Placeholder text shown inside the input area */
+    placeholder?: string;
+    /** Allow users to type custom values not present in the suggestion list */
+    acceptUserInput?: boolean;
+    /** Prevent duplicate chip values */
+    noDuplicates?: boolean;
+    /** Disable the chip input */
+    disabled?: boolean;
+    /** Make the chip input readonly */
+    readonly?: boolean;
+    /** Show a clear-all button */
+    clearable?: boolean;
+    /** Prevent chip tags from wrapping to multiple lines */
+    noWrap?: boolean;
+    /** Remove the autocomplete dropdown entirely */
+    noAutoComplete?: boolean;
+    /** Enable virtual scrolling in the suggestion dropdown */
+    enableVirtualScroll?: boolean;
+    /** Control whether the dropdown opens on focus — 'true' | 'false' | 'always' */
+    openDropdownOnFocus?: string;
+    /** Show loading spinner inside the dropdown */
+    loading?: boolean;
+    /** Warning state styling */
+    warning?: boolean;
+    /** Error state styling */
+    error?: boolean;
+    /** Success state styling */
+    success?: boolean;
+    /** Error message shown below the input */
+    errorMessage?: string;
+    /** Help text shown below the input */
+    helpText?: string;
+    /** Label text for the chip input */
+    label?: string;
+    /** Indexes of chips to highlight as errors */
+    errorIndexes?: number[];
+    /** Custom filter function for autocomplete */
+    filterFunction?: (query: string, option: string) => boolean;
+    /** Custom render function for dropdown items */
+    renderItemFunction?: (option: string) => string;
+    /** Auto-focus the input when editor opens (default: true) */
+    autoFocus?: boolean;
+    /** Minimum width of the popover in px (default: width of the cell) */
+    popoverMinWidth?: number;
+    /** Maximum height of the popover in px before it scrolls (default: 200) */
+    popoverMaxHeight?: number;
+}
+/**
+ * Custom editor that uses NileChip (tag input) component.
+ * Renders in a floating popover below the cell to avoid expanding row height.
+ *
+ * Cell value is expected to be `string[]` (array of tag strings).
+ */
+export declare class NileChipEditor implements CellEditor<string[]> {
+    private readonly options?;
+    acceptsInitialKeypress: boolean;
+    private chip?;
+    private popover?;
+    private cellContainer?;
+    private eventListeners;
+    private trackedValues;
+    constructor(options?: NileChipEditorOptions | undefined);
+    edit(context: CellEditorContext<string[]>): void;
+    private positionPopover;
+    private setInitialValue;
+    private applyOptions;
+    private addListener;
+    private setupEventListeners;
+    destroy(): void;
+    focus(): void;
+    getCurrentValue(): string[];
+}

package/lib/formatters/formatter-registry.d.ts

@@ -0,0 +1,13 @@
+import { CellFormatter } from '../models/cell-strategies.interface';
+declare 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.
+ */
+export 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'`).
+ */
+export declare function registerFormatter(name: string, factory: FormatterFactory): void;
+export {};

package/lib/formatters/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ou-formatter';
+export * from './formatter-registry';

package/lib/formatters/ou-formatter.d.ts

@@ -0,0 +1,45 @@
+import { CellFormatter } from '../models/cell-strategies.interface';
+/**
+ * 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)"
+ */
+export declare function dnToHumanReadable(dn: string): string;
+export 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)"
+ */
+export declare class OUFormatter implements CellFormatter<string | string[]> {
+    private readonly options?;
+    constructor(options?: OUFormatterOptions | undefined);
+    format(value: string | string[]): string;
+    private formatSingle;
+}

package/lib/models/base-column-config.class.d.ts

@@ -14,7 +14,7 @@ export declare abstract class BaseColumnConfig<T = any> implements ColumnConfig<
     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>;

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

@@ -49,9 +49,11 @@ export 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
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aquera/ngx-smart-table",
-  "version": "0.0.17-patch-0.4",
+  "version": "0.0.17-patch-0.6",
   "license": "MIT",
   "peerDependencies": {
     "@angular/common": ">=13.0.0 <16.0.0",

package/public-api.d.ts

@@ -25,6 +25,7 @@ export * from './lib/renderer/models/workbook-state.class';
 export * from './lib/renderer/models/cell.class';
 export * from './lib/models/base-column-config.class';
 export * from './lib/strategies/default-formatters';
+export * from './lib/formatters/index';
 export * from './lib/strategies/default-validators';
 export * from './lib/renderer/models/row-validation-state.interface';
 export * from './lib/renderer/models/table-validation-state.interface';