@asteby/metacore-runtime-react 45.0.0 → 45.3.0

package/dist/approval-pin-dialog.js

@@ -0,0 +1,66 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// ApprovalPinDialog — the supervisor PIN prompt shared by every sensitive action
+// (POS sell-without-stock, discount above the cap, price below the floor, refund,
+// CFDI cancel, inventory adjust). Presentational: it collects a reason + a PIN and
+// hands them to `onSubmit`, which does the network call, so federated addons that
+// carry their own HTTP client reuse the same dialog as hosts with an ApiProvider.
+//
+// The reason is always required (audit trail: who asked, who authorized, why).
+// A rejected `onSubmit` keeps the dialog open and shows the error inline (wrong
+// PIN, locked, no permission) instead of a toast that can be missed.
+import { useEffect, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { Loader2, ShieldCheck } from 'lucide-react';
+import { Button, Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, Input, Textarea, } from '@asteby/metacore-ui/primitives';
+/** Best human message out of an axios-style error carrying the kernel envelope. */
+export function approvalErrorMessage(err, t) {
+    const data = err?.response?.data;
+    switch (data?.error?.code) {
+        case 'approval_pin_invalid':
+            return t('approvals.pin_invalid', { defaultValue: 'PIN incorrecto o sin permiso para autorizar esto.' });
+        case 'approval_pin_locked':
+            return t('approvals.pin_locked', { defaultValue: 'Demasiados intentos. Espera unos minutos.' });
+        case 'approval_pin_unavailable':
+            return t('approvals.pin_unavailable', { defaultValue: 'La autorización con PIN no está disponible.' });
+        case 'approval_reason_required':
+            return t('approvals.reason_required', { defaultValue: 'Escribe el motivo.' });
+    }
+    return data?.error?.message || data?.message || err?.message || t('common.error', { defaultValue: 'Algo salió mal' });
+}
+export function ApprovalPinDialog({ open, title, description, onSubmit, onCancel, secondaryAction }) {
+    const { t } = useTranslation();
+    const [pin, setPin] = useState('');
+    const [reason, setReason] = useState('');
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        if (open) {
+            setPin('');
+            setReason('');
+            setError(null);
+            setBusy(false);
+        }
+    }, [open]);
+    const ready = /^\d{4,8}$/.test(pin) && reason.trim().length > 0;
+    const submit = async () => {
+        if (!ready || busy)
+            return;
+        setBusy(true);
+        setError(null);
+        try {
+            await onSubmit({ pin, reason: reason.trim() });
+        }
+        catch (err) {
+            setError(approvalErrorMessage(err, t));
+            setPin('');
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    return (_jsx(Dialog, { open: open, onOpenChange: (o) => { if (!o && !busy)
+            onCancel(); }, children: _jsxs(DialogContent, { className: "sm:max-w-md", children: [_jsxs(DialogHeader, { children: [_jsxs(DialogTitle, { className: "flex items-center gap-2", children: [_jsx(ShieldCheck, { className: "h-5 w-5" }), title] }), _jsx(DialogDescription, { asChild: true, children: _jsx("div", { children: description ?? t('approvals.pin_prompt', { defaultValue: 'Requiere autorización de un supervisor.' }) }) })] }), _jsxs("form", { className: "space-y-3", onSubmit: (e) => {
+                        e.preventDefault();
+                        void submit();
+                    }, children: [_jsxs("div", { className: "space-y-1.5", children: [_jsx("label", { className: "text-sm font-medium", htmlFor: "approval-reason", children: t('approvals.reason', { defaultValue: 'Motivo' }) }), _jsx(Textarea, { id: "approval-reason", value: reason, onChange: (e) => setReason(e.target.value), rows: 2, placeholder: t('approvals.reason_placeholder', { defaultValue: 'Por qué se autoriza' }) })] }), _jsxs("div", { className: "space-y-1.5", children: [_jsx("label", { className: "text-sm font-medium", htmlFor: "approval-pin", children: t('approvals.pin', { defaultValue: 'PIN del supervisor' }) }), _jsx(Input, { id: "approval-pin", type: "password", inputMode: "numeric", autoComplete: "off", maxLength: 8, value: pin, onChange: (e) => setPin(e.target.value.replace(/\D/g, '')), "aria-invalid": error ? true : undefined })] }), error ? (_jsx("p", { role: "alert", className: "text-sm text-destructive", children: error })) : null, _jsxs(DialogFooter, { className: "gap-2 sm:gap-2", children: [secondaryAction ? (_jsx(Button, { type: "button", variant: "ghost", onClick: secondaryAction.onClick, disabled: busy, children: secondaryAction.label })) : null, _jsx(Button, { type: "button", variant: "outline", onClick: onCancel, disabled: busy, children: t('common.cancel', { defaultValue: 'Cancelar' }) }), _jsxs(Button, { type: "submit", disabled: !ready || busy, children: [busy ? _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }) : null, t('approvals.authorize', { defaultValue: 'Autorizar' })] })] })] })] }) }));
+}

package/dist/business/catalog.d.ts

@@ -0,0 +1,16 @@
+export interface BusinessComponentSpec {
+    /** Nombre exportado desde `@asteby/metacore-runtime-react`. */
+    name: string;
+    /** Prop de datos principal y su tipo. */
+    value: string;
+    /** Eventos (props `on*`) que emite. */
+    events: string[];
+    /** Capabilities que consulta con `useCan` (formato `<modelo>.<acción>`). */
+    permissions: string[];
+    /** Módulos donde el benchmark dice que se usa. */
+    usedBy: string[];
+    /** Utilidades puras exportadas junto al componente. */
+    helpers: string[];
+}
+export declare const BUSINESS_COMPONENTS: readonly BusinessComponentSpec[];
+//# sourceMappingURL=catalog.d.ts.map

package/dist/business/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/business/catalog.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IAClC,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,uCAAuC;IACvC,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,kDAAkD;IAClD,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,eAAO,MAAM,mBAAmB,EAAE,SAAS,qBAAqB,EAiDtD,CAAA"}

package/dist/business/catalog.js

@@ -0,0 +1,50 @@
+export const BUSINESS_COMPONENTS = [
+    {
+        name: 'CustomerPicker',
+        value: 'value: CustomerResult | null',
+        events: ['onChange'],
+        permissions: ['<model>.create (alta rápida; default Customer → customer.create)'],
+        usedBy: ['POS', 'Cotización', 'Pedido', 'Apartado', 'Factura', 'OT', 'RMA', 'Cobranza'],
+        helpers: [],
+    },
+    {
+        name: 'ProductPicker',
+        value: '(sin estado: search + onSelect)',
+        events: ['onSelect'],
+        permissions: [],
+        usedBy: ['POS', 'Cotización', 'Pedido', 'OC', 'Recepción', 'Traspaso', 'Ajuste', 'OT'],
+        helpers: ['parseProductQuery', 'parseTireSize', 'availableStock', 'productToLine'],
+    },
+    {
+        name: 'LineItemsEditor',
+        value: 'value: LineItem[]',
+        events: ['onChange', 'onValidate', 'onRequestProduct'],
+        permissions: ['editPermission (prop, opcional)'],
+        usedBy: ['Cotización', 'Pedido', 'Factura', 'OC', 'Recepción', 'OT', 'RMA', 'NC'],
+        helpers: ['makeLine', 'computeLine', 'computeTotals', 'validateLineItems', 'serializeLineItems', 'parseLineItems'],
+    },
+    {
+        name: 'PaymentCapture',
+        value: 'value: PaymentTender[]',
+        events: ['onChange', 'onSubmit'],
+        permissions: ['submitPermission (prop, opcional)'],
+        usedBy: ['POS/Caja', 'Apartado', 'Cobranza', 'Factura (Registrar pago)', 'OT'],
+        helpers: ['newTender', 'summarizePayment', 'validatePayment', 'serializePayment'],
+    },
+    {
+        name: 'RefundDestination',
+        value: 'value: RefundAllocation[]',
+        events: ['onChange', 'onValidate'],
+        permissions: [],
+        usedBy: ['ReturnWizard', 'Cancelación de apartado', 'Anticipos'],
+        helpers: ['validateRefund', 'singleDestination', 'DEFAULT_REFUND_DESTINATIONS'],
+    },
+    {
+        name: 'ReturnWizard',
+        value: 'lines: ReturnableLine[]',
+        events: ['onSubmit', 'onCancel'],
+        permissions: [],
+        usedBy: ['POS', 'Pedido', 'Factura', 'RMA', 'OT'],
+        helpers: ['computeReturnTotals', 'validateReturnChoices', 'creditNoteRelation', 'returnSteps', 'serializeReturn'],
+    },
+];

package/dist/business/customer-picker.d.ts

@@ -0,0 +1,39 @@
+export interface CustomerResult {
+    id: string;
+    name: string;
+    /** Identificador fiscal (RFC u homólogo): dato de la org, sin formato hardcodeado. */
+    tax_id?: string;
+    phone?: string;
+    email?: string;
+    plate?: string;
+    vin?: string;
+    /** Saldo por cobrar (adeudo). */
+    balance?: number;
+    credit_limit?: number;
+    /** Alertas visibles: «Cliente con adeudo vencido», «Lista negra». */
+    alerts?: string[];
+}
+export interface CustomerPickerProps {
+    value: CustomerResult | null;
+    /** Evento único de cambio: cliente elegido/creado, o `null` al limpiar. */
+    onChange: (customer: CustomerResult | null) => void;
+    /** Búsqueda (nombre, ID fiscal, teléfono, placa, VIN). Estable (useCallback). */
+    search: (q: string, signal: AbortSignal) => Promise<CustomerResult[]>;
+    /** Modelo del kernel para el alta rápida. Default `Customer`. */
+    model?: string;
+    /** Endpoint CRUD del alta. Default `/data/<model>/me`. */
+    endpoint?: string;
+    /** Convierte el registro guardado a `CustomerResult`. Default: id + name. */
+    mapRecord?: (rec: Record<string, unknown>) => CustomerResult;
+    /** Valida el ID fiscal según la config de la org; devuelve el mensaje o undefined. */
+    validateTaxId?: (taxId: string) => string | undefined;
+    /** Overrides de permiso (default `<model>.create` con useCan). */
+    canCreate?: boolean;
+    /** Valores iniciales del alta rápida (p. ej. el texto buscado como nombre). */
+    createDefaults?: Record<string, unknown>;
+    currency?: string;
+    disabled?: boolean;
+    placeholder?: string;
+}
+export declare function CustomerPicker({ value, onChange, search, model, endpoint, mapRecord, validateTaxId, canCreate, createDefaults, currency, disabled, placeholder, }: CustomerPickerProps): import("react").JSX.Element;
+//# sourceMappingURL=customer-picker.d.ts.map

package/dist/business/customer-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customer-picker.d.ts","sourceRoot":"","sources":["../../src/business/customer-picker.tsx"],"names":[],"mappings":"AAcA,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;IAC5B,2EAA2E;IAC3E,QAAQ,EAAE,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAA;IACnD,iFAAiF;IACjF,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IACrE,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,cAAc,CAAA;IAC5D,sFAAsF;IACtF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IACrD,kEAAkE;IAClE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB;AAMD,wBAAgB,cAAc,CAAC,EAC3B,KAAK,EACL,QAAQ,EACR,MAAM,EACN,KAAkB,EAClB,QAAQ,EACR,SAAS,EACT,aAAa,EACb,SAAS,EACT,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,WAAW,GACd,EAAE,mBAAmB,+BAkIrB"}

package/dist/business/customer-picker.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// CustomerPicker + alta rápida — busca por nombre, RFC/ID fiscal, teléfono, placa
+// o VIN; muestra saldo, crédito y alertas (benchmark §7). El alta rápida reutiliza
+// el <CreateRecordDialog> dinámico del modelo (formulario desde metadata).
+import { useCallback, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { Plus, Search, X } from 'lucide-react';
+import { Badge, Button, Input } from '@asteby/metacore-ui';
+import { CreateRecordDialog } from '../dialogs/create-record-dialog';
+import { useApi } from '../api-context';
+import { useCan } from '../permissions-context';
+import { useFormatter } from './format';
+import { useAsyncSearch } from './use-async-search';
+import { EmptyState } from './feedback';
+function snake(model) {
+    return model.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toLowerCase();
+}
+export function CustomerPicker({ value, onChange, search, model = 'Customer', endpoint, mapRecord, validateTaxId, canCreate, createDefaults, currency, disabled, placeholder, }) {
+    const { t } = useTranslation();
+    const api = useApi();
+    const can = useCan();
+    const fmt = useFormatter({ currency });
+    const [text, setText] = useState('');
+    const [creating, setCreating] = useState(false);
+    const { results, loading, error } = useAsyncSearch(text, search, { minChars: 2 });
+    const mayCreate = canCreate ?? can(`${snake(model)}.create`);
+    const base = endpoint ?? `/data/${model}/me`;
+    const taxIdError = value?.tax_id && validateTaxId ? validateTaxId(value.tax_id) : undefined;
+    const pick = (c) => {
+        onChange(c);
+        setText('');
+    };
+    const toResult = useCallback((rec) => mapRecord
+        ? mapRecord(rec)
+        : {
+            id: String(rec.id ?? ''),
+            name: String(rec.name ?? ''),
+            tax_id: typeof rec.tax_id === 'string' ? rec.tax_id : undefined,
+            phone: typeof rec.phone === 'string' ? rec.phone : undefined,
+        }, [mapRecord]);
+    if (value) {
+        const overLimit = value.credit_limit != null && (value.balance ?? 0) > value.credit_limit;
+        return (_jsxs("div", { "data-slot": "customer-picker", className: "space-y-1 rounded-md border p-2", children: [_jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsxs("div", { children: [_jsx("p", { className: "text-sm font-medium", children: value.name }), _jsx("p", { className: "text-xs text-muted-foreground", children: [value.tax_id, value.phone, value.plate, value.vin].filter(Boolean).join(' · ') })] }), !disabled && (_jsx(Button, { type: "button", size: "icon", variant: "ghost", onClick: () => onChange(null), "aria-label": t('customerPicker.clear', { defaultValue: 'Quitar cliente' }), children: _jsx(X, { className: "size-4" }) }))] }), _jsxs("div", { className: "flex flex-wrap gap-1.5", children: [value.balance != null && value.balance !== 0 && (_jsxs(Badge, { variant: overLimit ? 'danger' : 'warning', children: [t('customerPicker.balance', { defaultValue: 'Adeudo' }), " ", fmt.money(value.balance)] })), value.credit_limit != null && (_jsxs(Badge, { variant: "muted", children: [t('customerPicker.credit', { defaultValue: 'Crédito' }), " ", fmt.money(value.credit_limit)] })), value.alerts?.map((a) => (_jsx(Badge, { variant: "danger", children: a }, a)))] }), taxIdError && _jsx("p", { role: "alert", className: "text-xs text-destructive", children: taxIdError })] }));
+    }
+    return (_jsxs("div", { "data-slot": "customer-picker", className: "space-y-2", children: [_jsxs("div", { className: "flex items-center gap-1.5", children: [_jsxs("div", { className: "relative flex-1", children: [_jsx(Search, { className: "pointer-events-none absolute left-2.5 top-2.5 size-4 text-muted-foreground", "aria-hidden": true }), _jsx(Input, { className: "pl-8", disabled: disabled, value: text, placeholder: placeholder ?? t('customerPicker.placeholder', { defaultValue: 'Nombre, RFC, teléfono, placa o VIN' }), onChange: (e) => setText(e.target.value) })] }), mayCreate && (_jsx(Button, { type: "button", variant: "outline", size: "icon", disabled: disabled, onClick: () => setCreating(true), "aria-label": t('customerPicker.create', { defaultValue: 'Nuevo cliente' }), children: _jsx(Plus, { className: "size-4" }) }))] }), loading && _jsx("p", { className: "text-sm text-muted-foreground", children: t('common.searching', { defaultValue: 'Buscando…' }) }), error && !loading && (_jsx("p", { role: "alert", className: "text-sm text-destructive", children: t('customerPicker.error', { defaultValue: 'No se pudo buscar clientes. Inténtalo de nuevo.' }) })), !loading && !error && text.trim().length >= 2 && results.length === 0 && (_jsx(EmptyState, { title: t('customerPicker.empty', { defaultValue: 'No encontramos a ese cliente' }), action: mayCreate ? { label: t('customerPicker.createAction', { defaultValue: 'Crear cliente' }), onClick: () => setCreating(true) } : undefined })), results.length > 0 && (_jsx("ul", { role: "listbox", className: "max-h-64 divide-y overflow-auto rounded-md border", children: results.map((c) => (_jsx("li", { role: "option", "aria-selected": false, children: _jsxs("button", { type: "button", className: "flex w-full items-center justify-between gap-2 px-2 py-1.5 text-left hover:bg-accent", onClick: () => pick(c), children: [_jsxs("span", { children: [_jsx("span", { className: "block text-sm font-medium", children: c.name }), _jsx("span", { className: "block text-xs text-muted-foreground", children: [c.tax_id, c.phone, c.plate, c.vin].filter(Boolean).join(' · ') })] }), c.balance != null && c.balance > 0 && _jsx(Badge, { variant: "warning", children: fmt.money(c.balance) })] }) }, c.id))) })), creating && (_jsx(CreateRecordDialog, { modelKey: model, open: creating, onOpenChange: setCreating, endpoint: base, defaults: createDefaults ?? (text.trim() ? { name: text.trim() } : undefined), onCreate: async (data) => {
+                    const res = await api.post(base, data);
+                    const rec = (res.data?.data ?? res.data);
+                    pick(toResult(rec));
+                    return rec.id != null ? { id: String(rec.id) } : undefined;
+                } }))] }));
+}

package/dist/business/feedback.d.ts

@@ -0,0 +1,72 @@
+import type { ReactNode } from 'react';
+import { type LucideIcon } from 'lucide-react';
+/**
+ * Props recomendadas para `<Toaster>` de metacore-ui: los toasts viven arriba a
+ * la derecha (el área de acciones primarias suele estar abajo) y dejan hueco
+ * bajo la cabecera. Se propagan tal cual: `<Toaster {...ACTION_SAFE_TOASTER_PROPS} />`.
+ */
+export declare const ACTION_SAFE_TOASTER_PROPS: {
+    position: "top-right";
+    offset: number;
+    mobileOffset: number;
+    visibleToasts: number;
+};
+/** Duración de un toast de éxito (ms): confirma y se va. */
+export declare const SUCCESS_TOAST_MS = 3000;
+export declare const notify: {
+    /** Confirmación breve de un éxito («Pago registrado»). Admite «Deshacer». */
+    success(message: string, opts?: {
+        undo?: {
+            label?: string;
+            onUndo: () => void;
+        };
+        description?: string;
+    }): string | number;
+    /**
+     * Error inesperado (red, 5xx) sin campo al que atribuirlo. Los errores de
+     * validación NO van aquí: usa `mapApiError` + `<FormErrorBanner>`/error del input.
+     */
+    error(message: string, description?: string): string | number;
+};
+export interface SystemNoticeBannerProps {
+    message: ReactNode;
+    /** Acción opcional («Actualizar»). */
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+    onDismiss?: () => void;
+    dismissLabel?: string;
+    className?: string;
+}
+/** Aviso del sistema en flujo normal de la página (no flota sobre botones). */
+export declare function SystemNoticeBanner({ message, action, onDismiss, dismissLabel, className }: SystemNoticeBannerProps): import("react").JSX.Element;
+export interface FormErrorBannerProps {
+    /** Qué pasó y cómo corregirlo (típicamente `mapApiError(...).form`). */
+    message?: string;
+    /** Botón a la solución («Ir al campo», «Reintentar»). */
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+    className?: string;
+}
+/** Error persistente de formulario; no renderiza nada sin `message`. */
+export declare function FormErrorBanner({ message, action, className }: FormErrorBannerProps): import("react").JSX.Element | null;
+export interface EmptyStateProps {
+    icon?: LucideIcon;
+    /** Qué falta («Aún no hay movimientos para este producto»). */
+    title: string;
+    description?: string;
+    /** Acción primaria («Registrar saldo inicial»). Se oculta si `hidden`. */
+    action?: {
+        label: string;
+        onClick?: () => void;
+        href?: string;
+        hidden?: boolean;
+    };
+    className?: string;
+}
+/** Estado vacío accionable: explicación + una acción primaria. */
+export declare function EmptyState({ icon: Icon, title, description, action, className }: EmptyStateProps): import("react").JSX.Element;
+//# sourceMappingURL=feedback.d.ts.map

package/dist/business/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/business/feedback.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,EAAwB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AAGpE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;;;CAKrC,CAAA;AAED,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,OAAO,CAAA;AAEpC,eAAO,MAAM,MAAM;IACf,6EAA6E;qBAC5D,MAAM,SAAS;QAAE,IAAI,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,IAAI,CAAA;SAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IASvG;;;OAGG;mBACY,MAAM,gBAAgB,MAAM;CAG9C,CAAA;AAED,MAAM,WAAW,uBAAuB;IACpC,OAAO,EAAE,SAAS,CAAA;IAClB,sCAAsC;IACtC,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAA;IAC/C,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,YAA0B,EAAE,SAAS,EAAE,EAAE,uBAAuB,+BAqBhI;AAED,MAAM,WAAW,oBAAoB;IACjC,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yDAAyD;IACzD,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAA;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,oBAAoB,sCAiBnF;AAED,MAAM,WAAW,eAAe;IAC5B,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0EAA0E;IAC1E,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACjF,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,eAAe,+BAsBhG"}

package/dist/business/feedback.js

@@ -0,0 +1,52 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { toast } from 'sonner';
+import { AlertCircle, Info, X } from 'lucide-react';
+import { Button } from '@asteby/metacore-ui';
+/**
+ * Props recomendadas para `<Toaster>` de metacore-ui: los toasts viven arriba a
+ * la derecha (el área de acciones primarias suele estar abajo) y dejan hueco
+ * bajo la cabecera. Se propagan tal cual: `<Toaster {...ACTION_SAFE_TOASTER_PROPS} />`.
+ */
+export const ACTION_SAFE_TOASTER_PROPS = {
+    position: 'top-right',
+    offset: 72,
+    mobileOffset: 72,
+    visibleToasts: 3,
+};
+/** Duración de un toast de éxito (ms): confirma y se va. */
+export const SUCCESS_TOAST_MS = 3000;
+export const notify = {
+    /** Confirmación breve de un éxito («Pago registrado»). Admite «Deshacer». */
+    success(message, opts) {
+        return toast.success(message, {
+            duration: SUCCESS_TOAST_MS,
+            description: opts?.description,
+            action: opts?.undo
+                ? { label: opts.undo.label ?? 'Deshacer', onClick: opts.undo.onUndo }
+                : undefined,
+        });
+    },
+    /**
+     * Error inesperado (red, 5xx) sin campo al que atribuirlo. Los errores de
+     * validación NO van aquí: usa `mapApiError` + `<FormErrorBanner>`/error del input.
+     */
+    error(message, description) {
+        return toast.error(message, { description, duration: 8000 });
+    },
+};
+/** Aviso del sistema en flujo normal de la página (no flota sobre botones). */
+export function SystemNoticeBanner({ message, action, onDismiss, dismissLabel = 'Descartar', className }) {
+    return (_jsxs("div", { role: "status", "data-slot": "system-notice", className: `flex items-center gap-3 rounded-md border bg-muted px-3 py-2 text-sm ${className ?? ''}`, children: [_jsx(Info, { className: "size-4 shrink-0 text-muted-foreground", "aria-hidden": true }), _jsx("span", { className: "flex-1", children: message }), action && (_jsx(Button, { type: "button", size: "sm", variant: "outline", onClick: action.onClick, children: action.label })), onDismiss && (_jsx(Button, { type: "button", size: "icon", variant: "ghost", onClick: onDismiss, "aria-label": dismissLabel, children: _jsx(X, { className: "size-4" }) }))] }));
+}
+/** Error persistente de formulario; no renderiza nada sin `message`. */
+export function FormErrorBanner({ message, action, className }) {
+    if (!message)
+        return null;
+    return (_jsxs("div", { role: "alert", "data-slot": "form-error", className: `flex items-start gap-3 rounded-md border border-destructive/40 bg-destructive/5 px-3 py-2 text-sm text-destructive ${className ?? ''}`, children: [_jsx(AlertCircle, { className: "mt-0.5 size-4 shrink-0", "aria-hidden": true }), _jsx("span", { className: "flex-1", children: message }), action && (_jsx(Button, { type: "button", size: "sm", variant: "outline", onClick: action.onClick, children: action.label }))] }));
+}
+/** Estado vacío accionable: explicación + una acción primaria. */
+export function EmptyState({ icon: Icon, title, description, action, className }) {
+    const showAction = action && !action.hidden;
+    return (_jsxs("div", { "data-slot": "empty-state", className: `flex flex-col items-center gap-2 px-4 py-10 text-center ${className ?? ''}`, children: [Icon && _jsx(Icon, { className: "size-8 text-muted-foreground", "aria-hidden": true }), _jsx("p", { className: "text-sm font-medium", children: title }), description && _jsx("p", { className: "max-w-sm text-sm text-muted-foreground", children: description }), showAction &&
+                (action.href ? (_jsx(Button, { asChild: true, size: "sm", className: "mt-2", children: _jsx("a", { href: action.href, children: action.label }) })) : (_jsx(Button, { type: "button", size: "sm", className: "mt-2", onClick: action.onClick, children: action.label })))] }));
+}

package/dist/business/field-errors.d.ts

@@ -0,0 +1,26 @@
+import { type Translate } from '../server-error';
+export interface MappedApiError {
+    /** HTTP status si el error lo trae (axios `response.status`). */
+    status?: number;
+    /** Mensaje ya localizado por campo, listo para el `error` de cada input. */
+    fields: Record<string, string>;
+    /** Mensaje general (qué pasó + cómo corregirlo) para un banner; sin jerga. */
+    form?: string;
+    /** true si hay al menos un mensaje atribuible a un campo. */
+    hasFieldErrors: boolean;
+}
+export interface MapApiErrorOptions {
+    t?: Translate;
+    language?: string;
+    /** Etiquetas traducidas por clave de campo (para «El campo {{label}}…»). */
+    labels?: Record<string, string>;
+    /** Campos conocidos del formulario: un 409 se atribuye al que la causa nombra. */
+    knownFields?: string[];
+    fallback?: string;
+}
+/**
+ * Convierte cualquier error de mutación en mensajes por campo + mensaje general.
+ * Pura salvo por `t`; no muestra toasts.
+ */
+export declare function mapApiError(err: unknown, opts?: MapApiErrorOptions): MappedApiError;
+//# sourceMappingURL=field-errors.d.ts.map

package/dist/business/field-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-errors.d.ts","sourceRoot":"","sources":["../../src/business/field-errors.ts"],"names":[],"mappings":"AAOA,OAAO,EAIH,KAAK,SAAS,EACjB,MAAM,iBAAiB,CAAA;AAExB,MAAM,WAAW,cAAc;IAC3B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6DAA6D;IAC7D,cAAc,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IAC/B,CAAC,CAAC,EAAE,SAAS,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAsBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE,kBAAuB,GAAG,cAAc,CAgCvF"}

package/dist/business/field-errors.js

@@ -0,0 +1,59 @@
+// Mapeo de errores de API (409/422/…) a mensajes por campo (PIT-002/003/013/021/029).
+//
+// Un 422 trae `errors: {campo: [{code, params}]}`; un 409 (duplicado, enum,
+// conflicto de estado) suele traer solo `message`/`details`. Ambos se resuelven
+// aquí a `{ fields, form }`: los campos se pintan junto al input y `form` (lo que
+// no se pudo atribuir a un campo) va a un banner persistente — el toast solo
+// confirma éxitos.
+import { extractFieldErrors, extractServerError, localizeFieldErrorMap, } from '../server-error';
+const CONFLICT_HINTS = [
+    { re: /duplicate|already exists|unique|23505|ya existe/i, es: 'Ya existe un registro con ese valor' },
+];
+/** Traductor sin i18next: devuelve el default con `{{var}}` interpolado. */
+const defaultTranslate = (key, o) => (o?.defaultValue ?? key).replace(/\{\{(\w+)\}\}/g, (_, k) => String(o?.[k] ?? ''));
+function statusOf(err) {
+    const s = err?.response?.status;
+    return typeof s === 'number' ? s : undefined;
+}
+/** Encuentra el campo que un texto de causa nombra (`Key (sku)=(A1) already exists`). */
+function fieldNamedBy(text, known) {
+    if (!known?.length)
+        return undefined;
+    const lower = text.toLowerCase();
+    return known.find((k) => new RegExp(`(^|[^a-z0-9_])${k.toLowerCase()}([^a-z0-9_]|$)`).test(lower));
+}
+/**
+ * Convierte cualquier error de mutación en mensajes por campo + mensaje general.
+ * Pura salvo por `t`; no muestra toasts.
+ */
+export function mapApiError(err, opts = {}) {
+    const t = opts.t ?? defaultTranslate;
+    const status = statusOf(err);
+    const raw = extractFieldErrors(err);
+    if (raw) {
+        const fields = localizeFieldErrorMap(raw, t, { labels: opts.labels, language: opts.language });
+        return { status, fields, hasFieldErrors: Object.keys(fields).length > 0 };
+    }
+    // Sin respuesta HTTP (red caída, CORS, excepción): el texto crudo es jerga.
+    const noResponse = !err?.response && err instanceof Error;
+    const fallback = opts.fallback ?? t('common.error', { defaultValue: 'No se pudo completar la operación' });
+    if (noResponse)
+        return { status, fields: {}, form: fallback, hasFieldErrors: false };
+    const { title, description } = extractServerError(err, fallback);
+    const text = [title, description].filter(Boolean).join(' — ');
+    if (status === 409 || status === 422) {
+        const hint = CONFLICT_HINTS.find((h) => h.re.test(text));
+        const field = fieldNamedBy(text, opts.knownFields);
+        if (field) {
+            const label = opts.labels?.[field] ?? field;
+            const msg = hint
+                ? t('validation.duplicate', { defaultValue: 'Ya existe un registro con ese {{label}}', label })
+                : t(title, { defaultValue: title });
+            return { status, fields: { [field]: msg }, hasFieldErrors: true };
+        }
+        const form = hint ? hint.es : t(title, { defaultValue: title });
+        return { status, fields: {}, form: description && !hint ? `${form}. ${description}` : form, hasFieldErrors: false };
+    }
+    const form = t(title, { defaultValue: title });
+    return { status, fields: {}, form: description ? `${form}. ${description}` : form, hasFieldErrors: false };
+}

package/dist/business/format.d.ts

@@ -0,0 +1,49 @@
+/** Locale por defecto del producto. */
+export declare const DEFAULT_LOCALE = "es-MX";
+/** Moneda cuando ni la org ni el llamador dan una (mismo fallback que las celdas). */
+export declare const FALLBACK_CURRENCY = "USD";
+export interface FormatOptions {
+    /** BCP-47. Default `es-MX`. */
+    locale?: string;
+    /** ISO-4217 de la org. Default: contexto → `USD`. */
+    currency?: string;
+    /** IANA de la org. Default: contexto → zona del navegador. */
+    timeZone?: string;
+}
+/** Redondea a centavos evitando el error binario (1.005 → 1.01). */
+export declare function roundMoney(n: number, decimals?: number): number;
+/** Número (string con símbolo/separadores, o number) → number; NaN → 0. */
+export declare function toAmount(v: unknown): number;
+/**
+ * Monto con símbolo de la moneda de la org: `formatMoney(1060, {currency:'MXN'})`
+ * → `$1,060.00`. Un valor no numérico devuelve `''` (nunca «NaN»).
+ */
+export declare function formatMoney(amount: unknown, opts?: FormatOptions): string;
+/** Número plano localizado (`1,234.5`). */
+export declare function formatQuantity(n: unknown, opts?: {
+    locale?: string;
+    maximumFractionDigits?: number;
+}): string;
+/**
+ * Fecha (`29 sep 2026`). Un `YYYY-MM-DD` es fecha de calendario: se formatea en
+ * UTC para que no retroceda un día en zonas con offset negativo.
+ */
+export declare function formatDate(input: unknown, opts?: FormatOptions & {
+    style?: Intl.DateTimeFormatOptions['dateStyle'];
+}): string;
+/** Fecha y hora en la zona de la org (`29 sep 2026, 14:05`). */
+export declare function formatDateTime(input: unknown, opts?: FormatOptions): string;
+export interface Formatter {
+    locale: string;
+    currency: string;
+    timeZone: string | undefined;
+    money: (amount: unknown, currency?: string) => string;
+    quantity: (n: unknown) => string;
+    date: (input: unknown) => string;
+    dateTime: (input: unknown) => string;
+}
+/** Formateador ligado a un locale/moneda/zona fijos (para tickets y PDFs fuera de React). */
+export declare function createFormatter(opts?: FormatOptions): Formatter;
+/** Formateador con la moneda y zona de la org tomadas del runtime provider. */
+export declare function useFormatter(overrides?: FormatOptions): Formatter;
+//# sourceMappingURL=format.d.ts.map

package/dist/business/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/business/format.ts"],"names":[],"mappings":"AASA,uCAAuC;AACvC,eAAO,MAAM,cAAc,UAAU,CAAA;AACrC,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,QAAQ,CAAA;AAEtC,MAAM,WAAW,aAAa;IAC1B,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAI1D;AAED,2EAA2E;AAC3E,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAW3C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAa7E;AAED,2CAA2C;AAC3C,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAMjH;AAeD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,aAAa,GAAG;IAAE,KAAK,CAAC,EAAE,IAAI,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAA;CAAO,GAAG,MAAM,CAOjI;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAS/E;AAED,MAAM,WAAW,SAAS;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IACrD,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,MAAM,CAAA;IAChC,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;IAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;CACvC;AAED,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,IAAI,GAAE,aAAkB,GAAG,SAAS,CAanE;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,SAAS,GAAE,aAAkB,GAAG,SAAS,CAarE"}