@makroz/web 1.2.0 → 1.2.2

package/dist/hooks/useApi.d.ts

@@ -1,3 +1,4 @@
+import type { MkResponse, ApiStatus } from '@makroz/core';
 interface UseApiOptions {
     baseUrl?: string;
     headers?: Record<string, string>;
@@ -8,11 +9,11 @@ export declare function useApi(options?: UseApiOptions): {
     error: any;
     waiting: number;
     loading: boolean;
-    get: (endpoint: string, params?: any) => Promise<MkResponse>;
-    post: (endpoint: string, body: any) => Promise<MkResponse>;
-    put: (endpoint: string, body: any) => Promise<MkResponse>;
-    delete: (endpoint: string) => Promise<MkResponse>;
-    remove: (endpoint: string) => Promise<MkResponse>;
+    get: (endpoint: string, params?: any) => Promise<MkResponse<unknown>>;
+    post: (endpoint: string, body: any) => Promise<MkResponse<unknown>>;
+    put: (endpoint: string, body: any) => Promise<MkResponse<unknown>>;
+    delete: (endpoint: string) => Promise<MkResponse<unknown>>;
+    remove: (endpoint: string) => Promise<MkResponse<unknown>>;
 };
 export {};
 //# sourceMappingURL=useApi.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useApi.d.ts","sourceRoot":"","sources":["../../src/hooks/useApi.ts"],"names":[],"mappings":"AAIA,UAAU,aAAa;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB;;;;;;oBAgF1B,MAAM,WAAU,GAAG;qBAClB,MAAM,QAAQ,GAAG;oBAClB,MAAM,QAAQ,GAAG;uBACd,MAAM;uBACN,MAAM;EAEhC"}
+{"version":3,"file":"useApi.d.ts","sourceRoot":"","sources":["../../src/hooks/useApi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG1D,UAAU,aAAa;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB;;;;;;oBAgF1B,MAAM,WAAU,GAAG;qBAClB,MAAM,QAAQ,GAAG;oBAClB,MAAM,QAAQ,GAAG;uBACd,MAAM;uBACN,MAAM;EAEhC"}

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

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

package/dist/hooks/useApi.test.js

@@ -0,0 +1,184 @@
+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":"AAAA,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,24 @@
+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":"AACA,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 '@makroz/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.test.d.ts

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

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":"AAEA;;;;;;;;;;;;;;;;;;;;;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,36 @@
+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,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"}

package/dist/hooks/useMkEvent.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @module useMkEvent
+ * @description Lightweight event bus for cross-component communication.
+ * Uses DOM CustomEvent on the web. API matches mk-mobile's useMkEvent.
+ *
+ * @example
+ * ```tsx
+ * // Component A — listen
+ * useMkEvent('cart:updated', (data) => {
+ *   console.log('Cart updated:', data);
+ * });
+ *
+ * // Component B — emit
+ * const { emit } = useMkEvent('cart:updated');
+ * emit({ items: 5 });
+ * ```
+ */
+export declare function useMkEvent<T = any>(eventName: string, handler?: (data: T) => void): {
+    emit: (data?: T) => void;
+};
+/**
+ * Imperative event API — for use outside React components (services, callbacks).
+ * @example
+ * import { MkEventBus } from '@makroz/web';
+ * MkEventBus.emit('notification:received', payload);
+ */
+export declare const MkEventBus: {
+    readonly emit: (event: string, data?: any) => void;
+    readonly on: (event: string, fn: (data?: any) => void) => () => void;
+};
+//# sourceMappingURL=useMkEvent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useMkEvent.d.ts","sourceRoot":"","sources":["../../src/hooks/useMkEvent.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,wBAAgB,UAAU,CAAC,CAAC,GAAG,GAAG,EAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI;kBAmBf,CAAC;EAQhB;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU;2BACL,MAAM,SAAS,GAAG;yBAGpB,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI;CAKtC,CAAC"}

package/dist/hooks/useMkEvent.js

@@ -0,0 +1,56 @@
+import { useEffect, useCallback, useRef } from 'react';
+/**
+ * @module useMkEvent
+ * @description Lightweight event bus for cross-component communication.
+ * Uses DOM CustomEvent on the web. API matches mk-mobile's useMkEvent.
+ *
+ * @example
+ * ```tsx
+ * // Component A — listen
+ * useMkEvent('cart:updated', (data) => {
+ *   console.log('Cart updated:', data);
+ * });
+ *
+ * // Component B — emit
+ * const { emit } = useMkEvent('cart:updated');
+ * emit({ items: 5 });
+ * ```
+ */
+export function useMkEvent(eventName, handler) {
+    // Stable ref to avoid stale closures & unnecessary re-subscriptions
+    const handlerRef = useRef(handler);
+    handlerRef.current = handler;
+    useEffect(() => {
+        if (!handlerRef.current)
+            return;
+        const listener = (event) => {
+            var _a;
+            const customEvent = event;
+            (_a = handlerRef.current) === null || _a === void 0 ? void 0 : _a.call(handlerRef, customEvent.detail);
+        };
+        window.addEventListener(eventName, listener);
+        return () => window.removeEventListener(eventName, listener);
+    }, [eventName]);
+    const emit = useCallback((data) => {
+        const event = new CustomEvent(eventName, { detail: data });
+        window.dispatchEvent(event);
+    }, [eventName]);
+    return { emit };
+}
+/**
+ * Imperative event API — for use outside React components (services, callbacks).
+ * @example
+ * import { MkEventBus } from '@makroz/web';
+ * MkEventBus.emit('notification:received', payload);
+ */
+export const MkEventBus = {
+    emit: (event, data) => {
+        window.dispatchEvent(new CustomEvent(event, { detail: data }));
+    },
+    on: (event, fn) => {
+        const listener = (e) => fn(e.detail);
+        window.addEventListener(event, listener);
+        return () => window.removeEventListener(event, listener);
+    },
+};
+//# sourceMappingURL=useMkEvent.js.map

package/dist/hooks/useMkEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMkEvent.js","sourceRoot":"","sources":["../../src/hooks/useMkEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEvD;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,UAAU,UAAU,CACtB,SAAiB,EACjB,OAA2B;IAE3B,oEAAoE;IACpE,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,CAAC,UAAU,CAAC,OAAO;YAAE,OAAO;QAEhC,MAAM,QAAQ,GAAG,CAAC,KAAY,EAAE,EAAE;;YAC9B,MAAM,WAAW,GAAG,KAAuB,CAAC;YAC5C,MAAA,UAAU,CAAC,OAAO,2DAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7C,CAAC,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC7C,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,MAAM,IAAI,GAAG,WAAW,CACpB,CAAC,IAAQ,EAAE,EAAE;QACT,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,EACD,CAAC,SAAS,CAAC,CACd,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB,IAAI,EAAE,CAAC,KAAa,EAAE,IAAU,EAAE,EAAE;QAChC,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,EAAE,EAAE,CAAC,KAAa,EAAE,EAAwB,EAAE,EAAE;QAC5C,MAAM,QAAQ,GAAG,CAAC,CAAQ,EAAE,EAAE,CAAC,EAAE,CAAE,CAAiB,CAAC,MAAM,CAAC,CAAC;QAC7D,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACzC,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;CACK,CAAC"}

package/dist/hooks/useMkForm.d.ts

@@ -0,0 +1,43 @@
+import type { MkFormFields, MkFormReturn, MkCrudAction } from '@makroz/core';
+/**
+ * @module useMkForm
+ * @description Unified form state manager with built-in validation.
+ * Works on both Web and Mobile — zero platform dependencies.
+ *
+ * Uses mkValidation from mk-core for field-level and form-level validation,
+ * and mkValidation.getApiFields for extracting API-ready data.
+ *
+ * @example
+ * ```tsx
+ * const form = useMkForm({
+ *   fields: {
+ *     name:  { rules: ['required', 'min:3'], api: 'ae' },
+ *     email: { rules: ['required', 'email'], api: 'ae' },
+ *     phone: { rules: ['phone'], api: 'ae*' },
+ *   },
+ *   initialData: { name: '', email: '', phone: '' },
+ * });
+ *
+ * // In handler
+ * <MkInput label="Nombre" value={form.formState.name} error={form.errors.name}
+ *   onChange={v => form.setField('name', v)} />
+ *
+ * const handleSave = () => {
+ *   if (!form.validate()) return;
+ *   const data = form.getApiData();
+ *   api.post('/users', data);
+ * };
+ * ```
+ */
+export interface UseMkFormOptions<T = Record<string, any>> {
+    /** Field definitions with rules and API flags. */
+    fields: MkFormFields;
+    /** Initial data for the form. */
+    initialData?: Partial<T>;
+    /** Current CRUD action (affects which rules apply). Default 'add'. */
+    action?: MkCrudAction;
+    /** Validate on every setField call. Default false. */
+    validateOnChange?: boolean;
+}
+export declare function useMkForm<T extends Record<string, any> = Record<string, any>>({ fields, initialData, action, validateOnChange, }: UseMkFormOptions<T>): MkFormReturn<T>;
+//# sourceMappingURL=useMkForm.d.ts.map

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

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

package/dist/hooks/useMkInViewPort.d.ts

@@ -0,0 +1,14 @@
+export interface UseMkInViewPortReturnType {
+    isInViewport: boolean;
+    ref: (node: HTMLElement | null) => void;
+}
+/**
+ * useMkInViewPort
+ *
+ * Custom hook to determine if an element is currently within the viewport using IntersectionObserver.
+ * 📌 Useful for lazy loading, animations on scroll, or triggering behavior when elements appear on screen.
+ *
+ * @param {IntersectionObserverInit} [options] - Optional configuration for the IntersectionObserver.
+ */
+export declare function useMkInViewPort(options?: IntersectionObserverInit): UseMkInViewPortReturnType;
+//# sourceMappingURL=useMkInViewPort.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useMkInViewPort.d.ts","sourceRoot":"","sources":["../../src/hooks/useMkInViewPort.tsx"],"names":[],"mappings":"AAEA,MAAM,WAAW,yBAAyB;IACtC,YAAY,EAAE,OAAO,CAAC;IACtB,GAAG,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;CAC3C;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC3B,OAAO,CAAC,EAAE,wBAAwB,GACnC,yBAAyB,CAyB3B"}

package/dist/hooks/useMkInViewPort.js

@@ -0,0 +1,31 @@
+import { useCallback, useEffect, useState } from 'react';
+/**
+ * useMkInViewPort
+ *
+ * Custom hook to determine if an element is currently within the viewport using IntersectionObserver.
+ * 📌 Useful for lazy loading, animations on scroll, or triggering behavior when elements appear on screen.
+ *
+ * @param {IntersectionObserverInit} [options] - Optional configuration for the IntersectionObserver.
+ */
+export function useMkInViewPort(options) {
+    const [isInViewport, setIsInViewport] = useState(false);
+    const [refElement, setRefElement] = useState(null);
+    const ref = useCallback((node) => {
+        if (node !== refElement) {
+            setRefElement(node);
+        }
+    }, [refElement]);
+    useEffect(() => {
+        if (!refElement || typeof window === 'undefined')
+            return;
+        const observer = new IntersectionObserver(([entry]) => {
+            setIsInViewport(entry.isIntersecting);
+        }, options);
+        observer.observe(refElement);
+        return () => {
+            observer.disconnect();
+        };
+    }, [refElement, options]);
+    return { isInViewport, ref };
+}
+//# sourceMappingURL=useMkInViewPort.js.map

package/dist/hooks/useMkInViewPort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMkInViewPort.js","sourceRoot":"","sources":["../../src/hooks/useMkInViewPort.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAOzD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC3B,OAAkC;IAElC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAU,KAAK,CAAC,CAAC;IACjE,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAqB,IAAI,CAAC,CAAC;IAEvE,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,IAAwB,EAAE,EAAE;QACjD,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACtB,aAAa,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACL,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjB,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,CAAC,UAAU,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO;QAEzD,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE;YAClD,eAAe,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC1C,CAAC,EAAE,OAAO,CAAC,CAAC;QAEZ,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE7B,OAAO,GAAG,EAAE;YACR,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC1B,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAE1B,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;AACjC,CAAC"}