@asteby/metacore-runtime-react 46.4.0 → 47.1.0

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @asteby/metacore-runtime-react
 
+## 47.1.0
+
+### Minor Changes
+
+- 1614e02: `TableMetadata.audit` (columnas de auditoría que sirve el kernel >= v0.188) y nuevo `<AuditInfo>`: «Creado por X · fecha», «Modificado por Y · fecha» y «Eliminado por Z · fecha», colapsado al pie del detalle/edición de `DynamicRecordDialog`. El nombre sale del host (`resolveActor`), del hermano expandido del registro (`created_by`) o, si no, un id corto; el actor de sistema se muestra como «Sistema».
+- 0ee83dd: Filtro de opciones en selectores de relación: el campo (columna o campo de acción) acepta `option_filter` / `optionFilter` (una regla o lista con `field` y `equals` / `not_equals` / `in` / `not_in`) para ocultar opciones, p. ej. facturas con status `cancelada` en el selector de abonos (PIT-059). Se aplica en cliente sobre las columnas extra que devuelve `/options`, nunca oculta la selección actual y es retrocompatible (sin la propiedad no cambia nada). Nuevos exports: `getOptionFilter`, `applyOptionFilter`, `optionPassesRule`, tipos `OptionFilter` y `OptionFilterRule`; `useOptionsResolver` acepta `optionFilter` y `keepValue`.
+
+### Patch Changes
+
+- ad1e1b0: Kanban: el menú «…» de la tarjeta ya no tira la app con «`MenuItem` must be used within `Menu`». El `DropdownMenu` de la tarjeta se importa ahora desde la entrada raíz de `@asteby/metacore-ui`, la misma de `RowActionMenuItem`. Así no se mezclan dos contextos de Radix cuando el host comparte la raíz por Module Federation y empaqueta `/primitives` aparte. Se agrega un test que lo vigila.
+- Updated dependencies [66d82f5]
+  - @asteby/metacore-ui@2.24.1
+
+## 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

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

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/audit-info.d.ts

@@ -0,0 +1,54 @@
+/**
+ * audit-info.tsx
+ *
+ * <AuditInfo> — discreet "when and who" footer for a record: created, modified
+ * and (if tombstoned) deleted, each with the actor and a relative + absolute
+ * date. Driven only by the kernel's `TableMetadata.audit` (column names) and
+ * the record row — manifests declare nothing.
+ *
+ * Actor resolution (no extra requests), in order:
+ *   1. the host's `resolveActor(id)` when it returns a name;
+ *   2. the record's expanded sibling (`created_by_id` → `row.created_by`,
+ *      `{ label | name | title }` or a plain string);
+ *   3. the system actor id → "Sistema" / "System";
+ *   4. a short id (first 8 chars) — never a long uuid.
+ *
+ * Renders nothing when `audit` is absent or the record has none of its values.
+ */
+import * as React from 'react';
+import type { AuditMeta } from './types';
+/** The kernel's actor for unattended work (schedules, webhooks, connectors). */
+export declare const SYSTEM_ACTOR_ID = "00000000-0000-0000-0000-000000000001";
+/**
+ * Defensive reader for the served `audit` block: keeps only known keys whose
+ * value is a non-empty string; returns `undefined` when nothing usable remains.
+ */
+export declare function readAuditMeta(raw: unknown): AuditMeta | undefined;
+export interface AuditActor {
+    /** Display text. */
+    name: string;
+    /** True when the name is a real resolved label (not a short id). */
+    resolved: boolean;
+}
+/** Resolves the actor stored in `row[idColumn]` to something human. */
+export declare function resolveAuditActor(row: Record<string, unknown>, idColumn: string | undefined, opts: {
+    resolveActor?: (id: string) => string | undefined;
+    systemLabel: string;
+}): AuditActor | null;
+export interface AuditInfoProps {
+    /** The record row (keys are the column names `audit` points at). */
+    record: Record<string, unknown> | null | undefined;
+    /** `TableMetadata.audit`. Absent → renders nothing. */
+    audit: AuditMeta | null | undefined;
+    /** Optional host resolver uuid → display name (e.g. from a users cache). */
+    resolveActor?: (id: string) => string | undefined;
+    /** IANA timezone; defaults to the org runtime timezone. */
+    timeZone?: string;
+    /** BCP-47 locale; defaults to the i18n language. */
+    locale?: string;
+    /** Start expanded. Default: collapsed. */
+    defaultOpen?: boolean;
+    className?: string;
+}
+export declare function AuditInfo({ record, audit, resolveActor, timeZone, locale, defaultOpen, className, }: AuditInfoProps): React.JSX.Element | null;
+//# sourceMappingURL=audit-info.d.ts.map

package/dist/audit-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-info.d.ts","sourceRoot":"","sources":["../src/audit-info.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAU9B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExC,gFAAgF;AAChF,eAAO,MAAM,eAAe,yCAAyC,CAAA;AAWrE;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CASjE;AAED,MAAM,WAAW,UAAU;IACvB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,oEAAoE;IACpE,QAAQ,EAAE,OAAO,CAAA;CACpB;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,IAAI,EAAE;IAAE,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACjF,UAAU,GAAG,IAAI,CAmBnB;AAyBD,MAAM,WAAW,cAAc;IAC3B,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAA;IAClD,uDAAuD;IACvD,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,CAAA;IACnC,4EAA4E;IAC5E,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IACjD,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0CAA0C;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAUD,wBAAgB,SAAS,CAAC,EACtB,MAAM,EACN,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,WAAmB,EACnB,SAAS,GACZ,EAAE,cAAc,4BA0EhB"}

package/dist/audit-info.js

@@ -0,0 +1,142 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * audit-info.tsx
+ *
+ * <AuditInfo> — discreet "when and who" footer for a record: created, modified
+ * and (if tombstoned) deleted, each with the actor and a relative + absolute
+ * date. Driven only by the kernel's `TableMetadata.audit` (column names) and
+ * the record row — manifests declare nothing.
+ *
+ * Actor resolution (no extra requests), in order:
+ *   1. the host's `resolveActor(id)` when it returns a name;
+ *   2. the record's expanded sibling (`created_by_id` → `row.created_by`,
+ *      `{ label | name | title }` or a plain string);
+ *   3. the system actor id → "Sistema" / "System";
+ *   4. a short id (first 8 chars) — never a long uuid.
+ *
+ * Renders nothing when `audit` is absent or the record has none of its values.
+ */
+import * as React from 'react';
+import { useTranslation } from 'react-i18next';
+import { formatDistanceToNow } from 'date-fns';
+import { es, enUS } from 'date-fns/locale';
+import { ChevronDown, ChevronRight, History } from 'lucide-react';
+import { cn } from '@asteby/metacore-ui/lib';
+import { formatDateCell } from './dynamic-columns';
+import { objectLabel } from './dynamic-relation-helpers';
+import { isNilUuid } from './nil-uuid';
+import { useTimeZone } from './org-runtime-context';
+/** The kernel's actor for unattended work (schedules, webhooks, connectors). */
+export const SYSTEM_ACTOR_ID = '00000000-0000-0000-0000-000000000001';
+const AUDIT_KEYS = [
+    'created_at',
+    'created_by',
+    'updated_at',
+    'updated_by',
+    'deleted_at',
+    'deleted_by',
+];
+/**
+ * Defensive reader for the served `audit` block: keeps only known keys whose
+ * value is a non-empty string; returns `undefined` when nothing usable remains.
+ */
+export function readAuditMeta(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return undefined;
+    const src = raw;
+    const out = {};
+    for (const k of AUDIT_KEYS) {
+        const v = src[k];
+        if (typeof v === 'string' && v.trim() !== '')
+            out[k] = v;
+    }
+    return Object.keys(out).length ? out : undefined;
+}
+/** Resolves the actor stored in `row[idColumn]` to something human. */
+export function resolveAuditActor(row, idColumn, opts) {
+    if (!idColumn)
+        return null;
+    const raw = row[idColumn];
+    // The column itself may already be an expanded object.
+    const own = objectLabel(raw);
+    const id = typeof raw === 'string' ? raw.trim() : '';
+    if (!own && (!id || isNilUuid(id)))
+        return null;
+    if (id.toLowerCase() === SYSTEM_ACTOR_ID)
+        return { name: opts.systemLabel, resolved: true };
+    if (id) {
+        const fromHost = opts.resolveActor?.(id);
+        if (fromHost)
+            return { name: fromHost, resolved: true };
+    }
+    if (own)
+        return { name: own, resolved: true };
+    const base = idColumn.endsWith('_id') ? idColumn.slice(0, -3) : idColumn;
+    const sibling = base === idColumn ? undefined : row[base];
+    const siblingName = objectLabel(sibling) ?? (typeof sibling === 'string' && sibling.trim() !== '' ? sibling : undefined);
+    if (siblingName)
+        return { name: siblingName, resolved: true };
+    return { name: id.length > 8 ? id.slice(0, 8) : id, resolved: false };
+}
+const COPY = {
+    es: {
+        title: 'Historial del registro',
+        created: 'Creado por {{who}}',
+        updated: 'Modificado por {{who}}',
+        deleted: 'Eliminado por {{who}}',
+        createdAt: 'Creado',
+        updatedAt: 'Modificado',
+        deletedAt: 'Eliminado',
+        system: 'Sistema',
+    },
+    en: {
+        title: 'Record history',
+        created: 'Created by {{who}}',
+        updated: 'Modified by {{who}}',
+        deleted: 'Deleted by {{who}}',
+        createdAt: 'Created',
+        updatedAt: 'Modified',
+        deletedAt: 'Deleted',
+        system: 'System',
+    },
+};
+export function AuditInfo({ record, audit, resolveActor, timeZone, locale, defaultOpen = false, className, }) {
+    const { t, i18n } = useTranslation();
+    const ctxTz = useTimeZone();
+    const [open, setOpen] = React.useState(defaultOpen);
+    const meta = readAuditMeta(audit);
+    if (!meta || !record)
+        return null;
+    const lang = (locale || i18n?.language || 'es').toLowerCase().startsWith('en') ? 'en' : 'es';
+    const copy = COPY[lang];
+    const dfLocale = lang === 'en' ? enUS : es;
+    const tz = timeZone ?? ctxTz;
+    const tt = (key, vars) => t(`audit.${key}`, { defaultValue: copy[key], ...vars });
+    const build = (key, atCol, byCol, whoKey, whenKey) => {
+        const f = atCol ? formatDateCell(record[atCol], undefined, dfLocale, tz) : null;
+        if (!f)
+            return null;
+        const actor = resolveAuditActor(record, byCol, { resolveActor, systemLabel: tt('system') });
+        const date = new Date(record[atCol]);
+        const relative = formatDistanceToNow(date, { addSuffix: true, locale: dfLocale });
+        return {
+            key,
+            text: actor ? tt(whoKey, { who: actor.name }) : tt(whenKey),
+            absolute: f.display,
+            title: f.title,
+            relative,
+        };
+    };
+    const lines = [
+        build('created', meta.created_at, meta.created_by, 'created', 'createdAt'),
+        // Hide "modified" when it is the creation instant itself (never edited).
+        meta.updated_at && record[meta.updated_at] !== record[meta.created_at ?? '']
+            ? build('updated', meta.updated_at, meta.updated_by, 'updated', 'updatedAt')
+            : null,
+        build('deleted', meta.deleted_at, meta.deleted_by, 'deleted', 'deletedAt'),
+    ].filter((l) => l !== null);
+    if (lines.length === 0)
+        return null;
+    const Chevron = open ? ChevronDown : ChevronRight;
+    return (_jsxs("div", { className: cn('text-xs text-muted-foreground', className), "data-testid": "audit-info", children: [_jsxs("button", { type: "button", className: "flex items-center gap-1.5 hover:text-foreground", "aria-expanded": open, onClick: () => setOpen(o => !o), children: [_jsx(Chevron, { className: "h-3.5 w-3.5" }), _jsx(History, { className: "h-3.5 w-3.5" }), _jsx("span", { children: tt('title') })] }), open && (_jsx("ul", { className: "mt-2 space-y-1 pl-6", children: lines.map(l => (_jsxs("li", { "data-audit-line": l.key, children: [_jsx("span", { children: l.text }), ' · ', _jsx("time", { title: l.title, children: l.absolute }), _jsxs("span", { className: "opacity-70", children: [" (", l.relative, ")"] })] }, l.key))) }))] }));
+}

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