ucol-ui 0.1.42 → 0.1.43

package/dist/ucol-ui.d.ts

@@ -20,6 +20,7 @@ export declare interface ActionConfig<T extends Record<string, unknown> = Record
     showView?: boolean | ((record: T) => boolean);
     customIcons?: ActionIcons;
     refreshButtonText?: string;
+    useDefaultDeleteConfirm?: boolean;
     customActionsColor?: {
         edit?: string;
         delete?: string;
@@ -180,6 +181,38 @@ export declare interface ColumnsProps<T = Record<string, unknown>> {
     sorter?: boolean | ((a: T, b: T) => number);
 }
 
+/**
+ * Combina múltiples condiciones con operador AND
+ * @param conditions - Array de funciones de condición
+ * @returns Función que retorna true solo si todas las condiciones son verdaderas
+ *
+ * @example
+ * // Mostrar acciones solo si es draft Y pertenece al usuario actual
+ * actionConfig: {
+ *   showEdit: combineConditions([
+ *     showActionWhen('status', 'draft'),
+ *     hideActionWhen('user.uuid', currentUserUuid)
+ *   ])
+ * }
+ */
+export declare const combineConditions: <T extends Record<string, unknown>>(conditions: Array<(record: T) => boolean>) => (record: T) => boolean;
+
+/**
+ * Combina múltiples condiciones con operador OR
+ * @param conditions - Array de funciones de condición
+ * @returns Función que retorna true si al menos una condición es verdadera
+ *
+ * @example
+ * // Mostrar acciones si es draft O es del usuario actual
+ * actionConfig: {
+ *   showEdit: combineConditionsOr([
+ *     showActionWhen('status', 'draft'),
+ *     showActionWhen('user.uuid', currentUserUuid)
+ *   ])
+ * }
+ */
+export declare const combineConditionsOr: <T extends Record<string, unknown>>(conditions: Array<(record: T) => boolean>) => (record: T) => boolean;
+
 /**
  * Crea un generador de acciones tipado para un tipo específico
  * @returns Una función createMoreAction tipada con T
@@ -396,6 +429,14 @@ export declare interface FilterItem {
     children?: FilterItem[];
 }
 
+/**
+ * Convierte un objeto anidado en un objeto plano con notación de punto.
+ * @param obj Objeto con estructura anidada (ej: {user: {first_name: "John"}})
+ * @param parentKey Prefijo para las keys (usado internamente en la recursión)
+ * @returns Objeto plano con keys en notación de punto (ej: {"user.first_name": "John"})
+ */
+export declare const flattenObject: (obj: Record<string, unknown>, parentKey?: string) => Record<string, unknown>;
+
 export declare interface FormField {
     type: FieldType;
     name: string;
@@ -433,6 +474,52 @@ export declare const generateColumns: <T extends object>(fields: Record<string,
  */
 export declare const generateFields: (fields: Record<string, SharedFieldConfig>) => FormField[];
 
+/**
+ * Función auxiliar para acceder a propiedades anidadas usando notación de punto.
+ * @param obj Objeto del cual extraer el valor.
+ * @param path Ruta de la propiedad (ej: "user.first_name").
+ * @returns Valor de la propiedad anidada o undefined si no existe.
+ */
+export declare const getNestedValue: <T extends object>(obj: T, path: string) => unknown;
+
+/**
+ * Crea una función que oculta acciones cuando un campo del registro coincide con un valor específico
+ * @param fieldPath - Ruta del campo a comparar (soporta notación de punto para campos anidados)
+ * @param value - Valor con el que comparar
+ * @returns Función que retorna false si el valor coincide, true en caso contrario
+ *
+ * @example
+ * // Ocultar acciones si el estado es 'archived'
+ * actionConfig: {
+ *   showEdit: hideActionWhen('status', 'archived'),
+ *   showDelete: hideActionWhen('status', 'archived')
+ * }
+ *
+ * @example
+ * // Ocultar acciones si el user.uuid coincide con el uuid del usuario actual
+ * const currentUserUuid = '123-456';
+ * actionConfig: {
+ *   showEdit: hideActionWhen('user.uuid', currentUserUuid),
+ *   showDelete: hideActionWhen('user.uuid', currentUserUuid)
+ * }
+ */
+export declare const hideActionWhen: <T extends Record<string, unknown>>(fieldPath: string, value: unknown) => (record: T) => boolean;
+
+/**
+ * Crea una función que oculta acciones cuando un campo del registro está incluido en una lista de valores
+ * @param fieldPath - Ruta del campo a comparar
+ * @param values - Array de valores a comparar
+ * @returns Función que retorna false si el valor está en la lista, true en caso contrario
+ *
+ * @example
+ * // Ocultar acciones si el estado es 'archived' o 'deleted'
+ * actionConfig: {
+ *   showEdit: hideActionWhenIn('status', ['archived', 'deleted']),
+ *   showDelete: hideActionWhenIn('status', ['archived', 'deleted'])
+ * }
+ */
+export declare const hideActionWhenIn: <T extends Record<string, unknown>>(fieldPath: string, values: unknown[]) => (record: T) => boolean;
+
 export declare interface MoreActions<T = Record<string, unknown>> {
     key: string;
     label?: string;
@@ -451,6 +538,19 @@ declare type MutationConfig<TData, TError, TVariables> = {
     onSettled?: (data: TData | undefined, error: TError | null) => void;
 };
 
+/**
+ * Niega una condición
+ * @param condition - Función de condición a negar
+ * @returns Función que retorna el opuesto de la condición
+ *
+ * @example
+ * // Ocultar acciones si NO es draft
+ * actionConfig: {
+ *   showEdit: not(showActionWhen('status', 'draft'))
+ * }
+ */
+export declare const not: <T extends Record<string, unknown>>(condition: (record: T) => boolean) => (record: T) => boolean;
+
 /**
  * Componente de Notificación
  * @description Muestra una notificación con un mensaje
@@ -560,6 +660,14 @@ export declare interface SelectDependencyConfig {
     transformRequest?: (value: string | number) => Record<string, string>;
 }
 
+/**
+ * Función auxiliar para establecer propiedades anidadas usando notación de punto.
+ * @param obj Objeto en el cual establecer el valor.
+ * @param path Ruta de la propiedad (ej: "user.first_name").
+ * @param value Valor a establecer.
+ */
+export declare const setNestedValue: (obj: Record<string, unknown>, path: string, value: unknown) => void;
+
 export declare interface SharedFieldConfig<T = Record<string, unknown>> {
     key: string;
     title: string;
@@ -597,6 +705,21 @@ export declare interface SharedFieldConfig<T = Record<string, unknown>> {
     radioConfig?: RadioConfig;
 }
 
+/**
+ * Crea una función que muestra acciones solo cuando un campo del registro coincide con un valor específico
+ * @param fieldPath - Ruta del campo a comparar (soporta notación de punto para campos anidados)
+ * @param value - Valor con el que comparar
+ * @returns Función que retorna true si el valor coincide, false en caso contrario
+ *
+ * @example
+ * // Mostrar acciones solo si el estado es 'draft'
+ * actionConfig: {
+ *   showEdit: showActionWhen('status', 'draft'),
+ *   showDelete: showActionWhen('status', 'draft')
+ * }
+ */
+export declare const showActionWhen: <T extends Record<string, unknown>>(fieldPath: string, value: unknown) => (record: T) => boolean;
+
 declare type SortFunction<T> = (a: T, b: T) => number;
 
 /**
@@ -639,6 +762,13 @@ export declare interface ThemeConfig {
 
 export declare const Title: ({ level, children, className, style }: CustomTitleProps) => JSX.Element;
 
+/**
+ * Convierte un objeto plano con notación de punto en un objeto anidado.
+ * @param flatObj Objeto plano con keys en notación de punto (ej: {"user.first_name": "John"})
+ * @returns Objeto con estructura anidada (ej: {user: {first_name: "John"}})
+ */
+export declare const unflattenObject: (flatObj: Record<string, unknown>) => Record<string, unknown>;
+
 declare interface UploadConfig {
     textButton?: string;
     iconButton?: string;