@asteby/metacore-runtime-react 47.1.0 → 48.0.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @asteby/metacore-runtime-react
 
+## 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.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';
@@ -46,6 +46,9 @@ import { ViewValue, objectLabel, relationSiblingValue, isLineItemsField as isRec
 // Canonical registry lives in @asteby/metacore-sdk
 import { 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 &&
@@ -248,13 +251,26 @@ 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) {
+        const FederatedComponent = federatedModalComponent(federatedModal);
+        return (_jsx(Suspense, { fallback: _jsx(LoadingActionDialog, { open: open, onOpenChange: onOpenChange, action: action }), children: _jsx(FederatedComponent, { open: open, onOpenChange: onOpenChange, action: action, model: model, record: record, endpoint: endpoint, onSuccess: 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 +304,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 +344,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. */

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

@@ -0,0 +1,25 @@
+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[]>;
+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"}

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

@@ -0,0 +1,57 @@
+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));
+    };
+}

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,107 @@
+import { type LineItem } from './line-items';
+import type { Allocation, AllocationIssue, OpenDocument } from '../primitives/allocation';
+import type { ActionFieldDef, DocumentFormLines, 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'> | 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).
+ */
+export declare function linesFromSource(rows: unknown, map?: Record<string, string>, opts?: {
+    kind?: DocumentFormLines['kind'];
+}): LineItem[];
+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

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

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

package/dist/business/document-editor-model.js

@@ -0,0 +1,279 @@
+// Reglas puras del DocumentEditor (sin React ni host): qué se ve a primera
+// vista y qué va en «Opciones fiscales», qué copiar de la contraparte, cómo
+// traer renglones de un documento origen, cómo repartir un cobro entre los
+// documentos abiertos y qué revisar antes de guardar. Genérico: factura,
+// cotización, pedido, OC, nota de crédito y cobro/REP. El SDK no conoce CFDI.
+import { roundMoney, toAmount } from './format';
+import { computeTotals, makeLine } from './line-items';
+import { optionPassesRule, getOptionFilter } from '../option-filter';
+export const EXTENSION_PREFIX = 'fiscal_data.';
+/** Secciones de campo que el editor pliega en «Opciones fiscales». */
+const ADVANCED_SECTIONS = new Set(['fiscal', 'advanced']);
+/** true si el tipo se abre en el DocumentEditor (`layout: "editor"`). */
+export function isEditorLayout(type) {
+    return type?.layout === 'editor';
+}
+/** Paso de renglones efectivo del tipo (o undefined si no tiene). */
+export function editorLinesConfig(type, forms) {
+    if (!type.lines)
+        return undefined;
+    const cfg = type.lines === true ? {} : type.lines;
+    const fallback = cfg.kind === 'allocation' ? 'allocations' : 'lines';
+    return { ...cfg, field: cfg.field ?? forms.lines_field ?? fallback };
+}
+/** Lee `a.b.c` de un registro (incluye `fiscal_data.x` dentro del jsonb). */
+function readPath(rec, path) {
+    if (!rec)
+        return undefined;
+    if (path in rec)
+        return rec[path];
+    return path.split('.').reduce((acc, k) => (acc == null ? undefined : acc[k]), rec);
+}
+const hasValue = (v) => v !== undefined && v !== null && v !== '';
+function declaredDefault(f) {
+    return f.defaultValue ?? f.default;
+}
+/**
+ * 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 function isAdvancedField(f, essentialKeys = new Set()) {
+    if (essentialKeys.has(f.key))
+        return false;
+    if (f.key.startsWith(EXTENSION_PREFIX))
+        return true;
+    if (f.section && ADVANCED_SECTIONS.has(f.section))
+        return true;
+    const hasOptions = Array.isArray(f.options) && f.options.length > 0;
+    return !f.required && hasOptions && hasValue(declaredDefault(f));
+}
+/** Reparte los campos del tipo (más los de extensión) en grupos de pantalla. */
+export function splitEditorFields(fields, opts = {}) {
+    const essentialKeys = new Set(opts.essentialKeys ?? []);
+    const out = { essential: [], advanced: [], notes: [] };
+    const seen = new Set();
+    for (const f of [...fields, ...(opts.extensionFields ?? [])]) {
+        if (seen.has(f.key))
+            continue;
+        seen.add(f.key);
+        if (opts.partyField && f.key === opts.partyField)
+            out.party = f;
+        else if (f.type === 'textarea' || f.widget === 'textarea')
+            out.notes.push(f);
+        else if (isAdvancedField(f, essentialKeys))
+            out.advanced.push(f);
+        else
+            out.essential.push(f);
+    }
+    return out;
+}
+/**
+ * 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 function friendlyOptionLabel(label) {
+    const m = /^\s*([A-Z0-9]{1,5})\s*[·\-–]\s*(.+)$/.exec(label);
+    return m && /\d/.test(m[1]) ? `${m[2].trim()} · ${m[1]}` : label;
+}
+/** El mismo campo con sus opciones en formato «texto · código». */
+export function withFriendlyOptions(f) {
+    if (!Array.isArray(f.options) || f.options.length === 0)
+        return f;
+    return { ...f, options: f.options.map((o) => ({ ...o, label: friendlyOptionLabel(String(o.label ?? o.value)) })) };
+}
+/**
+ * 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 function partyDefaults(party, documentFieldKeys, current) {
+    if (!party)
+        return {};
+    const out = {};
+    for (const key of documentFieldKeys) {
+        if (!key.startsWith(EXTENSION_PREFIX) || hasValue(current[key]))
+            continue;
+        const v = readPath(party, key);
+        if (hasValue(v))
+            out[key] = v;
+    }
+    if (!hasValue(current.currency_code) && typeof party.currency_code === 'string' && party.currency_code) {
+        out.currency_code = party.currency_code;
+    }
+    return out;
+}
+/** Filas de la tarjeta de contraparte: resumen declarado + extensiones (máximo `limit`). */
+export function partySummaryRows(party, summary = [], labels = {}, limit = 6) {
+    if (!party)
+        return [];
+    const keys = new Set(summary);
+    const fd = party.fiscal_data;
+    if (fd && typeof fd === 'object')
+        for (const k of Object.keys(fd))
+            keys.add(EXTENSION_PREFIX + k);
+    const rows = [];
+    for (const key of keys) {
+        const v = readPath(party, key);
+        if (!hasValue(v) || typeof v === 'object')
+            continue;
+        rows.push({ key, label: labels[key] ?? key.replace(EXTENSION_PREFIX, ''), value: String(v) });
+    }
+    return rows.slice(0, limit);
+}
+export function creditStatus(party, cols, documentTotal) {
+    if (!party || !cols)
+        return null;
+    const n = (k) => (k && hasValue(party[k]) ? toAmount(party[k]) : undefined);
+    const limit = n(cols.limit);
+    const balance = n(cols.balance);
+    const overdue = n(cols.overdue);
+    const holdReason = cols.hold_reason ? party[cols.hold_reason] || undefined : undefined;
+    if (limit == null && balance == null && overdue == null && !holdReason)
+        return null;
+    const available = limit != null ? roundMoney(limit - (balance ?? 0)) : undefined;
+    let level = 'ok';
+    if (holdReason || (available != null && limit > 0 && available < documentTotal))
+        level = 'block';
+    else if ((overdue ?? 0) > 0 || (limit != null && limit > 0 && (balance ?? 0) + documentTotal > 0.8 * limit))
+        level = 'warn';
+    return { limit, balance, overdue, available, holdReason, level };
+}
+/**
+ * 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).
+ */
+export function linesFromSource(rows, map = {}, opts = {}) {
+    if (!Array.isArray(rows))
+        return [];
+    return rows.map((raw) => {
+        const r = (raw ?? {});
+        const get = (k) => r[map[k] ?? k];
+        const qty = toAmount(get('quantity') ?? 1);
+        let rate = get('tax_rate');
+        if (!hasValue(rate)) {
+            const sub = toAmount(get('subtotal'));
+            const tax = toAmount(get('tax_amount'));
+            rate = sub > 0 ? Math.round((tax / sub) * 10000) / 10000 : 0;
+        }
+        const r2 = toAmount(rate);
+        const line = makeLine({
+            product_id: get('product_id') ?? undefined,
+            sku: get('sku') ?? undefined,
+            description: String(get('description') ?? get('product_name') ?? ''),
+            quantity: qty,
+            unit_price: toAmount(get('unit_price')),
+            discount: toAmount(get('discount') ?? 0),
+            tax_rate: r2 > 1 ? r2 / 100 : r2,
+            unit: get('unit') ?? undefined,
+        });
+        if (opts.kind === 'credit')
+            line.max_quantity = hasValue(get('max_quantity')) ? toAmount(get('max_quantity')) : qty;
+        return line;
+    });
+}
+/** Revisión local (instantánea) de los renglones. Sin ruido: solo lo que hay que mirar. */
+export function localIssues(lines, opts = {}) {
+    const issues = [];
+    const items = lines.filter((l) => l.kind === 'item');
+    if ((opts.requireLines ?? true) && items.length === 0) {
+        issues.push({ field: 'lines', severity: 'error', message: 'Agrega al menos un renglón.' });
+    }
+    items.forEach((l, i) => {
+        if (!l.description.trim())
+            issues.push({ field: `lines.${i}`, severity: 'error', message: `Renglón ${i + 1}: falta la descripción.` });
+        if (toAmount(l.unit_price) <= 0)
+            issues.push({ field: `lines.${i}`, severity: 'warning', message: `Renglón ${i + 1}: precio en cero.` });
+        if (opts.requireTax && toAmount(l.tax_rate) === 0) {
+            issues.push({ field: `lines.${i}`, severity: 'warning', message: `Renglón ${i + 1}: sin impuesto.` });
+        }
+    });
+    if (computeTotals(lines).total < 0)
+        issues.push({ severity: 'error', message: 'El total no puede ser negativo.' });
+    return issues;
+}
+// ---- Cobro / REP (lines.kind = allocation) ----------------------------------
+/** Documento abierto (fila de /data) → OpenDocument para PaymentAllocator. */
+export function toOpenDocuments(rows, cfg, currency) {
+    if (!Array.isArray(rows))
+        return [];
+    const rules = getOptionFilter(cfg);
+    const out = [];
+    for (const raw of rows) {
+        if (!raw || typeof raw !== 'object')
+            continue;
+        const r = raw;
+        if (rules.length) {
+            const opt = { id: r.id, value: r.id, label: String(r[cfg.number_field] ?? ''), name: '', meta: r };
+            if (!rules.every((rule) => optionPassesRule(opt, rule)))
+                continue;
+        }
+        const balance = roundMoney(toAmount(readPath(r, cfg.balance_field)));
+        if (balance <= 0)
+            continue;
+        out.push({
+            id: String(r.id),
+            number: String(readPath(r, cfg.number_field) ?? r.id),
+            issued_at: String(readPath(r, cfg.issued_field ?? 'issued_at') ?? r.created_at ?? ''),
+            due_at: (cfg.due_field ? readPath(r, cfg.due_field) : null) ?? null,
+            total: roundMoney(toAmount(cfg.total_field ? readPath(r, cfg.total_field) : balance)),
+            balance,
+            currency: String(r.currency_code ?? r.currency ?? currency),
+            payment_method: cfg.method_field ? (readPath(r, cfg.method_field) ?? null) : null,
+            installments_paid: hasValue(r.installments_paid) ? toAmount(r.installments_paid) : undefined,
+        });
+    }
+    return out;
+}
+/** Monto actual de cada documento, para pasar a modo manual sin perder lo repartido. */
+export function manualFromAllocations(allocations) {
+    return Object.fromEntries(allocations.map((a) => [a.document_id, a.amount]));
+}
+/** Renglones del payload: solo los dos campos que declara la acción (`invoice_id`, `amount`). */
+export function allocationPayload(allocations, cfg) {
+    return allocations.filter((a) => a.amount > 0).map((a) => ({ [cfg.line_document_field]: a.document_id, [cfg.line_amount_field]: a.amount }));
+}
+/**
+ * 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 function allocationAmountField(fields) {
+    return (fields.find((f) => f.key === 'amount')?.key ??
+        fields.find((f) => ['number', 'numeric', 'decimal', 'currency', 'money'].includes(f.type) || f.widget === 'currency')?.key);
+}
+const ALLOCATION_MESSAGES = {
+    non_positive: 'Captura el monto recibido.',
+    over_balance: 'Se aplica más que el saldo del documento.',
+    over_amount: 'Lo aplicado supera el monto recibido.',
+    currency_mismatch: 'El documento está en otra moneda.',
+    unapplied: 'Queda monto sin aplicar.',
+};
+/** AllocationIssue → mensaje en español claro (con el número del documento). */
+export function allocationIssueMessages(issues, docs) {
+    const byId = new Map(docs.map((d) => [d.id, d]));
+    return issues.map((i) => {
+        const doc = i.document_id ? byId.get(i.document_id) : undefined;
+        return {
+            field: i.code === 'non_positive' ? 'amount' : 'allocations',
+            severity: i.severity,
+            message: doc ? `${doc.number}: ${ALLOCATION_MESSAGES[i.code]}` : ALLOCATION_MESSAGES[i.code],
+        };
+    });
+}
+/** Días de atraso de un documento abierto (0 si no está vencido o no tiene vencimiento). */
+export function overdueDays(doc, today = new Date()) {
+    if (!doc.due_at)
+        return 0;
+    const due = new Date(doc.due_at);
+    if (Number.isNaN(due.getTime()))
+        return 0;
+    const ms = Date.UTC(today.getFullYear(), today.getMonth(), today.getDate()) - Date.UTC(due.getUTCFullYear(), due.getUTCMonth(), due.getUTCDate());
+    return Math.max(0, Math.floor(ms / 86_400_000));
+}