@makroz/web 1.0.1

package/dist/hooks/useApi.test.js

@@ -0,0 +1,186 @@
+use;
+client;
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { renderHook, act } from '@testing-library/react';
+import { useApi } from './useApi';
+// Mock the MkApiContext
+const mockSetWaiting = vi.fn();
+const mockContext = {
+    baseUrl: 'http://localhost:8000/api',
+    headers: { 'X-Custom-Header': 'test' },
+    waiting: 0,
+    setWaiting: mockSetWaiting,
+};
+vi.mock('../context/MkApiContext', () => ({
+    useMkApiContext: () => mockContext,
+}));
+// Mock fetch globally
+const mockFetch = vi.fn();
+global.fetch = mockFetch;
+describe('useApi', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockFetch.mockReset();
+    });
+    it('should have initial state as idle', () => {
+        const { result } = renderHook(() => useApi());
+        expect(result.current.status).toBe('idle');
+        expect(result.current.data).toBeNull();
+        expect(result.current.error).toBeNull();
+        expect(result.current.loading).toBe(false);
+    });
+    it('should make a GET request and return data on success', async () => {
+        const mockResponse = {
+            success: true,
+            data: { id: 1, name: 'Test Item' },
+            message: 'OK',
+        };
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: () => Promise.resolve(mockResponse),
+        });
+        const { result } = renderHook(() => useApi());
+        let response;
+        await act(async () => {
+            response = await result.current.get('/items');
+        });
+        expect(mockFetch).toHaveBeenCalledWith('http://localhost:8000/api/items', expect.objectContaining({
+            method: 'GET',
+            headers: expect.objectContaining({
+                'Content-Type': 'application/json',
+                'X-Custom-Header': 'test',
+            }),
+        }));
+        expect(response).toEqual(mockResponse);
+        expect(result.current.data).toEqual({ id: 1, name: 'Test Item' });
+        expect(result.current.status).toBe('success');
+        expect(result.current.loading).toBe(false);
+    });
+    it('should handle API errors correctly', async () => {
+        const mockErrorResponse = {
+            success: false,
+            message: 'Item not found',
+            data: null,
+        };
+        mockFetch.mockResolvedValueOnce({
+            ok: false,
+            json: () => Promise.resolve(mockErrorResponse),
+        });
+        const { result } = renderHook(() => useApi());
+        await act(async () => {
+            await expect(result.current.get('/items/999')).rejects.toThrow('Item not found');
+        });
+        expect(result.current.status).toBe('error');
+        expect(result.current.error).toBe('Item not found');
+    });
+    it('should handle network errors', async () => {
+        mockFetch.mockRejectedValueOnce(new Error('Network request failed'));
+        const { result } = renderHook(() => useApi());
+        await act(async () => {
+            await expect(result.current.get('/items')).rejects.toThrow('Network request failed');
+        });
+        expect(result.current.status).toBe('error');
+        expect(result.current.error).toBe('Network request failed');
+    });
+    it('should make a POST request with body', async () => {
+        const mockResponse = {
+            success: true,
+            data: { id: 1, name: 'New Item' },
+            message: 'Created',
+        };
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: () => Promise.resolve(mockResponse),
+        });
+        const { result } = renderHook(() => useApi());
+        const newBody = { name: 'New Item' };
+        await act(async () => {
+            await result.current.post('/items', newBody);
+        });
+        expect(mockFetch).toHaveBeenCalledWith('http://localhost:8000/api/items', expect.objectContaining({
+            method: 'POST',
+            body: JSON.stringify({ name: 'New Item' }),
+        }));
+    });
+    it('should build query params for GET requests', async () => {
+        const mockResponse = { success: true, data: [], message: 'OK' };
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: () => Promise.resolve(mockResponse),
+        });
+        const { result } = renderHook(() => useApi());
+        await act(async () => {
+            await result.current.get('/items', {
+                q: 'search term',
+                sort: '-created_at',
+                page: 2,
+                per_page: 20,
+            });
+        });
+        const calledUrl = mockFetch.mock.calls[0][0];
+        expect(calledUrl).toContain('q=search+term');
+        expect(calledUrl).toContain('sort=-created_at');
+        expect(calledUrl).toContain('page=2');
+        expect(calledUrl).toContain('per_page=20');
+    });
+    it('should handle advanced filter params', async () => {
+        const mockResponse = { success: true, data: [], message: 'OK' };
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: () => Promise.resolve(mockResponse),
+        });
+        const { result } = renderHook(() => useApi());
+        await act(async () => {
+            await result.current.get('/items', {
+                filter: {
+                    status: 'A',
+                    price: { gt: 100 },
+                },
+            });
+        });
+        const calledUrl = mockFetch.mock.calls[0][0];
+        // URLSearchParams encodes brackets: [ -> %5B, ] -> %5D
+        expect(calledUrl).toContain('filter%5Bstatus%5D=A');
+        expect(calledUrl).toContain('filter%5Bprice%5D%5Bgt%5D=100');
+    });
+    it('should manage waiting state during requests', async () => {
+        const mockResponse = { success: true, data: {}, message: 'OK' };
+        let resolvePromise;
+        const delayedResponse = new Promise((resolve) => {
+            resolvePromise = resolve;
+        });
+        mockFetch.mockReturnValueOnce(delayedResponse.then(() => ({
+            ok: true,
+            json: () => Promise.resolve(mockResponse),
+        })));
+        const { result } = renderHook(() => useApi());
+        act(() => {
+            result.current.get('/items');
+        });
+        expect(mockSetWaiting).toHaveBeenCalledWith(1, 'call:/items');
+        expect(result.current.loading).toBe(true);
+        await act(async () => {
+            // eslint-disable-next-line @typescript-eslint/require-await
+            await (async () => {
+                resolvePromise({
+                    ok: true,
+                    json: () => Promise.resolve(mockResponse),
+                });
+            })();
+        });
+        expect(mockSetWaiting).toHaveBeenCalledWith(-1, '-call:/items');
+    });
+    it('should support DELETE requests', async () => {
+        const mockResponse = { success: true, data: null, message: 'Deleted' };
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: () => Promise.resolve(mockResponse),
+        });
+        const { result } = renderHook(() => useApi());
+        await act(async () => {
+            await result.current.delete('/items/123');
+        });
+        expect(mockFetch).toHaveBeenCalledWith('http://localhost:8000/api/items/123', expect.objectContaining({ method: 'DELETE' }));
+    });
+});
+//# sourceMappingURL=useApi.test.js.map

package/dist/hooks/useApi.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useApi.test.js","sourceRoot":"","sources":["../../src/hooks/useApi.test.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useMkClickOutside.d.ts

@@ -0,0 +1,8 @@
+import type { RefObject } from "react";
+/**
+ * useMkClickOutside
+ * 🚀 Hook para cerrar elementos UI al hacer clic fuera de ellos.
+ * Soporta múltiples referencias.
+ */
+export declare const useMkClickOutside: <T extends HTMLElement | null>(refs: Array<RefObject<T>>, handler: (event: MouseEvent | TouchEvent) => void) => void;
+//# sourceMappingURL=useMkClickOutside.d.ts.map

package/dist/hooks/useMkClickOutside.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMkClickOutside.d.ts","sourceRoot":"","sources":["../../src/hooks/useMkClickOutside.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,WAAW,GAAG,IAAI,EAC5D,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EACzB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,KAAK,IAAI,KAChD,IAqBF,CAAC"}

package/dist/hooks/useMkClickOutside.js

@@ -0,0 +1,26 @@
+use;
+client;
+import { useEffect } from "react";
+/**
+ * useMkClickOutside
+ * 🚀 Hook para cerrar elementos UI al hacer clic fuera de ellos.
+ * Soporta múltiples referencias.
+ */
+export const useMkClickOutside = (refs, handler) => {
+    useEffect(() => {
+        const listener = (event) => {
+            const target = event.target;
+            const clickedInside = refs.some((ref) => ref.current && ref.current.contains(target));
+            if (clickedInside)
+                return;
+            handler(event);
+        };
+        document.addEventListener("mousedown", listener);
+        document.addEventListener("touchstart", listener);
+        return () => {
+            document.removeEventListener("mousedown", listener);
+            document.removeEventListener("touchstart", listener);
+        };
+    }, [refs, handler]);
+};
+//# sourceMappingURL=useMkClickOutside.js.map

package/dist/hooks/useMkClickOutside.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMkClickOutside.js","sourceRoot":"","sources":["../../src/hooks/useMkClickOutside.ts"],"names":[],"mappings":"AAAA,GAAG,CAAA;AAAC,MAAM,CAAA;AAEV,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAAyB,EACzB,OAAiD,EAC3C,EAAE;IACR,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,QAAQ,GAAG,CAAC,KAA8B,EAAE,EAAE;YAClD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAc,CAAC;YAEpC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAC7B,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CACrD,CAAC;YAEF,IAAI,aAAa;gBAAE,OAAO;YAC1B,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC;QAEF,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACjD,QAAQ,CAAC,gBAAgB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAElD,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,mBAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YACpD,QAAQ,CAAC,mBAAmB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QACvD,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AACtB,CAAC,CAAC"}

package/dist/hooks/useMkCrud.d.ts

@@ -0,0 +1,39 @@
+import type { MkCrudConfig, MkCrudAction, MkCrudReturn } from '@mk/core';
+/**
+ * @module useMkCrud
+ * @description Full CRUD operations hook with form management, validation, and API integration.
+ * Same API surface for both mk-web and mk-mobile.
+ *
+ * @example
+ * ```tsx
+ * const crud = useMkCrud({
+ *   module: 'users',
+ *   singular: 'Usuario',
+ *   plural: 'Usuarios',
+ *   fields: {
+ *     name:  { rules: ['required', 'min:3'], api: 'ae', label: 'Nombre' },
+ *     email: { rules: ['required', 'email'], api: 'ae', label: 'Email' },
+ *   },
+ * });
+ *
+ * // In your component:
+ * <MkButton label="Nuevo" onPress={crud.onAdd} />
+ *
+ * // In the modal:
+ * <MkInput label="Nombre" value={crud.form.formState.name}
+ *   error={crud.form.errors.name}
+ *   onChange={v => crud.form.setField('name', v)} />
+ * <MkButton label="Guardar" loading={crud.saving} onClick={crud.onSave} />
+ * ```
+ */
+interface UseMkCrudOptions extends MkCrudConfig {
+    /** Callback after successful save. */
+    onSuccess?: (action: MkCrudAction, data: any) => void;
+    /** Callback after failed save. */
+    onError?: (action: MkCrudAction, error: any) => void;
+    /** External reload function (from useMkList). */
+    onReload?: () => void;
+}
+export declare function useMkCrud<T extends Record<string, any> = Record<string, any>>(config: UseMkCrudOptions): MkCrudReturn<T>;
+export {};
+//# sourceMappingURL=useMkCrud.d.ts.map

package/dist/hooks/useMkCrud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMkCrud.d.ts","sourceRoot":"","sources":["../../src/hooks/useMkCrud.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAC,MAAM,UAAU,CAAC;AAMxE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,UAAU,gBAAiB,SAAQ,YAAY;IAC3C,sCAAsC;IACtC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IACtD,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IACrD,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzE,MAAM,EAAE,gBAAgB,GACzB,YAAY,CAAC,CAAC,CAAC,CAwIjB"}

package/dist/hooks/useMkCrud.js

@@ -0,0 +1,121 @@
+use;
+client;
+import { useState, useCallback, useRef } from 'react';
+import { useMkForm } from './useMkForm';
+import { useApi } from './useApi';
+import { useMkToast } from '../context/MkToastContext';
+export function useMkCrud(config) {
+    const { module: moduleName, singular, fields, messages, showSuccessToast = true, autoReload = true, onSuccess, onError, onReload, } = config;
+    const api = useApi();
+    const toast = useMkToast();
+    const [action, setAction] = useState('add');
+    const [isOpen, setIsOpen] = useState(false);
+    const [isDelOpen, setIsDelOpen] = useState(false);
+    const [saving, setSaving] = useState(false);
+    const currentItemRef = useRef(null);
+    const form = useMkForm({
+        fields,
+        action,
+    });
+    // ──── Actions ────
+    const onAdd = useCallback(() => {
+        setAction('add');
+        form.reset();
+        currentItemRef.current = null;
+        setIsOpen(true);
+    }, [form]);
+    const onEdit = useCallback((item) => {
+        setAction('edit');
+        form.reset(item);
+        currentItemRef.current = item;
+        setIsOpen(true);
+    }, [form]);
+    const onDel = useCallback((item) => {
+        setAction('del');
+        currentItemRef.current = item;
+        form.reset(item);
+        setIsDelOpen(true);
+    }, [form]);
+    const onClose = useCallback(() => {
+        setIsOpen(false);
+        setIsDelOpen(false);
+        form.clearErrors();
+    }, [form]);
+    // ──── Save ────
+    const onSave = useCallback(async () => {
+        var _a;
+        // Validate (skip for delete)
+        if (action !== 'del') {
+            if (!form.validate())
+                return false;
+        }
+        setSaving(true);
+        try {
+            const itemId = (_a = currentItemRef.current) === null || _a === void 0 ? void 0 : _a.id;
+            let response;
+            if (action === 'del') {
+                response = await api.delete(`/${moduleName}/${itemId}`);
+            }
+            else if (action === 'edit' && itemId) {
+                const data = form.getApiData();
+                response = await api.put(`/${moduleName}/${itemId}`, data);
+            }
+            else {
+                const data = form.getApiData();
+                response = await api.post(`/${moduleName}`, data);
+            }
+            if (response === null || response === void 0 ? void 0 : response.success) {
+                onClose();
+                if (showSuccessToast) {
+                    const msg = (messages === null || messages === void 0 ? void 0 : messages[action])
+                        || response.message
+                        || `${singular} ${action === 'del' ? 'eliminado' : action === 'edit' ? 'actualizado' : 'creado'} correctamente`;
+                    toast.showToast(msg, { type: 'success' });
+                }
+                if (autoReload && onReload) {
+                    onReload();
+                }
+                onSuccess === null || onSuccess === void 0 ? void 0 : onSuccess(action, response.data);
+                return true;
+            }
+            else {
+                // Handle API validation errors
+                if (response === null || response === void 0 ? void 0 : response.errors) {
+                    const apiErrors = {};
+                    for (const key in response.errors) {
+                        apiErrors[key] = Array.isArray(response.errors[key])
+                            ? response.errors[key][0]
+                            : response.errors[key];
+                    }
+                    form.setErrors(apiErrors);
+                }
+                if (response === null || response === void 0 ? void 0 : response.message) {
+                    toast.showToast(response.message, { type: 'error' });
+                }
+                onError === null || onError === void 0 ? void 0 : onError(action, response);
+                return false;
+            }
+        }
+        catch (error) {
+            toast.showToast('Error al procesar la solicitud', { type: 'error' });
+            onError === null || onError === void 0 ? void 0 : onError(action, error);
+            return false;
+        }
+        finally {
+            setSaving(false);
+        }
+    }, [action, form, api, moduleName, singular, messages, showSuccessToast, autoReload, onReload, onSuccess, onError, onClose, toast]);
+    return {
+        action,
+        form,
+        onAdd,
+        onEdit,
+        onDel,
+        onSave,
+        onClose,
+        isOpen,
+        isDelOpen,
+        saving,
+    };
+}
+//# sourceMappingURL=useMkCrud.js.map

package/dist/hooks/useMkCrud.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMkCrud.js","sourceRoot":"","sources":["../../src/hooks/useMkCrud.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useMkCrud.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useMkCrud.test.d.ts.map

package/dist/hooks/useMkCrud.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMkCrud.test.d.ts","sourceRoot":"","sources":["../../src/hooks/useMkCrud.test.ts"],"names":[],"mappings":""}

package/dist/hooks/useMkCrud.test.js

@@ -0,0 +1,89 @@
+use;
+client;
+import { renderHook, act } from '@testing-library/react';
+import { describe, it, expect, vi } from 'vitest';
+import { useMkCrud } from './useMkCrud';
+// Mock the context hooks used inside useMkCrud
+vi.mock('../context/MkApiContext', () => ({
+    useMkApi: () => ({
+        api: {
+            post: vi.fn(),
+            put: vi.fn(),
+            delete: vi.fn(),
+        }
+    }),
+    useMkApiContext: () => ({
+        api: {
+            post: vi.fn(),
+            put: vi.fn(),
+            delete: vi.fn(),
+        }
+    })
+}));
+vi.mock('../context/MkToastContext', () => ({
+    useMkToast: () => ({
+        showToast: vi.fn(),
+    })
+}));
+describe('useMkCrud', () => {
+    const config = {
+        module: 'users',
+        singular: 'Usuario',
+        plural: 'Usuarios',
+        fields: {
+            name: { rules: ['required'], api: 'ae' }
+        }
+    };
+    it('initializes fully closed on action add', () => {
+        const { result } = renderHook(() => useMkCrud(config));
+        expect(result.current.isOpen).toBe(false);
+        expect(result.current.isDelOpen).toBe(false);
+        expect(result.current.action).toBe('add');
+        expect(result.current.saving).toBe(false);
+    });
+    it('handles onAdd opening the correct modal states', () => {
+        const { result } = renderHook(() => useMkCrud(config));
+        act(() => {
+            result.current.onAdd();
+        });
+        expect(result.current.isOpen).toBe(true);
+        expect(result.current.isDelOpen).toBe(false);
+        expect(result.current.action).toBe('add');
+        expect(result.current.form.isDirty).toBe(false);
+    });
+    it('handles onEdit injecting values', () => {
+        const { result } = renderHook(() => useMkCrud(config));
+        const user = { id: 1, name: 'Mario', email: 'mario@example.com' };
+        act(() => {
+            result.current.onEdit(user);
+        });
+        expect(result.current.isOpen).toBe(true);
+        expect(result.current.action).toBe('edit');
+        expect(result.current.form.formState.name).toBe('Mario');
+        expect(result.current.form.formState.email).toBe('mario@example.com');
+    });
+    it('handles onDel opening specific deletion modal', () => {
+        const { result } = renderHook(() => useMkCrud(config));
+        const user = { id: 1, name: 'Mario' };
+        act(() => {
+            result.current.onDel(user);
+        });
+        expect(result.current.isDelOpen).toBe(true);
+        expect(result.current.action).toBe('del');
+        expect(result.current.form.formState.id).toBe(1);
+    });
+    it('closes all modals when onClose is called', () => {
+        const { result } = renderHook(() => useMkCrud(config));
+        act(() => {
+            result.current.onAdd();
+        });
+        expect(result.current.isOpen).toBe(true);
+        act(() => {
+            result.current.onClose();
+        });
+        expect(result.current.isOpen).toBe(false);
+        expect(result.current.isDelOpen).toBe(false);
+        expect(result.current.form.isDirty).toBe(false); // form is reset
+    });
+});
+//# sourceMappingURL=useMkCrud.test.js.map

package/dist/hooks/useMkCrud.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMkCrud.test.js","sourceRoot":"","sources":["../../src/hooks/useMkCrud.test.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useMkDebounce.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @module useMkDebounce
+ * @description Returns a debounced value — the value only updates after the specified
+ * delay of inactivity. Useful for search inputs, filters, and API-driven queries.
+ *
+ * API is identical between mk-web and mk-mobile.
+ *
+ * @template T - Type of the input value.
+ * @param value - The value to debounce.
+ * @param delay - Milliseconds to wait before updating. Default 300.
+ * @returns The debounced value.
+ *
+ * @example
+ * ```tsx
+ * const [search, setSearch] = useState('');
+ * const debouncedSearch = useMkDebounce(search, 400);
+ *
+ * useEffect(() => {
+ *   if (debouncedSearch) api.get('/search', { q: debouncedSearch });
+ * }, [debouncedSearch]);
+ * ```
+ */
+export declare const useMkDebounce: <T = any>(value: T, delay?: number) => T;
+//# sourceMappingURL=useMkDebounce.d.ts.map

package/dist/hooks/useMkDebounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMkDebounce.d.ts","sourceRoot":"","sources":["../../src/hooks/useMkDebounce.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,GAAG,GAAG,EAAE,OAAO,CAAC,EAAE,QAAO,MAAY,KAAG,CActE,CAAC"}

package/dist/hooks/useMkDebounce.js

@@ -0,0 +1,38 @@
+use;
+client;
+import { useEffect, useState } from 'react';
+/**
+ * @module useMkDebounce
+ * @description Returns a debounced value — the value only updates after the specified
+ * delay of inactivity. Useful for search inputs, filters, and API-driven queries.
+ *
+ * API is identical between mk-web and mk-mobile.
+ *
+ * @template T - Type of the input value.
+ * @param value - The value to debounce.
+ * @param delay - Milliseconds to wait before updating. Default 300.
+ * @returns The debounced value.
+ *
+ * @example
+ * ```tsx
+ * const [search, setSearch] = useState('');
+ * const debouncedSearch = useMkDebounce(search, 400);
+ *
+ * useEffect(() => {
+ *   if (debouncedSearch) api.get('/search', { q: debouncedSearch });
+ * }, [debouncedSearch]);
+ * ```
+ */
+export const useMkDebounce = (value, delay = 300) => {
+    const [debouncedValue, setDebouncedValue] = useState(value);
+    useEffect(() => {
+        const handler = setTimeout(() => {
+            setDebouncedValue(value);
+        }, delay);
+        return () => {
+            clearTimeout(handler);
+        };
+    }, [value, delay]);
+    return debouncedValue;
+};
+//# sourceMappingURL=useMkDebounce.js.map

package/dist/hooks/useMkDebounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMkDebounce.js","sourceRoot":"","sources":["../../src/hooks/useMkDebounce.ts"],"names":[],"mappings":"AAAA,GAAG,CAAA;AAAC,MAAM,CAAA;AACV,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAU,KAAQ,EAAE,QAAgB,GAAG,EAAK,EAAE;IACvE,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAI,KAAK,CAAC,CAAC;IAE/D,SAAS,CAAC,GAAG,EAAE;QACX,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC,EAAE,KAAK,CAAC,CAAC;QAEV,OAAO,GAAG,EAAE;YACR,YAAY,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAEnB,OAAO,cAAc,CAAC;AAC1B,CAAC,CAAC"}

package/dist/hooks/useMkEffectDebug.d.ts

@@ -0,0 +1,7 @@
+/**
+ * useMkEffectDebug
+ * 🚀 Herramienta de diagnóstico para desarrolladores.
+ * Muestra en consola qué dependencia disparó el efecto y sus valores (antes/después).
+ */
+export declare const useMkEffectDebug: (effectFunction: () => void | (() => void), dependencies: any[]) => void;
+//# sourceMappingURL=useMkEffectDebug.d.ts.map

package/dist/hooks/useMkEffectDebug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMkEffectDebug.d.ts","sourceRoot":"","sources":["../../src/hooks/useMkEffectDebug.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,gBAAgB,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,EACzC,cAAc,GAAG,EAAE,KAClB,IAsBF,CAAC"}

package/dist/hooks/useMkEffectDebug.js

@@ -0,0 +1,26 @@
+import { useEffect } from "react";
+import { useMkPrevious } from "./useMkPrevious";
+/**
+ * useMkEffectDebug
+ * 🚀 Herramienta de diagnóstico para desarrolladores.
+ * Muestra en consola qué dependencia disparó el efecto y sus valores (antes/después).
+ */
+export const useMkEffectDebug = (effectFunction, dependencies) => {
+    const previousDependencies = useMkPrevious(dependencies, []);
+    const changedDependencies = dependencies.reduce((accum, dependency, index) => {
+        if (dependency !== (previousDependencies === null || previousDependencies === void 0 ? void 0 : previousDependencies[index])) {
+            accum[index] = {
+                before: previousDependencies === null || previousDependencies === void 0 ? void 0 : previousDependencies[index],
+                after: dependency,
+            };
+        }
+        return accum;
+    }, {});
+    if (Object.keys(changedDependencies).length) {
+        console.group("📌 [useMkEffectDebug] Cambio Detectado");
+        console.table(changedDependencies);
+        console.groupEnd();
+    }
+    useEffect(effectFunction, dependencies);
+};
+//# sourceMappingURL=useMkEffectDebug.js.map

package/dist/hooks/useMkEffectDebug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMkEffectDebug.js","sourceRoot":"","sources":["../../src/hooks/useMkEffectDebug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,cAAyC,EACzC,YAAmB,EACb,EAAE;IACR,MAAM,oBAAoB,GAAG,aAAa,CAAQ,YAAY,EAAE,EAAE,CAAC,CAAC;IAEpE,MAAM,mBAAmB,GAAG,YAAY,CAAC,MAAM,CAE7C,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE;QAC7B,IAAI,UAAU,MAAK,oBAAoB,aAApB,oBAAoB,uBAApB,oBAAoB,CAAG,KAAK,CAAC,CAAA,EAAE,CAAC;YACjD,KAAK,CAAC,KAAK,CAAC,GAAG;gBACb,MAAM,EAAE,oBAAoB,aAApB,oBAAoB,uBAApB,oBAAoB,CAAG,KAAK,CAAC;gBACrC,KAAK,EAAE,UAAU;aAClB,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,IAAI,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5C,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACxD,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACnC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACrB,CAAC;IAED,SAAS,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;AAC1C,CAAC,CAAC"}