@asteby/metacore-runtime-react 45.0.0 → 45.2.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @asteby/metacore-runtime-react
 
+## 45.2.0
+
+### Minor Changes
+
+- 19870d6: Patrón «página de documento» (benchmark Pitsline §5/§6/§7, FAC-1/FAC-5/FAC-6). Un `DocumentSpec` de datos puros declara, por modelo, badges de varias máquinas de estado independientes (`StatusMachine`, catálogo semántico neutral/info/success/caution/warning/critical con ícono y texto: el color nunca es la única señal), la distribución de acciones por estado (1 primaria + hasta 3 secundarias + «Más…» + zona destructiva separada, con bloqueo explicado `blockedWhen`), botones inteligentes con contador, pestañas (`fields` / `records` / `slot`) y fuentes relacionadas (con relación de dos saltos `via`). Componentes: `DocumentPage`, `DocumentHeader`, `ActionBar`, `SmartButtons`, `StatusBadge`, `DocumentTimeline`, `CancelWithReason` (cancelación guiada de 2 pasos con catálogo de motivos, documento sustituto y consecuencias). Registro por modelo con `registerDocumentPage` / `getDocumentPage`; `pruneUnavailableActions` quita las acciones que el backend no declara.
+
+## 45.1.0
+
+### Minor Changes
+
+- 610500d: Aprobación de supervisor con PIN: `ApprovalPinDialog` (motivo + PIN, error inline), `ApprovalGateProvider` / `useApprovalGate` (`requestApproval({policy, label, context})`: quien tiene `general.approve_<policy>` pasa sin prompt; los demás piden PIN a `/approvals/pin-grant`) y `approvalCapability`. `toastServerError` ya no pinta como error una escritura parada con `approval_required`: avisa "Enviado a aprobación" y, con el gate montado, ofrece "Aprobar con PIN" (`/approvals/:id/approve-pin`). Cierra el pendiente de docs/APPROVALS.md (los dispatchers del SDK apilaban el toast de error).
+- 2c4c75e: Componentes de negocio compartidos con contrato estable (benchmark Pitsline §7, §6.4-6.7) en `@asteby/metacore-runtime-react`.
+
+  - Componentes: `CustomerPicker`, `ProductPicker` (medida de llanta, código de barras, SKU/clave de proveedor, variantes, existencia por almacén), `LineItemsEditor` (secciones/notas, política de sobreventa, `serializeLineItems` como única salida hacia el backend — corrige el guardado de renglones PIT-018), `PaymentCapture` (cobro mixto, cambio solo en efectivo, referencia y cuenta) y `RefundDestination` (efectivo, tarjeta, monedero, saldo a favor, NC CFDI).
+  - Utilidades: formateador único `formatMoney` / `formatDate` / `formatDateTime` / `createFormatter` / `useFormatter` (es-MX, moneda y zona de la org, sin mezclar locale — PIT-023/025); `mapApiError` (409/422 → mensaje por campo + banner, PIT-002/003/013/021/029); `notify`, `SystemNoticeBanner`, `FormErrorBanner`, `ACTION_SAFE_TOASTER_PROPS` (avisos que no tapan acciones, PIT-005) y `EmptyState` accionable.
+  - `BUSINESS_COMPONENTS`: catálogo legible por máquina (props, eventos, permisos, dónde se usa). Guía en `docs/business-components.md`.
+
 ## 45.0.0
 
 ### Minor Changes

package/dist/approval-events.d.ts

@@ -0,0 +1,16 @@
+/** Window event toastServerError fires for a parked `approval_required` write. */
+export declare const APPROVAL_PARKED_EVENT = "metacore:approval-parked";
+/** Fired after a parked request was approved (and replayed) with a PIN. */
+export declare const APPROVAL_DECIDED_EVENT = "metacore:approval-decided";
+/** @internal provider bookkeeping. */
+export declare function gateMountedDelta(d: number): void;
+/** True while an <ApprovalGateProvider> is mounted (toastServerError offers the PIN action only then). */
+export declare function approvalGateAvailable(): boolean;
+export interface ApprovalRequiredInfo {
+    requestId: string;
+    label?: string;
+    roles: string[];
+}
+/** Extracts the parked-request info from an axios error / response body, or null. */
+export declare function approvalRequiredInfo(err: unknown): ApprovalRequiredInfo | null;
+//# sourceMappingURL=approval-events.d.ts.map

package/dist/approval-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-events.d.ts","sourceRoot":"","sources":["../src/approval-events.ts"],"names":[],"mappings":"AAIA,kFAAkF;AAClF,eAAO,MAAM,qBAAqB,6BAA6B,CAAA;AAC/D,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,8BAA8B,CAAA;AAGjE,sCAAsC;AACtC,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED,0GAA0G;AAC1G,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,MAAM,WAAW,oBAAoB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAU9E"}

package/dist/approval-events.js

@@ -0,0 +1,27 @@
+// approval-events — dependency-free glue between server-error.ts (which sees a
+// parked `approval_required` write) and <ApprovalGateProvider> (which owns the
+// PIN dialog). Kept apart so the error toaster never imports React/UI code.
+/** Window event toastServerError fires for a parked `approval_required` write. */
+export const APPROVAL_PARKED_EVENT = 'metacore:approval-parked';
+/** Fired after a parked request was approved (and replayed) with a PIN. */
+export const APPROVAL_DECIDED_EVENT = 'metacore:approval-decided';
+let gateMounted = 0;
+/** @internal provider bookkeeping. */
+export function gateMountedDelta(d) {
+    gateMounted += d;
+}
+/** True while an <ApprovalGateProvider> is mounted (toastServerError offers the PIN action only then). */
+export function approvalGateAvailable() {
+    return gateMounted > 0;
+}
+/** Extracts the parked-request info from an axios error / response body, or null. */
+export function approvalRequiredInfo(err) {
+    const data = (err?.response?.data ?? err);
+    if (data?.error?.code !== 'approval_required')
+        return null;
+    return {
+        requestId: data.meta?.approval_request_id ?? '',
+        label: data.meta?.approval_label,
+        roles: data.meta?.approval_roles ?? [],
+    };
+}

package/dist/approval-gate.d.ts

@@ -0,0 +1,39 @@
+import React from 'react';
+export { APPROVAL_DECIDED_EVENT, APPROVAL_PARKED_EVENT, approvalGateAvailable, approvalRequiredInfo, type ApprovalRequiredInfo, } from './approval-events';
+/** Capability that authorizes `policy` (and lets its holder skip the prompt). */
+export declare function approvalCapability(policy: string): string;
+export interface ApprovalGrant {
+    /** Audit row id (ApprovalRequest.kind=pin); null when the caller bypassed. */
+    id: string | null;
+    policy: string;
+    bypassed: boolean;
+    reason?: string;
+}
+export interface RequestApprovalOptions {
+    /** Policy key: oversell | discount | price_below_min | refund | cancel_cfdi | inventory_adjust | <addon-declared>. */
+    policy: string;
+    label: string;
+    description?: React.ReactNode;
+    /** Free-form audit data stored with the grant (product, qty, before → after…). */
+    context?: Record<string, unknown>;
+    model?: string;
+    recordId?: string;
+    addonKey?: string;
+}
+export interface ApprovalGateValue {
+    /** Resolves the grant, or null when the operator cancelled. */
+    requestApproval: (opts: RequestApprovalOptions) => Promise<ApprovalGrant | null>;
+    /** True when the current user may do `policy` without asking anyone. */
+    canSelfApprove: (policy: string) => boolean;
+}
+export declare function ApprovalGateProvider({ children }: {
+    children: React.ReactNode;
+}): React.JSX.Element;
+/**
+ * Access the gate. Without a provider the gate fails CLOSED for inline requests
+ * (resolves null) — never silently authorizes — but honours the capability
+ * bypass, and `canSelfApprove` follows `useCan()` (always-true with no
+ * <PermissionsProvider>, i.e. legacy hosts keep today's behaviour).
+ */
+export declare function useApprovalGate(): ApprovalGateValue;
+//# sourceMappingURL=approval-gate.d.ts.map

package/dist/approval-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-gate.d.ts","sourceRoot":"","sources":["../src/approval-gate.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAuF,MAAM,OAAO,CAAA;AAa3G,OAAO,EACH,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,oBAAoB,GAC5B,MAAM,mBAAmB,CAAA;AAE1B,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,MAAM,WAAW,aAAa;IAC1B,8EAA8E;IAC9E,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,sBAAsB;IACnC,sHAAsH;IACtH,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC7B,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAC9B,+DAA+D;IAC/D,eAAe,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IAChF,wEAAwE;IACxE,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAA;CAC9C;AAQD,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,qBAuF/E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAYnD"}

package/dist/approval-gate.js

@@ -0,0 +1,110 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// ApprovalGate — one place for "this needs a supervisor" in hosts that mount an
+// ApiProvider. It answers two situations with the same PIN dialog:
+//
+//   1. INLINE policy (POS oversell, discount over the cap, refund…): the client
+//      calls `requestApproval({policy, …})`. A user who already holds the policy's
+//      `general.approve_<policy>` capability passes straight through (`bypassed`);
+//      everyone else gets the dialog, which posts `/approvals/pin-grant`.
+//   2. PARKED request: a write answered 422 `approval_required`. toastServerError
+//      shows "Enviado a aprobación" with an "Aprobar con PIN" action that opens the
+//      dialog against `/approvals/:id/approve-pin` (kernel approvals_pin.go).
+//
+// Federated addons with their own HTTP client use <ApprovalPinDialog> directly
+// (approval-pin-dialog.tsx) and post to the same endpoints.
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { toast } from 'sonner';
+import { useApi } from './api-context';
+import { useCan } from './permissions-context';
+import { ApprovalPinDialog } from './approval-pin-dialog';
+import { APPROVAL_DECIDED_EVENT, APPROVAL_PARKED_EVENT, gateMountedDelta, } from './approval-events';
+export { APPROVAL_DECIDED_EVENT, APPROVAL_PARKED_EVENT, approvalGateAvailable, approvalRequiredInfo, } from './approval-events';
+/** Capability that authorizes `policy` (and lets its holder skip the prompt). */
+export function approvalCapability(policy) {
+    return `general.approve_${policy}`;
+}
+const ApprovalGateContext = createContext(null);
+export function ApprovalGateProvider({ children }) {
+    const { t } = useTranslation();
+    const api = useApi();
+    const can = useCan();
+    const [pending, setPending] = useState(null);
+    const pendingRef = useRef(null);
+    pendingRef.current = pending;
+    useEffect(() => {
+        gateMountedDelta(1);
+        const onParked = (e) => {
+            const info = e.detail;
+            if (info?.requestId)
+                setPending({ kind: 'parked', info });
+        };
+        window.addEventListener(APPROVAL_PARKED_EVENT, onParked);
+        return () => {
+            gateMountedDelta(-1);
+            window.removeEventListener(APPROVAL_PARKED_EVENT, onParked);
+        };
+    }, []);
+    const canSelfApprove = useCallback((policy) => can(approvalCapability(policy)), [can]);
+    const requestApproval = useCallback((opts) => {
+        if (can(approvalCapability(opts.policy))) {
+            return Promise.resolve({ id: null, policy: opts.policy, bypassed: true });
+        }
+        return new Promise((resolve) => {
+            pendingRef.current?.kind === 'inline' && pendingRef.current.resolve(null);
+            setPending({ kind: 'inline', opts, resolve });
+        });
+    }, [can]);
+    const close = () => {
+        const p = pendingRef.current;
+        if (p?.kind === 'inline')
+            p.resolve(null);
+        setPending(null);
+    };
+    const submit = async ({ pin, reason }) => {
+        const p = pendingRef.current;
+        if (!p)
+            return;
+        if (p.kind === 'inline') {
+            const res = await api.post('/approvals/pin-grant', {
+                policy: p.opts.policy,
+                label: p.opts.label,
+                pin,
+                reason,
+                context: p.opts.context,
+                model: p.opts.model,
+                record_id: p.opts.recordId,
+                addon_key: p.opts.addonKey,
+            });
+            const row = res.data?.data;
+            p.resolve({ id: row?.id ?? null, policy: p.opts.policy, bypassed: false, reason });
+        }
+        else {
+            await api.post(`/approvals/${p.info.requestId}/approve-pin`, { pin, reason });
+            toast.success(t('approvals.approved_applied', { defaultValue: 'Aprobado y aplicado' }));
+            window.dispatchEvent(new CustomEvent(APPROVAL_DECIDED_EVENT, { detail: p.info }));
+        }
+        setPending(null);
+    };
+    const value = useMemo(() => ({ requestApproval, canSelfApprove }), [requestApproval, canSelfApprove]);
+    const title = pending?.kind === 'inline'
+        ? pending.opts.label
+        : pending?.kind === 'parked'
+            ? pending.info.label || t('approvals.parked_title', { defaultValue: 'Requiere aprobación' })
+            : '';
+    return (_jsxs(ApprovalGateContext.Provider, { value: value, children: [children, _jsx(ApprovalPinDialog, { open: pending !== null, title: title, description: pending?.kind === 'inline' ? pending.opts.description : undefined, onSubmit: submit, onCancel: close })] }));
+}
+/**
+ * Access the gate. Without a provider the gate fails CLOSED for inline requests
+ * (resolves null) — never silently authorizes — but honours the capability
+ * bypass, and `canSelfApprove` follows `useCan()` (always-true with no
+ * <PermissionsProvider>, i.e. legacy hosts keep today's behaviour).
+ */
+export function useApprovalGate() {
+    const ctx = useContext(ApprovalGateContext);
+    const can = useCan();
+    return useMemo(() => ctx ?? {
+        canSelfApprove: (policy) => can(approvalCapability(policy)),
+        requestApproval: async (opts) => can(approvalCapability(opts.policy)) ? { id: null, policy: opts.policy, bypassed: true } : null,
+    }, [ctx, can]);
+}

package/dist/approval-pin-dialog.d.ts

@@ -0,0 +1,25 @@
+export interface ApprovalPinSubmit {
+    pin: string;
+    reason: string;
+}
+export interface ApprovalPinDialogProps {
+    open: boolean;
+    /** Headline, e.g. "Venta sin existencias". */
+    title: string;
+    /** What is being authorized, in the operator's words. */
+    description?: React.ReactNode;
+    /** Called with the typed PIN + reason. Throw (or reject) to keep the dialog open. */
+    onSubmit: (v: ApprovalPinSubmit) => Promise<void>;
+    onCancel: () => void;
+    /** Optional secondary action, e.g. "Enviar a la bandeja" (async request). */
+    secondaryAction?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+/** Best human message out of an axios-style error carrying the kernel envelope. */
+export declare function approvalErrorMessage(err: unknown, t: (k: string, o?: {
+    defaultValue?: string;
+}) => string): string;
+export declare function ApprovalPinDialog({ open, title, description, onSubmit, onCancel, secondaryAction }: ApprovalPinDialogProps): import("react").JSX.Element;
+//# sourceMappingURL=approval-pin-dialog.d.ts.map

package/dist/approval-pin-dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-pin-dialog.d.ts","sourceRoot":"","sources":["../src/approval-pin-dialog.tsx"],"names":[],"mappings":"AAwBA,MAAM,WAAW,iBAAiB;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,OAAO,CAAA;IACb,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC7B,qFAAqF;IACrF,QAAQ,EAAE,CAAC,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,6EAA6E;IAC7E,eAAe,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAA;CAC3D;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,MAAM,GAAG,MAAM,CAalH;AAED,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE,sBAAsB,+BAuG1H"}

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,EAyCtD,CAAA"}

package/dist/business/catalog.js

@@ -0,0 +1,42 @@
+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'],
+    },
+];

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 })))] }));
+}