@ngx-smz/core 21.7.2 → 21.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngx-smz/core",
-  "version": "21.7.2",
+  "version": "21.8.0",
   "peerDependencies": {
     "@angular/animations": ">=21.0.0 <22.0.0",
     "@angular/common": ">=21.0.0 <22.0.0",

package/types/ngx-smz-core.d.ts

@@ -7656,6 +7656,19 @@ declare class SmzContentActionIconBuilder<TColumn extends SmzBaseColumnBuilder<T
     get action(): SmzHeaderActionsBuilder<TColumn, TData>;
 }
 
+type DecrementColumnPathDepth = [never, 0, 1, 2, 3, 4];
+type IsAnyType<TValue> = 0 extends (1 & TValue) ? true : false;
+type UnresolvedColumnFieldValue = any;
+type SpecificColumnPropertyNames<TData> = keyof TData extends infer PropertyName ? PropertyName extends string ? string extends PropertyName ? never : PropertyName : never : never;
+type NestedColumnObject<TValue> = IsAnyType<TValue> extends true ? never : NonNullable<TValue> extends readonly unknown[] ? never : NonNullable<TValue> extends Date ? never : NonNullable<TValue> extends (...args: any[]) => unknown ? never : NonNullable<TValue> extends object ? NonNullable<TValue> : never;
+type ColumnPropertyPath<TData, TDepth extends number = 4> = IsAnyType<TData> extends true ? string : TData extends unknown ? BuildColumnPropertyPath<NonNullable<TData>, TDepth> : never;
+type ColumnFieldName<TData> = IsAnyType<TData> extends true ? string : ColumnPropertyPath<TData> | (string & {});
+type ColumnFieldValue<TData, TField extends string> = IsAnyType<TData> extends true ? UnresolvedColumnFieldValue : string extends TField ? UnresolvedColumnFieldValue : TData extends unknown ? ResolveColumnFieldValue<NonNullable<TData>, TField> : never;
+type BuildColumnPropertyPath<TData, TDepth extends number> = TData extends object ? {
+    [PropertyName in SpecificColumnPropertyNames<TData>]: PropertyName | (NestedColumnObject<TData[PropertyName]> extends never ? never : TDepth extends 0 ? never : `${PropertyName}.${BuildColumnPropertyPath<NestedColumnObject<TData[PropertyName]>, DecrementColumnPathDepth[TDepth]>}`);
+}[SpecificColumnPropertyNames<TData>] : never;
+type ResolveColumnFieldValue<TData, TField extends string> = IsAnyType<TData> extends true ? UnresolvedColumnFieldValue : TField extends `${infer PropertyName}.${infer RemainingPath}` ? PropertyName extends keyof TData ? ResolveColumnFieldValue<NonNullable<TData[PropertyName]>, RemainingPath> : UnresolvedColumnFieldValue : TField extends keyof TData ? TData[TField] : UnresolvedColumnFieldValue;
+
 declare abstract class SmzBaseColumnBuilder<T extends SmzBaseColumnBuilder<T, TData>, TData> {
     protected tableRef: SmzTableBuilder<TData>;
     protected parentRef: SmzColumnCollectionBuilder<TData>;
@@ -7707,46 +7720,46 @@ declare class SmzTextColumnBuilder<TData> extends SmzBaseColumnBuilder<SmzTextCo
     constructor(tableRef: SmzTableBuilder<TData>, parentRef: SmzColumnCollectionBuilder<TData>, field: string, header: string, width?: string);
     setFilter(type: SmzFilterType): SmzTextColumnBuilder<TData>;
 }
-declare class SmzCustomColumnBuilder<TData> extends SmzBaseColumnBuilder<SmzCustomColumnBuilder<TData>, TData> {
+declare class SmzCustomColumnBuilder<TData, TField extends string = string> extends SmzBaseColumnBuilder<SmzCustomColumnBuilder<TData, TField>, TData> {
     protected tableRef: SmzTableBuilder<TData>;
     protected parentRef: SmzColumnCollectionBuilder<TData>;
     protected that: this;
-    constructor(tableRef: SmzTableBuilder<TData>, parentRef: SmzColumnCollectionBuilder<TData>, field: string, header: string, width?: string);
-    setFilter(type: SmzFilterType): SmzCustomColumnBuilder<TData>;
-    enableSort(): SmzCustomColumnBuilder<TData>;
-    forceGlobalFilter(): SmzCustomColumnBuilder<TData>;
-    setFilterableData(getFilterableDataCallback: (data: unknown, row: unknown, index: number) => string): SmzCustomColumnBuilder<TData>;
+    constructor(tableRef: SmzTableBuilder<TData>, parentRef: SmzColumnCollectionBuilder<TData>, field: TField, header: string, width?: string);
+    setFilter(type: SmzFilterType): this;
+    enableSort(): this;
+    forceGlobalFilter(): this;
+    setFilterableData(getFilterableDataCallback: (data: ColumnFieldValue<TData, TField>, row: TData, index: number) => string): this;
 }
-declare class SmzIconColumnBuilder<TData> extends SmzBaseColumnBuilder<SmzIconColumnBuilder<TData>, TData> {
+declare class SmzIconColumnBuilder<TData, TField extends string = string> extends SmzBaseColumnBuilder<SmzIconColumnBuilder<TData, TField>, TData> {
     protected tableRef: SmzTableBuilder<TData>;
     protected parentRef: SmzColumnCollectionBuilder<TData>;
     protected that: this;
-    constructor(tableRef: SmzTableBuilder<TData>, parentRef: SmzColumnCollectionBuilder<TData>, field: string, header: string, width?: string);
-    addIconConfiguration(icon: string, value: unknown, styleClass?: string | null, tooltip?: string | null): SmzIconColumnBuilder<TData>;
-    setFilter(type: SmzFilterType): SmzIconColumnBuilder<TData>;
-    forceGlobalFilter(): SmzIconColumnBuilder<TData>;
-    setFilterableData(getFilterableDataCallback: (data: unknown, row: unknown, index: number) => string): SmzIconColumnBuilder<TData>;
+    constructor(tableRef: SmzTableBuilder<TData>, parentRef: SmzColumnCollectionBuilder<TData>, field: TField, header: string, width?: string);
+    addIconConfiguration(icon: string, value: unknown, styleClass?: string | null, tooltip?: string | null): this;
+    setFilter(type: SmzFilterType): this;
+    forceGlobalFilter(): this;
+    setFilterableData(getFilterableDataCallback: (data: ColumnFieldValue<TData, TField>, row: TData, index: number) => string): this;
 }
-declare class SmzDataTransformColumnBuilder<TData> extends SmzBaseColumnBuilder<SmzDataTransformColumnBuilder<TData>, TData> {
+declare class SmzDataTransformColumnBuilder<TData, TField extends string = string> extends SmzBaseColumnBuilder<SmzDataTransformColumnBuilder<TData, TField>, TData> {
     protected tableRef: SmzTableBuilder<TData>;
     protected parentRef: SmzColumnCollectionBuilder<TData>;
     protected that: this;
-    constructor(tableRef: SmzTableBuilder<TData>, parentRef: SmzColumnCollectionBuilder<TData>, field: string, header: string, callback: (data: unknown, row: unknown, index: number) => string, width?: string);
-    setFilter(type: SmzFilterType): SmzDataTransformColumnBuilder<TData>;
-    filterWithTransformedData(): SmzDataTransformColumnBuilder<TData>;
-    ignoreTransformOnExport(): SmzDataTransformColumnBuilder<TData>;
-    setFilterableData(getFilterableDataCallback: (data: unknown, row: unknown, index: number) => string): SmzDataTransformColumnBuilder<TData>;
+    constructor(tableRef: SmzTableBuilder<TData>, parentRef: SmzColumnCollectionBuilder<TData>, field: TField, header: string, callback: (data: ColumnFieldValue<TData, TField>, row: TData, index: number) => string, width?: string);
+    setFilter(type: SmzFilterType): this;
+    filterWithTransformedData(): this;
+    ignoreTransformOnExport(): this;
+    setFilterableData(getFilterableDataCallback: (data: ColumnFieldValue<TData, TField>, row: TData, index: number) => string): this;
 }
 declare class SmzColumnCollectionBuilder<TData> extends SmzBuilderUtilities<SmzColumnCollectionBuilder<TData>> {
     private tableRefBuilder;
     protected that: this;
     constructor(tableRefBuilder: SmzTableBuilder<TData>);
     text(field: string, header: string, width?: string): SmzTextColumnBuilder<TData>;
-    custom(field: string, header: string, width?: string): SmzCustomColumnBuilder<TData>;
-    icon(field: string, header: string, width?: string): SmzIconColumnBuilder<TData>;
+    custom<TField extends ColumnFieldName<TData>>(field: TField, header: string, width?: string): SmzCustomColumnBuilder<TData, TField>;
+    icon<TField extends ColumnFieldName<TData>>(field: TField, header: string, width?: string): SmzIconColumnBuilder<TData, TField>;
     date(field: string, header: string, width?: string): SmzDateColumnBuilder<TData>;
     currency(field: string, header: string, width?: string): SmzCurrencyColumnBuilder<TData>;
-    dataTransform(field: string, header: string, callback: (data: any, row: TData, index: number) => string, width?: string): SmzDataTransformColumnBuilder<TData>;
+    dataTransform<TField extends ColumnFieldName<TData>>(field: TField, header: string, callback: (data: ColumnFieldValue<TData, NoInfer<TField>>, row: TData, index: number) => string, width?: string): SmzDataTransformColumnBuilder<TData, TField>;
     get table(): SmzTableBuilder<TData>;
 }