@asteby/metacore-runtime-react 28.7.0 → 28.8.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @asteby/metacore-runtime-react
 
+## 28.8.0
+
+### Minor Changes
+
+- 3db2705: Nuevo primitivo `EntitySelect`: combobox async de un modelo relacionado con las dos affordances del modal dinámico — "+" para CREAR (sin selección) que auto-selecciona el creado, y lápiz para EDITAR el seleccionado. Ambas gateadas por permisos del kernel (useCan: `<model>.create`/`.update`) y 100% dinámicas (el form sale de `/metadata/modal/:model` vía CreateRecordDialog). Reemplaza los pickers bespoke duplicados en POS/purchases por una sola implementación reusable.
+- 8346d8d: PrintDocumentButton: botón reusable de impresión de documentos
+
+  Componente drop-in sobre usePrintDocument: renderiza un <button> (estilable con
+  className) que imprime/descarga/abre un documento del servidor, se deshabilita
+  mientras baja el PDF (aria-busy) y reporta errores por onError. Evita recablear
+  el hook + estado de carga en cada addon.
+
+- 05bc470: usePrintDocument: primitivo reusable para imprimir documentos del servidor
+
+  Nuevo hook que cualquier addon federado usa para imprimir/descargar/abrir un
+  documento renderizado por el motor de docs de ops (ticket, comprobante, orden):
+  GET /api/data/:model/:id/documents/:key.pdf. Fetch con auth vía el ApiClient
+  inyectado (el endpoint es Bearer-gated, no se puede window.open directo), blob →
+  iframe print (modo default, ideal para ticket térmico), download u open. Era el
+  primitivo de impresión que faltaba en el SDK (había 0). Habilita el auto-print del
+  POS al cerrar venta.
+
+### Patch Changes
+
+- 233d63b: DynamicTable: una celda `creator` sin actor resuelto (registro creado por el sistema, `created_by` null) muestra "Sistema" en vez de "N/A", consistente con el fallback del historial de actividad. `user`/`avatar`/`search` mantienen "N/A" (vacío = sin asignar).
+
 ## 28.7.0
 
 ### Minor Changes

package/dist/dynamic-columns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-columns.d.ts","sourceRoot":"","sources":["../src/dynamic-columns.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,UAAU,CAAA;AAwC9C,OAAO,KAAK,EAAiB,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE9D,OAAO,KAAK,EAER,iBAAiB,EACpB,MAAM,wBAAwB,CAAA;AAE/B,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IAClC;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACtC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB;AA0BD;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,gBAAgB,EAAE,cAAc,MAAM,KAAG,MACzB,CAAA;AAQrD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,gBAAgB,KAAG,MAAM,GAAG,SAG5D,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC7B,KAAK,gBAAgB,EACrB,OAAO,OAAO,EACd,WAAW,MAAM,EACjB,SAAS,MAAM,KAChB,MAyBF,CAAA;AAyCD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,GAAI,QAAQ,GAAG,EAAE,KAAK,GAAG,KAAG,OAMlE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,GAAG,EAAE,KAAK,GAAG,KAAG,OAiB5D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,GAAG,EAAE,KAAK,GAAG,KAAG,OACqB,CAAA;AAwFhF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,KAAG,MAGnE,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,eAAe,2DAA4D,CAAA;AAExF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAClB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA6C5C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,gBAAgB,EAAE,KAAK,GAAG,KAAG,MAWtE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,gBAAgB,EAAE,KAAK,GAAG,KAAG,MAOtE,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,GACzB,KAAK,gBAAgB,EACrB,KAAK,GAAG,EACR,OAAO,GAAG,EACV,mBAAe,KAChB,MAAM,GAAG,SAcX,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAAI,KAAK,gBAAgB,EAAE,KAAK,GAAG,KAAG,MAOzE,CAAA;AA+ID;;;;GAIG;AACH;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAA;IACd,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CACxC,CAqBA,CAAA;AAED,wBAAgB,4BAA4B,CACxC,OAAO,GAAE,qBAA0B,GACpC,iBAAiB,CAkmBnB;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBACL,CAAA"}
+{"version":3,"file":"dynamic-columns.d.ts","sourceRoot":"","sources":["../src/dynamic-columns.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,UAAU,CAAA;AAwC9C,OAAO,KAAK,EAAiB,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE9D,OAAO,KAAK,EAER,iBAAiB,EACpB,MAAM,wBAAwB,CAAA;AAE/B,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IAClC;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACtC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB;AA0BD;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,gBAAgB,EAAE,cAAc,MAAM,KAAG,MACzB,CAAA;AAQrD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,gBAAgB,KAAG,MAAM,GAAG,SAG5D,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC7B,KAAK,gBAAgB,EACrB,OAAO,OAAO,EACd,WAAW,MAAM,EACjB,SAAS,MAAM,KAChB,MAyBF,CAAA;AAyCD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,GAAI,QAAQ,GAAG,EAAE,KAAK,GAAG,KAAG,OAMlE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,GAAG,EAAE,KAAK,GAAG,KAAG,OAiB5D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,GAAG,EAAE,KAAK,GAAG,KAAG,OACqB,CAAA;AAwFhF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,KAAG,MAGnE,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,eAAe,2DAA4D,CAAA;AAExF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAClB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA6C5C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,gBAAgB,EAAE,KAAK,GAAG,KAAG,MAWtE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,gBAAgB,EAAE,KAAK,GAAG,KAAG,MAOtE,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,GACzB,KAAK,gBAAgB,EACrB,KAAK,GAAG,EACR,OAAO,GAAG,EACV,mBAAe,KAChB,MAAM,GAAG,SAcX,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAAI,KAAK,gBAAgB,EAAE,KAAK,GAAG,KAAG,MAOzE,CAAA;AA+ID;;;;GAIG;AACH;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAA;IACd,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CACxC,CAqBA,CAAA;AAED,wBAAgB,4BAA4B,CACxC,OAAO,GAAE,qBAA0B,GACpC,iBAAiB,CA+mBnB;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBACL,CAAA"}

package/dist/dynamic-columns.js

@@ -622,7 +622,19 @@ export function makeDefaultGetDynamicColumns(helpers = {}) {
                                 col.tooltip ||
                                 col.displayField ||
                                 col.key;
-                            const name = getNestedValue(row.original, namePath) || 'N/A';
+                            // A `creator` cell with no resolved actor means the
+                            // record was created by the SYSTEM (e.g. an owner /
+                            // seed row whose `created_by` is null), not a missing
+                            // value — show "Sistema" rather than "N/A". Matches
+                            // the record-history actor fallback. `user`/`avatar`/
+                            // `search` keep "N/A" (empty there means unassigned).
+                            const resolvedName = getNestedValue(row.original, namePath);
+                            const name = resolvedName ||
+                                (renderAs === 'creator'
+                                    ? t
+                                        ? t('common.system', { defaultValue: 'Sistema' })
+                                        : 'Sistema'
+                                    : 'N/A');
                             const desc = getNestedValue(row.original, col.description || '');
                             const avatarSrc = resolveAvatarSrc(col, row.original, value, apiBaseUrl);
                             return (_jsx(AvatarCell, { name: String(name), desc: desc ? String(desc) : undefined, avatarSrc: avatarSrc, getImageUrl: getImageUrl }));

package/dist/entity-select.d.ts

@@ -0,0 +1,43 @@
+import { type LucideIcon } from 'lucide-react';
+/** One searchable option: `value` is the id, `label` the display text. */
+export interface EntitySelectOption {
+    value: string;
+    label: string;
+    description?: string;
+}
+export interface EntitySelectProps {
+    /** Kernel model key (e.g. "Supplier", "Warehouse", "Category"). */
+    model: string;
+    /** Currently selected id (or null). */
+    value: string | null;
+    /** Label of the selected record (rendered without a re-fetch). */
+    label: string | null;
+    /** Called with (id, label) on select/create/clear. */
+    onSelect: (id: string | null, label: string | null) => void;
+    /** Async search over the model. Callers pass their `/api/options/<model>` fetcher. */
+    fetcher: (q: string, signal: AbortSignal) => Promise<EntitySelectOption[]>;
+    icon?: LucideIcon;
+    placeholder?: string;
+    searchPlaceholder?: string;
+    emptyText?: string;
+    /** Preload first results on open and drop the 2-char gate. */
+    preload?: boolean;
+    /**
+     * Permission overrides. By default create/edit are gated by the kernel
+     * permissions `<model>.create` / `<model>.update` (useCan). Pass explicit
+     * booleans to force them (e.g. a read-only surface).
+     */
+    canCreate?: boolean;
+    canEdit?: boolean;
+    /**
+     * CRUD endpoint base for the create/edit dialog. Defaults to the standard
+     * org-scoped `/data/<model>/me`, with edit at `/data/<model>/me/<id>`.
+     */
+    endpoint?: string;
+    /** Record field used as the label after create/edit (default "name"). */
+    labelField?: string;
+    /** Disable the whole control. */
+    disabled?: boolean;
+}
+export declare function EntitySelect({ model, value, label, onSelect, fetcher, icon: Icon, placeholder, searchPlaceholder, emptyText, preload, canCreate, canEdit, endpoint, labelField, disabled, }: EntitySelectProps): import("react").JSX.Element;
+//# sourceMappingURL=entity-select.d.ts.map

package/dist/entity-select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-select.d.ts","sourceRoot":"","sources":["../src/entity-select.tsx"],"names":[],"mappings":"AAiBA,OAAO,EAA2B,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AAiBvE,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAC9B,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAA;IACb,uCAAuC;IACvC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,kEAAkE;IAClE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,sDAAsD;IACtD,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IAC3D,sFAAsF;IACtF,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAA;IAE1E,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACrB;AAOD,wBAAgB,YAAY,CAAC,EACzB,KAAK,EACL,KAAK,EACL,KAAK,EACL,QAAQ,EACR,OAAO,EACP,IAAI,EAAE,IAAI,EACV,WAA4B,EAC5B,iBAA6B,EAC7B,SAA4B,EAC5B,OAAe,EACf,SAAS,EACT,OAAO,EACP,QAAQ,EACR,UAAmB,EACnB,QAAgB,GACnB,EAAE,iBAAiB,+BAuNnB"}

package/dist/entity-select.js

@@ -0,0 +1,124 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// EntitySelect — the shared, permission-aware single-select for a related model.
+//
+// A searchable async combobox over a kernel model's records, plus the two
+// affordances every "pick a related record" control should have, exactly like
+// the dynamic create modal's relation fields (Categoría/Marca) do:
+//
+//   - nothing selected → a "+" that opens the model's CREATE dialog, and
+//     auto-selects the record it creates;
+//   - a record selected → a pencil that opens that record's EDIT dialog.
+//
+// Both affordances are gated by the kernel permissions (useCan): the "+" only
+// shows when the user can create the model, the pencil only when they can edit
+// it. Everything is DYNAMIC — the create/edit form comes from the model's
+// `/metadata/modal/:model` schema via <CreateRecordDialog>, so no per-model form
+// code is needed. This lives in the SDK so POS, purchases and any future addon
+// share ONE implementation instead of each re-porting a bespoke picker.
+import { useCallback, useEffect, useState } from 'react';
+import { Search, X, Plus, Pencil } from 'lucide-react';
+import { Button, Command, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, Popover, PopoverContent, PopoverTrigger, } from '@asteby/metacore-ui';
+import { CreateRecordDialog } from './dialogs/create-record-dialog';
+import { useCan } from './permissions-context';
+import { useApi } from './api-context';
+/** Lowercase model → permission capability namespace (Supplier → supplier). */
+function capabilityNamespace(model) {
+    return model.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toLowerCase();
+}
+export function EntitySelect({ model, value, label, onSelect, fetcher, icon: Icon, placeholder = 'Seleccionar…', searchPlaceholder = 'Buscar…', emptyText = 'Sin resultados', preload = false, canCreate, canEdit, endpoint, labelField = 'name', disabled = false, }) {
+    const can = useCan();
+    const api = useApi();
+    const ns = capabilityNamespace(model);
+    const mayCreate = canCreate ?? can(`${ns}.create`);
+    const mayEdit = canEdit ?? can(`${ns}.update`);
+    const base = endpoint ?? `/data/${model}/me`;
+    const [open, setOpen] = useState(false);
+    const [dialogOpen, setDialogOpen] = useState(false);
+    const [dialogRecordId, setDialogRecordId] = useState(undefined);
+    const [searchTerm, setSearchTerm] = useState('');
+    const [results, setResults] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const minChars = preload ? 0 : 2;
+    const run = useCallback(async (q, signal) => {
+        if (q.length < minChars) {
+            setResults([]);
+            return;
+        }
+        setIsLoading(true);
+        try {
+            const rows = await fetcher(q, signal);
+            if (!signal.aborted)
+                setResults(rows);
+        }
+        catch {
+            if (!signal.aborted)
+                setResults([]);
+        }
+        finally {
+            if (!signal.aborted)
+                setIsLoading(false);
+        }
+    }, [fetcher, minChars]);
+    useEffect(() => {
+        if (!open)
+            return;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => run(searchTerm, controller.signal), 250);
+        return () => {
+            clearTimeout(timeout);
+            controller.abort();
+        };
+    }, [searchTerm, run, open]);
+    const pick = (row) => {
+        onSelect(row.value, row.label);
+        setOpen(false);
+        setSearchTerm('');
+    };
+    const clear = (e) => {
+        e.stopPropagation();
+        onSelect(null, null);
+    };
+    const openCreate = (e) => {
+        e.stopPropagation();
+        setDialogRecordId(undefined);
+        setDialogOpen(true);
+    };
+    const openEdit = (e) => {
+        e.stopPropagation();
+        if (!value)
+            return;
+        setDialogRecordId(value);
+        setDialogOpen(true);
+    };
+    // Read the {id,label} off a saved record and select it. The transport
+    // matches the standard org-scoped CRUD the dynamic modal uses, so create/edit
+    // stay consistent with the rest of the app.
+    const selectSaved = (rec) => {
+        if (!rec)
+            return;
+        const id = rec.id != null ? String(rec.id) : value ?? '';
+        const lbl = (rec[labelField] != null && String(rec[labelField])) ||
+            (rec.name != null && String(rec.name)) ||
+            label ||
+            id;
+        onSelect(id, lbl);
+    };
+    return (_jsxs("div", { className: "flex items-center gap-1.5", children: [_jsxs(Popover, { open: open, onOpenChange: disabled ? undefined : setOpen, children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs(Button, { variant: "outline", disabled: disabled, className: "w-full flex-1 justify-start gap-2 font-normal", children: [Icon && _jsx(Icon, { className: "text-muted-foreground size-4 shrink-0" }), _jsx("span", { className: "flex-1 truncate text-left", children: label ?? placeholder }), value && (_jsx("span", { role: "button", tabIndex: 0, onClick: clear, onKeyDown: (e) => {
+                                        if (e.key === 'Enter' || e.key === ' ')
+                                            clear(e);
+                                    }, className: "hover:bg-accent ml-auto shrink-0 rounded-sm p-0.5", children: _jsx(X, { className: "size-3.5" }) }))] }) }), _jsx(PopoverContent, { className: "p-0", align: "start", style: { width: 'var(--radix-popover-trigger-width)' }, children: _jsxs(Command, { shouldFilter: false, children: [_jsx(CommandInput, { placeholder: searchPlaceholder, value: searchTerm, onValueChange: setSearchTerm }), _jsxs(CommandList, { children: [isLoading && (_jsx("div", { className: "text-muted-foreground py-4 text-center text-sm", children: "Buscando\u2026" })), !isLoading &&
+                                            searchTerm.length >= minChars &&
+                                            results.length === 0 && _jsx(CommandEmpty, { children: emptyText }), !isLoading && results.length > 0 && (_jsx(CommandGroup, { className: "max-h-64 overflow-auto", children: results.map((row) => (_jsxs(CommandItem, { value: row.value, onSelect: () => pick(row), className: "flex flex-col items-start gap-0.5", children: [_jsx("span", { className: "text-sm font-medium", children: row.label }), row.description && (_jsx("span", { className: "text-muted-foreground text-xs", children: row.description }))] }, row.value))) })), !isLoading && !preload && searchTerm.length < minChars && (_jsxs("div", { className: "text-muted-foreground flex flex-col items-center gap-1 py-6", children: [_jsx(Search, { className: "size-5" }), _jsx("span", { className: "text-xs", children: "Escribe al menos 2 caracteres" })] }))] })] }) })] }), value
+                ? mayEdit && (_jsx(Button, { type: "button", variant: "outline", size: "icon", disabled: disabled, onClick: openEdit, "aria-label": "Editar", title: "Editar", className: "shrink-0", children: _jsx(Pencil, { className: "size-4" }) }))
+                : mayCreate && (_jsx(Button, { type: "button", variant: "outline", size: "icon", disabled: disabled, onClick: openCreate, "aria-label": "Crear", title: "Crear", className: "shrink-0", children: _jsx(Plus, { className: "size-4" }) })), dialogOpen && (_jsx(CreateRecordDialog, { modelKey: model, open: dialogOpen, onOpenChange: setDialogOpen, recordId: dialogRecordId, endpoint: base, onCreate: async (data) => {
+                    const res = await api.post(base, data);
+                    const rec = (res.data?.data ?? res.data);
+                    selectSaved(rec);
+                    return rec.id != null ? { id: String(rec.id) } : undefined;
+                }, onUpdate: async (id, data) => {
+                    const res = await api.put(`${base}/${id}`, data);
+                    const rec = (res.data?.data ?? res.data);
+                    selectSaved({ id, ...rec });
+                    return { id: String(id) };
+                } }))] }));
+}

package/dist/index.d.ts

@@ -29,6 +29,8 @@ export * from './navigation-builder';
 export * from './i18n-provider';
 export * from './api-context';
 export * from './use-addon-settings';
+export * from './use-print-document';
+export * from './print-document-button';
 export * from './metadata-cache';
 export { ADDON_MANIFEST_CHANGED_TYPE, wireHotSwapInvalidation, useManifestHotSwapSubscriber, type AddonManifestChangedMessage, type ManifestHotSwapClient, type WireHotSwapInvalidationOptions, } from './manifest-hotswap-subscriber';
 export { useHotSwapReload, applyHotSwapReload, withVersionParam, clearFederationContainer, shortenHash, type HotSwapReloadStrategy, type HotSwapReloadConfig, type HotSwapReloadAction, type HotSwapReloadDeps, type UseHotSwapReloadResult, } from './hotswap-reload-policy';
@@ -43,6 +45,8 @@ export { DynamicRecordDialog, ViewValue } from './dialogs/dynamic-record';
 export { normalizeRefFieldsForSubmit } from './dialogs/normalize-submit';
 export type { DynamicRecordDialogProps, FieldDef, FieldOption, GetImageUrl } from './dialogs/dynamic-record';
 export { CreateRecordDialog } from './dialogs/create-record-dialog';
+export { EntitySelect } from './entity-select';
+export type { EntitySelectProps, EntitySelectOption } from './entity-select';
 export { ViewRecordDialog } from './dialogs/view-record-dialog';
 export type { ModelKey, ModelSchema, CreateResult, RecordDialogProps, CreateRecordDialogProps, ViewRecordDialogProps, } from './dialogs/types';
 export { ExportDialog } from './dialogs/export';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -34,6 +34,8 @@ export * from './navigation-builder';
 export * from './i18n-provider';
 export * from './api-context';
 export * from './use-addon-settings';
+export * from './use-print-document';
+export * from './print-document-button';
 export * from './metadata-cache';
 export { ADDON_MANIFEST_CHANGED_TYPE, wireHotSwapInvalidation, useManifestHotSwapSubscriber, } from './manifest-hotswap-subscriber';
 export { useHotSwapReload, applyHotSwapReload, withVersionParam, clearFederationContainer, shortenHash, } from './hotswap-reload-policy';
@@ -46,6 +48,7 @@ export { NIL_UUID, isNilUuid, normalizeNilUuid } from './nil-uuid';
 export { DynamicRecordDialog, ViewValue } from './dialogs/dynamic-record';
 export { normalizeRefFieldsForSubmit } from './dialogs/normalize-submit';
 export { CreateRecordDialog } from './dialogs/create-record-dialog';
+export { EntitySelect } from './entity-select';
 export { ViewRecordDialog } from './dialogs/view-record-dialog';
 export { ExportDialog } from './dialogs/export';
 export { ImportDialog } from './dialogs/import';

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

@@ -0,0 +1,21 @@
+import React from 'react';
+import { type PrintDocumentArgs } from './use-print-document';
+export interface PrintDocumentButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'onError'> {
+    /** Model KEY the document is declared against (e.g. "SalesOrder"). */
+    model: string;
+    /** Record id. */
+    id: string;
+    /** Document key from contributions.documents[].key (e.g. "sale_ticket"). */
+    documentKey: string;
+    /** print (default) | download | open — see usePrintDocument. */
+    mode?: PrintDocumentArgs['mode'];
+    /** Download filename (mode="download"). */
+    filename?: string;
+    /** Called if the fetch/print fails (surface it to a toast in the host). */
+    onError?: (err: unknown) => void;
+    /** Rendered while the PDF is being fetched, in place of children. */
+    pendingLabel?: React.ReactNode;
+    children?: React.ReactNode;
+}
+export declare function PrintDocumentButton({ model, id, documentKey, mode, filename, onError, pendingLabel, children, disabled, onClick, ...rest }: PrintDocumentButtonProps): React.JSX.Element;
+//# sourceMappingURL=print-document-button.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"print-document-button.d.ts","sourceRoot":"","sources":["../src/print-document-button.tsx"],"names":[],"mappings":"AASA,OAAO,KAAgC,MAAM,OAAO,CAAA;AACpD,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE/E,MAAM,WAAW,wBACb,SAAQ,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC;IACtE,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAA;IACb,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAA;IACnB,gEAAgE;IAChE,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;IAChC,qEAAqE;IACrE,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC7B;AAED,wBAAgB,mBAAmB,CAAC,EAChC,KAAK,EACL,EAAE,EACF,WAAW,EACX,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,GAAG,IAAI,EACV,EAAE,wBAAwB,qBA+B1B"}

package/dist/print-document-button.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// PrintDocumentButton — a drop-in button that prints/downloads a server-rendered
+// document via usePrintDocument, so an addon doesn't re-wire the hook + loading
+// state every time. Headless-friendly: it renders a plain <button> you style
+// with `className`, disables itself while the PDF is fetching, and reports
+// failures through `onError` (no toast dependency baked in).
+//
+// Example:
+//   <PrintDocumentButton model="SalesOrder" id={sale.id} documentKey="sale_ticket"
+//     className="btn">Imprimir ticket</PrintDocumentButton>
+import { useCallback, useState } from 'react';
+import { usePrintDocument } from './use-print-document';
+export function PrintDocumentButton({ model, id, documentKey, mode, filename, onError, pendingLabel, children, disabled, onClick, ...rest }) {
+    const printDocument = usePrintDocument();
+    const [busy, setBusy] = useState(false);
+    const handleClick = useCallback(async (e) => {
+        onClick?.(e);
+        if (e.defaultPrevented)
+            return;
+        setBusy(true);
+        try {
+            await printDocument({ model, id, key: documentKey, mode, filename });
+        }
+        catch (err) {
+            onError?.(err);
+        }
+        finally {
+            setBusy(false);
+        }
+    }, [printDocument, model, id, documentKey, mode, filename, onError, onClick]);
+    return (_jsx("button", { type: "button", ...rest, disabled: disabled || busy, "aria-busy": busy || undefined, onClick: handleClick, children: busy && pendingLabel != null ? pendingLabel : children }));
+}

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

@@ -0,0 +1,25 @@
+export interface PrintDocumentArgs {
+    /** The model KEY the document is declared against (e.g. "SalesOrder"). */
+    model: string;
+    /** The record id. */
+    id: string;
+    /** The document key from contributions.documents[].key (e.g. "sale_ticket"). */
+    key: string;
+    /**
+     * print  → open the PDF in a hidden iframe and fire the browser print dialog
+     *          (default; best for thermal tickets — one click to the printer).
+     * download → save the PDF to disk.
+     * 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"). */
+    filename?: string;
+}
+/**
+ * Returns a `printDocument(args)` callback. Resolves once the PDF has been
+ * fetched and the browser action (print/download/open) has been kicked off;
+ * rejects if the fetch fails (surface the error to a toast). Returns the blob
+ * URL created, revoked automatically after a minute.
+ */
+export declare function usePrintDocument(): ({ model, id, key, mode, filename, }: PrintDocumentArgs) => Promise<string>;
+//# sourceMappingURL=use-print-document.d.ts.map

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

@@ -0,0 +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"}

package/dist/use-print-document.js

@@ -0,0 +1,79 @@
+// usePrintDocument — THE standard primitive for printing/downloading a
+// server-rendered document (ticket, receipt, order) from any federated addon or
+// host surface, without each addon reimplementing PDF fetching.
+//
+// The host (ops) renders documents declared in an addon's
+// `contributions.documents[]` via a country/business-agnostic engine
+// (pdf_chrome + document_render + org branding) and serves them at:
+//
+//   GET /api/data/:model/:id/documents/:key.pdf  → application/pdf
+//
+// The endpoint is auth-gated (Bearer), so we CANNOT just window.open the URL —
+// that request carries no Authorization header and 401s. Instead we fetch the
+// PDF through the injected ApiClient (which carries the token), turn the bytes
+// into a blob URL, and print/download/open that. Re-printing is just calling
+// this again — the render is an idempotent GET.
+//
+// The ApiClient is a PEER via <ApiProvider> (same one useAddonSettings uses), so
+// this hook constructs no client of its own.
+import { useCallback } from 'react';
+import { useApi } from './api-context';
+/**
+ * Returns a `printDocument(args)` callback. Resolves once the PDF has been
+ * fetched and the browser action (print/download/open) has been kicked off;
+ * rejects if the fetch fails (surface the error to a toast). Returns the blob
+ * URL created, revoked automatically after a minute.
+ */
+export function usePrintDocument() {
+    const api = useApi();
+    return useCallback(async ({ model, id, key, mode = 'print', filename, }) => {
+        const url = `/data/${encodeURIComponent(model)}/${encodeURIComponent(id)}/documents/${encodeURIComponent(key)}.pdf`;
+        const res = await api.get(url, { responseType: 'blob' });
+        const blob = res.data instanceof Blob
+            ? res.data
+            : new Blob([res.data], { type: 'application/pdf' });
+        const blobUrl = URL.createObjectURL(blob);
+        const cleanup = () => setTimeout(() => URL.revokeObjectURL(blobUrl), 60_000);
+        if (mode === 'download') {
+            const a = document.createElement('a');
+            a.href = blobUrl;
+            a.download = filename || `${key}.pdf`;
+            document.body.appendChild(a);
+            a.click();
+            a.remove();
+            cleanup();
+            return blobUrl;
+        }
+        if (mode === 'open') {
+            window.open(blobUrl, '_blank');
+            cleanup();
+            return blobUrl;
+        }
+        // mode === 'print': hidden iframe + contentWindow.print(). This is the
+        // reliable cross-browser way to auto-open the print dialog for a PDF
+        // blob (window.open + print() is blocked by the PDF viewer in Chrome).
+        const iframe = document.createElement('iframe');
+        iframe.style.position = 'fixed';
+        iframe.style.right = '0';
+        iframe.style.bottom = '0';
+        iframe.style.width = '0';
+        iframe.style.height = '0';
+        iframe.style.border = '0';
+        iframe.src = blobUrl;
+        iframe.onload = () => {
+            try {
+                iframe.contentWindow?.focus();
+                iframe.contentWindow?.print();
+            }
+            catch {
+                // Popup/print blocked — fall back to opening the PDF.
+                window.open(blobUrl, '_blank');
+            }
+            // Keep the iframe around long enough for the print dialog to read it.
+            setTimeout(() => iframe.remove(), 60_000);
+            cleanup();
+        };
+        document.body.appendChild(iframe);
+        return blobUrl;
+    }, [api]);
+}

package/package.json

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

package/src/dynamic-columns.tsx

@@ -899,7 +899,20 @@ export function makeDefaultGetDynamicColumns(
                                 col.tooltip ||
                                 col.displayField ||
                                 col.key
-                            const name = getNestedValue(row.original, namePath) || 'N/A'
+                            // A `creator` cell with no resolved actor means the
+                            // record was created by the SYSTEM (e.g. an owner /
+                            // seed row whose `created_by` is null), not a missing
+                            // value — show "Sistema" rather than "N/A". Matches
+                            // the record-history actor fallback. `user`/`avatar`/
+                            // `search` keep "N/A" (empty there means unassigned).
+                            const resolvedName = getNestedValue(row.original, namePath)
+                            const name =
+                                resolvedName ||
+                                (renderAs === 'creator'
+                                    ? t
+                                        ? t('common.system', { defaultValue: 'Sistema' })
+                                        : 'Sistema'
+                                    : 'N/A')
                             const desc = getNestedValue(row.original, col.description || '')
 
                             const avatarSrc = resolveAvatarSrc(col, row.original, value, apiBaseUrl)

package/src/entity-select.tsx

@@ -0,0 +1,316 @@
+// EntitySelect — the shared, permission-aware single-select for a related model.
+//
+// A searchable async combobox over a kernel model's records, plus the two
+// affordances every "pick a related record" control should have, exactly like
+// the dynamic create modal's relation fields (Categoría/Marca) do:
+//
+//   - nothing selected → a "+" that opens the model's CREATE dialog, and
+//     auto-selects the record it creates;
+//   - a record selected → a pencil that opens that record's EDIT dialog.
+//
+// Both affordances are gated by the kernel permissions (useCan): the "+" only
+// shows when the user can create the model, the pencil only when they can edit
+// it. Everything is DYNAMIC — the create/edit form comes from the model's
+// `/metadata/modal/:model` schema via <CreateRecordDialog>, so no per-model form
+// code is needed. This lives in the SDK so POS, purchases and any future addon
+// share ONE implementation instead of each re-porting a bespoke picker.
+import { useCallback, useEffect, useState } from 'react'
+import { Search, X, Plus, Pencil, type LucideIcon } from 'lucide-react'
+import {
+    Button,
+    Command,
+    CommandEmpty,
+    CommandGroup,
+    CommandInput,
+    CommandItem,
+    CommandList,
+    Popover,
+    PopoverContent,
+    PopoverTrigger,
+} from '@asteby/metacore-ui'
+import { CreateRecordDialog } from './dialogs/create-record-dialog'
+import { useCan } from './permissions-context'
+import { useApi } from './api-context'
+
+/** One searchable option: `value` is the id, `label` the display text. */
+export interface EntitySelectOption {
+    value: string
+    label: string
+    description?: string
+}
+
+export interface EntitySelectProps {
+    /** Kernel model key (e.g. "Supplier", "Warehouse", "Category"). */
+    model: string
+    /** Currently selected id (or null). */
+    value: string | null
+    /** Label of the selected record (rendered without a re-fetch). */
+    label: string | null
+    /** Called with (id, label) on select/create/clear. */
+    onSelect: (id: string | null, label: string | null) => void
+    /** Async search over the model. Callers pass their `/api/options/<model>` fetcher. */
+    fetcher: (q: string, signal: AbortSignal) => Promise<EntitySelectOption[]>
+
+    icon?: LucideIcon
+    placeholder?: string
+    searchPlaceholder?: string
+    emptyText?: string
+    /** Preload first results on open and drop the 2-char gate. */
+    preload?: boolean
+
+    /**
+     * Permission overrides. By default create/edit are gated by the kernel
+     * permissions `<model>.create` / `<model>.update` (useCan). Pass explicit
+     * booleans to force them (e.g. a read-only surface).
+     */
+    canCreate?: boolean
+    canEdit?: boolean
+
+    /**
+     * CRUD endpoint base for the create/edit dialog. Defaults to the standard
+     * org-scoped `/data/<model>/me`, with edit at `/data/<model>/me/<id>`.
+     */
+    endpoint?: string
+    /** Record field used as the label after create/edit (default "name"). */
+    labelField?: string
+    /** Disable the whole control. */
+    disabled?: boolean
+}
+
+/** Lowercase model → permission capability namespace (Supplier → supplier). */
+function capabilityNamespace(model: string): string {
+    return model.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toLowerCase()
+}
+
+export function EntitySelect({
+    model,
+    value,
+    label,
+    onSelect,
+    fetcher,
+    icon: Icon,
+    placeholder = 'Seleccionar…',
+    searchPlaceholder = 'Buscar…',
+    emptyText = 'Sin resultados',
+    preload = false,
+    canCreate,
+    canEdit,
+    endpoint,
+    labelField = 'name',
+    disabled = false,
+}: EntitySelectProps) {
+    const can = useCan()
+    const api = useApi()
+
+    const ns = capabilityNamespace(model)
+    const mayCreate = canCreate ?? can(`${ns}.create`)
+    const mayEdit = canEdit ?? can(`${ns}.update`)
+    const base = endpoint ?? `/data/${model}/me`
+
+    const [open, setOpen] = useState(false)
+    const [dialogOpen, setDialogOpen] = useState(false)
+    const [dialogRecordId, setDialogRecordId] = useState<string | undefined>(undefined)
+    const [searchTerm, setSearchTerm] = useState('')
+    const [results, setResults] = useState<EntitySelectOption[]>([])
+    const [isLoading, setIsLoading] = useState(false)
+
+    const minChars = preload ? 0 : 2
+
+    const run = useCallback(
+        async (q: string, signal: AbortSignal) => {
+            if (q.length < minChars) {
+                setResults([])
+                return
+            }
+            setIsLoading(true)
+            try {
+                const rows = await fetcher(q, signal)
+                if (!signal.aborted) setResults(rows)
+            } catch {
+                if (!signal.aborted) setResults([])
+            } finally {
+                if (!signal.aborted) setIsLoading(false)
+            }
+        },
+        [fetcher, minChars],
+    )
+
+    useEffect(() => {
+        if (!open) return
+        const controller = new AbortController()
+        const timeout = setTimeout(() => run(searchTerm, controller.signal), 250)
+        return () => {
+            clearTimeout(timeout)
+            controller.abort()
+        }
+    }, [searchTerm, run, open])
+
+    const pick = (row: EntitySelectOption) => {
+        onSelect(row.value, row.label)
+        setOpen(false)
+        setSearchTerm('')
+    }
+
+    const clear = (e: React.MouseEvent) => {
+        e.stopPropagation()
+        onSelect(null, null)
+    }
+
+    const openCreate = (e: React.MouseEvent) => {
+        e.stopPropagation()
+        setDialogRecordId(undefined)
+        setDialogOpen(true)
+    }
+    const openEdit = (e: React.MouseEvent) => {
+        e.stopPropagation()
+        if (!value) return
+        setDialogRecordId(value)
+        setDialogOpen(true)
+    }
+
+    // Read the {id,label} off a saved record and select it. The transport
+    // matches the standard org-scoped CRUD the dynamic modal uses, so create/edit
+    // stay consistent with the rest of the app.
+    const selectSaved = (rec: Record<string, unknown> | undefined | null) => {
+        if (!rec) return
+        const id = rec.id != null ? String(rec.id) : value ?? ''
+        const lbl =
+            (rec[labelField] != null && String(rec[labelField])) ||
+            (rec.name != null && String(rec.name)) ||
+            label ||
+            id
+        onSelect(id, lbl)
+    }
+
+    return (
+        <div className="flex items-center gap-1.5">
+            <Popover open={open} onOpenChange={disabled ? undefined : setOpen}>
+                <PopoverTrigger asChild>
+                    <Button
+                        variant="outline"
+                        disabled={disabled}
+                        className="w-full flex-1 justify-start gap-2 font-normal"
+                    >
+                        {Icon && <Icon className="text-muted-foreground size-4 shrink-0" />}
+                        <span className="flex-1 truncate text-left">{label ?? placeholder}</span>
+                        {value && (
+                            <span
+                                role="button"
+                                tabIndex={0}
+                                onClick={clear}
+                                onKeyDown={(e) => {
+                                    if (e.key === 'Enter' || e.key === ' ')
+                                        clear(e as unknown as React.MouseEvent)
+                                }}
+                                className="hover:bg-accent ml-auto shrink-0 rounded-sm p-0.5"
+                            >
+                                <X className="size-3.5" />
+                            </span>
+                        )}
+                    </Button>
+                </PopoverTrigger>
+                <PopoverContent
+                    className="p-0"
+                    align="start"
+                    style={{ width: 'var(--radix-popover-trigger-width)' }}
+                >
+                    <Command shouldFilter={false}>
+                        <CommandInput
+                            placeholder={searchPlaceholder}
+                            value={searchTerm}
+                            onValueChange={setSearchTerm}
+                        />
+                        <CommandList>
+                            {isLoading && (
+                                <div className="text-muted-foreground py-4 text-center text-sm">
+                                    Buscando…
+                                </div>
+                            )}
+                            {!isLoading &&
+                                searchTerm.length >= minChars &&
+                                results.length === 0 && <CommandEmpty>{emptyText}</CommandEmpty>}
+                            {!isLoading && results.length > 0 && (
+                                <CommandGroup className="max-h-64 overflow-auto">
+                                    {results.map((row) => (
+                                        <CommandItem
+                                            key={row.value}
+                                            value={row.value}
+                                            onSelect={() => pick(row)}
+                                            className="flex flex-col items-start gap-0.5"
+                                        >
+                                            <span className="text-sm font-medium">{row.label}</span>
+                                            {row.description && (
+                                                <span className="text-muted-foreground text-xs">
+                                                    {row.description}
+                                                </span>
+                                            )}
+                                        </CommandItem>
+                                    ))}
+                                </CommandGroup>
+                            )}
+                            {!isLoading && !preload && searchTerm.length < minChars && (
+                                <div className="text-muted-foreground flex flex-col items-center gap-1 py-6">
+                                    <Search className="size-5" />
+                                    <span className="text-xs">Escribe al menos 2 caracteres</span>
+                                </div>
+                            )}
+                        </CommandList>
+                    </Command>
+                </PopoverContent>
+            </Popover>
+
+            {/* Selected → edit (pencil); empty → create (+). Each gated by perms. */}
+            {value
+                ? mayEdit && (
+                      <Button
+                          type="button"
+                          variant="outline"
+                          size="icon"
+                          disabled={disabled}
+                          onClick={openEdit}
+                          aria-label="Editar"
+                          title="Editar"
+                          className="shrink-0"
+                      >
+                          <Pencil className="size-4" />
+                      </Button>
+                  )
+                : mayCreate && (
+                      <Button
+                          type="button"
+                          variant="outline"
+                          size="icon"
+                          disabled={disabled}
+                          onClick={openCreate}
+                          aria-label="Crear"
+                          title="Crear"
+                          className="shrink-0"
+                      >
+                          <Plus className="size-4" />
+                      </Button>
+                  )}
+
+            {dialogOpen && (
+                <CreateRecordDialog
+                    modelKey={model}
+                    open={dialogOpen}
+                    onOpenChange={setDialogOpen}
+                    recordId={dialogRecordId}
+                    endpoint={base}
+                    onCreate={async (data) => {
+                        const res = await api.post(base, data)
+                        const rec = (res.data?.data ?? res.data) as Record<string, unknown>
+                        selectSaved(rec)
+                        return rec.id != null ? { id: String(rec.id) } : undefined
+                    }}
+                    onUpdate={async (id, data) => {
+                        const res = await api.put(`${base}/${id}`, data)
+                        const rec = (res.data?.data ?? res.data) as Record<string, unknown>
+                        selectSaved({ id, ...rec })
+                        return { id: String(id) }
+                    }}
+                />
+            )}
+        </div>
+    )
+}

package/src/index.ts

@@ -175,6 +175,8 @@ export * from './navigation-builder'
 export * from './i18n-provider'
 export * from './api-context'
 export * from './use-addon-settings'
+export * from './use-print-document'
+export * from './print-document-button'
 export * from './metadata-cache'
 export {
     ADDON_MANIFEST_CHANGED_TYPE,
@@ -242,6 +244,8 @@ export { DynamicRecordDialog, ViewValue } from './dialogs/dynamic-record'
 export { normalizeRefFieldsForSubmit } from './dialogs/normalize-submit'
 export type { DynamicRecordDialogProps, FieldDef, FieldOption, GetImageUrl } from './dialogs/dynamic-record'
 export { CreateRecordDialog } from './dialogs/create-record-dialog'
+export { EntitySelect } from './entity-select'
+export type { EntitySelectProps, EntitySelectOption } from './entity-select'
 export { ViewRecordDialog } from './dialogs/view-record-dialog'
 export type {
     ModelKey,

package/src/print-document-button.tsx

@@ -0,0 +1,75 @@
+// PrintDocumentButton — a drop-in button that prints/downloads a server-rendered
+// document via usePrintDocument, so an addon doesn't re-wire the hook + loading
+// state every time. Headless-friendly: it renders a plain <button> you style
+// with `className`, disables itself while the PDF is fetching, and reports
+// failures through `onError` (no toast dependency baked in).
+//
+// Example:
+//   <PrintDocumentButton model="SalesOrder" id={sale.id} documentKey="sale_ticket"
+//     className="btn">Imprimir ticket</PrintDocumentButton>
+import React, { useCallback, useState } from 'react'
+import { usePrintDocument, type PrintDocumentArgs } from './use-print-document'
+
+export interface PrintDocumentButtonProps
+    extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'onError'> {
+    /** Model KEY the document is declared against (e.g. "SalesOrder"). */
+    model: string
+    /** Record id. */
+    id: string
+    /** Document key from contributions.documents[].key (e.g. "sale_ticket"). */
+    documentKey: string
+    /** print (default) | download | open — see usePrintDocument. */
+    mode?: PrintDocumentArgs['mode']
+    /** Download filename (mode="download"). */
+    filename?: string
+    /** Called if the fetch/print fails (surface it to a toast in the host). */
+    onError?: (err: unknown) => void
+    /** Rendered while the PDF is being fetched, in place of children. */
+    pendingLabel?: React.ReactNode
+    children?: React.ReactNode
+}
+
+export function PrintDocumentButton({
+    model,
+    id,
+    documentKey,
+    mode,
+    filename,
+    onError,
+    pendingLabel,
+    children,
+    disabled,
+    onClick,
+    ...rest
+}: PrintDocumentButtonProps) {
+    const printDocument = usePrintDocument()
+    const [busy, setBusy] = useState(false)
+
+    const handleClick = useCallback(
+        async (e: React.MouseEvent<HTMLButtonElement>) => {
+            onClick?.(e)
+            if (e.defaultPrevented) return
+            setBusy(true)
+            try {
+                await printDocument({ model, id, key: documentKey, mode, filename })
+            } catch (err) {
+                onError?.(err)
+            } finally {
+                setBusy(false)
+            }
+        },
+        [printDocument, model, id, documentKey, mode, filename, onError, onClick],
+    )
+
+    return (
+        <button
+            type="button"
+            {...rest}
+            disabled={disabled || busy}
+            aria-busy={busy || undefined}
+            onClick={handleClick}
+        >
+            {busy && pendingLabel != null ? pendingLabel : children}
+        </button>
+    )
+}

package/src/use-print-document.ts

@@ -0,0 +1,112 @@
+// usePrintDocument — THE standard primitive for printing/downloading a
+// server-rendered document (ticket, receipt, order) from any federated addon or
+// host surface, without each addon reimplementing PDF fetching.
+//
+// The host (ops) renders documents declared in an addon's
+// `contributions.documents[]` via a country/business-agnostic engine
+// (pdf_chrome + document_render + org branding) and serves them at:
+//
+//   GET /api/data/:model/:id/documents/:key.pdf  → application/pdf
+//
+// The endpoint is auth-gated (Bearer), so we CANNOT just window.open the URL —
+// that request carries no Authorization header and 401s. Instead we fetch the
+// PDF through the injected ApiClient (which carries the token), turn the bytes
+// into a blob URL, and print/download/open that. Re-printing is just calling
+// this again — the render is an idempotent GET.
+//
+// The ApiClient is a PEER via <ApiProvider> (same one useAddonSettings uses), so
+// this hook constructs no client of its own.
+import { useCallback } from 'react'
+import { useApi } from './api-context'
+
+export interface PrintDocumentArgs {
+    /** The model KEY the document is declared against (e.g. "SalesOrder"). */
+    model: string
+    /** The record id. */
+    id: string
+    /** The document key from contributions.documents[].key (e.g. "sale_ticket"). */
+    key: string
+    /**
+     * print  → open the PDF in a hidden iframe and fire the browser print dialog
+     *          (default; best for thermal tickets — one click to the printer).
+     * download → save the PDF to disk.
+     * 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"). */
+    filename?: string
+}
+
+/**
+ * Returns a `printDocument(args)` callback. Resolves once the PDF has been
+ * fetched and the browser action (print/download/open) has been kicked off;
+ * rejects if the fetch fails (surface the error to a toast). Returns the blob
+ * URL created, revoked automatically after a minute.
+ */
+export function usePrintDocument() {
+    const api = useApi()
+    return useCallback(
+        async ({
+            model,
+            id,
+            key,
+            mode = 'print',
+            filename,
+        }: PrintDocumentArgs): Promise<string> => {
+            const url = `/data/${encodeURIComponent(model)}/${encodeURIComponent(
+                id,
+            )}/documents/${encodeURIComponent(key)}.pdf`
+            const res = await api.get(url, { responseType: 'blob' })
+            const blob =
+                res.data instanceof Blob
+                    ? res.data
+                    : new Blob([res.data], { type: 'application/pdf' })
+            const blobUrl = URL.createObjectURL(blob)
+            const cleanup = () => setTimeout(() => URL.revokeObjectURL(blobUrl), 60_000)
+
+            if (mode === 'download') {
+                const a = document.createElement('a')
+                a.href = blobUrl
+                a.download = filename || `${key}.pdf`
+                document.body.appendChild(a)
+                a.click()
+                a.remove()
+                cleanup()
+                return blobUrl
+            }
+
+            if (mode === 'open') {
+                window.open(blobUrl, '_blank')
+                cleanup()
+                return blobUrl
+            }
+
+            // mode === 'print': hidden iframe + contentWindow.print(). This is the
+            // reliable cross-browser way to auto-open the print dialog for a PDF
+            // blob (window.open + print() is blocked by the PDF viewer in Chrome).
+            const iframe = document.createElement('iframe')
+            iframe.style.position = 'fixed'
+            iframe.style.right = '0'
+            iframe.style.bottom = '0'
+            iframe.style.width = '0'
+            iframe.style.height = '0'
+            iframe.style.border = '0'
+            iframe.src = blobUrl
+            iframe.onload = () => {
+                try {
+                    iframe.contentWindow?.focus()
+                    iframe.contentWindow?.print()
+                } catch {
+                    // Popup/print blocked — fall back to opening the PDF.
+                    window.open(blobUrl, '_blank')
+                }
+                // Keep the iframe around long enough for the print dialog to read it.
+                setTimeout(() => iframe.remove(), 60_000)
+                cleanup()
+            }
+            document.body.appendChild(iframe)
+            return blobUrl
+        },
+        [api],
+    )
+}