@asteby/metacore-runtime-react 47.0.0 → 48.0.0

package/CHANGELOG.md

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

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

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

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

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

package/dist/audit-info.js

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

package/dist/business/catalog-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":"AAMA,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAA;AAGrE,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACzF,OAAO,KAAK,EACR,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,gBAAgB,EACnB,MAAM,UAAU,CAAA;AAEjB,eAAO,MAAM,gBAAgB,iBAAiB,CAAA;AAK9C,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAErE,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEjG;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,aAAa,CAAC,GAAG,iBAAiB,GAAG,SAAS,CAK1I;AAeD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,cAAc,EAAE,aAAa,GAAE,WAAW,CAAC,MAAM,CAAa,GAAG,OAAO,CAM1G;AAED,MAAM,WAAW,iBAAiB;IAC9B,iFAAiF;IACjF,KAAK,CAAC,EAAE,cAAc,CAAA;IACtB,8CAA8C;IAC9C,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,uCAAuC;IACvC,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,yCAAyC;IACzC,KAAK,EAAE,cAAc,EAAE,CAAA;CAC1B;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,SAAS,cAAc,EAAE,EACjC,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,eAAe,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;CAAO,GACnH,iBAAiB,CAanB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,cAAc,GAAG,cAAc,CAGrE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,EACjC,iBAAiB,EAAE,SAAS,MAAM,EAAE,EACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,EACjC,OAAO,GAAE,SAAS,MAAM,EAAO,EAC/B,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACnC,KAAK,SAAI,GACV,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAYtD;AAED,MAAM,WAAW,YAAY;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+FAA+F;IAC/F,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,CAAA;CACjC;AAED,wBAAgB,YAAY,CACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,EACjC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EAC9F,aAAa,EAAE,MAAM,GACtB,YAAY,GAAG,IAAI,CAarB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAAE,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAA;CAAO,GAAG,QAAQ,EAAE,CA0B5I;AAED,MAAM,WAAW,WAAW;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;CAClB;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,WAAW,EAAE,CAezH;AAID,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,yBAAyB,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CA0B/G;AAED,wFAAwF;AACxF,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEhG;AAED,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,EAAE,GAAG,EAAE,yBAAyB,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEpI;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,GAAG,SAAS,CAK3F;AAUD,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,EAAE,IAAI,EAAE,SAAS,YAAY,EAAE,GAAG,WAAW,EAAE,CAUxH;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE,KAAK,GAAE,IAAiB,GAAG,MAAM,CAM/F"}