@makroz/web 1.0.1

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 '@mk/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 '@mk/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 '@mk/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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMkForm.d.ts","sourceRoot":"","sources":["../../src/hooks/useMkForm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAgB,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACrD,kDAAkD;IAClD,MAAM,EAAE,YAAY,CAAC;IACrB,iCAAiC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,sEAAsE;IACtE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAC3E,MAAM,EACN,WAA8B,EAC9B,MAAc,EACd,gBAAwB,GAC3B,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAmIvC"}

package/dist/hooks/useMkForm.js

@@ -0,0 +1,115 @@
+import { useState, useCallback, useRef, useMemo } from 'react';
+import { mkValidation } from '@mk/core';
+export function useMkForm({ fields, initialData = {}, action = 'add', validateOnChange = false, }) {
+    // Compute defaults from field definitions + initialData
+    const defaults = useMemo(() => {
+        var _a;
+        const d = {};
+        for (const key in fields) {
+            d[key] = (_a = fields[key].defaultValue) !== null && _a !== void 0 ? _a : '';
+        }
+        return Object.assign(Object.assign({}, d), initialData);
+    }, []); // Only compute once on mount
+    const [formState, setFormState] = useState(defaults);
+    const [errors, setErrorsState] = useState({});
+    const initialRef = useRef(defaults);
+    // ──── Field setters ────
+    const setField = useCallback((name, value) => {
+        setFormState(prev => (Object.assign(Object.assign({}, prev), { [name]: value })));
+        // Clear error for this field on change
+        setErrorsState(prev => {
+            if (!prev[name])
+                return prev;
+            const next = Object.assign({}, prev);
+            delete next[name];
+            return next;
+        });
+        // Optionally validate on each change
+        if (validateOnChange) {
+            const field = fields[name];
+            if (field === null || field === void 0 ? void 0 : field.rules) {
+                setFormState(current => {
+                    const updated = Object.assign(Object.assign({}, current), { [name]: value });
+                    const error = mkValidation.check(value, field.rules, updated);
+                    if (error) {
+                        setErrorsState(prev => (Object.assign(Object.assign({}, prev), { [name]: error })));
+                    }
+                    return updated;
+                });
+            }
+        }
+    }, [fields, validateOnChange]);
+    const setFields = useCallback((partial) => {
+        setFormState(prev => (Object.assign(Object.assign({}, prev), partial)));
+    }, []);
+    // ──── Error management ────
+    const setError = useCallback((name, message) => {
+        setErrorsState(prev => (Object.assign(Object.assign({}, prev), { [name]: message })));
+    }, []);
+    const setErrors = useCallback((errs) => {
+        setErrorsState(errs);
+    }, []);
+    const clearErrors = useCallback(() => {
+        setErrorsState({});
+    }, []);
+    // ──── Validation ────
+    const validate = useCallback(() => {
+        const fieldRules = {};
+        for (const key in fields) {
+            if (fields[key].rules) {
+                fieldRules[key] = { rules: fields[key].rules };
+            }
+        }
+        const errs = mkValidation.checkFields(fieldRules, formState, action);
+        setErrorsState(errs);
+        return !mkValidation.hasErrors(errs);
+    }, [fields, formState, action]);
+    // ──── API data extraction ────
+    const getApiData = useCallback(() => {
+        const apiFields = {};
+        for (const key in fields) {
+            if (fields[key].api) {
+                apiFields[key] = { api: fields[key].api };
+            }
+        }
+        const extracted = mkValidation.getApiFields(formState, apiFields, action);
+        // Apply transforms
+        const result = {};
+        for (const key in extracted) {
+            const field = fields[key];
+            result[key] = (field === null || field === void 0 ? void 0 : field.transform)
+                ? field.transform(extracted[key], formState)
+                : extracted[key];
+        }
+        return result;
+    }, [fields, formState, action]);
+    // ──── Reset ────
+    const reset = useCallback((data) => {
+        const newState = data ? Object.assign(Object.assign({}, defaults), data) : defaults;
+        setFormState(newState);
+        initialRef.current = newState;
+        setErrorsState({});
+    }, [defaults]);
+    // ──── Computed ────
+    const isDirty = useMemo(() => {
+        return JSON.stringify(formState) !== JSON.stringify(initialRef.current);
+    }, [formState]);
+    const isValid = useMemo(() => {
+        return Object.keys(errors).length === 0;
+    }, [errors]);
+    return {
+        formState,
+        errors,
+        setField,
+        setFields,
+        setError,
+        setErrors,
+        clearErrors,
+        reset,
+        validate,
+        getApiData,
+        isDirty,
+        isValid,
+    };
+}
+//# sourceMappingURL=useMkForm.js.map

package/dist/hooks/useMkForm.js.map

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

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

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

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

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

package/dist/hooks/useMkForm.test.js

@@ -0,0 +1,81 @@
+import { renderHook, act } from '@testing-library/react';
+import { describe, it, expect } from 'vitest';
+import { useMkForm } from './useMkForm';
+describe('useMkForm', () => {
+    const fields = {
+        name: { rules: ['required', 'min:3'], api: 'ae' },
+        email: { rules: ['required', 'email'], api: 'a*' },
+    };
+    it('initializes with default values and clean state', () => {
+        const { result } = renderHook(() => useMkForm({ fields, action: 'add' }));
+        expect(result.current.formState).toEqual({ name: '', email: '' });
+        expect(result.current.errors).toEqual({});
+        expect(result.current.isDirty).toBe(false);
+        expect(result.current.isValid).toBe(true);
+    });
+    it('updates fields and marks form as dirty', () => {
+        const { result } = renderHook(() => useMkForm({ fields, action: 'add' }));
+        act(() => {
+            result.current.setField('name', 'Mario');
+        });
+        expect(result.current.formState.name).toBe('Mario');
+        expect(result.current.isDirty).toBe(true);
+    });
+    it('validates correctly and populates errors array', () => {
+        const { result } = renderHook(() => useMkForm({ fields, action: 'add' }));
+        act(() => {
+            result.current.setFields({ name: 'Ma', email: 'bad' });
+        });
+        let isValid = false;
+        act(() => {
+            isValid = result.current.validate();
+        });
+        expect(isValid).toBe(false);
+        // Expect exact error messages based on validation engine
+        expect(result.current.errors.name).toBe('Mínimo 3 caracteres');
+        expect(result.current.errors.email).toBe('No es un email válido');
+        expect(result.current.isValid).toBe(false);
+    });
+    it('clears individual errors on valid input change', () => {
+        const { result } = renderHook(() => useMkForm({ fields, action: 'add' }));
+        // Force error
+        act(() => {
+            result.current.setField('name', 'M');
+        });
+        act(() => {
+            result.current.validate();
+        });
+        expect(result.current.errors.name).toBeTruthy();
+        // Fix error - setField clears the individual error instantly
+        act(() => {
+            result.current.setField('name', 'Mario');
+        });
+        expect(result.current.errors.name).toBeUndefined();
+    });
+    it('extracts API data applying optional filters (*)', () => {
+        const { result } = renderHook(() => useMkForm({ fields, action: 'add' }));
+        act(() => {
+            result.current.setFields({ name: 'Mario', email: '' });
+        });
+        const apiData = result.current.getApiData();
+        expect(apiData.name).toBe('Mario');
+        // 'a*' means email is optional on add action; if it's empty, it should be omitted
+        expect(apiData.email).toBeUndefined();
+    });
+    it('resets the form correctly', () => {
+        const { result } = renderHook(() => useMkForm({ fields, action: 'add' }));
+        act(() => {
+            result.current.setField('name', 'Mario');
+            result.current.validate(); // force validation cache
+        });
+        expect(result.current.isDirty).toBe(true);
+        act(() => {
+            result.current.reset({ name: 'Luigi' }); // Reset with default values
+        });
+        expect(result.current.formState.name).toBe('Luigi');
+        expect(result.current.isDirty).toBe(false);
+        expect(result.current.errors).toEqual({});
+        expect(result.current.isValid).toBe(true);
+    });
+});
+//# sourceMappingURL=useMkForm.test.js.map

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

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

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"}

package/dist/hooks/useMkInfiniteList.d.ts

@@ -0,0 +1,15 @@
+export interface InfiniteListOptions {
+    per_page?: number;
+    q?: string;
+    filter?: Record<string, any>;
+    sort?: string;
+}
+export declare function useMkInfiniteList(endpoint: string, options?: InfiniteListOptions): {
+    items: any[];
+    loading: boolean;
+    error: any;
+    hasMore: boolean;
+    loadMore: () => Promise<void>;
+    reset: () => void;
+};
+//# sourceMappingURL=useMkInfiniteList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useMkInfiniteList.d.ts","sourceRoot":"","sources":["../../src/hooks/useMkInfiniteList.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB;;;;;;;EAmDpF"}

package/dist/hooks/useMkInfiniteList.js

@@ -0,0 +1,47 @@
+import { useState, useCallback, useEffect } from 'react';
+import { useApi } from './useApi';
+export function useMkInfiniteList(endpoint, options = {}) {
+    const api = useApi();
+    const [items, setItems] = useState([]);
+    const [hasMore, setHasMore] = useState(true);
+    const [page, setPage] = useState(1);
+    // Reset list when filters/search changes
+    useEffect(() => {
+        setItems([]);
+        setPage(1);
+        setHasMore(true);
+    }, [options.q, JSON.stringify(options.filter), options.sort]);
+    const loadMore = useCallback(async () => {
+        if (!hasMore || api.loading)
+            return;
+        const response = await api.get(endpoint, Object.assign(Object.assign({}, options), { page, per_page: options.per_page || 15 }));
+        if (response.success) {
+            const newData = Array.isArray(response.data) ? response.data : [];
+            if (newData.length === 0) {
+                setHasMore(false);
+            }
+            else {
+                setItems((prev) => [...prev, ...newData]);
+                setPage(prev => prev + 1);
+                // Check pagination from extraData
+                const extra = response.__extraData;
+                if (extra && typeof extra.last_page === 'number' && page >= extra.last_page) {
+                    setHasMore(false);
+                }
+            }
+        }
+    }, [endpoint, page, hasMore, api.loading, options]);
+    return {
+        items,
+        loading: api.loading,
+        error: api.error,
+        hasMore,
+        loadMore,
+        reset: () => {
+            setItems([]);
+            setPage(1);
+            setHasMore(true);
+        }
+    };
+}
+//# sourceMappingURL=useMkInfiniteList.js.map

package/dist/hooks/useMkInfiniteList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMkInfiniteList.js","sourceRoot":"","sources":["../../src/hooks/useMkInfiniteList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAU,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AASlC,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,UAA+B,EAAE;IACjF,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAQ,EAAE,CAAC,CAAC;IAC9C,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEpC,yCAAyC;IACzC,SAAS,CAAC,GAAG,EAAE;QACX,QAAQ,CAAC,EAAE,CAAC,CAAC;QACb,OAAO,CAAC,CAAC,CAAC,CAAC;QACX,UAAU,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAE9D,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACpC,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO;YAAE,OAAO;QAEpC,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,QAAQ,kCAChC,OAAO,KACV,IAAI,EACJ,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE,IAClC,CAAC;QAEH,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,OAAO,GAAc,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,UAAU,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACJ,QAAQ,CAAC,CAAC,IAAW,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAI,OAAiB,CAAC,CAAC,CAAC;gBAC5D,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;gBAE1B,kCAAkC;gBAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAiD,CAAC;gBACzE,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,IAAI,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;oBAC1E,UAAU,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAEpD,OAAO;QACH,KAAK;QACL,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,OAAO;QACP,QAAQ;QACR,KAAK,EAAE,GAAG,EAAE;YACR,QAAQ,CAAC,EAAE,CAAC,CAAC;YACb,OAAO,CAAC,CAAC,CAAC,CAAC;YACX,UAAU,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/hooks/useMkList.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @module useMkList
+ * @description Paginated list manager for React Web — mirrors mk-mobile's useMkList API.
+ * Manages page, search, sort, and filters with auto-refresh on param changes.
+ *
+ * @example
+ * ```tsx
+ * const { data, loading, params, setSearch, setPage, setSort, setFilter, refresh } = useMkList('/users');
+ *
+ * // Search
+ * setSearch('mario');
+ *
+ * // Change page
+ * setPage(2);
+ *
+ * // Sort
+ * setSort('-created_at');
+ *
+ * // Filter
+ * setFilter('status', 'active');
+ * ```
+ */
+export interface MkListParams {
+    page?: number;
+    per_page?: number;
+    q?: string;
+    sort?: string;
+    filter?: Record<string, any>;
+}
+export interface MkListOptions {
+    /** Initial params. */
+    initialParams?: MkListParams;
+    /** Whether to auto-fetch on mount and param changes. Default true. */
+    autoFetch?: boolean;
+    /** Debounce delay in ms for search updates. Default 0 (no debounce). */
+    debounceMs?: number;
+}
+export declare function useMkList(endpoint: string, options?: MkListOptions): {
+    params: MkListParams;
+    setParams: import("react").Dispatch<import("react").SetStateAction<MkListParams>>;
+    setFilter: (field: string, value: any) => void;
+    setPage: (page: number) => void;
+    setSearch: (q: string) => void;
+    setSort: (sort: string) => void;
+    setPerPage: (per_page: number) => void;
+    resetFilters: () => void;
+    refresh: (extraParams?: MkListParams) => Promise<import("@mk/core").MkResponse<unknown>>;
+    /** Pagination meta from __extraData */
+    pagination: any;
+    status: import("@mk/core").ApiStatus;
+    data: any;
+    error: any;
+    waiting: number;
+    loading: boolean;
+    get: (endpoint: string, params?: any) => Promise<import("@mk/core").MkResponse<unknown>>;
+    post: (endpoint: string, body: any) => Promise<import("@mk/core").MkResponse<unknown>>;
+    put: (endpoint: string, body: any) => Promise<import("@mk/core").MkResponse<unknown>>;
+    delete: (endpoint: string) => Promise<import("@mk/core").MkResponse<unknown>>;
+    remove: (endpoint: string) => Promise<import("@mk/core").MkResponse<unknown>>;
+};
+//# sourceMappingURL=useMkList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useMkList.d.ts","sourceRoot":"","sources":["../../src/hooks/useMkList.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,YAAY;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC1B,sBAAsB;IACtB,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,sEAAsE;IACtE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB;;;uBAiB7B,MAAM,SAAS,GAAG;oBAQrB,MAAM;mBAIP,MAAM;oBAIL,MAAM;2BAIC,MAAM;;4BA1B9B,YAAY;IAyD1B,uCAAuC;;;;;;;;;;;;EAG9C"}

package/dist/hooks/useMkList.js

@@ -0,0 +1,54 @@
+import { useState, useCallback, useEffect, useRef } from 'react';
+import { useApi } from './useApi';
+export function useMkList(endpoint, options = {}) {
+    var _a;
+    const { initialParams = {}, autoFetch = true } = options;
+    const api = useApi();
+    const [params, setParams] = useState(Object.assign({ page: 1, per_page: 15 }, initialParams));
+    const mountedRef = useRef(false);
+    const refresh = useCallback((extraParams = {}) => {
+        return api.get(endpoint, Object.assign(Object.assign({}, params), extraParams));
+    }, [endpoint, params]);
+    const setFilter = useCallback((field, value) => {
+        setParams(prev => (Object.assign(Object.assign({}, prev), { page: 1, filter: Object.assign(Object.assign({}, prev.filter), { [field]: value }) })));
+    }, []);
+    const setPage = useCallback((page) => {
+        setParams(prev => (Object.assign(Object.assign({}, prev), { page })));
+    }, []);
+    const setSearch = useCallback((q) => {
+        setParams(prev => (Object.assign(Object.assign({}, prev), { page: 1, q })));
+    }, []);
+    const setSort = useCallback((sort) => {
+        setParams(prev => (Object.assign(Object.assign({}, prev), { sort })));
+    }, []);
+    const setPerPage = useCallback((per_page) => {
+        setParams(prev => (Object.assign(Object.assign({}, prev), { page: 1, per_page })));
+    }, []);
+    const resetFilters = useCallback(() => {
+        setParams(prev => (Object.assign(Object.assign({}, prev), { page: 1, q: undefined, sort: undefined, filter: undefined })));
+    }, []);
+    // Auto-refresh
+    useEffect(() => {
+        if (!autoFetch)
+            return;
+        if (!mountedRef.current) {
+            mountedRef.current = true;
+            refresh();
+            return;
+        }
+        refresh();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [params]);
+    return Object.assign(Object.assign({}, api), { params,
+        setParams,
+        setFilter,
+        setPage,
+        setSearch,
+        setSort,
+        setPerPage,
+        resetFilters,
+        refresh, 
+        /** Pagination meta from __extraData */
+        pagination: ((_a = api.data) === null || _a === void 0 ? void 0 : _a.__extraData) || {} });
+}
+//# sourceMappingURL=useMkList.js.map

package/dist/hooks/useMkList.js.map

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

package/dist/hooks/useMkLocalStorage.d.ts

@@ -0,0 +1,6 @@
+/**
+ * useMkLocalStorage
+ * 🚀 Sincroniza el estado de React con el almacenamiento local.
+ */
+export declare function useMkLocalStorage<T>(key: string, initialValue: T): readonly [T, (value: T | ((val: T) => T)) => void];
+//# sourceMappingURL=useMkLocalStorage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useMkLocalStorage.d.ts","sourceRoot":"","sources":["../../src/hooks/useMkLocalStorage.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,wBAYtC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,WAa7C"}