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

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.5",
   "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';