@asteby/metacore-runtime-react 47.1.0 → 49.0.0

package/CHANGELOG.md

@@ -1,5 +1,56 @@
 # @asteby/metacore-runtime-react
 
+## 49.0.0
+
+### Minor Changes
+
+- 4d97e6b: «Crear desde» con renglones y cantidad pendiente en el DocumentEditor. Una fuente (`document_forms.types[].sources[]`) que declara `line_link_field`, `remaining_qty_field` o `remaining_endpoint` precarga sus renglones desde lo que sirve el host (`<endpoint>/source-lines`, kernel ≥ v0.191): la cantidad sugerida y el tope son lo pendiente (cantidad − lo ya facturado/devuelto, calculado en el servidor), los renglones ya cubiertos se omiten con un aviso breve y cada renglón guarda `source_line_id`, que se envía en la columna `line_link_field` para que el servidor valide al guardar (su rechazo en español se muestra tal cual). Sin `source-lines` (404) cae a la relación como antes. Un tipo con `sources` usa el editor salvo `layout: "wizard"`; `DocumentFormDialog` abre el editor cuando recibe `initialSource`, y `DynamicCRUDPage` acepta `initialCreate` para abrir el alta con tipo y origen (p. ej. desde la URL). Las acciones de fila `type: "link"` con query (`?create=…&from_id={id}`) navegan con `search` (antes la query quedaba en el path y la ruta no casaba); los valores interpolados van codificados. `serializeLineItems(lines, { sourceLineField })`, `sourceLoadSummary` y `sourceTracksRemaining` exportados del modelo del editor; cada renglón serializado lleva además `subtotal` y `tax_amount` calculados (modelos de renglón sin tasa no pierden el IVA) y `linesFromSource` respeta `discount_mode: "amount"`. i18n es/en de los avisos de carga.
+- f9616d1: Un solo registro para modales, slots y acciones, y acciones secundarias fuera de la vista principal:
+
+  - `@asteby/metacore-sdk` es la única fuente de verdad: `registerModalComponent` (modales por slug, con addon dueño y `load` perezoso), `registerRecordAction` (acciones secundarias sobre registros con su proveedor `requires: { addon | capability }`) y `slotStore`. `Registry.scope(addon).registerModal/registerAction/registerSlot` escriben ahí (antes `registerModal` no tenía lector) y `unbind` lo retira todo. `adaptActionProps` entrega a un remote ambos contratos de props (ActionModalProps y recordId/payload/close).
+  - `registerFederatedModal` queda como alias deprecado y compatible de `registerModalComponent`; `slotRegistry` y `<Slot>` de runtime-react leen el `slotStore` del SDK y no pintan contribuciones de addons no instalados.
+  - Acciones primarias/secundarias: `priority` del manifest v3 (o convención por clave: print, share, email, mail, whatsapp, chat, download, pdf, xml, acuse). `RowActionsMenu` (menú «…» por defecto de DynamicTable) muestra una primaria destacada y agrupa las secundarias y las aportadas por addons en «Más…»; las acciones por capacidad sin proveedor activo no se ofrecen. `DocumentPage` manda las secundarias de su layout a `DocumentSecondaryBar` (pie) y `resolveActions` devuelve el nuevo grupo `footer`.
+  - i18n: `datatable.more_actions`, `datatable.open_menu`, `datatable.secondary_actions` (es/en).
+
+### Patch Changes
+
+- b8a2ba3: Acciones abiertas desde una fila y buscador del host en documentos (retest Pitsline 2026-10-05)
+
+  - Un campo de acción que apunta al MISMO modelo de la fila y que la fila no tiene como columna se precarga con el id de esa fila: «Registrar pago» desde una factura abre con la factura elegida (`invoice_id` → Invoice). Una columna propia vacía (`parent_id` sin padre) no se siembra.
+  - `DocumentFormDialog` aplica el IVA de la org (`OrgRuntimeProvider` `taxRate`) a los productos del buscador del host (`searchProducts`) que no traen su tasa; antes sólo el buscador por defecto lo hacía y el renglón entraba sin IVA.
+
+- Updated dependencies [f9616d1]
+  - @asteby/metacore-sdk@3.14.0
+
+## 48.0.0
+
+### Minor Changes
+
+- 7532829: Primitivos de negocio para hosts y addons federados:
+
+  - `InstalledAddonsProvider` + `useAddonInstalled` / `useCapabilityProvided` / `useInstalledAddons`: una sola respuesta a «¿qué hay instalado?» (sin provider devuelven `undefined`, nunca «ausente»).
+  - `allocatePayment` / `validateAllocation` (PaymentAllocator) y `computeAging` / `bucketFor` (AgingTable) como funciones puras.
+  - Bandeja de aprobaciones: `approvalsClient`, `registerApprovalCategory`, `groupApprovals` y el tipo `ApprovalRequestDTO`.
+  - Contribuciones federadas por documento: `registerDocumentContribution` (con disposer y carga perezosa), `resolveContributions` (pura) y el hook `useDocumentContributions`.
+  - Modales federados: `registerFederatedModal` / `resolveFederatedModal`. `ActionModalDispatcher` pinta el modal registrado sin esperar al host y, si el addon del `modal` no está instalado, abre el formulario genérico de la acción de inmediato en lugar de esperar 20 s.
+  - Tipos de documento (`registerDocumentKind`, `CORE_DOCUMENT_KINDS`) y contratos de PartyCard / TotalsPanel / PreviewPanel / ValidationChecklist.
+  - Manifest `document_forms`: `lines.kind`, `lines.open_documents`, `sources`, `preview` y `submit_action` en los tipos.
+  - Ayudantes de captura por modelo: `registerRecordPrefill` (también en `registry.scope(addon)`, se retira en el `unbind`) y `RecordPrefillBar`, que `DynamicRecordDialog` monta arriba del formulario; solo aplica claves que el formulario declara.
+
+- 830349b: `DocumentEditor`: alta de documentos en una sola pantalla por secciones cuando el tipo de `document_forms` declara `layout: "editor"` (factura, nota de crédito, cobro/REP, cotización, OC). A la vista solo lo esencial (contraparte con su tarjeta, «Cargar desde…», renglones o reparto del pago, totales); los campos fiscales (`fiscal_data.*`, catálogos con default, contribuciones `header.fields`) van en «Opciones fiscales», plegada por defecto, y la vista previa también es opcional y plegada. Una sola acción primaria. Prefill desde el documento origen (`sources`, `initialSource`, `default_from_record` vía la nueva prop `record`) y validación inline. `lines.kind: "allocation"` reparte el cobro con `PaymentAllocator` (del más vencido o manual, con parcialidad) y guarda por `submit_action`. Nuevos exports: `DocumentEditor`, `PaymentAllocator`, `PartyCard`, `TotalsPanel`, `ValidationChecklist`, `PreviewPanel`, `CollapsibleSection`, `EditorSection` y las reglas puras de `document-editor-model`. Sin `layout: "editor"` el wizard sigue igual.
+- 7d1bdf9: Alta guiada acotada a la vista filtrada: `scopeDocumentFormsToFilter(forms, filter)` y la prop `filter` de `DynamicCRUDPage`. Si el filtro fijo de la vista (el `filter` del nav) va sobre el `type_field` de `document_forms`, «Crear» abre ese tipo directo; si no hay formulario para ese tipo, no se ofrece. Antes «Documentos fiscales → Facturas → Crear» abría el formulario del REP.
+- 9c34b09: Crear factura (DocumentFormDialog): el paso de renglones busca en el catálogo de productos aunque el host no pase `searchProducts`. Antes solo ofrecía «Renglón libre» y la factura se guardaba en $0. Al elegir un producto, el renglón entra con precio de venta, unidad, SKU, claves de extensión (`fiscal_data`), cantidad 1 y la tasa de impuesto del producto o, si no trae, la de la organización (`OrgRuntimeProvider taxRate`, nuevo). Nuevos: `createCatalogProductSearch`, props `productModel`/`defaultTaxRate` y `lines.discount_mode` en `document_forms`. Una cantidad vacía al leer renglones ya no queda en 0.
+
+### Patch Changes
+
+- 3c6e8eb: Corrige que al editar un registro (p. ej. un renglón dentro de una relación) un campo select con valor se borrara al guardar sin tocarlo. `DynamicForm` siembra los valores del registro de forma síncrona, ignora el `onValueChange('')` espurio del Select cuando ya hay valor y `''` no es opción válida, y en edición no manda selects vacíos que el usuario no tocó. `deriveRelationFormFields` ahora copia `readonly` de la columna, y el modal de alta/edición de renglón limita su alto al viewport con cuerpo con scroll y botones fijos abajo.
+- 153dff8: El formulario de alta/edición (`DynamicRecordDialog`) ya no muestra claves de catálogo crudas como etiqueta de campo (p. ej. `FISCAL_MEXICO.EXT.CUSTOMER.RFC_RECEPTOR` en los campos que un addon agrega por extensión a Clientes o Productos). Si la etiqueta llega del servidor sin resolver, se traduce con el catálogo del cliente y, si tampoco está ahí, se muestra legible (`Codigo Postal`). Las etiquetas que ya llegan en texto humano no se tocan. Nuevo helper exportado `localizeFieldLabel`.
+- db934ed: Kanban: los carriles de etapas ya no se pintan sobre otra columna. El host sirve un solo `group_by` por modelo, el del ÚLTIMO tablero de la navegación (en Taller, `service_bay_id`). Un tablero abierto sin `?group_by=` (por ejemplo, con el cambio de vista desde la lista) agrupaba las etapas por la bahía: todas las OT caían en «Sin etapa», los conteos de cada carril pedían `f_service_bay_id=diagnosis` (422) y al soltar una tarjeta se enviaba `service_bay_id = 'diagnosis'` (422 «no es un UUID válido»). `withGroupBy` ahora agrupa por el `stage_field` cuando no hay `?group_by=`. El tablero de la columna servida conserva la máquina de etapas solo si esa columna es la de etapas.
+- 4ed3225: Renglones de formularios de acción: cuando la columna `total` es el precio unitario (`price`, `unit_price`…) y el renglón tiene cantidad pero ninguna columna de importe, la fila de total suma cantidad × precio − descuento de cada renglón y ya no los precios sueltos. En la OT de taller, cantidad 2 × 750 mostraba 750 en el total, aunque al guardar quedaba bien (1500). Si hay columna de importe (`subtotal`, `line_total`…), el comportamiento no cambia.
+- f2e31cf: Las acciones por fila con `requiresState` se filtran contra el `stage_field` del modelo cuando hay máquina de etapas, igual que el kernel. Antes se comparaban con `status`, y por eso la OT de taller no mostraba «Procesar», «Esperar refacciones» ni «Cancelar» en la tabla ni en el kanban. Nuevo export `lifecycleStageField(metadata)`.
+- Updated dependencies [7532829]
+  - @asteby/metacore-sdk@3.13.0
+
 ## 47.1.0
 
 ### Minor Changes

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

@@ -65,8 +65,22 @@ export declare function prefillFromFieldRelationRequest(req: PrefillFromFieldReq
 } | null;
 export declare function unwrapRecordScalar(value: unknown): unknown;
 export declare function readRecordPath(record: any, path: string): unknown;
-/** Scalar seed for one action field from the row being acted on. */
-export declare function scalarDefaultFromRecord(field: ActionFieldDef, record: any): unknown;
+/**
+ * ¿`ref` (FK de un campo) apunta al modelo `model` de la fila? Tolera prefijo de
+ * addon, PascalCase vs tabla y el plural de la tabla (`Invoice` ↔ `invoices`,
+ * `CustomerAddress` ↔ `customer_addresses`).
+ */
+export declare function refTargetsModel(ref: string | undefined | null, model: string | undefined | null): boolean;
+/**
+ * Scalar seed for one action field from the row being acted on.
+ *
+ * Sin `default_from_record` declarado, un campo se siembra con la columna
+ * homónima de la fila; y un selector que apunta al MISMO modelo de la fila y
+ * que la fila no tiene como columna (`invoice_id` → Invoice en «Registrar pago»
+ * de una factura) se siembra con el id de esa fila: la acción se abrió desde
+ * ella (retest Pitsline 2026-10-05).
+ */
+export declare function scalarDefaultFromRecord(field: ActionFieldDef, record: any, model?: string): unknown;
 export declare function ActionModalDispatcher({ open, onOpenChange, action, model, record, endpoint, onSuccess: onSuccessProp, }: ActionModalProps): import("react").JSX.Element | null;
 /** How long an action with `modal` waits for its federated component. */
 export declare const FEDERATED_ACTION_MODAL_TIMEOUT_MS = 20000;
@@ -75,7 +89,7 @@ export declare const FEDERATED_ACTION_MODAL_TIMEOUT_MS = 20000;
  *  other failure (500, network) -> the server's own message and cause. Unlike
  *  the toast it stays on screen until the next attempt. */
 export declare function actionErrorBannerMessage(err: unknown, fields: readonly ActionFieldDef[] | undefined, t: Translate, language?: string): string;
-export declare function buildFieldDefaults(fields: ActionFieldDef[], record: any): Record<string, any>;
+export declare function buildFieldDefaults(fields: ActionFieldDef[], record: any, model?: string): Record<string, any>;
 /** Renders one action field (same widgets as the action modals). Shared with DocumentFormDialog. */
 export declare function renderField(field: ActionFieldDef, value: any, onChange: (value: any) => void, formValues?: Record<string, any>, record?: Record<string, any>, fieldErrors?: Record<string, string>): import("react").JSX.Element;
 //# sourceMappingURL=action-modal-dispatcher.d.ts.map

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

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

package/dist/action-modal-dispatcher.js

@@ -16,7 +16,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 // The host injects its axios-like client via <ApiProvider>; we no longer
 // depend on a bundler alias to `@/lib/api`.
 import { emitRecordMutation } from './record-mutation-events';
-import { useState, useCallback, useEffect, useMemo, useRef, useSyncExternalStore } from 'react';
+import { Suspense, useState, useCallback, useEffect, useMemo, useRef, useSyncExternalStore } from 'react';
 import { useTranslation } from 'react-i18next';
 import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, DialogFooter, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, Button, Input, Textarea, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Switch, } from '@asteby/metacore-ui/primitives';
 import { Loader2 } from 'lucide-react';
@@ -44,8 +44,11 @@ import { FieldGrid, FieldCell, FieldLabel } from './field-grid';
 import { useMetadataCache } from './metadata-cache';
 import { ViewValue, objectLabel, relationSiblingValue, isLineItemsField as isRecordLineItemsField, } from './dialogs/dynamic-record';
 // Canonical registry lives in @asteby/metacore-sdk
-import { getActionComponent, subscribeActionComponents, } from '@asteby/metacore-sdk';
+import { adaptActionProps, getActionComponent, subscribeActionComponents, } from '@asteby/metacore-sdk';
 import { requestFederatedAction } from './federated-action-loader';
+import { useInstalledAddons } from './installed-addons-context';
+import { federatedModalComponent, resolveFederatedModal } from './primitives/contributions';
+import { installedPredicate, useContributionsVersion } from './primitives/use-contributions';
 export function isPrefillSpec(v) {
     return (typeof v === 'object' &&
         v !== null &&
@@ -212,8 +215,46 @@ function defaultFromRecordSpec(field) {
     const f = field;
     return f.defaultFromRecord ?? f.default_from_record;
 }
-/** Scalar seed for one action field from the row being acted on. */
-export function scalarDefaultFromRecord(field, record) {
+/** `customers.Invoice`, `Invoice`, `invoices`, `sales_orders` → forma comparable. */
+function modelToken(m) {
+    const last = m.split('.').pop() ?? m;
+    return last.replace(/[^a-z0-9]/gi, '').toLowerCase();
+}
+/**
+ * ¿`ref` (FK de un campo) apunta al modelo `model` de la fila? Tolera prefijo de
+ * addon, PascalCase vs tabla y el plural de la tabla (`Invoice` ↔ `invoices`,
+ * `CustomerAddress` ↔ `customer_addresses`).
+ */
+export function refTargetsModel(ref, model) {
+    if (!ref || !model)
+        return false;
+    const a = modelToken(ref);
+    const b = modelToken(model);
+    if (!a || !b)
+        return false;
+    return a === b || a + 's' === b || a + 'es' === b || b + 's' === a || b + 'es' === a;
+}
+function fieldRef(field) {
+    if (field.ref)
+        return field.ref;
+    const opts = field.options;
+    if (opts && !Array.isArray(opts) && typeof opts === 'object') {
+        const src = opts.source;
+        if (typeof src === 'string' && src)
+            return src;
+    }
+    return undefined;
+}
+/**
+ * Scalar seed for one action field from the row being acted on.
+ *
+ * Sin `default_from_record` declarado, un campo se siembra con la columna
+ * homónima de la fila; y un selector que apunta al MISMO modelo de la fila y
+ * que la fila no tiene como columna (`invoice_id` → Invoice en «Registrar pago»
+ * de una factura) se siembra con el id de esa fila: la acción se abrió desde
+ * ella (retest Pitsline 2026-10-05).
+ */
+export function scalarDefaultFromRecord(field, record, model) {
     if (!record)
         return undefined;
     const spec = defaultFromRecordSpec(field);
@@ -233,6 +274,12 @@ export function scalarDefaultFromRecord(field, record) {
         const v = readRecordPath(record, field.key);
         if (v !== undefined && v !== null && v !== '')
             return v;
+        // Sólo si la fila NO tiene esa columna: un `parent_id` vacío de una
+        // categoría es «sin padre», no «yo mismo».
+        const id = unwrapRecordScalar(record.id);
+        if (!(field.key in record) && id !== undefined && id !== null && id !== '' && refTargetsModel(fieldRef(field), model)) {
+            return id;
+        }
     }
     return undefined;
 }
@@ -248,13 +295,29 @@ export function ActionModalDispatcher({ open, onOpenChange, action, model, recor
     // render, and a memoized lookup would pin the fallback forever.
     const readComponent = () => getActionComponent(model, action.key);
     const CustomComponent = useSyncExternalStore(subscribeActionComponents, readComponent, readComponent);
+    // Modal federado declarativo (registerFederatedModal). Si el addon dueño
+    // del slug consta como NO instalado, el `modal` se ignora y se usa el
+    // formulario genérico de la acción de inmediato (sin esperar el timeout).
+    useContributionsVersion();
+    const installed = useInstalledAddons();
+    const slug = action.modal || '';
+    const federatedModal = slug ? resolveFederatedModal(slug, installedPredicate(installed)) : null;
+    const modalAddonMissing = !!slug && !federatedModal && !!installed && !installed.addons.has(slug.split('.')[0]);
     if (CustomComponent) {
         return (_jsx(CustomComponent, { open: open, onOpenChange: onOpenChange, action: action, model: model, record: record, endpoint: endpoint, onSuccess: onSuccess }));
     }
+    if (federatedModal) {
+        // Modal por slug del store canónico: lo registró `api.registry.registerModal`
+        // (contrato recordId/payload/close) o registerFederatedModal
+        // (ActionModalProps). Recibe ambos contratos.
+        const FederatedComponent = federatedModalComponent(federatedModal);
+        return (_jsx(Suspense, { fallback: _jsx(LoadingActionDialog, { open: open, onOpenChange: onOpenChange, action: action }), children: _jsx(FederatedComponent, { ...adaptActionProps({ open, onOpenChange, action, model, record, endpoint, onSuccess }) }) }));
+    }
     // Declarative custom slot (`modal: "addon.action"`). Wait for the remote,
     // then a hard error — confirm/fields generics look "fine" and hide a
-    // missing remote.
-    if (action.modal) {
+    // missing remote. Exception: the slug's addon is known NOT installed — the
+    // remote will never come, so fall through to the generic form now.
+    if (action.modal && !modalAddonMissing) {
         return (_jsx(PendingCustomActionModal, { open: open, onOpenChange: onOpenChange, action: action, model: model }));
     }
     if (action.steps && action.steps.length > 0) {
@@ -288,7 +351,6 @@ const MODAL_SLUG_RE = /^[\w-]+(\.[\w-]+)+$/;
  * override from another addon that registerAction()s over it.
  */
 function PendingCustomActionModal({ open, onOpenChange, action, model, }) {
-    const { t } = useTranslation();
     const slug = action.modal || '';
     const [timedOut, setTimedOut] = useState(false);
     useEffect(() => {
@@ -329,6 +391,11 @@ function PendingCustomActionModal({ open, onOpenChange, action, model, }) {
     if (timedOut) {
         return _jsx(MissingCustomActionModal, { open: open, onOpenChange: onOpenChange, action: action, model: model });
     }
+    return _jsx(LoadingActionDialog, { open: open, onOpenChange: onOpenChange, action: action });
+}
+/** Diálogo «Cargando…» mientras llega el componente federado de la acción. */
+function LoadingActionDialog({ open, onOpenChange, action, }) {
+    const { t } = useTranslation();
     return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { children: [_jsxs(DialogHeader, { children: [_jsx(DialogTitle, { children: t(action.label, { defaultValue: action.label }) }), _jsx(DialogDescription, { children: t('dynamic.action_modal_loading', { defaultValue: 'Cargando…' }) })] }), _jsx("div", { className: "flex justify-center py-6", "data-testid": "federated-action-loading", children: _jsx(Loader2, { className: "h-6 w-6 animate-spin text-muted-foreground" }) })] }) }));
 }
 /** Shown when the action declares `modal` but no federated component registered. */
@@ -657,11 +724,11 @@ function GenericActionModal({ open, onOpenChange, action, model, record, endpoin
     }, [open, model, recordId, api]);
     useEffect(() => {
         if (open && action.fields) {
-            setFormData(buildFieldDefaults(action.fields, record));
+            setFormData(buildFieldDefaults(action.fields, record, model));
             setFieldErrors({});
             setFormError(undefined);
         }
-    }, [open, action.fields, record]);
+    }, [open, action.fields, record, model]);
     // Lines the list row does not carry: load them from the declared relation
     // (see prefillRelationRequests) and seed the line-items grid.
     useEffect(() => {
@@ -870,7 +937,7 @@ function GenericActionModal({ open, onOpenChange, action, model, record, endpoin
 // buildFieldDefaults seeds formData for a set of action fields, honoring the
 // same line-items prefill spec + boolean/empty rules GenericActionModal uses, so
 // wizard steps and single-page forms initialize identically.
-export function buildFieldDefaults(fields, record) {
+export function buildFieldDefaults(fields, record, model) {
     const defaults = {};
     for (const field of fields) {
         if (isLineItemsField(field)) {
@@ -882,7 +949,7 @@ export function buildFieldDefaults(fields, record) {
                     : [];
             continue;
         }
-        const fromRecord = scalarDefaultFromRecord(field, record);
+        const fromRecord = scalarDefaultFromRecord(field, record, model);
         if (fromRecord !== undefined && fromRecord !== null && fromRecord !== '') {
             defaults[field.key] = fromRecord;
             continue;
@@ -925,10 +992,10 @@ function WizardActionModal({ open, onOpenChange, action, model, record, endpoint
         if (!open)
             return;
         const allFields = steps.flatMap((s) => s.fields ?? []);
-        setFormData(buildFieldDefaults(allFields, record));
+        setFormData(buildFieldDefaults(allFields, record, model));
         setStepIndex(0);
         setFormError(undefined);
-    }, [open, action.steps, record]);
+    }, [open, action.steps, record, model]);
     const updateField = (key, value) => setFormData((prev) => ({ ...prev, [key]: value }));
     const step = steps[stepIndex];
     const isLast = stepIndex === steps.length - 1;

package/dist/action-priority.d.ts

@@ -0,0 +1,34 @@
+import type { ActionPriority } from '@asteby/metacore-sdk';
+import type { InstalledAddonsValue } from './installed-addons-context';
+export type { ActionPriority };
+/** Lo mínimo que se lee de una acción de metadata para clasificarla. */
+export interface PrioritizableAction {
+    key: string;
+    priority?: string;
+    trigger?: {
+        type?: string;
+        capability?: string;
+    } | null;
+}
+/** "primary" | "secondary" | undefined (= acción normal del menú). */
+export declare function classifyActionPriority(action: PrioritizableAction): ActionPriority | undefined;
+export interface SplitActions<A> {
+    /** La única destacada (la primera que se declara `primary`). */
+    primary?: A;
+    /** El resto de acciones principales, en orden. */
+    main: A[];
+    /** Compartir / imprimir / correo / chat… */
+    secondary: A[];
+}
+/**
+ * Separa primaria, principales y secundarias conservando el orden. Si varias
+ * reclaman `primary`, sólo la primera lo es; las demás quedan como principales.
+ */
+export declare function splitActionsByPriority<A extends PrioritizableAction>(actions: readonly A[]): SplitActions<A>;
+/**
+ * Una acción que despacha por capacidad (`trigger.type: "capability"`) sólo se
+ * ofrece si algún addon instalado la provee. Sin provider = desconocido → se
+ * muestra (el servidor revalida igual).
+ */
+export declare function isActionProviderActive(action: PrioritizableAction, installed: InstalledAddonsValue | null): boolean;
+//# sourceMappingURL=action-priority.d.ts.map

package/dist/action-priority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-priority.d.ts","sourceRoot":"","sources":["../src/action-priority.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAEtE,YAAY,EAAE,cAAc,EAAE,CAAA;AAE9B,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAC1D;AAqBD,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,cAAc,GAAG,SAAS,CAS9F;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC3B,gEAAgE;IAChE,OAAO,CAAC,EAAE,CAAC,CAAA;IACX,kDAAkD;IAClD,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,4CAA4C;IAC5C,SAAS,EAAE,CAAC,EAAE,CAAA;CACjB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,mBAAmB,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,CAW5G;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,EAAE,SAAS,EAAE,oBAAoB,GAAG,IAAI,GAAG,OAAO,CAInH"}

package/dist/action-priority.js

@@ -0,0 +1,60 @@
+// Segmentos de la clave (separados por _ . -) que marcan una acción de
+// compartir/salida. Por segmento: `create_mailbox` no es «mail», `send` solo
+// (enviar una cotización) sigue siendo flujo principal.
+const SECONDARY_SEGMENTS = new Set([
+    'print',
+    'reprint',
+    'share',
+    'email',
+    'mail',
+    'whatsapp',
+    'chat',
+    'download',
+    'pdf',
+    'xml',
+    'acuse',
+]);
+const CRUD_KEYS = new Set(['view', 'edit', 'delete']);
+/** "primary" | "secondary" | undefined (= acción normal del menú). */
+export function classifyActionPriority(action) {
+    if (action.priority === 'primary' || action.priority === 'secondary')
+        return action.priority;
+    if (CRUD_KEYS.has(action.key))
+        return undefined;
+    return action.key
+        .toLowerCase()
+        .split(/[_.-]+/)
+        .some((seg) => SECONDARY_SEGMENTS.has(seg))
+        ? 'secondary'
+        : undefined;
+}
+/**
+ * Separa primaria, principales y secundarias conservando el orden. Si varias
+ * reclaman `primary`, sólo la primera lo es; las demás quedan como principales.
+ */
+export function splitActionsByPriority(actions) {
+    let primary;
+    const main = [];
+    const secondary = [];
+    for (const a of actions) {
+        const p = classifyActionPriority(a);
+        if (p === 'secondary')
+            secondary.push(a);
+        else if (p === 'primary' && !primary)
+            primary = a;
+        else
+            main.push(a);
+    }
+    return { primary, main, secondary };
+}
+/**
+ * Una acción que despacha por capacidad (`trigger.type: "capability"`) sólo se
+ * ofrece si algún addon instalado la provee. Sin provider = desconocido → se
+ * muestra (el servidor revalida igual).
+ */
+export function isActionProviderActive(action, installed) {
+    const t = action.trigger;
+    if (!installed || !t || t.type !== 'capability' || !t.capability)
+        return true;
+    return installed.capabilities.has(t.capability);
+}

package/dist/business/catalog-product-search.d.ts

@@ -0,0 +1,32 @@
+import type { ProductQuery, ProductResult } from './product-search';
+interface ApiLike {
+    get: (url: string, cfg?: {
+        params?: Record<string, unknown>;
+        signal?: AbortSignal;
+    }) => Promise<{
+        data: any;
+    }>;
+}
+export interface CatalogProductSearchOptions {
+    /** Modelo de catálogo. Default `products.Product`. */
+    model?: string;
+    /** Endpoint de listado. Default `/data/<model>`. */
+    endpoint?: string;
+    limit?: number;
+    /** Tasa de impuesto cuando el producto no trae la suya (config fiscal de la org; p. ej. 0.16). */
+    defaultTaxRate?: number;
+}
+/** Proyección pura registro del catálogo → ProductResult (exportada para tests). */
+export declare function catalogRecordToProduct(rec: Record<string, any>, defaultTaxRate?: number): ProductResult;
+export declare function createCatalogProductSearch(api: ApiLike, opts?: CatalogProductSearchOptions): (query: Exclude<ProductQuery, {
+    kind: "empty";
+}>, signal: AbortSignal) => Promise<ProductResult[]>;
+/**
+ * Buscador del host (`searchProducts`) con el IVA de la org como respaldo: un
+ * producto que no trae su tasa entra con la de la org en vez de 0 (retest
+ * Pitsline 2026-10-05: el buscador de ops no devolvía tasa y el renglón de la
+ * factura quedaba sin IVA). Sin tasa de org, el buscador queda tal cual.
+ */
+export declare function withDefaultTaxRate<Q, S>(search: (query: Q, signal: S) => Promise<ProductResult[]>, defaultTaxRate: number | undefined): (query: Q, signal: S) => Promise<ProductResult[]>;
+export {};
+//# sourceMappingURL=catalog-product-search.d.ts.map

package/dist/business/catalog-product-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-product-search.d.ts","sourceRoot":"","sources":["../../src/business/catalog-product-search.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEnE,UAAU,OAAO;IACb,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,CAAA;KAAE,CAAC,CAAA;CACjH;AAED,MAAM,WAAW,2BAA2B;IACxC,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kGAAkG;IAClG,cAAc,CAAC,EAAE,MAAM,CAAA;CAC1B;AA4BD,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,aAAa,CAkBvG;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE,2BAAgC,IAI7E,OAAO,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,EAAE,QAAQ,WAAW,KAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAShH;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EACnC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,EACzD,cAAc,EAAE,MAAM,GAAG,SAAS,GACnC,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAMnD"}

package/dist/business/catalog-product-search.js

@@ -0,0 +1,71 @@
+const num = (v) => {
+    const n = typeof v === 'string' && v.trim() !== '' ? Number(v) : typeof v === 'number' ? v : NaN;
+    return Number.isFinite(n) ? n : undefined;
+};
+const str = (v) => (typeof v === 'string' && v.trim() ? v.trim() : undefined);
+/** Tasa como fracción: acepta 0.16 o 16. */
+const rate = (v) => {
+    const n = num(v);
+    if (n == null || n < 0)
+        return undefined;
+    return n > 1 ? n / 100 : n;
+};
+const bag = (v) => {
+    if (typeof v === 'string') {
+        try {
+            const parsed = JSON.parse(v);
+            return parsed && typeof parsed === 'object' ? parsed : {};
+        }
+        catch {
+            return {};
+        }
+    }
+    return v && typeof v === 'object' ? v : {};
+};
+/** Proyección pura registro del catálogo → ProductResult (exportada para tests). */
+export function catalogRecordToProduct(rec, defaultTaxRate) {
+    // Campos de extensión de otros addons (p. ej. claves SAT de fiscal_mexico).
+    const extensions = Object.fromEntries(Object.entries(bag(rec.fiscal_data)).filter(([, v]) => typeof v === 'string' && v !== ''));
+    const pt = String(rec.product_type ?? '');
+    return {
+        id: String(rec.id ?? rec.value ?? ''),
+        name: String(rec.name ?? rec.label ?? ''),
+        sku: str(rec.sku),
+        barcode: str(rec.barcode),
+        kind: pt === 'service' ? 'service' : 'product',
+        price: num(rec.unit_price ?? rec.sale_price ?? rec.price),
+        cost: num(rec.cost_price ?? rec.cost),
+        tax_rate: rate(rec.tax_rate) ?? defaultTaxRate,
+        unit: str(rec.unit_of_measure) ?? str(rec.unit),
+        extensions: Object.keys(extensions).length ? extensions : undefined,
+    };
+}
+export function createCatalogProductSearch(api, opts = {}) {
+    const model = opts.model ?? 'products.Product';
+    const url = opts.endpoint ?? `/data/${model}`;
+    const limit = opts.limit ?? 20;
+    return async (query, signal) => {
+        const search = query.kind === 'barcode' ? query.barcode : query.raw.trim();
+        const res = await api.get(url, { params: { search, per_page: limit }, signal });
+        const rows = res?.data?.data;
+        if (!Array.isArray(rows))
+            return [];
+        return rows
+            .filter((r) => r && typeof r === 'object' && r.is_active !== false)
+            .map((r) => catalogRecordToProduct(r, opts.defaultTaxRate));
+    };
+}
+/**
+ * Buscador del host (`searchProducts`) con el IVA de la org como respaldo: un
+ * producto que no trae su tasa entra con la de la org en vez de 0 (retest
+ * Pitsline 2026-10-05: el buscador de ops no devolvía tasa y el renglón de la
+ * factura quedaba sin IVA). Sin tasa de org, el buscador queda tal cual.
+ */
+export function withDefaultTaxRate(search, defaultTaxRate) {
+    if (defaultTaxRate == null)
+        return search;
+    return async (query, signal) => {
+        const rows = await search(query, signal);
+        return rows.map((p) => (p.tax_rate == null ? { ...p, tax_rate: defaultTaxRate } : p));
+    };
+}

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

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/business/catalog.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IAClC,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,uCAAuC;IACvC,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,kDAAkD;IAClD,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,eAAO,MAAM,mBAAmB,EAAE,SAAS,qBAAqB,EAsGtD,CAAA"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/business/catalog.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IAClC,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,uCAAuC;IACvC,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,kDAAkD;IAClD,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,eAAO,MAAM,mBAAmB,EAAE,SAAS,qBAAqB,EAwGtD,CAAA"}

package/dist/business/catalog.js

@@ -33,6 +33,8 @@ export const BUSINESS_COMPONENTS = [
             'applyProductToLine',
             'addProductLine',
             'lineGridKeyCommand',
+            'createCatalogProductSearch',
+            'catalogRecordToProduct',
         ],
     },
     {

package/dist/business/document-editor-model.d.ts

@@ -0,0 +1,119 @@
+import { type LineItem } from './line-items';
+import type { Allocation, AllocationIssue, OpenDocument } from '../primitives/allocation';
+import type { ActionFieldDef, DocumentFormLines, DocumentFormSource, DocumentFormOpenDocuments, DocumentFormsManifest, DocumentFormType } from '../types';
+export declare const EXTENSION_PREFIX = "fiscal_data.";
+export type EditorLinesConfig = DocumentFormLines & {
+    field: string;
+};
+/** true si el tipo se abre en el DocumentEditor (`layout: "editor"`). */
+export declare function isEditorLayout(type: Pick<DocumentFormType, 'layout' | 'sources'> | null | undefined): boolean;
+/** Paso de renglones efectivo del tipo (o undefined si no tiene). */
+export declare function editorLinesConfig(type: DocumentFormType, forms: Pick<DocumentFormsManifest, 'lines_field'>): EditorLinesConfig | undefined;
+/**
+ * Divulgación progresiva: ¿el campo va plegado en «Opciones fiscales»?
+ *  - campos de extensión (`fiscal_data.*`) que aportan otros addons;
+ *  - `section: "fiscal" | "advanced"`;
+ *  - catálogos opcionales que ya traen un default (método, serie, relación…):
+ *    el usuario no necesita tocarlos para guardar.
+ * Lo obligatorio sin default, la contraparte y el monto siempre están a la vista.
+ */
+export declare function isAdvancedField(f: ActionFieldDef, essentialKeys?: ReadonlySet<string>): boolean;
+export interface EditorFieldGroups {
+    /** Campo que elige la contraparte (cliente/proveedor), si el tipo la declara. */
+    party?: ActionFieldDef;
+    /** A la vista: lo esencial del encabezado. */
+    essential: ActionFieldDef[];
+    /** Plegados en «Opciones fiscales». */
+    advanced: ActionFieldDef[];
+    /** Notas largas (textarea): al final. */
+    notes: ActionFieldDef[];
+}
+/** Reparte los campos del tipo (más los de extensión) en grupos de pantalla. */
+export declare function splitEditorFields(fields: readonly ActionFieldDef[], opts?: {
+    partyField?: string;
+    essentialKeys?: readonly string[];
+    extensionFields?: readonly ActionFieldDef[];
+}): EditorFieldGroups;
+/**
+ * Etiqueta clara con el código como dato secundario:
+ * `03 · Transferencia electrónica` → `Transferencia electrónica · 03`.
+ * Solo reordena el patrón «CÓDIGO · texto»; cualquier otra etiqueta pasa igual.
+ */
+export declare function friendlyOptionLabel(label: string): string;
+/** El mismo campo con sus opciones en formato «texto · código». */
+export declare function withFriendlyOptions(f: ActionFieldDef): ActionFieldDef;
+/**
+ * Defaults del encabezado que salen de la contraparte: los campos de extensión
+ * con la MISMA clave en ambos modelos (p. ej. `fiscal_data.uso_cfdi` de Customer
+ * → `fiscal_data.uso_cfdi` del documento) y la moneda.
+ * Solo llena lo que está vacío: nunca pisa lo que el usuario ya capturó.
+ */
+export declare function partyDefaults(party: Record<string, any> | null, documentFieldKeys: readonly string[], current: Record<string, unknown>): Record<string, unknown>;
+/** Filas de la tarjeta de contraparte: resumen declarado + extensiones (máximo `limit`). */
+export declare function partySummaryRows(party: Record<string, any> | null, summary?: readonly string[], labels?: Record<string, string>, limit?: number): Array<{
+    key: string;
+    label: string;
+    value: string;
+}>;
+export interface CreditStatus {
+    limit?: number;
+    balance?: number;
+    overdue?: number;
+    available?: number;
+    holdReason?: string;
+    /** `ok` | `warn` (supera 80 % o hay vencido) | `block` (retenido o sin crédito disponible). */
+    level: 'ok' | 'warn' | 'block';
+}
+export declare function creditStatus(party: Record<string, any> | null, cols: {
+    limit?: string;
+    balance?: string;
+    overdue?: string;
+    hold_reason?: string;
+} | undefined, documentTotal: number): CreditStatus | null;
+/**
+ * Renglones de un documento origen → LineItem. `map` traduce nombres
+ * (`description: product_name`, `discount: discount_pct`). Si el origen trae
+ * `tax_amount` y `subtotal` pero no la tasa, la deriva. `credit` (NC) topa la
+ * cantidad en lo facturado (o en `max_quantity` si el origen la trae).
+ *
+ * Con `remaining_quantity` (lo sirve el host: cantidad − lo ya facturado o
+ * devuelto) la cantidad sugerida y el tope son lo pendiente y los renglones ya
+ * cubiertos se omiten. Cada línea guarda `source_line_id` para el vínculo.
+ */
+export declare function linesFromSource(rows: unknown, map?: Record<string, string>, opts?: {
+    kind?: DocumentFormLines['kind'];
+    discountMode?: DocumentFormLines['discount_mode'];
+}): LineItem[];
+/** Cuántos renglones del origen se cargaron y cuántos se omitieron por estar ya cubiertos. */
+export declare function sourceLoadSummary(rows: unknown): {
+    loaded: number;
+    covered: number;
+};
+/** Fuente que precarga desde lo pendiente servido por el host (no desde la relación cruda). */
+export declare function sourceTracksRemaining(src: Pick<DocumentFormSource, 'line_link_field' | 'remaining_qty_field' | 'remaining_endpoint'>): boolean;
+export interface EditorIssue {
+    field?: string;
+    severity: 'error' | 'warning';
+    message: string;
+}
+/** Revisión local (instantánea) de los renglones. Sin ruido: solo lo que hay que mirar. */
+export declare function localIssues(lines: LineItem[], opts?: {
+    requireLines?: boolean;
+    requireTax?: boolean;
+}): EditorIssue[];
+/** Documento abierto (fila de /data) → OpenDocument para PaymentAllocator. */
+export declare function toOpenDocuments(rows: unknown, cfg: DocumentFormOpenDocuments, currency: string): OpenDocument[];
+/** Monto actual de cada documento, para pasar a modo manual sin perder lo repartido. */
+export declare function manualFromAllocations(allocations: readonly Allocation[]): Record<string, number>;
+/** Renglones del payload: solo los dos campos que declara la acción (`invoice_id`, `amount`). */
+export declare function allocationPayload(allocations: readonly Allocation[], cfg: DocumentFormOpenDocuments): Array<Record<string, unknown>>;
+/**
+ * Campo del encabezado con el monto recibido: `amount` si existe; si no, el
+ * primer campo numérico/moneda. Convención documentada (el schema no lo nombra).
+ */
+export declare function allocationAmountField(fields: readonly ActionFieldDef[]): string | undefined;
+/** AllocationIssue → mensaje en español claro (con el número del documento). */
+export declare function allocationIssueMessages(issues: readonly AllocationIssue[], docs: readonly OpenDocument[]): EditorIssue[];
+/** Días de atraso de un documento abierto (0 si no está vencido o no tiene vencimiento). */
+export declare function overdueDays(doc: Pick<OpenDocument, 'due_at'>, today?: Date): number;
+//# sourceMappingURL=document-editor-model.d.ts.map