@asteby/metacore-runtime-react 34.1.0 → 35.1.0

package/dist/permissions-manager.js

@@ -30,6 +30,8 @@ import { toast } from 'sonner';
 import { cn } from '@asteby/metacore-ui/lib';
 import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, Badge, Button, Card, CardContent, CardDescription, CardHeader, CardTitle, Checkbox, Command, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, Dialog, DialogContent, DialogFooter, DialogHeader, DialogTitle, Input, Label, Popover, PopoverContent, PopoverTrigger, Separator, Skeleton, Collapsible, CollapsibleContent, CollapsibleTrigger, } from '@asteby/metacore-ui/primitives';
 import { DynamicIcon } from './dynamic-icon';
+import { IconPickerField } from './icon-picker-field';
+import { ColorPickerField, DEFAULT_ROLE_COLOR } from './color-picker-field';
 // ---------------------------------------------------------------------------
 // Pure helpers (exported for hosts/tests)
 // ---------------------------------------------------------------------------
@@ -133,17 +135,29 @@ function slugify(label) {
         .replace(/[^a-z0-9]+/g, '_')
         .replace(/^_+|_+$/g, '');
 }
-const ROLE_COLORS = [
-    '#ef4444',
-    '#f97316',
-    '#eab308',
-    '#22c55e',
-    '#06b6d4',
-    '#3b82f6',
-    '#8b5cf6',
-    '#ec4899',
-    '#6b7280',
-];
+/** Suggest a Lucide icon from the role label (create-dialog default). */
+export function suggestRoleIcon(label) {
+    const s = fold(label);
+    const rules = [
+        [/cajer|cash|teller|bank/, 'Banknote'],
+        [/vend|seller|sales|shop|mostrador/, 'ShoppingBag'],
+        [/mecanic|technic|wrench|taller/, 'Wrench'],
+        [/jefe|lead|manager|gerente|supervisor/, 'HardHat'],
+        [/almacen|ware|stock|invent/, 'Warehouse'],
+        [/compr|purch|buyer/, 'Truck'],
+        [/contad|account|ledger/, 'Calculator'],
+        [/nomina|payroll|sueldo/, 'Wallet'],
+        [/rh|hr|human|emplead|people/, 'Users'],
+        [/fleet|flota|vehic/, 'Car'],
+        [/admin|dueño|owner/, 'ShieldCheck'],
+        [/view|observa|lectura|read/, 'Eye'],
+    ];
+    for (const [re, icon] of rules) {
+        if (re.test(s))
+            return icon;
+    }
+    return 'Shield';
+}
 /**
  * Normalize whatever `loadModules` returned into the canonical grouped shape.
  *
@@ -237,7 +251,14 @@ export function PermissionsManager({ loadModules, loadRoles, loadRolePermissions
     const [moduleOpen, setModuleOpen] = React.useState(false);
     // Pending role switch while there are unsaved changes.
     const [pendingRoleId, setPendingRoleId] = React.useState(null);
-    const [roleDialog, setRoleDialog] = React.useState({ open: false, mode: 'create', label: '', color: ROLE_COLORS[5], grantAll: false });
+    const [roleDialog, setRoleDialog] = React.useState({
+        open: false,
+        mode: 'create',
+        label: '',
+        color: DEFAULT_ROLE_COLOR,
+        icon: 'Shield',
+        grantAll: false,
+    });
     const [roleSaving, setRoleSaving] = React.useState(false);
     const [deleteOpen, setDeleteOpen] = React.useState(false);
     const [deleting, setDeleting] = React.useState(false);
@@ -389,6 +410,7 @@ export function PermissionsManager({ loadModules, loadRoles, loadRolePermissions
                     name: slugify(label),
                     label,
                     color: roleDialog.color,
+                    icon: roleDialog.icon || suggestRoleIcon(label),
                 });
                 const rs = await loadRoles();
                 setRoles(rs);
@@ -412,6 +434,7 @@ export function PermissionsManager({ loadModules, loadRoles, loadRolePermissions
                     name: activeRole.name,
                     label,
                     color: roleDialog.color,
+                    icon: roleDialog.icon || suggestRoleIcon(label),
                 });
                 await refreshRoles(activeRole.id);
                 toast.success('Rol actualizado');
@@ -451,7 +474,8 @@ export function PermissionsManager({ loadModules, loadRoles, loadRolePermissions
             open: true,
             mode: 'edit',
             label: activeRole.label || activeRole.name,
-            color: activeRole.color || ROLE_COLORS[5],
+            color: activeRole.color || DEFAULT_ROLE_COLOR,
+            icon: activeRole.icon || suggestRoleIcon(activeRole.label || activeRole.name),
             grantAll: false,
         });
     };
@@ -476,18 +500,21 @@ export function PermissionsManager({ loadModules, loadRoles, loadRolePermissions
                                     open: true,
                                     mode: 'create',
                                     label: '',
-                                    color: ROLE_COLORS[5],
+                                    color: DEFAULT_ROLE_COLOR,
+                                    icon: 'Shield',
                                     grantAll: false,
-                                }), children: [_jsx(Plus, { className: "mr-1.5 h-4 w-4" }), " Nuevo rol"] })), _jsxs(Button, { variant: "outline", onClick: () => setAllPermissions(true), disabled: checksDisabled || !allCatalogCapabilities.length, title: "Marca todos los permisos de todos los m\u00F3dulos", children: [_jsx(CheckCheck, { className: "mr-1.5 h-4 w-4" }), " Otorgar todo"] }), _jsxs(Button, { variant: "outline", onClick: () => setAllPermissions(false), disabled: checksDisabled || !draft?.size, title: "Quita todos los permisos del rol", children: [_jsx(Eraser, { className: "mr-1.5 h-4 w-4" }), " Quitar todo"] }), _jsxs(Button, { onClick: handleSave, disabled: !dirty || saving || !activeRole, className: "bg-emerald-600 text-white hover:bg-emerald-700", children: [_jsx(Save, { className: "mr-1.5 h-4 w-4" }), saving ? 'Guardando…' : 'Guardar permisos'] })] })] }), _jsxs("div", { className: "grid items-start gap-4 lg:grid-cols-[340px_1fr]", children: [_jsxs("div", { className: "flex flex-col gap-4", children: [_jsxs(Card, { children: [_jsxs(CardHeader, { children: [_jsx(CardTitle, { className: "text-base", children: "Rol" }), _jsx(CardDescription, { children: "Selecciona el rol a configurar." })] }), _jsxs(CardContent, { className: "flex flex-col gap-3", children: [_jsxs("div", { className: "flex items-center gap-1.5", children: [_jsxs(Popover, { open: roleOpen, onOpenChange: setRoleOpen, children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs(Button, { variant: "outline", role: "combobox", "aria-expanded": roleOpen, className: "min-w-0 flex-1 justify-between font-normal", children: [_jsxs("span", { className: "flex min-w-0 items-center gap-2", children: [activeRole && (_jsx("span", { className: "h-2.5 w-2.5 shrink-0 rounded-full", style: {
-                                                                                        background: activeRole.color || '#6b7280',
-                                                                                    }, "aria-hidden": "true" })), _jsx("span", { className: "truncate", children: activeRole
+                                }), children: [_jsx(Plus, { className: "mr-1.5 h-4 w-4" }), " Nuevo rol"] })), _jsxs(Button, { variant: "outline", onClick: () => setAllPermissions(true), disabled: checksDisabled || !allCatalogCapabilities.length, title: "Marca todos los permisos de todos los m\u00F3dulos", children: [_jsx(CheckCheck, { className: "mr-1.5 h-4 w-4" }), " Otorgar todo"] }), _jsxs(Button, { variant: "outline", onClick: () => setAllPermissions(false), disabled: checksDisabled || !draft?.size, title: "Quita todos los permisos del rol", children: [_jsx(Eraser, { className: "mr-1.5 h-4 w-4" }), " Quitar todo"] }), _jsxs(Button, { onClick: handleSave, disabled: !dirty || saving || !activeRole, className: "bg-emerald-600 text-white hover:bg-emerald-700", children: [_jsx(Save, { className: "mr-1.5 h-4 w-4" }), saving ? 'Guardando…' : 'Guardar permisos'] })] })] }), _jsxs("div", { className: "grid items-start gap-4 lg:grid-cols-[340px_1fr]", children: [_jsxs("div", { className: "flex flex-col gap-4", children: [_jsxs(Card, { children: [_jsxs(CardHeader, { children: [_jsx(CardTitle, { className: "text-base", children: "Rol" }), _jsx(CardDescription, { children: "Selecciona el rol a configurar." })] }), _jsxs(CardContent, { className: "flex flex-col gap-3", children: [_jsxs("div", { className: "flex items-center gap-1.5", children: [_jsxs(Popover, { open: roleOpen, onOpenChange: setRoleOpen, children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs(Button, { variant: "outline", role: "combobox", "aria-expanded": roleOpen, className: "min-w-0 flex-1 justify-between font-normal", children: [_jsxs("span", { className: "flex min-w-0 items-center gap-2", children: [activeRole && (_jsx("span", { className: "flex h-6 w-6 shrink-0 items-center justify-center rounded-md", style: {
+                                                                                        background: `${activeRole.color || '#64748b'}22`,
+                                                                                        color: activeRole.color || '#64748b',
+                                                                                    }, "aria-hidden": "true", children: _jsx(DynamicIcon, { name: activeRole.icon || 'Shield', className: "h-3.5 w-3.5" }) })), _jsx("span", { className: "truncate", children: activeRole
                                                                                         ? activeRole.label || activeRole.name
                                                                                         : 'Seleccionar rol…' })] }), _jsx(ChevronsUpDown, { className: "ml-2 h-4 w-4 shrink-0 opacity-50" })] }) }), _jsx(PopoverContent, { className: "w-[280px] p-0", align: "start", children: _jsxs(Command, { children: [_jsx(CommandInput, { placeholder: "Buscar rol\u2026" }), _jsxs(CommandList, { children: [_jsx(CommandEmpty, { children: "Sin resultados." }), _jsx(CommandGroup, { children: (roles ?? []).map((role) => (_jsxs(CommandItem, { value: `${role.label || ''} ${role.name}`, onSelect: () => {
                                                                                             requestRoleSwitch(role.id);
                                                                                             setRoleOpen(false);
-                                                                                        }, children: [_jsx("span", { className: "mr-2 h-2 w-2 shrink-0 rounded-full", style: {
-                                                                                                    background: role.color || '#6b7280',
-                                                                                                }, "aria-hidden": "true" }), _jsx("span", { className: "truncate", children: role.label || role.name }), role.id === activeRoleId && (_jsx(Check, { className: "ml-auto h-4 w-4" }))] }, role.id))) })] })] }) })] }), updateRole && (_jsx(Button, { variant: "outline", size: "icon", className: "h-9 w-9 shrink-0", "aria-label": "Editar rol", disabled: !activeRole, onClick: openEditRole, children: _jsx(Pencil, { className: "h-4 w-4" }) })), deleteRole && (_jsx(Button, { variant: "outline", size: "icon", className: "h-9 w-9 shrink-0 text-destructive hover:text-destructive", "aria-label": "Eliminar rol", disabled: !activeRole, onClick: () => setDeleteOpen(true), children: _jsx(Trash2, { className: "h-4 w-4" }) }))] }), (general?.length ?? 0) > 0 && (_jsxs(_Fragment, { children: [_jsx(Separator, {}), _jsxs("div", { children: [_jsx("h3", { className: "mb-2 text-sm font-semibold", children: "Permisos Generales" }), _jsx("div", { className: "flex flex-col gap-2", children: general.map((g) => (_jsx(CapabilityCheck, { checked: draft?.has(g.key) ?? false, disabled: checksDisabled, onToggle: () => toggleCapability(g.key), label: g.label, description: g.description }, g.key))) })] })] }))] })] }), _jsxs(Card, { children: [_jsxs(CardHeader, { children: [_jsx(CardTitle, { className: "text-base", children: "M\u00F3dulo" }), _jsx(CardDescription, { children: "Elige el m\u00F3dulo cuyas acciones quieres configurar." })] }), _jsx(CardContent, { children: _jsxs(Popover, { open: moduleOpen, onOpenChange: setModuleOpen, children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs(Button, { variant: "outline", role: "combobox", "aria-expanded": moduleOpen, className: "w-full justify-between font-normal", children: [_jsxs("span", { className: "flex min-w-0 items-center gap-2", children: [activeModule && (_jsx(DynamicIcon, { name: activeModule.icon ||
+                                                                                        }, children: [_jsx("span", { className: "mr-2 flex h-6 w-6 shrink-0 items-center justify-center rounded-md", style: {
+                                                                                                    background: `${role.color || '#64748b'}22`,
+                                                                                                    color: role.color || '#64748b',
+                                                                                                }, "aria-hidden": "true", children: _jsx(DynamicIcon, { name: role.icon || 'Shield', className: "h-3.5 w-3.5" }) }), _jsx("span", { className: "truncate", children: role.label || role.name }), role.id === activeRoleId && (_jsx(Check, { className: "ml-auto h-4 w-4" }))] }, role.id))) })] })] }) })] }), updateRole && (_jsx(Button, { variant: "outline", size: "icon", className: "h-9 w-9 shrink-0", "aria-label": "Editar rol", disabled: !activeRole, onClick: openEditRole, children: _jsx(Pencil, { className: "h-4 w-4" }) })), deleteRole && (_jsx(Button, { variant: "outline", size: "icon", className: "h-9 w-9 shrink-0 text-destructive hover:text-destructive", "aria-label": "Eliminar rol", disabled: !activeRole, onClick: () => setDeleteOpen(true), children: _jsx(Trash2, { className: "h-4 w-4" }) }))] }), (general?.length ?? 0) > 0 && (_jsxs(_Fragment, { children: [_jsx(Separator, {}), _jsxs("div", { children: [_jsx("h3", { className: "mb-2 text-sm font-semibold", children: "Permisos Generales" }), _jsx("div", { className: "flex flex-col gap-2", children: general.map((g) => (_jsx(CapabilityCheck, { checked: draft?.has(g.key) ?? false, disabled: checksDisabled, onToggle: () => toggleCapability(g.key), label: g.label, description: g.description }, g.key))) })] })] }))] })] }), _jsxs(Card, { children: [_jsxs(CardHeader, { children: [_jsx(CardTitle, { className: "text-base", children: "M\u00F3dulo" }), _jsx(CardDescription, { children: "Elige el m\u00F3dulo cuyas acciones quieres configurar." })] }), _jsx(CardContent, { children: _jsxs(Popover, { open: moduleOpen, onOpenChange: setModuleOpen, children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs(Button, { variant: "outline", role: "combobox", "aria-expanded": moduleOpen, className: "w-full justify-between font-normal", children: [_jsxs("span", { className: "flex min-w-0 items-center gap-2", children: [activeModule && (_jsx(DynamicIcon, { name: activeModule.icon ||
                                                                             (activeModule.kind === 'screen'
                                                                                 ? 'Eye'
                                                                                 : 'Square'), className: "h-4 w-4 shrink-0 opacity-70" })), _jsx("span", { className: "truncate", children: activeModule
@@ -506,9 +533,26 @@ export function PermissionsManager({ loadModules, loadRoles, loadRolePermissions
                                                         : 'Configura los permisos del módulo seleccionado.' })] }), activeRole && activeModule && (_jsxs("div", { className: "flex items-center gap-2", children: [_jsxs(Badge, { variant: "secondary", className: "tabular-nums", children: [moduleGranted, "/", moduleTotal] }), _jsxs(Button, { variant: "outline", size: "sm", className: "h-8", disabled: checksDisabled || moduleGranted === moduleTotal, onClick: () => setModuleAll(true), children: [_jsx(CheckCheck, { className: "mr-1.5 h-3.5 w-3.5" }), " Marcar todo"] }), _jsxs(Button, { variant: "outline", size: "sm", className: "h-8", disabled: checksDisabled || moduleGranted === 0, onClick: () => setModuleAll(false), children: [_jsx(Eraser, { className: "mr-1.5 h-3.5 w-3.5" }), " Limpiar"] })] }))] }) }), _jsx(CardContent, { children: !activeRole ? (_jsx(EmptyHint, { text: "Selecciona un rol para configurar sus permisos." })) : loadingPerms ? (_jsx("div", { className: "grid gap-2 sm:grid-cols-2", children: Array.from({ length: 6 }).map((_, i) => (_jsx(Skeleton, { className: "h-14 w-full" }, i))) })) : !activeModule ? (_jsx(EmptyHint, { text: "Selecciona un m\u00F3dulo de la lista para ver sus acciones." })) : (_jsx(ModuleActionsPanel, { module: activeModule, draft: draft, checksDisabled: checksDisabled, onToggle: toggleCapability })) })] })] }), _jsx(AlertDialog, { open: pendingRoleId !== null, onOpenChange: (open) => !open && setPendingRoleId(null), children: _jsxs(AlertDialogContent, { children: [_jsxs(AlertDialogHeader, { children: [_jsx(AlertDialogTitle, { children: "Cambios sin guardar" }), _jsx(AlertDialogDescription, { children: "Tienes cambios sin guardar en este rol. Si cambias de rol se descartar\u00E1n." })] }), _jsxs(AlertDialogFooter, { children: [_jsx(AlertDialogCancel, { children: "Cancelar" }), _jsx(AlertDialogAction, { onClick: () => {
                                         setActiveRoleId(pendingRoleId);
                                         setPendingRoleId(null);
-                                    }, children: "Descartar y cambiar" })] })] }) }), _jsx(Dialog, { open: roleDialog.open, onOpenChange: (open) => setRoleDialog((d) => ({ ...d, open })), children: _jsxs(DialogContent, { className: "sm:max-w-md", children: [_jsx(DialogHeader, { children: _jsx(DialogTitle, { children: roleDialog.mode === 'create' ? 'Nuevo rol' : 'Editar rol' }) }), _jsxs("div", { className: "flex flex-col gap-4 py-2", children: [_jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(Label, { htmlFor: "pm-role-name", children: "Nombre del rol" }), _jsx(Input, { id: "pm-role-name", value: roleDialog.label, placeholder: "Ej. Cajero", onChange: (e) => setRoleDialog((d) => ({ ...d, label: e.target.value })) })] }), _jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(Label, { children: "Color" }), _jsx("div", { className: "flex flex-wrap gap-2", children: ROLE_COLORS.map((c) => (_jsx("button", { type: "button", "aria-label": `Color ${c}`, onClick: () => setRoleDialog((d) => ({ ...d, color: c })), className: cn('h-7 w-7 rounded-full border-2 transition-transform', roleDialog.color === c
-                                                    ? 'scale-110 border-foreground'
-                                                    : 'border-transparent hover:scale-105'), style: { background: c } }, c))) })] }), roleDialog.mode === 'create' && (_jsxs("label", { className: "flex cursor-pointer items-start gap-3 rounded-lg border p-3 text-sm hover:bg-muted/40", children: [_jsx("input", { type: "checkbox", className: "mt-0.5 size-4 accent-emerald-600", checked: roleDialog.grantAll, onChange: (e) => setRoleDialog((d) => ({
+                                    }, children: "Descartar y cambiar" })] })] }) }), _jsx(Dialog, { open: roleDialog.open, onOpenChange: (open) => setRoleDialog((d) => ({ ...d, open })), children: _jsxs(DialogContent, { className: "sm:max-w-md", children: [_jsx(DialogHeader, { children: _jsx(DialogTitle, { children: roleDialog.mode === 'create' ? 'Nuevo rol' : 'Editar rol' }) }), _jsxs("div", { className: "flex flex-col gap-4 py-2", children: [_jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(Label, { htmlFor: "pm-role-name", children: "Nombre del rol" }), _jsx(Input, { id: "pm-role-name", value: roleDialog.label, placeholder: "Ej. Cajero", onChange: (e) => {
+                                                const label = e.target.value;
+                                                setRoleDialog((d) => ({
+                                                    ...d,
+                                                    label,
+                                                    icon: d.icon === suggestRoleIcon(d.label) ||
+                                                        d.icon === 'Shield' ||
+                                                        !d.icon
+                                                        ? suggestRoleIcon(label)
+                                                        : d.icon,
+                                                }));
+                                            } })] }), _jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(Label, { children: "\u00CDcono" }), _jsx(IconPickerField, { field: {
+                                                key: 'icon',
+                                                label: 'Ícono',
+                                                type: 'text',
+                                                widget: 'icon',
+                                            }, value: roleDialog.icon, onChange: (v) => setRoleDialog((d) => ({
+                                                ...d,
+                                                icon: typeof v === 'string' && v ? v : 'Shield',
+                                            })) })] }), _jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(Label, { children: "Color" }), _jsx(ColorPickerField, { "aria-label": "Color del rol", value: roleDialog.color, onChange: (color) => setRoleDialog((d) => ({ ...d, color })) })] }), roleDialog.mode === 'create' && (_jsxs("label", { className: "flex cursor-pointer items-start gap-3 rounded-lg border p-3 text-sm hover:bg-muted/40", children: [_jsx("input", { type: "checkbox", className: "mt-0.5 size-4 accent-emerald-600", checked: roleDialog.grantAll, onChange: (e) => setRoleDialog((d) => ({
                                                 ...d,
                                                 grantAll: e.target.checked,
                                             })) }), _jsxs("span", { children: [_jsx("span", { className: "font-medium", children: "Otorgar todos los permisos" }), _jsx("span", { className: "mt-0.5 block text-xs text-muted-foreground", children: "Acceso completo a todos los m\u00F3dulos del cat\u00E1logo (como un admin). Puedes quitar permisos despu\u00E9s." })] })] }))] }), _jsxs(DialogFooter, { children: [_jsx(Button, { variant: "outline", onClick: () => setRoleDialog((d) => ({ ...d, open: false })), disabled: roleSaving, children: "Cancelar" }), _jsx(Button, { onClick: handleRoleSubmit, disabled: roleSaving || !roleDialog.label.trim(), children: roleSaving

package/dist/use-print-document.d.ts

@@ -12,9 +12,18 @@ export interface PrintDocumentArgs {
      * open   → open the PDF in a new tab (user prints from the viewer).
      */
     mode?: 'print' | 'download' | 'open';
-    /** Filename for the download mode (defaults to "<key>.pdf"). */
+    /**
+     * Hint filename for download mode. Prefer leaving this unset: the server
+     * expands `{{record.*}}` into Content-Disposition. A raw template string
+     * (e.g. "cfdi-{{record.number}}.pdf") must NOT be used as a.download —
+     * that is how downloads end up literally named with mustache braces.
+     */
     filename?: string;
 }
+/** Parse filename from Content-Disposition (RFC 5987 / quoted). */
+export declare function filenameFromContentDisposition(header: string | undefined | null): string | undefined;
+/** True when a caller passed an unexpanded mustache template as filename. */
+export declare function looksLikeFilenameTemplate(name: string | undefined): boolean;
 /**
  * Returns a `printDocument(args)` callback. Resolves once the PDF has been
  * fetched and the browser action (print/download/open) has been kicked off;

package/dist/use-print-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-print-document.d.ts","sourceRoot":"","sources":["../src/use-print-document.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,iBAAiB;IAC9B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAA;IACb,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAA;IACX;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAA;IACpC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,0CASrB,iBAAiB,KAAG,OAAO,CAAC,MAAM,CAAC,CAyD7C"}
+{"version":3,"file":"use-print-document.d.ts","sourceRoot":"","sources":["../src/use-print-document.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,iBAAiB;IAC9B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAA;IACb,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAA;IACX;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAA;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,mEAAmE;AACnE,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAapG;AAED,6EAA6E;AAC7E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE3E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,0CASrB,iBAAiB,KAAG,OAAO,CAAC,MAAM,CAAC,CAmE7C"}

package/dist/use-print-document.js

@@ -18,6 +18,27 @@
 // this hook constructs no client of its own.
 import { useCallback } from 'react';
 import { useApi } from './api-context';
+/** Parse filename from Content-Disposition (RFC 5987 / quoted). */
+export function filenameFromContentDisposition(header) {
+    if (!header)
+        return undefined;
+    const star = /filename\*\s*=\s*UTF-8''([^;]+)/i.exec(header);
+    if (star?.[1]) {
+        try {
+            return decodeURIComponent(star[1].trim().replace(/^"|"$/g, ''));
+        }
+        catch {
+            return star[1].trim().replace(/^"|"$/g, '');
+        }
+    }
+    const plain = /filename\s*=\s*"([^"]+)"|filename\s*=\s*([^;]+)/i.exec(header);
+    const raw = (plain?.[1] ?? plain?.[2] ?? '').trim();
+    return raw || undefined;
+}
+/** True when a caller passed an unexpanded mustache template as filename. */
+export function looksLikeFilenameTemplate(name) {
+    return !!name && /\{\{/.test(name);
+}
 /**
  * Returns a `printDocument(args)` callback. Resolves once the PDF has been
  * fetched and the browser action (print/download/open) has been kicked off;
@@ -35,9 +56,15 @@ export function usePrintDocument() {
         const blobUrl = URL.createObjectURL(blob);
         const cleanup = () => setTimeout(() => URL.revokeObjectURL(blobUrl), 60_000);
         if (mode === 'download') {
+            const headers = res.headers || {};
+            const fromHeader = filenameFromContentDisposition(headers['content-disposition'] || headers['Content-Disposition']) || undefined;
+            // Prefer server-expanded name; never use a raw {{record.*}} template.
+            const downloadName = fromHeader ||
+                (!looksLikeFilenameTemplate(filename) ? filename : undefined) ||
+                `${key}.pdf`;
             const a = document.createElement('a');
             a.href = blobUrl;
-            a.download = filename || `${key}.pdf`;
+            a.download = downloadName;
             document.body.appendChild(a);
             a.click();
             a.remove();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-runtime-react",
-  "version": "34.1.0",
+  "version": "35.1.0",
   "description": "React runtime for metacore hosts — renders addon contributions dynamically",
   "repository": {
     "type": "git",

package/src/__tests__/color-picker-field.test.tsx

@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest'
+import { normalizeHex, DEFAULT_ROLE_COLOR } from '../color-picker-field'
+
+describe('normalizeHex', () => {
+    it('accepts #rgb and expands', () => {
+        expect(normalizeHex('#0af')).toBe('#00aaff')
+    })
+    it('lowercases #rrggbb', () => {
+        expect(normalizeHex('#3B82F6')).toBe('#3b82f6')
+    })
+    it('rejects garbage', () => {
+        expect(normalizeHex('blue')).toBe('')
+        expect(normalizeHex('#gg0000')).toBe('')
+    })
+    it('default constant is valid', () => {
+        expect(normalizeHex(DEFAULT_ROLE_COLOR)).toBe('#3b82f6')
+    })
+})

package/src/__tests__/filename-from-disposition.test.ts

@@ -0,0 +1,30 @@
+import { describe, expect, it } from 'vitest'
+import {
+  filenameFromContentDisposition,
+  looksLikeFilenameTemplate,
+} from '../use-print-document'
+
+describe('filenameFromContentDisposition', () => {
+  it('parses quoted filename', () => {
+    expect(filenameFromContentDisposition('inline; filename="cfdi-F-950.pdf"')).toBe(
+      'cfdi-F-950.pdf',
+    )
+  })
+
+  it('parses RFC 5987 filename*', () => {
+    expect(
+      filenameFromContentDisposition("attachment; filename*=UTF-8''cfdi-F%20950.pdf"),
+    ).toBe('cfdi-F 950.pdf')
+  })
+
+  it('returns undefined for empty', () => {
+    expect(filenameFromContentDisposition(undefined)).toBeUndefined()
+  })
+})
+
+describe('looksLikeFilenameTemplate', () => {
+  it('detects mustache', () => {
+    expect(looksLikeFilenameTemplate('cfdi-{{record.number}}.pdf')).toBe(true)
+    expect(looksLikeFilenameTemplate('cfdi-F-950.pdf')).toBe(false)
+  })
+})

package/src/__tests__/prefill-scalar-from-record.test.ts

@@ -0,0 +1,37 @@
+import { describe, expect, it } from 'vitest'
+import { readRecordPath, scalarDefaultFromRecord, unwrapRecordScalar } from '../action-modal-dispatcher'
+import type { ActionFieldDef } from '../types'
+
+describe('scalarDefaultFromRecord', () => {
+    it('unwraps FK cells with value/label', () => {
+        expect(unwrapRecordScalar({ value: 'abc', label: 'Cliente SA' })).toBe('abc')
+    })
+
+    it('reads dotted paths', () => {
+        const record = { fiscal_data: { forma_pago: '03' } }
+        expect(readRecordPath(record, 'fiscal_data.forma_pago')).toBe('03')
+    })
+
+    it('uses defaultFromRecord string', () => {
+        const field = { key: 'forma_pago', defaultFromRecord: 'fiscal_data.forma_pago' } as ActionFieldDef & {
+            defaultFromRecord: string
+        }
+        const record = { fiscal_data: { forma_pago: '01' }, forma_pago: '99' }
+        expect(scalarDefaultFromRecord(field, record)).toBe('01')
+    })
+
+    it('tries defaultFromRecord array in order', () => {
+        const field = {
+            key: 'uso_cfdi',
+            defaultFromRecord: ['fiscal_data.uso_cfdi', 'uso_cfdi'],
+        } as ActionFieldDef & { defaultFromRecord: string[] }
+        const record = { uso_cfdi: 'G03' }
+        expect(scalarDefaultFromRecord(field, record)).toBe('G03')
+    })
+
+    it('falls back to record[field.key]', () => {
+        const field = { key: 'customer_id' } as ActionFieldDef
+        const record = { customer_id: '11111111-1111-4111-8111-111111111111' }
+        expect(scalarDefaultFromRecord(field, record)).toBe('11111111-1111-4111-8111-111111111111')
+    })
+})

package/src/__tests__/record-detail-display.test.tsx

@@ -110,4 +110,34 @@ describe('ViewValue — detail dialog display mapping', () => {
         )
         expect(container.textContent).toContain('—')
     })
+
+    it('renders plain text external_id without a relation initials avatar', () => {
+        const { container } = render(
+            <ViewValue
+                field={{ key: 'external_id', label: 'ID externo', type: 'text' }}
+                value="6a8c931523ea7"
+                record={{}}
+            />
+        )
+        expect(screen.getByText('6a8c931523ea7')).toBeTruthy()
+        // Must NOT render the InitialsAvatar lead ("6" chip) used for FKs.
+        expect(container.querySelector('[data-slot="avatar"]')).toBeNull()
+        expect(container.textContent).not.toMatch(/^6\s*6a8c/)
+    })
+
+    it('renders nested provider_data objects as pretty JSON, not key: {…}', () => {
+        render(
+            <ViewValue
+                field={{ key: 'provider_data', label: 'Datos del proveedor', type: 'json' }}
+                value={{
+                    forma_pago: '03',
+                    INV: { Folio: 950, Serie: 'F' },
+                }}
+                record={{}}
+            />
+        )
+        expect(screen.getByText('03')).toBeTruthy()
+        expect(screen.getByText(/"Folio": 950/)).toBeTruthy()
+        expect(screen.queryByText(/Inv:\s*\{\.\.\.\}/i)).toBeNull()
+    })
 })

package/src/action-modal-dispatcher.tsx

@@ -156,6 +156,65 @@ export function buildPrefillRows(spec: PrefillSpec, record: any): Array<Record<s
     return rows
 }
 
+// ---- scalar prefill from the acted-on record --------------------------------
+//
+// Row actions (stamp / refactura / cancel-with-reason) should open with the
+// current record's values, not empty selects. Manifest declares explicit paths
+// via `defaultFromRecord` (string or string[] fallback chain). When omitted,
+// the field seeds from record[field.key] if present.
+
+export function unwrapRecordScalar(value: unknown): unknown {
+    if (value === null || value === undefined) return value
+    if (typeof value !== 'object' || value instanceof Date) return value
+    if (Array.isArray(value)) return value
+    const o = value as Record<string, unknown>
+    if ('value' in o && (typeof o.value === 'string' || typeof o.value === 'number')) {
+        return o.value
+    }
+    if ('id' in o && (typeof o.id === 'string' || typeof o.id === 'number')) {
+        return o.id
+    }
+    return value
+}
+
+export function readRecordPath(record: any, path: string): unknown {
+    if (!record || !path) return undefined
+    const parts = path.split('.')
+    let cur: any = record
+    for (const p of parts) {
+        if (cur == null || typeof cur !== 'object') return undefined
+        cur = cur[p]
+    }
+    return unwrapRecordScalar(cur)
+}
+
+function defaultFromRecordSpec(field: ActionFieldDef): string | string[] | undefined {
+    const f = field as ActionFieldDef & {
+        defaultFromRecord?: string | string[]
+        default_from_record?: string | string[]
+    }
+    return f.defaultFromRecord ?? f.default_from_record
+}
+
+/** Scalar seed for one action field from the row being acted on. */
+export function scalarDefaultFromRecord(field: ActionFieldDef, record: any): unknown {
+    if (!record) return undefined
+    const spec = defaultFromRecordSpec(field)
+    if (typeof spec === 'string') {
+        const v = readRecordPath(record, spec)
+        if (v !== undefined && v !== null && v !== '') return v
+    } else if (Array.isArray(spec)) {
+        for (const path of spec) {
+            const v = readRecordPath(record, path)
+            if (v !== undefined && v !== null && v !== '') return v
+        }
+    } else if (field.key) {
+        const v = readRecordPath(record, field.key)
+        if (v !== undefined && v !== null && v !== '') return v
+    }
+    return undefined
+}
+
 export function ActionModalDispatcher({
     open,
     onOpenChange,
@@ -322,14 +381,17 @@ function selectPreviewColumns(columns: ColumnDefinition[] | undefined, record: a
             continue
         }
 
-        // Relación (ref / search / dynamic_select / *_id): solo si el sibling
-        // resolvió a un label legible; si es un *_id crudo sin resolver, se omite.
+        // Relación (ref / search / dynamic_select / uuid *_id): solo si el sibling
+        // resolvió a un label legible; text `*_id` (external_id) no es FK.
+        const t = String(col.type || '').toLowerCase()
         const isRelation =
             !!getFieldRef(col as ActionFieldDef) ||
             col.type === 'search' ||
             col.type === 'relation' ||
             (col as { widget?: string }).widget === 'dynamic_select' ||
-            (typeof col.key === 'string' && col.key.endsWith('_id'))
+            (typeof col.key === 'string' &&
+                col.key.endsWith('_id') &&
+                (t === 'uuid' || t === 'search' || t === 'relation' || t === 'dynamic_select' || t === 'belongs_to'))
         if (isRelation) {
             const sib = relationSiblingValue(col as any, record)
             const label = typeof sib === 'string' ? sib : objectLabel(sib)
@@ -552,20 +614,7 @@ function GenericActionModal({ open, onOpenChange, action, model, record, endpoin
 
     useEffect(() => {
         if (open && action.fields) {
-            const defaults: Record<string, any> = {}
-            for (const field of action.fields) {
-                if (isLineItemsField(field)) {
-                    const dv = lineItemsDefault(field)
-                    defaults[field.key] = isPrefillSpec(dv)
-                        ? buildPrefillRows(dv, record)
-                        : Array.isArray(dv)
-                          ? dv
-                          : []
-                    continue
-                }
-                defaults[field.key] = field.defaultValue ?? (field.type === 'boolean' ? false : '')
-            }
-            setFormData(defaults)
+            setFormData(buildFieldDefaults(action.fields, record))
             setFieldErrors({})
         }
     }, [open, action.fields, record])
@@ -632,6 +681,8 @@ function GenericActionModal({ open, onOpenChange, action, model, record, endpoin
         () => (action.fields ?? []).some(isLineItemsField),
         [action.fields],
     )
+    const embedRelations =
+        hasLineItems || !!(action as ActionMetadata & { embedRelations?: boolean }).embedRelations
     const explicitWidth = (action as unknown as { modalWidth?: number | string }).modalWidth
     const widthPx =
         explicitWidth != null
@@ -657,7 +708,7 @@ function GenericActionModal({ open, onOpenChange, action, model, record, endpoin
                         <DynamicIcon name={action.icon} className="h-5 w-5" />
                         {tl(action.label)}
                     </DialogTitle>
-                    {action.confirmMessage && <DialogDescription>{action.confirmMessage}</DialogDescription>}
+                    {action.confirmMessage && <DialogDescription>{tl(action.confirmMessage)}</DialogDescription>}
                 </DialogHeader>
                 {/* Scrollable body. The shared FieldGrid lays scalar fields out
                     in two responsive columns (single column on phones); line-items
@@ -676,14 +727,14 @@ function GenericActionModal({ open, onOpenChange, action, model, record, endpoin
                                     <FieldLabel htmlFor={field.key} required={field.required}>
                                         {tl(field.label)}
                                     </FieldLabel>
-                                    {renderField(field, formData[field.key], (v: any) => updateField(field.key, v), formData)}
+                                    {renderField(field, formData[field.key], (v: any) => updateField(field.key, v), formData, record)}
                                     {fieldErrors[field.key] && (
                                         <p className="text-destructive text-xs mt-1">{fieldErrors[field.key]}</p>
                                     )}
                                 </FieldCell>
                             )
                         })}
-                        {relations.length > 0 && (
+                        {embedRelations && relations.length > 0 && (
                             <FieldCell fullWidth>
                                 {/* Igual que el modal de registro: solo las
                                     relaciones de composición se embeben. */}
@@ -725,6 +776,11 @@ function buildFieldDefaults(fields: ActionFieldDef[], record: any): Record<strin
                   : []
             continue
         }
+        const fromRecord = scalarDefaultFromRecord(field, record)
+        if (fromRecord !== undefined && fromRecord !== null && fromRecord !== '') {
+            defaults[field.key] = fromRecord
+            continue
+        }
         defaults[field.key] = field.defaultValue ?? (field.type === 'boolean' ? false : '')
     }
     return defaults
@@ -881,7 +937,7 @@ function WizardActionModal({ open, onOpenChange, action, model, record, endpoint
                                     <FieldLabel htmlFor={field.key} required={field.required}>
                                         {tl(field.label)}
                                     </FieldLabel>
-                                    {renderField(field, formData[field.key], (v: any) => updateField(field.key, v), formData)}
+                                    {renderField(field, formData[field.key], (v: any) => updateField(field.key, v), formData, record)}
                                 </FieldCell>
                             )
                         })}
@@ -922,6 +978,29 @@ function WizardActionModal({ open, onOpenChange, action, model, record, endpoint
     )
 }
 
+function seedOptionFromRecord(
+    field: ActionFieldDef,
+    value: any,
+    record?: Record<string, any>,
+): import('./use-options-resolver').ResolvedOption | undefined {
+    if (!record || !field.key.endsWith('_id')) return undefined
+    const siblingKey = field.key.replace(/_id$/, '')
+    const sib = record[siblingKey]
+    if (!sib || typeof sib !== 'object') return undefined
+    const label = (sib as any).label ?? (sib as any).name ?? ''
+    if (!label && !(sib as any).image) return undefined
+    const id = String((sib as any).value ?? (sib as any).id ?? value ?? '')
+    return {
+        id,
+        value: id,
+        label: String(label),
+        name: String(label),
+        image: (sib as any).image,
+        color: (sib as any).color,
+        icon: (sib as any).icon,
+    }
+}
+
 function renderField(
     field: ActionFieldDef,
     value: any,
@@ -931,6 +1010,7 @@ function renderField(
     // fields. Omitted by callers that have no surrounding form (the field is
     // then treated as having no resolvable dependency).
     formValues?: Record<string, any>,
+    record?: Record<string, any>,
 ) {
     // Repeatable line-items group → row grid (value is an array of row objects).
     // The header form values flow in so a cell can depend on a header field.
@@ -948,7 +1028,15 @@ function renderField(
         const dependsValue = getDependsOn(field)
             ? resolveDependsValue(field, formValues)
             : undefined
-        return <DynamicSelectField field={field} value={value} onChange={onChange} dependsValue={dependsValue} />
+        return (
+            <DynamicSelectField
+                field={field}
+                value={value}
+                onChange={onChange}
+                dependsValue={dependsValue}
+                seedOption={seedOptionFromRecord(field, value, record)}
+            />
+        )
     }
     // File upload → themed picker that POSTs the file to the host upload
     // endpoint and stores the returned url/path. Kept in sync with DynamicForm.

package/src/addon-loader.tsx

@@ -199,7 +199,13 @@ export function AddonLoader({
     }, [scope, url, module, addonKey, unbindKey, hostRegistry])
 
     if (status === 'loading') return <>{fallback}</>
-    if (status === 'error')
+    if (status === 'error') {
+        // Hosts that pass `onError` (toast + telemetry) should not also paint
+        // a second, persistent inline banner — DynamicAddonLoaders mounts one
+        // fiber per installed addon and a visible error stack reads as a broken
+        // shell even when only one remote failed transiently.
+        if (onError) return null
         return <div className="text-sm text-red-500">Addon load error: {error?.message}</div>
+    }
     return <>{children}</>
 }