@asteby/metacore-runtime-react 46.3.0 → 47.0.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @asteby/metacore-runtime-react
 
+## 47.0.0
+
+### Minor Changes
+
+- 4371f2c: Diálogos de acción: resultado de timbrado y errores del servidor.
+
+  - #1024 (FAC-3 / PIT-051): nuevo `CfdiStampPanel` / `CfdiStampResultDialog` / `extractStampResult`. Cuando la acción responde con `fiscal_uuid`, `pdf_url` y/o `xml_url`, el diálogo muestra el UUID como texto y enlaces «Descargar PDF» / «Descargar XML» en lugar del JSON. Sin esas claves no se inventa un resultado fiscal.
+  - #1023 (PIT-046): los diálogos de acción (genérico, wizard y confirmación) pintan un `FormErrorBanner` dentro del diálogo con el 422 (`errors` por campo) o el mensaje y causa de un 500, y permanecen abiertos.
+
+- 4371f2c: FAC-12 (#1022): alta guiada por tipo de documento. Nuevo `DocumentFormDialog` y `resolveDocumentForms`: cuando el metadata de la tabla (o la prop `documentForms` de `DynamicCRUDPage`) trae `document_forms`, «Crear» muestra tarjetas de tipo (Factura / Nota de crédito / REP / Global / Traslado…) y, al elegir, los campos de ese tipo y un paso de renglones con `DocumentLinesGrid`; un solo tipo se salta el selector. Escribe el valor del tipo en `type_field`, serializa los renglones con `serializeLineItems`, muestra los 422 (banner + campos) dentro del diálogo y emite el evento de mutación para refrescar la lista. Sin manifest, el alta genérica no cambia. El SDK no embebe catálogos SAT: campos y valores los sirve el kernel o el addon. Nuevos tipos: `DocumentFormsManifest`, `DocumentFormType`, `DocumentFormLines`, `TableMetadata.document_forms`.
+- 4371f2c: PIT-044: el menú lateral se filtra por los permisos efectivos del rol. `@asteby/metacore-ui` agrega `filterNavGroups`, `NavLinkItem.requires` y la prop `isItemVisible` de `AppSidebar`; `@asteby/metacore-runtime-react` agrega `useNavItemVisible`, `isNavItemAllowed`, `capabilityForNavItem` (una entrada `/m/<modelo>` exige `<modelo>.index`; las demás rutas no se bloquean) y `useNavigation` respeta `NavItem.requires`; el `AppSidebar` de starter-core lo aplica. Sin `PermissionsProvider` (o con `isAdmin`) no se oculta nada.
+- 4371f2c: Las listas se refrescan tras crear, editar o borrar (#1020). `DynamicRecordDialog` y `ActionModalDispatcher` (componente federado, wizard, formulario genérico y confirmación) emiten el evento `metacore:record-mutated` con el modelo; `DynamicTable` y `DynamicKanban` vuelven a pedir los datos cuando el modelo coincide (sin distinguir mayúsculas). Nuevos exports: `emitRecordMutation`, `subscribeRecordMutations`, `useRecordMutationTick`.
+- 4371f2c: Tres componentes de negocio compartidos:
+
+  - `VehiclePicker` (#1025): selector controlado de vehículo con búsqueda por placa o VIN y alta rápida (`CreateRecordDialog`), mismo estilo que `CustomerPicker`; sin `PermissionsProvider` no bloquea la UI.
+  - `RelateDocuments` (#1026): relaciona uno o más documentos origen con un tipo de relación (`related_document_id`, `relation_type`), muestra UUID/folio; los tipos llegan por prop (sin catálogos fiscales embebidos).
+  - `PrintSendDialog` (#1027): imprimir (URL de PDF del host) o enviar por `onSend(canal, destino, documento)`; sin integración de mensajería.
+
+### Patch Changes
+
+- 4371f2c: Roles y permisos (#1021): «Permisos generales» deja de ser una columna de tarjetas junto al rol y pasa a ser un grupo sintético del combobox de módulos; al elegirlo se editan en la misma grilla de dos columnas que las acciones de un módulo, y el conteo de concedidos los incluye. Nuevo `generalPermissionsModule`.
+- 4371f2c: Auditoría Ronda D: «Descargar Factura CFDI» no daba ninguna señal. `usePrintDocument` ahora muestra un toast de progreso, uno de éxito y, si falla, el motivo que responde el servidor (también cuando el cuerpo llega como Blob); la promesa sigue rechazando. `feedback: false` lo silencia y `PrintDocumentButton` deja el toast de error al llamador cuando pasa `onError`.
+- Updated dependencies [4371f2c]
+  - @asteby/metacore-ui@2.24.0
+
+## 46.4.0
+
+### Minor Changes
+
+- e47bca8: Una sola acción primaria de alta por pantalla. `resolveListPrimaryAction` oculta el Crear genérico cuando hay `placement: create`, `replaces_create`, `create_mode: hidden|action`, `canCreate: false` o `ModelExtension.primaryActionKey`. Si dos acciones reclaman el alta, solo una lleva `data-primary`.
+
 ## 46.3.0
 
 ### Minor Changes

package/dist/action-modal-dispatcher.d.ts

@@ -1,3 +1,4 @@
+import type { Translate } from './server-error';
 import type { ActionFieldDef } from './types';
 import { type ActionMetadata, type ActionModalProps } from '@asteby/metacore-sdk';
 export type { ActionMetadata, ActionModalProps };
@@ -66,7 +67,15 @@ export declare function unwrapRecordScalar(value: unknown): unknown;
 export declare function readRecordPath(record: any, path: string): unknown;
 /** Scalar seed for one action field from the row being acted on. */
 export declare function scalarDefaultFromRecord(field: ActionFieldDef, record: any): unknown;
-export declare function ActionModalDispatcher({ open, onOpenChange, action, model, record, endpoint, onSuccess, }: ActionModalProps): import("react").JSX.Element | null;
+export declare function ActionModalDispatcher({ open, onOpenChange, action, model, record, endpoint, onSuccess: onSuccessProp, }: ActionModalProps): import("react").JSX.Element | null;
 /** How long an action with `modal` waits for its federated component. */
 export declare const FEDERATED_ACTION_MODAL_TIMEOUT_MS = 20000;
+/** Text for the in-dialog error banner of a failed action (PIT-046, #1023): a
+ *  422 with per-field `errors` -> "Revisa los campos" + each localized line; any
+ *  other failure (500, network) -> the server's own message and cause. Unlike
+ *  the toast it stays on screen until the next attempt. */
+export declare function actionErrorBannerMessage(err: unknown, fields: readonly ActionFieldDef[] | undefined, t: Translate, language?: string): string;
+export declare function buildFieldDefaults(fields: ActionFieldDef[], record: any): Record<string, any>;
+/** Renders one action field (same widgets as the action modals). Shared with DocumentFormDialog. */
+export declare function renderField(field: ActionFieldDef, value: any, onChange: (value: any) => void, formValues?: Record<string, any>, record?: Record<string, any>, fieldErrors?: Record<string, string>): import("react").JSX.Element;
 //# sourceMappingURL=action-modal-dispatcher.d.ts.map

package/dist/action-modal-dispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-modal-dispatcher.d.ts","sourceRoot":"","sources":["../src/action-modal-dispatcher.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"action-modal-dispatcher.d.ts","sourceRoot":"","sources":["../src/action-modal-dispatcher.tsx"],"names":[],"mappings":"AAmDA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AA8B/C,OAAO,KAAK,EAAE,cAAc,EAAmC,MAAM,SAAS,CAAA;AAE9E,OAAO,EACH,KAAK,cAAc,EACnB,KAAK,gBAAgB,EAGxB,MAAM,sBAAsB,CAAA;AAG7B,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAA;AAiBhD,MAAM,WAAW,WAAW;IACxB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,SAAS,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1D;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,WAAW,CAM1D;AAsBD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAStE;AAGD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAkB3F;AAYD,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,WAAW,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;CAC1C;AAED,wBAAgB,uBAAuB,CACnC,MAAM,EAAE,cAAc,EAAE,GAAG,SAAS,EACpC,MAAM,EAAE,GAAG,EACX,SAAS,EAAE,KAAK,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,GAC5H,sBAAsB,EAAE,CAyB1B;AASD,MAAM,WAAW,uBAAuB;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,WAAW,CAAA;IACjB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAA;IAChB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,wBAAwB,CACpC,MAAM,EAAE,cAAc,EAAE,GAAG,SAAS,EACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,uBAAuB,EAAE,CAe3B;AAKD,wBAAgB,+BAA+B,CAC3C,GAAG,EAAE,uBAAuB,EAC5B,SAAS,EAAE,KAAK,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,GAC5H;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CActE;AASD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAY1D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CASjE;AAUD,oEAAoE;AACpE,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAgBnF;AAED,wBAAgB,qBAAqB,CAAC,EAClC,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,KAAK,EACL,MAAM,EACN,QAAQ,EACR,SAAS,EAAE,aAAa,GAC3B,EAAE,gBAAgB,sCA0FlB;AAED,yEAAyE;AACzE,eAAO,MAAM,iCAAiC,QAAS,CAAA;AA6VvD;;;2DAG2D;AAC3D,wBAAgB,wBAAwB,CACpC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,EAC7C,CAAC,EAAE,SAAS,EACZ,QAAQ,CAAC,EAAE,MAAM,GAClB,MAAM,CAWR;AA+bD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAoB7F;AAyPD,oGAAoG;AACpG,wBAAgB,WAAW,CACvB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,GAAG,EACV,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,EAK9B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,+BAwEvC"}

package/dist/action-modal-dispatcher.js

@@ -15,13 +15,16 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 //
 // The host injects its axios-like client via <ApiProvider>; we no longer
 // depend on a bundler alias to `@/lib/api`.
-import { useState, useEffect, useMemo, useRef, useSyncExternalStore } from 'react';
+import { emitRecordMutation } from './record-mutation-events';
+import { useState, useCallback, useEffect, useMemo, useRef, useSyncExternalStore } from 'react';
 import { useTranslation } from 'react-i18next';
 import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, DialogFooter, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, Button, Input, Textarea, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Switch, } from '@asteby/metacore-ui/primitives';
 import { Loader2 } from 'lucide-react';
 import { ProcessStepper } from '@asteby/metacore-ui/wizard';
 import { toast } from 'sonner';
-import { toastServerError, toastServerSuccess, extractFieldErrors, localizeFieldErrorMap } from './server-error';
+import { toastServerError, toastServerSuccess, extractFieldErrors, extractServerError, localizeFieldErrorMap } from './server-error';
+import { FormErrorBanner } from './business/feedback';
+import { CfdiStampResultDialog, extractStampResult } from './cfdi-stamp-panel';
 import { useBranchCreateGate } from './branch-create-gate';
 import { validateValues, bagHasErrors } from './validator';
 import { clearFieldErrorTree, formatFieldErrorsDescription, labelsForValidationFields, labelForValidationPath, lineItemErrorsFor, } from './field-validation-ui';
@@ -233,7 +236,14 @@ export function scalarDefaultFromRecord(field, record) {
     }
     return undefined;
 }
-export function ActionModalDispatcher({ open, onOpenChange, action, model, record, endpoint, onSuccess, }) {
+export function ActionModalDispatcher({ open, onOpenChange, action, model, record, endpoint, onSuccess: onSuccessProp, }) {
+    // Every successful action may have created/updated/deleted a record of
+    // `model` (federated component, wizard, generic form or confirmation), so
+    // announce it: mounted lists of the model reload on their own (#1020).
+    const onSuccess = useCallback(() => {
+        emitRecordMutation(model, 'update');
+        onSuccessProp?.();
+    }, [model, onSuccessProp]);
     // Reactive read: a federated remote usually registers AFTER the first
     // render, and a memoized lookup would pin the fallback forever.
     const readComponent = () => getActionComponent(model, action.key);
@@ -518,10 +528,28 @@ function toastActionError(err, fields, t, language) {
     }
     toastServerError(err, { t, language });
 }
+/** Text for the in-dialog error banner of a failed action (PIT-046, #1023): a
+ *  422 with per-field `errors` -> "Revisa los campos" + each localized line; any
+ *  other failure (500, network) -> the server's own message and cause. Unlike
+ *  the toast it stays on screen until the next attempt. */
+export function actionErrorBannerMessage(err, fields, t, language) {
+    const localized = localizeActionFieldErrors(err, fields, t, language);
+    if (localized) {
+        const head = t('validation.failed', { defaultValue: validationCatalog(language).failed });
+        const lines = Object.values(localized).filter(Boolean);
+        return lines.length ? `${head}: ${lines.join(' · ')}` : head;
+    }
+    const fallback = t('common.error', { defaultValue: 'Algo salió mal. Intenta de nuevo.' });
+    const ex = extractServerError(err, fallback);
+    const title = t(ex.title, { defaultValue: ex.title });
+    return ex.description && ex.description !== title ? `${title} — ${ex.description}` : title;
+}
 function ConfirmActionDialog({ open, onOpenChange, action, model, record, endpoint, onSuccess }) {
     const { t, i18n } = useTranslation();
     const api = useApi();
     const [executing, setExecuting] = useState(false);
+    const [formError, setFormError] = useState();
+    const [stamp, setStamp] = useState();
     // Actions listed in the model's `reason_required.actions` (cancel, void…)
     // answer 422 errors.reason without a motive; the prompt asks and retries.
     const reasonPrompt = useReasonPrompt();
@@ -532,6 +560,7 @@ function ConfirmActionDialog({ open, onOpenChange, action, model, record, endpoi
     const label = t(action.label, { defaultValue: action.label });
     const execute = async () => {
         setExecuting(true);
+        setFormError(undefined);
         try {
             const url = buildActionUrl(endpoint, model, record.id, action.key);
             // Supervisor PIN first (action.supervisorPolicy); null = cancelled.
@@ -548,21 +577,37 @@ function ConfirmActionDialog({ open, onOpenChange, action, model, record, endpoi
                 return;
             if (res.data.success) {
                 toastServerSuccess(res.data, { t });
+                const result = extractStampResult(res.data);
+                if (result) {
+                    setStamp(result);
+                    return;
+                }
                 onOpenChange(false);
                 onSuccess();
             }
             else {
+                setFormError(actionErrorBannerMessage({ response: { data: res.data } }, action.fields, t, i18n.language));
                 toastActionError({ response: { data: res.data } }, action.fields, t, i18n.language);
             }
         }
         catch (err) {
+            setFormError(actionErrorBannerMessage(err, action.fields, t, i18n.language));
             toastActionError(err, action.fields, t, i18n.language);
         }
         finally {
             setExecuting(false);
         }
     };
-    return (_jsxs(_Fragment, { children: [reasonPrompt.dialog, _jsx(AlertDialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(AlertDialogContent, { children: [_jsxs(AlertDialogHeader, { children: [_jsxs(AlertDialogTitle, { className: "flex items-center gap-2", children: [_jsx(DynamicIcon, { name: action.icon, className: "h-5 w-5" }), label] }), _jsx(AlertDialogDescription, { children: action.confirmMessage || `${label}?` })] }), record ? _jsx(RecordPreview, { model: model, record: record }) : null, _jsxs(AlertDialogFooter, { children: [_jsx(AlertDialogCancel, { disabled: executing, children: t('common.cancel') }), _jsxs(AlertDialogAction, { onClick: (e) => { e.preventDefault(); execute(); }, disabled: executing, style: action.color ? { backgroundColor: action.color } : undefined, children: [executing ? _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }) : _jsx(DynamicIcon, { name: action.icon, className: "mr-2 h-4 w-4" }), label] })] })] }) })] }));
+    if (stamp) {
+        return (_jsx(CfdiStampResultDialog, { open: open, result: stamp, title: label, onOpenChange: (o) => {
+                if (o)
+                    return;
+                setStamp(undefined);
+                onOpenChange(false);
+                onSuccess();
+            } }));
+    }
+    return (_jsxs(_Fragment, { children: [reasonPrompt.dialog, _jsx(AlertDialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(AlertDialogContent, { children: [_jsxs(AlertDialogHeader, { children: [_jsxs(AlertDialogTitle, { className: "flex items-center gap-2", children: [_jsx(DynamicIcon, { name: action.icon, className: "h-5 w-5" }), label] }), _jsx(AlertDialogDescription, { children: action.confirmMessage || `${label}?` })] }), record ? _jsx(RecordPreview, { model: model, record: record }) : null, _jsx(FormErrorBanner, { message: formError }), _jsxs(AlertDialogFooter, { children: [_jsx(AlertDialogCancel, { disabled: executing, children: t('common.cancel') }), _jsxs(AlertDialogAction, { onClick: (e) => { e.preventDefault(); execute(); }, disabled: executing, style: action.color ? { backgroundColor: action.color } : undefined, children: [executing ? _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }) : _jsx(DynamicIcon, { name: action.icon, className: "mr-2 h-4 w-4" }), label] })] })] }) })] }));
 }
 function GenericActionModal({ open, onOpenChange, action, model, record, endpoint, onSuccess }) {
     const { t, i18n } = useTranslation();
@@ -578,6 +623,10 @@ function GenericActionModal({ open, onOpenChange, action, model, record, endpoin
     const [executing, setExecuting] = useState(false);
     // Per-field validation errors (localized), shown inline under each input.
     const [fieldErrors, setFieldErrors] = useState({});
+    // Persistent in-dialog banner for a failed submit (422 / 500) — the toast
+    // alone vanished and, for some failures, only the console had the cause.
+    const [formError, setFormError] = useState();
+    const [stamp, setStamp] = useState();
     // Related records to surface BELOW the form, as read-only context for the
     // record being acted on — e.g. the reception history of a transfer while
     // receiving against it. Sourced from the model's metadata.relations (the
@@ -610,6 +659,7 @@ function GenericActionModal({ open, onOpenChange, action, model, record, endpoin
         if (open && action.fields) {
             setFormData(buildFieldDefaults(action.fields, record));
             setFieldErrors({});
+            setFormError(undefined);
         }
     }, [open, action.fields, record]);
     // Lines the list row does not carry: load them from the declared relation
@@ -696,6 +746,7 @@ function GenericActionModal({ open, onOpenChange, action, model, record, endpoin
     };
     const lang = i18n.language;
     const handleActionError = (err) => {
+        setFormError(actionErrorBannerMessage(err, action.fields, t, lang));
         const labels = labelsForValidationFields(action.fields, t);
         const localized = localizeActionFieldErrors(err, action.fields, t, lang);
         if (localized) {
@@ -733,6 +784,7 @@ function GenericActionModal({ open, onOpenChange, action, model, record, endpoin
             }
         }
         setFieldErrors({});
+        setFormError(undefined);
         setExecuting(true);
         try {
             let payload = { ...formData };
@@ -765,6 +817,11 @@ function GenericActionModal({ open, onOpenChange, action, model, record, endpoin
                 return;
             if (res.data.success) {
                 toastServerSuccess(res.data, { t });
+                const result = extractStampResult(res.data);
+                if (result) {
+                    setStamp(result);
+                    return;
+                }
                 onOpenChange(false);
                 onSuccess();
             }
@@ -794,17 +851,26 @@ function GenericActionModal({ open, onOpenChange, action, model, record, endpoin
         : hasLineItems
             ? '820px'
             : undefined;
-    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { className: 'flex max-h-[90dvh] flex-col overflow-hidden ' + (widthPx ? '' : 'sm:max-w-xl'), style: { maxHeight: '90dvh', ...(widthPx ? { maxWidth: widthPx, width: '95vw' } : {}) }, children: [_jsxs(DialogHeader, { className: "shrink-0", children: [_jsxs(DialogTitle, { className: "flex items-center gap-2", children: [_jsx(DynamicIcon, { name: action.icon, className: "h-5 w-5" }), tl(action.label)] }), action.confirmMessage && _jsx(DialogDescription, { children: tl(action.confirmMessage) })] }), _jsx("div", { className: "-mx-1 min-h-0 flex-1 overflow-y-auto px-1 py-4", children: _jsxs(FieldGrid, { children: [action.fields?.map((field) => {
-                                const fullWidth = isLineItemsField(field) ||
-                                    resolveWidget(field) === 'textarea' ||
-                                    resolveWidget(field) === 'richtext';
-                                return (_jsxs(FieldCell, { fullWidth: fullWidth, children: [_jsx(FieldLabel, { htmlFor: field.key, required: field.required, children: tl(field.label) }), renderField(field, formData[field.key], (v) => updateField(field.key, v), formData, record, fieldErrors), fieldErrors[field.key] && (_jsx("p", { className: "text-destructive text-xs mt-1", children: fieldErrors[field.key] }))] }, field.key));
-                            }), embedRelations && relations.length > 0 && (_jsx(FieldCell, { fullWidth: true, children: _jsx(DynamicRelations, { record: record, relations: relations, lineSubtable: true, embedOnly: true }) }))] }) }), _jsxs(DialogFooter, { className: "shrink-0", children: [_jsx(Button, { variant: "outline", onClick: () => onOpenChange(false), disabled: executing, children: t('common.cancel') }), _jsxs(Button, { onClick: execute, disabled: executing, style: action.color ? { backgroundColor: action.color, color: 'white' } : undefined, children: [executing ? _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }) : _jsx(DynamicIcon, { name: action.icon, className: "mr-2 h-4 w-4" }), tl(action.label)] })] }), reasonPrompt.dialog] }) }));
+    if (stamp) {
+        return (_jsx(CfdiStampResultDialog, { open: open, result: stamp, title: tl(action.label), onOpenChange: (o) => {
+                if (o)
+                    return;
+                setStamp(undefined);
+                onOpenChange(false);
+                onSuccess();
+            } }));
+    }
+    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { className: 'flex max-h-[90dvh] flex-col overflow-hidden ' + (widthPx ? '' : 'sm:max-w-xl'), style: { maxHeight: '90dvh', ...(widthPx ? { maxWidth: widthPx, width: '95vw' } : {}) }, children: [_jsxs(DialogHeader, { className: "shrink-0", children: [_jsxs(DialogTitle, { className: "flex items-center gap-2", children: [_jsx(DynamicIcon, { name: action.icon, className: "h-5 w-5" }), tl(action.label)] }), action.confirmMessage && _jsx(DialogDescription, { children: tl(action.confirmMessage) })] }), _jsxs("div", { className: "-mx-1 min-h-0 flex-1 overflow-y-auto px-1 py-4", children: [_jsx(FormErrorBanner, { message: formError, className: "mb-3" }), _jsxs(FieldGrid, { children: [action.fields?.map((field) => {
+                                    const fullWidth = isLineItemsField(field) ||
+                                        resolveWidget(field) === 'textarea' ||
+                                        resolveWidget(field) === 'richtext';
+                                    return (_jsxs(FieldCell, { fullWidth: fullWidth, children: [_jsx(FieldLabel, { htmlFor: field.key, required: field.required, children: tl(field.label) }), renderField(field, formData[field.key], (v) => updateField(field.key, v), formData, record, fieldErrors), fieldErrors[field.key] && (_jsx("p", { className: "text-destructive text-xs mt-1", children: fieldErrors[field.key] }))] }, field.key));
+                                }), embedRelations && relations.length > 0 && (_jsx(FieldCell, { fullWidth: true, children: _jsx(DynamicRelations, { record: record, relations: relations, lineSubtable: true, embedOnly: true }) }))] })] }), _jsxs(DialogFooter, { className: "shrink-0", children: [_jsx(Button, { variant: "outline", onClick: () => onOpenChange(false), disabled: executing, children: t('common.cancel') }), _jsxs(Button, { onClick: execute, disabled: executing, style: action.color ? { backgroundColor: action.color, color: 'white' } : undefined, children: [executing ? _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }) : _jsx(DynamicIcon, { name: action.icon, className: "mr-2 h-4 w-4" }), tl(action.label)] })] }), reasonPrompt.dialog] }) }));
 }
 // buildFieldDefaults seeds formData for a set of action fields, honoring the
 // same line-items prefill spec + boolean/empty rules GenericActionModal uses, so
 // wizard steps and single-page forms initialize identically.
-function buildFieldDefaults(fields, record) {
+export function buildFieldDefaults(fields, record) {
     const defaults = {};
     for (const field of fields) {
         if (isLineItemsField(field)) {
@@ -851,6 +917,8 @@ function WizardActionModal({ open, onOpenChange, action, model, record, endpoint
     const [stepIndex, setStepIndex] = useState(0);
     const [formData, setFormData] = useState({});
     const [executing, setExecuting] = useState(false);
+    const [formError, setFormError] = useState();
+    const [stamp, setStamp] = useState();
     // Reset to the first step and seed defaults for EVERY step's fields whenever
     // the modal (re)opens, so accumulated values from a prior run don't leak.
     useEffect(() => {
@@ -859,6 +927,7 @@ function WizardActionModal({ open, onOpenChange, action, model, record, endpoint
         const allFields = steps.flatMap((s) => s.fields ?? []);
         setFormData(buildFieldDefaults(allFields, record));
         setStepIndex(0);
+        setFormError(undefined);
     }, [open, action.steps, record]);
     const updateField = (key, value) => setFormData((prev) => ({ ...prev, [key]: value }));
     const step = steps[stepIndex];
@@ -890,6 +959,7 @@ function WizardActionModal({ open, onOpenChange, action, model, record, endpoint
             }
         }
         setExecuting(true);
+        setFormError(undefined);
         try {
             const url = buildActionUrl(endpoint, model, record?.id, action.key);
             const auth = await supervisor.authorize({ label: tl(action.label), supervisorPolicy: action.supervisorPolicy }, { model, recordId: record?.id != null ? String(record.id) : undefined });
@@ -902,16 +972,24 @@ function WizardActionModal({ open, onOpenChange, action, model, record, endpoint
             });
             if (!res)
                 return;
+            const allFields = steps.flatMap(s => s.fields ?? []);
             if (res.data.success) {
                 toastServerSuccess(res.data, { t });
+                const result = extractStampResult(res.data);
+                if (result) {
+                    setStamp(result);
+                    return;
+                }
                 onOpenChange(false);
                 onSuccess();
             }
             else {
-                toastActionError({ response: { data: res.data } }, steps.flatMap(s => s.fields ?? []), t, i18n.language);
+                setFormError(actionErrorBannerMessage({ response: { data: res.data } }, allFields, t, i18n.language));
+                toastActionError({ response: { data: res.data } }, allFields, t, i18n.language);
             }
         }
         catch (err) {
+            setFormError(actionErrorBannerMessage(err, steps.flatMap(s => s.fields ?? []), t, i18n.language));
             toastActionError(err, steps.flatMap(s => s.fields ?? []), t, i18n.language);
         }
         finally {
@@ -920,12 +998,21 @@ function WizardActionModal({ open, onOpenChange, action, model, record, endpoint
     };
     if (steps.length === 0)
         return null;
-    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { className: 'flex max-h-[90dvh] flex-col overflow-hidden ' + (widthPx ? '' : 'sm:max-w-xl'), style: { maxHeight: '90dvh', ...(widthPx ? { maxWidth: widthPx, width: '95vw' } : {}) }, children: [_jsxs(DialogHeader, { className: "shrink-0", children: [_jsxs(DialogTitle, { className: "flex items-center gap-2", children: [_jsx(DynamicIcon, { name: action.icon, className: "h-5 w-5" }), tl(action.label)] }), _jsxs("div", { className: "pt-1", children: [_jsx(ProcessStepper, { steps: steps.map((s, i) => ({ key: String(i), label: s.title ? tl(s.title) : `${t('common.step', { defaultValue: 'Paso' })} ${i + 1}` })), activeIndex: stepIndex, onStepClick: i => setStepIndex(i) }), _jsxs(DialogDescription, { className: "pt-3", children: [t('common.step', { defaultValue: 'Paso' }), " ", stepIndex + 1, "/", steps.length, step?.title ? ` · ${tl(step.title)}` : ''] }), step?.description && (_jsx("p", { className: "pt-1 text-sm text-muted-foreground", children: tl(step.description) }))] })] }), _jsx("div", { className: "-mx-1 min-h-0 flex-1 overflow-y-auto px-1 py-4", children: _jsx(FieldGrid, { children: stepFields.map((field) => {
-                            const fullWidth = isLineItemsField(field) ||
-                                resolveWidget(field) === 'textarea' ||
-                                resolveWidget(field) === 'richtext';
-                            return (_jsxs(FieldCell, { fullWidth: fullWidth, children: [_jsx(FieldLabel, { htmlFor: field.key, required: field.required, children: tl(field.label) }), renderField(field, formData[field.key], (v) => updateField(field.key, v), formData, record)] }, field.key));
-                        }) }) }), _jsxs(DialogFooter, { className: "shrink-0", children: [stepIndex > 0 ? (_jsx(Button, { variant: "outline", onClick: goBack, disabled: executing, children: t('common.back', { defaultValue: 'Atrás' }) })) : (_jsx(Button, { variant: "outline", onClick: () => onOpenChange(false), disabled: executing, children: t('common.cancel') })), isLast ? (_jsxs(Button, { onClick: submit, disabled: executing, style: action.color ? { backgroundColor: action.color, color: 'white' } : undefined, children: [executing ? _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }) : _jsx(DynamicIcon, { name: action.icon, className: "mr-2 h-4 w-4" }), tl(action.label)] })) : (_jsx(Button, { onClick: goNext, disabled: executing, style: action.color ? { backgroundColor: action.color, color: 'white' } : undefined, children: t('common.next', { defaultValue: 'Siguiente' }) }))] }), reasonPrompt.dialog] }) }));
+    if (stamp) {
+        return (_jsx(CfdiStampResultDialog, { open: open, result: stamp, title: tl(action.label), onOpenChange: (o) => {
+                if (o)
+                    return;
+                setStamp(undefined);
+                onOpenChange(false);
+                onSuccess();
+            } }));
+    }
+    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { className: 'flex max-h-[90dvh] flex-col overflow-hidden ' + (widthPx ? '' : 'sm:max-w-xl'), style: { maxHeight: '90dvh', ...(widthPx ? { maxWidth: widthPx, width: '95vw' } : {}) }, children: [_jsxs(DialogHeader, { className: "shrink-0", children: [_jsxs(DialogTitle, { className: "flex items-center gap-2", children: [_jsx(DynamicIcon, { name: action.icon, className: "h-5 w-5" }), tl(action.label)] }), _jsxs("div", { className: "pt-1", children: [_jsx(ProcessStepper, { steps: steps.map((s, i) => ({ key: String(i), label: s.title ? tl(s.title) : `${t('common.step', { defaultValue: 'Paso' })} ${i + 1}` })), activeIndex: stepIndex, onStepClick: i => setStepIndex(i) }), _jsxs(DialogDescription, { className: "pt-3", children: [t('common.step', { defaultValue: 'Paso' }), " ", stepIndex + 1, "/", steps.length, step?.title ? ` · ${tl(step.title)}` : ''] }), step?.description && (_jsx("p", { className: "pt-1 text-sm text-muted-foreground", children: tl(step.description) }))] })] }), _jsxs("div", { className: "-mx-1 min-h-0 flex-1 overflow-y-auto px-1 py-4", children: [_jsx(FormErrorBanner, { message: formError, className: "mb-3" }), _jsx(FieldGrid, { children: stepFields.map((field) => {
+                                const fullWidth = isLineItemsField(field) ||
+                                    resolveWidget(field) === 'textarea' ||
+                                    resolveWidget(field) === 'richtext';
+                                return (_jsxs(FieldCell, { fullWidth: fullWidth, children: [_jsx(FieldLabel, { htmlFor: field.key, required: field.required, children: tl(field.label) }), renderField(field, formData[field.key], (v) => updateField(field.key, v), formData, record)] }, field.key));
+                            }) })] }), _jsxs(DialogFooter, { className: "shrink-0", children: [stepIndex > 0 ? (_jsx(Button, { variant: "outline", onClick: goBack, disabled: executing, children: t('common.back', { defaultValue: 'Atrás' }) })) : (_jsx(Button, { variant: "outline", onClick: () => onOpenChange(false), disabled: executing, children: t('common.cancel') })), isLast ? (_jsxs(Button, { onClick: submit, disabled: executing, style: action.color ? { backgroundColor: action.color, color: 'white' } : undefined, children: [executing ? _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }) : _jsx(DynamicIcon, { name: action.icon, className: "mr-2 h-4 w-4" }), tl(action.label)] })) : (_jsx(Button, { onClick: goNext, disabled: executing, style: action.color ? { backgroundColor: action.color, color: 'white' } : undefined, children: t('common.next', { defaultValue: 'Siguiente' }) }))] }), reasonPrompt.dialog] }) }));
 }
 function seedOptionFromRecord(field, value, record) {
     if (!record || !field.key.endsWith('_id'))
@@ -948,7 +1035,8 @@ function seedOptionFromRecord(field, value, record) {
         icon: sib.icon,
     };
 }
-function renderField(field, value, onChange, 
+/** Renders one action field (same widgets as the action modals). Shared with DocumentFormDialog. */
+export function renderField(field, value, onChange, 
 // Full current form values — lets a line-items grid (and any cascading
 // header picker) resolve a `dependsOn` reference against sibling header
 // fields. Omitted by callers that have no surrounding form (the field is

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

@@ -1 +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,EA8EtD,CAAA"}
+{"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,EAsGtD,CAAA"}

package/dist/business/catalog.js

@@ -76,4 +76,28 @@ export const BUSINESS_COMPONENTS = [
             'recommendationsToLines',
         ],
     },
+    {
+        name: 'VehiclePicker',
+        value: 'value: VehicleResult | null',
+        events: ['onChange'],
+        permissions: ['<model>.create (alta rápida; default Vehicle → vehicle.create)'],
+        usedBy: ['POS', 'Recepción de vehículo', 'OT', 'Cotización', 'Pedido'],
+        helpers: ['describeVehicle'],
+    },
+    {
+        name: 'RelateDocuments',
+        value: 'value: RelatedDocument[] (related_document_id + relation_type)',
+        events: ['onChange'],
+        permissions: [],
+        usedBy: ['Nota de crédito', 'Devolución', 'Sustitución de CFDI', 'REP'],
+        helpers: ['serializeRelatedDocuments'],
+    },
+    {
+        name: 'PrintSendDialog',
+        value: 'document: PrintableDocument (+ open)',
+        events: ['onSend', 'onPrint', 'onOpenChange'],
+        permissions: [],
+        usedBy: ['Cotización', 'Factura', 'Nota de crédito', 'Pedido', 'OC'],
+        helpers: [],
+    },
 ];

package/dist/business/index.d.ts

@@ -16,4 +16,7 @@ export * from './return';
 export * from './return-wizard';
 export * from './inspection';
 export * from './inspection-checklist';
+export * from './vehicle-picker';
+export * from './relate-documents';
+export * from './print-send-dialog';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/business/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA;AACjC,cAAc,UAAU,CAAA;AACxB,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/business/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA;AACjC,cAAc,UAAU,CAAA;AACxB,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA"}

package/dist/business/index.js

@@ -16,3 +16,6 @@ export * from './return';
 export * from './return-wizard';
 export * from './inspection';
 export * from './inspection-checklist';
+export * from './vehicle-picker';
+export * from './relate-documents';
+export * from './print-send-dialog';

package/dist/business/print-send-dialog.d.ts

@@ -0,0 +1,27 @@
+export type SendChannel = 'email' | 'whatsapp';
+export interface PrintableDocument {
+    folio: string;
+    /** URL del PDF ya generado. Sin ella no hay «Imprimir». */
+    pdfUrl?: string;
+    /** Texto de cabecera («Factura», «Cotización»). */
+    title?: string;
+    /** Destinos sugeridos (datos del cliente). */
+    email?: string;
+    phone?: string;
+}
+export interface PrintSendDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    document: PrintableDocument;
+    /** Canales de envío disponibles. Default: ambos. Vacío = solo imprimir. */
+    channels?: SendChannel[];
+    /**
+     * Envío a cargo del host. Si rechaza, el mensaje se muestra en el diálogo.
+     * Sin `onSend` no se ofrece enviar.
+     */
+    onSend?: (channel: SendChannel, destination: string, document: PrintableDocument) => Promise<void> | void;
+    /** Reemplaza la impresión por defecto (abrir `pdfUrl` en otra pestaña). */
+    onPrint?: (document: PrintableDocument) => void;
+}
+export declare function PrintSendDialog({ open, onOpenChange, document: doc, channels, onSend, onPrint, }: PrintSendDialogProps): import("react").JSX.Element;
+//# sourceMappingURL=print-send-dialog.d.ts.map

package/dist/business/print-send-dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-send-dialog.d.ts","sourceRoot":"","sources":["../../src/business/print-send-dialog.tsx"],"names":[],"mappings":"AAmBA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,UAAU,CAAA;AAE9C,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,OAAO,CAAA;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACzG,2EAA2E;IAC3E,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAA;CAClD;AAOD,wBAAgB,eAAe,CAAC,EAC5B,IAAI,EACJ,YAAY,EACZ,QAAQ,EAAE,GAAG,EACb,QAAgC,EAChC,MAAM,EACN,OAAO,GACV,EAAE,oBAAoB,+BAmHtB"}

package/dist/business/print-send-dialog.js

@@ -0,0 +1,55 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+// PrintSendDialog — imprimir o enviar un documento ya emitido (cotización,
+// factura, nota de crédito…). El SDK NO llama a un proveedor de mensajería: el
+// host recibe `onSend(channel, destination, document)` y decide qué hacer.
+// Imprimir usa la URL del PDF que pasa el host (o su propio `onPrint`).
+import { useEffect, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { Mail, MessageCircle, Printer, Loader2 } from 'lucide-react';
+import { Button, Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, Input, } from '@asteby/metacore-ui/primitives';
+import { FormErrorBanner } from './feedback';
+function defaultPrint(doc) {
+    if (!doc.pdfUrl || typeof window === 'undefined')
+        return;
+    window.open(doc.pdfUrl, '_blank', 'noopener,noreferrer');
+}
+export function PrintSendDialog({ open, onOpenChange, document: doc, channels = ['email', 'whatsapp'], onSend, onPrint, }) {
+    const { t } = useTranslation();
+    const [channel, setChannel] = useState(channels[0] ?? 'email');
+    const [destination, setDestination] = useState('');
+    const [sending, setSending] = useState(false);
+    const [sent, setSent] = useState(false);
+    const [error, setError] = useState();
+    const suggested = channel === 'email' ? doc.email : doc.phone;
+    useEffect(() => {
+        if (open) {
+            setDestination(suggested ?? '');
+            setSent(false);
+            setError(undefined);
+        }
+    }, [open, channel, suggested]);
+    const canSend = !!onSend && channels.length > 0;
+    const send = async () => {
+        const dest = destination.trim();
+        if (!onSend || !dest)
+            return;
+        setSending(true);
+        setError(undefined);
+        setSent(false);
+        try {
+            await onSend(channel, dest, doc);
+            setSent(true);
+        }
+        catch (e) {
+            const msg = e?.message;
+            setError(typeof msg === 'string' && msg
+                ? msg
+                : t('printSend.error', { defaultValue: 'No se pudo enviar el documento. Inténtalo de nuevo.' }));
+        }
+        finally {
+            setSending(false);
+        }
+    };
+    const channelLabel = (c) => c === 'email' ? t('printSend.email', { defaultValue: 'Correo' }) : t('printSend.whatsapp', { defaultValue: 'WhatsApp' });
+    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { className: "sm:max-w-md", children: [_jsxs(DialogHeader, { children: [_jsxs(DialogTitle, { children: [t('printSend.title', { defaultValue: 'Imprimir o enviar' }), doc.title ? ` · ${doc.title}` : ''] }), _jsx(DialogDescription, { children: doc.folio })] }), _jsxs("div", { className: "space-y-4", children: [_jsxs(Button, { type: "button", variant: "outline", className: "w-full justify-start", disabled: !doc.pdfUrl && !onPrint, onClick: () => (onPrint ?? defaultPrint)(doc), children: [_jsx(Printer, { className: "mr-2 size-4", "aria-hidden": true }), t('printSend.print', { defaultValue: 'Imprimir' })] }), canSend && (_jsxs("div", { className: "space-y-2", children: [channels.length > 1 && (_jsx("div", { className: "flex gap-2", role: "group", "aria-label": t('printSend.channel', { defaultValue: 'Canal de envío' }), children: channels.map((c) => (_jsxs(Button, { type: "button", size: "sm", variant: c === channel ? 'default' : 'outline', "aria-pressed": c === channel, onClick: () => setChannel(c), children: [c === 'email' ? _jsx(Mail, { className: "mr-1.5 size-4", "aria-hidden": true }) : _jsx(MessageCircle, { className: "mr-1.5 size-4", "aria-hidden": true }), channelLabel(c)] }, c))) })), _jsx(Input, { value: destination, type: channel === 'email' ? 'email' : 'tel', "aria-label": t('printSend.destination', { defaultValue: 'Destino' }), placeholder: channel === 'email' ? 'cliente@ejemplo.com' : '+52 55 0000 0000', onChange: (e) => setDestination(e.target.value) }), _jsx(FormErrorBanner, { message: error }), sent && (_jsx("p", { role: "status", className: "text-sm text-emerald-600 dark:text-emerald-400", children: t('printSend.sent', { defaultValue: 'Enviado.' }) }))] }))] }), _jsxs(DialogFooter, { children: [_jsx(Button, { type: "button", variant: "outline", onClick: () => onOpenChange(false), children: t('common.close', { defaultValue: 'Cerrar' }) }), canSend && (_jsxs(Button, { type: "button", onClick: send, disabled: sending || !destination.trim(), children: [sending && _jsx(Loader2, { className: "mr-2 size-4 animate-spin", "aria-hidden": true }), t('printSend.send', { defaultValue: 'Enviar' })] }))] })] }) }));
+}

package/dist/business/relate-documents.d.ts

@@ -0,0 +1,41 @@
+export interface RelatableDocument {
+    id: string;
+    /** UUID fiscal (CFDI), cuando ya está timbrado. */
+    uuid?: string;
+    folio?: string;
+    /** Texto libre para mostrar («Factura A-120 · Cliente X»). */
+    label?: string;
+    total?: number;
+}
+export interface RelationTypeOption {
+    /** Clave que viaja en `relation_type` (p. ej. `"01"`). */
+    value: string;
+    label: string;
+}
+/** Un documento relacionado: lo que el formulario guarda. */
+export interface RelatedDocument {
+    related_document_id: string;
+    relation_type: string;
+    /** Solo para mostrar. */
+    uuid?: string;
+    folio?: string;
+    label?: string;
+}
+export interface RelateDocumentsProps {
+    value: RelatedDocument[];
+    onChange: (value: RelatedDocument[]) => void;
+    /** Catálogo de tipos de relación (lo aporta el addon). */
+    relationTypes: RelationTypeOption[];
+    /** Búsqueda de documentos origen. Estable (useCallback). */
+    search: (q: string, signal: AbortSignal) => Promise<RelatableDocument[]>;
+    /** Tipo preseleccionado al agregar. Default: el primero del catálogo. */
+    defaultRelationType?: string;
+    /** Máximo de documentos relacionados. Sin tope por defecto. */
+    max?: number;
+    disabled?: boolean;
+    placeholder?: string;
+}
+export declare function RelateDocuments({ value, onChange, relationTypes, search, defaultRelationType, max, disabled, placeholder, }: RelateDocumentsProps): import("react").JSX.Element;
+/** Valor a enviar al servidor: solo los datos, sin los campos de visualización. */
+export declare function serializeRelatedDocuments(value: RelatedDocument[]): Array<Pick<RelatedDocument, 'related_document_id' | 'relation_type'>>;
+//# sourceMappingURL=relate-documents.d.ts.map

package/dist/business/relate-documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relate-documents.d.ts","sourceRoot":"","sources":["../../src/business/relate-documents.tsx"],"names":[],"mappings":"AAWA,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,kBAAkB;IAC/B,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CAChB;AAED,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC5B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,aAAa,EAAE,MAAM,CAAA;IACrB,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,eAAe,EAAE,CAAA;IACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,IAAI,CAAA;IAC5C,0DAA0D;IAC1D,aAAa,EAAE,kBAAkB,EAAE,CAAA;IACnC,4DAA4D;IAC5D,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAA;IACxE,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB;AAMD,wBAAgB,eAAe,CAAC,EAC5B,KAAK,EACL,QAAQ,EACR,aAAa,EACb,MAAM,EACN,mBAAmB,EACnB,GAAG,EACH,QAAQ,EACR,WAAW,GACd,EAAE,oBAAoB,+BA+GtB;AAED,mFAAmF;AACnF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,qBAAqB,GAAG,eAAe,CAAC,CAAC,CAEzI"}

package/dist/business/relate-documents.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// RelateDocuments — relaciona uno o más documentos origen (CFDI) desde un
+// formulario: nota de crédito, devolución, sustitución. El valor es DATO
+// (`related_document_id`, `relation_type`, UUID/folio para mostrar), no un flujo
+// de un solo módulo. El SDK no embebe catálogos fiscales: los tipos de relación
+// (p. ej. SAT 01/03/04) llegan por la prop `relationTypes`.
+import { useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { Link2, Search, X } from 'lucide-react';
+import { Badge, Button, Input } from '@asteby/metacore-ui';
+import { useAsyncSearch } from './use-async-search';
+function docTitle(d) {
+    return d.label || d.folio || d.uuid || d.id || '';
+}
+export function RelateDocuments({ value, onChange, relationTypes, search, defaultRelationType, max, disabled, placeholder, }) {
+    const { t } = useTranslation();
+    const [text, setText] = useState('');
+    const [pendingType, setPendingType] = useState(defaultRelationType ?? relationTypes[0]?.value ?? '');
+    const { results, loading, error } = useAsyncSearch(text, search, { minChars: 2 });
+    const full = max != null && value.length >= max;
+    const typeLabel = (v) => relationTypes.find((r) => r.value === v)?.label ?? v;
+    const add = (d) => {
+        if (full || value.some((x) => x.related_document_id === d.id))
+            return;
+        onChange([
+            ...value,
+            { related_document_id: d.id, relation_type: pendingType, uuid: d.uuid, folio: d.folio, label: d.label },
+        ]);
+        setText('');
+    };
+    const remove = (id) => onChange(value.filter((x) => x.related_document_id !== id));
+    const setType = (id, relation_type) => onChange(value.map((x) => (x.related_document_id === id ? { ...x, relation_type } : x)));
+    const selectCls = 'h-9 rounded-md border bg-background px-2 text-sm';
+    return (_jsxs("div", { "data-slot": "relate-documents", className: "space-y-2", children: [value.length > 0 && (_jsx("ul", { className: "divide-y rounded-md border", children: value.map((d) => (_jsxs("li", { className: "flex flex-wrap items-center gap-2 px-2 py-1.5", children: [_jsx(Link2, { className: "size-4 text-muted-foreground", "aria-hidden": true }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("p", { className: "truncate text-sm font-medium", children: docTitle({ folio: d.folio, label: d.label, id: d.related_document_id }) }), d.uuid && _jsx("p", { className: "break-all font-mono text-xs text-muted-foreground", children: d.uuid })] }), _jsxs("select", { className: selectCls, disabled: disabled, value: d.relation_type, "aria-label": t('relateDocuments.type', { defaultValue: 'Tipo de relación' }), onChange: (e) => setType(d.related_document_id, e.target.value), children: [!relationTypes.some((r) => r.value === d.relation_type) && (_jsx("option", { value: d.relation_type, children: typeLabel(d.relation_type) })), relationTypes.map((r) => (_jsx("option", { value: r.value, children: r.label }, r.value)))] }), !disabled && (_jsx(Button, { type: "button", size: "icon", variant: "ghost", onClick: () => remove(d.related_document_id), "aria-label": t('relateDocuments.remove', { defaultValue: 'Quitar relación' }), children: _jsx(X, { className: "size-4" }) }))] }, d.related_document_id))) })), !full && !disabled && (_jsxs("div", { 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", value: text, placeholder: placeholder ?? t('relateDocuments.placeholder', { defaultValue: 'Buscar por folio o UUID' }), onChange: (e) => setText(e.target.value) })] }), _jsx("select", { className: selectCls, value: pendingType, "aria-label": t('relateDocuments.newType', { defaultValue: 'Tipo para el documento nuevo' }), onChange: (e) => setPendingType(e.target.value), children: relationTypes.map((r) => (_jsx("option", { value: r.value, children: r.label }, r.value))) })] }), 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('relateDocuments.error', { defaultValue: 'No se pudo buscar documentos. Inténtalo de nuevo.' }) })), !loading && !error && text.trim().length >= 2 && results.length === 0 && (_jsx("p", { className: "text-sm text-muted-foreground", children: t('relateDocuments.empty', { defaultValue: 'No encontramos ese documento.' }) })), results.length > 0 && (_jsx("ul", { role: "listbox", className: "max-h-64 divide-y overflow-auto rounded-md border", children: results.map((d) => {
+                            const already = value.some((x) => x.related_document_id === d.id);
+                            return (_jsx("li", { role: "option", "aria-selected": already, children: _jsxs("button", { type: "button", disabled: already, className: "flex w-full items-center justify-between gap-2 px-2 py-1.5 text-left hover:bg-accent disabled:opacity-50", onClick: () => add(d), children: [_jsxs("span", { children: [_jsx("span", { className: "block text-sm font-medium", children: docTitle(d) }), d.uuid && _jsx("span", { className: "block break-all font-mono text-xs text-muted-foreground", children: d.uuid })] }), already && _jsx(Badge, { variant: "muted", children: t('relateDocuments.added', { defaultValue: 'Agregado' }) })] }) }, d.id));
+                        }) }))] }))] }));
+}
+/** Valor a enviar al servidor: solo los datos, sin los campos de visualización. */
+export function serializeRelatedDocuments(value) {
+    return value.map(({ related_document_id, relation_type }) => ({ related_document_id, relation_type }));
+}