@asteby/metacore-runtime-react 47.0.0 → 48.0.0

package/dist/primitives/approvals.js

@@ -0,0 +1,48 @@
+const categories = [];
+/** Los addons registran su categoría al cargar (purchases: «Compras», fiscal_mexico: «Cancelación CFDI»…). */
+export function registerApprovalCategory(c) {
+    categories.push(c);
+    return () => {
+        const i = categories.indexOf(c);
+        if (i >= 0)
+            categories.splice(i, 1);
+    };
+}
+export function categorize(r) {
+    return categories.find(c => c.match(r))?.key ?? 'other';
+}
+export function groupApprovals(items) {
+    const out = {};
+    for (const r of items)
+        (out[categorize(r)] ??= []).push(r);
+    return out;
+}
+export function parseJSONField(v) {
+    if (v == null || v === '')
+        return null;
+    if (typeof v !== 'string')
+        return v;
+    try {
+        return JSON.parse(v);
+    }
+    catch {
+        return null;
+    }
+}
+/** Cliente fino sobre las rutas del kernel; la UI lo usa vía useApi(). */
+export function approvalsClient(api) {
+    const qs = (q) => Object.entries(q)
+        .filter(([, v]) => v !== undefined && v !== '')
+        .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`)
+        .join('&');
+    return {
+        list: async (q = { status: 'pending', for_me: true }) => {
+            const res = await api.get(`/approvals?${qs(q)}`);
+            return { items: (res.data?.data ?? []), total: Number(res.data?.meta?.total ?? 0) };
+        },
+        count: async () => Number((await api.get('/approvals/count')).data?.data?.count ?? 0),
+        approve: (id, reason) => api.post(`/approvals/${id}/approve`, { reason }),
+        reject: (id, reason) => api.post(`/approvals/${id}/reject`, { reason }),
+        approveWithPin: (id, pin, reason) => api.post(`/approvals/${id}/approve-pin`, { pin, reason }),
+    };
+}

package/dist/primitives/contributions.d.ts

@@ -0,0 +1,82 @@
+import { type ComponentType } from 'react';
+/** Regiones del DocumentEditor/DocumentPage donde se puede contribuir. */
+export type DocumentRegion = 'header.fields' | 'party.card' | 'lines.columns' | 'side.panels' | 'body.sections' | 'footer.actions';
+export interface DocumentEditorContext {
+    kind: string;
+    model: string;
+    values: Record<string, unknown>;
+    mode: 'create' | 'edit' | 'view';
+}
+export interface DocumentContribution<P = DocumentContributionProps> {
+    /** Id estable `addon.region.name` (dedupe y orden). Re-registrar el mismo id reemplaza. */
+    id: string;
+    kinds: string[] | '*';
+    region: DocumentRegion;
+    /** Addon dueño. Si no está instalado, no se renderiza (y el server revalida). */
+    requiresAddon?: string;
+    /** Mayor = primero. Default 0. */
+    priority?: number;
+    when?: (ctx: DocumentEditorContext) => boolean;
+    /** Componente o loader perezoso del remote (`() => import('fiscal_mexico/CfdiSection')`). */
+    component?: ComponentType<P>;
+    load?: () => Promise<{
+        default: ComponentType<P>;
+    }>;
+}
+/**
+ * Contribución resuelta: `component` siempre presente (si se registró con
+ * `load`, es un envoltorio lazy + Suspense que no pinta nada mientras carga).
+ */
+export type ResolvedDocumentContribution<P = DocumentContributionProps> = DocumentContribution<P> & {
+    component: ComponentType<P>;
+};
+export interface DocumentContributionProps {
+    ctx: DocumentEditorContext;
+    setValue: (key: string, value: unknown) => void;
+    issues: {
+        report: (key: string, issue: {
+            severity: 'error' | 'warning';
+            message: string;
+        }) => void;
+    };
+}
+/** Predicado «¿está instalado?»; `useInstalledAddons` lo arma en React. */
+export type IsAddonInstalled = (addonKey: string) => boolean;
+/** Suscripción para useSyncExternalStore (contribuciones y modales). */
+export declare function subscribeContributions(listener: () => void): () => void;
+/** Versión monotónica: cambia en cada register/dispose. */
+export declare function contributionsVersion(): number;
+export declare function slotIdFor(kind: string, region: DocumentRegion): string;
+/**
+ * Registra la contribución y la publica en slotRegistry bajo cada `doc:<kind>:<region>`
+ * (kinds '*' → `doc:*:<region>`). Devuelve el disposer: AddonLoader lo llama al
+ * desmontar o recargar el remote (fiber), así la sección desaparece al desinstalar.
+ * Re-registrar el mismo `id` (recarga en caliente) reemplaza la anterior.
+ */
+export declare function registerDocumentContribution<P = DocumentContributionProps>(c: DocumentContribution<P>, source?: string): () => void;
+/**
+ * Contribuciones aplicables a `region` para el documento `ctx`, ordenadas por
+ * prioridad (desc) y luego id. Pura: no lee React; `useDocumentContributions`
+ * la envuelve con useInstalledAddons.
+ */
+export declare function resolveContributions(ctx: DocumentEditorContext, region: DocumentRegion, isInstalled: IsAddonInstalled): ResolvedDocumentContribution<any>[];
+export interface FederatedModal<P = any> {
+    /** Clave `<addon>.<nombre>`, la misma que `modal` en el manifest. */
+    key: string;
+    addon: string;
+    /** El dispatcher le pasa ActionModalProps (open, onOpenChange, action, model, record…). */
+    load: () => Promise<{
+        default: ComponentType<P>;
+    }>;
+}
+export declare function registerFederatedModal(m: FederatedModal): () => void;
+/** null si el modal no está registrado o su addon no está instalado. Nunca espera. */
+export declare function resolveFederatedModal(key: string, isInstalled: IsAddonInstalled): FederatedModal | null;
+/**
+ * Componente `React.lazy` del modal resuelto, memoizado por registro (no se
+ * re-crea en cada render). Quien lo pinta lo envuelve en `<Suspense>`.
+ */
+export declare function federatedModalComponent<P = any>(m: FederatedModal<P>): ComponentType<P>;
+/** Solo para tests. */
+export declare function __resetContributions(): void;
+//# sourceMappingURL=contributions.d.ts.map

package/dist/primitives/contributions.d.ts.map

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

package/dist/primitives/contributions.js

@@ -0,0 +1,126 @@
+// Registro de contribuciones federadas — cómo un addon mete secciones,
+// columnas, modales, fuentes de «Cargar desde» y vistas previas en la pantalla
+// de OTRO addon sin que ese addon lo conozca.
+//
+// Se monta sobre slotRegistry (slot.tsx) — no es un segundo sistema: cada
+// contribución es un SlotEntry con id canónico `doc:<kind>:<region>` — y añade
+// lo que slot no tiene: `requiresAddon` (se oculta solo si el addon no está
+// instalado o se desinstala en caliente), orden estable, `when` por documento y
+// carga perezosa del componente (import() del remote federado).
+//
+// Contrato estable para remotes federados: los tipos de este archivo. Todo
+// `register*` devuelve un disposer; el AddonLoader lo llama al desmontar o
+// recargar el remote y la contribución desaparece sin recargar la página.
+import { createElement, lazy, Suspense } from 'react';
+import { slotRegistry } from '../slot';
+const contribs = new Map();
+const listeners = new Set();
+let version = 0;
+function notify() {
+    version += 1;
+    for (const l of [...listeners])
+        l();
+}
+/** Suscripción para useSyncExternalStore (contribuciones y modales). */
+export function subscribeContributions(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+/** Versión monotónica: cambia en cada register/dispose. */
+export function contributionsVersion() {
+    return version;
+}
+export function slotIdFor(kind, region) {
+    return `doc:${kind}:${region}`;
+}
+/** `load` → componente lazy envuelto en Suspense (fallback vacío: sin saltos de layout). */
+function lazyComponent(load) {
+    const Lazy = lazy(load);
+    return (props) => createElement(Suspense, { fallback: null }, createElement(Lazy, props));
+}
+/**
+ * Registra la contribución y la publica en slotRegistry bajo cada `doc:<kind>:<region>`
+ * (kinds '*' → `doc:*:<region>`). Devuelve el disposer: AddonLoader lo llama al
+ * desmontar o recargar el remote (fiber), así la sección desaparece al desinstalar.
+ * Re-registrar el mismo `id` (recarga en caliente) reemplaza la anterior.
+ */
+export function registerDocumentContribution(c, source) {
+    if (!c.component && !c.load)
+        throw new Error(`contribution ${c.id}: component o load es obligatorio`);
+    contribs.get(c.id)?.dispose();
+    const resolved = { ...c, component: c.component ?? lazyComponent(c.load) };
+    const kinds = c.kinds === '*' ? ['*'] : c.kinds;
+    const slotDisposers = kinds.map(k => slotRegistry.register(slotIdFor(k, c.region), resolved.component, {
+        priority: c.priority ?? 0,
+        source: source ?? c.requiresAddon ?? c.id,
+    }));
+    let disposed = false;
+    const entry = {
+        c: resolved,
+        dispose: () => {
+            if (disposed)
+                return;
+            disposed = true;
+            slotDisposers.forEach(d => d());
+            if (contribs.get(c.id) === entry)
+                contribs.delete(c.id);
+            notify();
+        },
+    };
+    contribs.set(c.id, entry);
+    notify();
+    return entry.dispose;
+}
+/**
+ * Contribuciones aplicables a `region` para el documento `ctx`, ordenadas por
+ * prioridad (desc) y luego id. Pura: no lee React; `useDocumentContributions`
+ * la envuelve con useInstalledAddons.
+ */
+export function resolveContributions(ctx, region, isInstalled) {
+    return [...contribs.values()]
+        .map(e => e.c)
+        .filter(c => c.region === region)
+        .filter(c => c.kinds === '*' || c.kinds.includes(ctx.kind))
+        .filter(c => !c.requiresAddon || isInstalled(c.requiresAddon))
+        .filter(c => !c.when || c.when(ctx))
+        .sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0) || a.id.localeCompare(b.id));
+}
+const modals = new Map();
+const modalComponents = new WeakMap();
+export function registerFederatedModal(m) {
+    modals.set(m.key, m);
+    notify();
+    return () => {
+        if (modals.get(m.key) === m) {
+            modals.delete(m.key);
+            notify();
+        }
+    };
+}
+/** null si el modal no está registrado o su addon no está instalado. Nunca espera. */
+export function resolveFederatedModal(key, isInstalled) {
+    const m = modals.get(key);
+    return m && isInstalled(m.addon) ? m : null;
+}
+/**
+ * Componente `React.lazy` del modal resuelto, memoizado por registro (no se
+ * re-crea en cada render). Quien lo pinta lo envuelve en `<Suspense>`.
+ */
+export function federatedModalComponent(m) {
+    let C = modalComponents.get(m);
+    if (!C) {
+        C = lazy(m.load);
+        modalComponents.set(m, C);
+    }
+    return C;
+}
+/** Solo para tests. */
+export function __resetContributions() {
+    for (const e of [...contribs.values()])
+        e.dispose();
+    contribs.clear();
+    modals.clear();
+    notify();
+}

package/dist/primitives/document-kinds.d.ts

@@ -0,0 +1,25 @@
+import type { DocumentFormPreview, DocumentFormSource } from '../types';
+export type PartyRole = 'customer' | 'supplier' | 'none';
+export type LinesMode = 'sale' | 'purchase' | 'credit' | 'allocation' | 'workorder' | 'none';
+export interface DocumentKind {
+    key: string;
+    label: string;
+    model: string;
+    party: PartyRole;
+    partyModel?: string;
+    lines: LinesMode;
+    /** Campo de renglones del modelo (one_to_many) o del payload de la acción. */
+    linesField?: string;
+    sources?: DocumentFormSource[];
+    preview?: DocumentFormPreview;
+    /** Estados del documento (StageMachine): los muestra StageStepper. */
+    stages?: string[];
+    /** Addon dueño del tipo (si no está, el tipo no se ofrece). */
+    addon: string;
+}
+export declare function registerDocumentKind(k: DocumentKind): () => void;
+export declare function getDocumentKind(key: string): DocumentKind | undefined;
+export declare function listDocumentKinds(isInstalled: (addon: string) => boolean): DocumentKind[];
+/** Tipos base que el core ya tiene (modelos verificados en addons main 9cd69bde). */
+export declare const CORE_DOCUMENT_KINDS: DocumentKind[];
+//# sourceMappingURL=document-kinds.d.ts.map

package/dist/primitives/document-kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-kinds.d.ts","sourceRoot":"","sources":["../../src/primitives/document-kinds.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAEvE,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAA;AACxD,MAAM,MAAM,SAAS,GACf,MAAM,GACN,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,MAAM,CAAA;AAEZ,MAAM,WAAW,YAAY;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,SAAS,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,SAAS,CAAA;IAChB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAA;IAC9B,OAAO,CAAC,EAAE,mBAAmB,CAAA;IAC7B,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAA;CAChB;AAID,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,IAAI,CAKhE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAErE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,YAAY,EAAE,CAEzF;AAED,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,EAAE,YAAY,EAU7C,CAAA"}

package/dist/primitives/document-kinds.js

@@ -0,0 +1,26 @@
+const kinds = new Map();
+export function registerDocumentKind(k) {
+    kinds.set(k.key, k);
+    return () => {
+        if (kinds.get(k.key) === k)
+            kinds.delete(k.key);
+    };
+}
+export function getDocumentKind(key) {
+    return kinds.get(key);
+}
+export function listDocumentKinds(isInstalled) {
+    return [...kinds.values()].filter(k => isInstalled(k.addon));
+}
+/** Tipos base que el core ya tiene (modelos verificados en addons main 9cd69bde). */
+export const CORE_DOCUMENT_KINDS = [
+    { key: 'invoice', label: 'Factura', model: 'customers.Invoice', party: 'customer', partyModel: 'customers.Customer', lines: 'sale', linesField: 'items', addon: 'customers' },
+    { key: 'quote', label: 'Cotización', model: 'quotes.Quote', party: 'customer', partyModel: 'customers.Customer', lines: 'sale', linesField: 'items', addon: 'quotes' },
+    { key: 'sales_order', label: 'Pedido', model: 'customers.SalesOrder', party: 'customer', partyModel: 'customers.Customer', lines: 'sale', linesField: 'items', addon: 'customers' },
+    { key: 'payment', label: 'Cobro', model: 'customers.Payment', party: 'customer', partyModel: 'customers.Customer', lines: 'allocation', linesField: 'allocations', addon: 'customers' },
+    { key: 'credit_note', label: 'Nota de crédito', model: 'fiscal_mexico.CreditNote', party: 'customer', partyModel: 'customers.Customer', lines: 'credit', linesField: 'lines', addon: 'fiscal_mexico' },
+    { key: 'purchase_order', label: 'Orden de compra', model: 'purchases.PurchaseOrder', party: 'supplier', partyModel: 'purchases.Supplier', lines: 'purchase', linesField: 'items', addon: 'purchases' },
+    { key: 'supplier_invoice', label: 'Factura de proveedor', model: 'purchases.SupplierInvoice', party: 'supplier', partyModel: 'purchases.Supplier', lines: 'purchase', addon: 'purchases' },
+    { key: 'supplier_payment', label: 'Pago a proveedor', model: 'purchases.PurchasePayment', party: 'supplier', partyModel: 'purchases.Supplier', lines: 'allocation', addon: 'purchases' },
+    { key: 'work_order', label: 'Orden de trabajo', model: 'workshop.WorkOrder', party: 'customer', partyModel: 'customers.Customer', lines: 'workorder', linesField: 'items', addon: 'workshop' },
+];

package/dist/primitives/index.d.ts

@@ -0,0 +1,8 @@
+export * from './allocation';
+export * from './aging';
+export * from './approvals';
+export * from './contributions';
+export * from './document-kinds';
+export * from './panels';
+export * from './use-contributions';
+//# sourceMappingURL=index.d.ts.map

package/dist/primitives/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/primitives/index.ts"],"names":[],"mappings":"AAgBA,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,UAAU,CAAA;AACxB,cAAc,qBAAqB,CAAA"}

package/dist/primitives/index.js

@@ -0,0 +1,23 @@
+// Primitivos de negocio — contrato estable para hosts y remotes federados.
+// Las funciones son puras (sin React ni host) salvo use-contributions; la UI y
+// el backend (wasm) pueden validar con las mismas reglas.
+//
+//  allocation       PaymentAllocator: allocatePayment / validateAllocation
+//                   (cobro multi-factura, REP, CxC «Registrar abono», CxP «Aplicar pago»).
+//  aging            AgingTable: computeAging / daysOverdue / bucketFor (antigüedad de saldos).
+//  approvals        ApprovalInbox: approvalsClient (rutas /approvals del kernel),
+//                   registerApprovalCategory / groupApprovals.
+//  contributions    Secciones y modales federados: registerDocumentContribution,
+//                   resolveContributions (pura), registerFederatedModal /
+//                   resolveFederatedModal. Todo register* devuelve su disposer.
+//  document-kinds   registerDocumentKind / listDocumentKinds / CORE_DOCUMENT_KINDS.
+//  panels           Tipos de PartyCard / TotalsPanel / PreviewPanel /
+//                   ValidationChecklist / LoadFromDocument + blockingChecks.
+//  use-contributions  Hooks: useDocumentContributions, useIsAddonInstalled.
+export * from './allocation';
+export * from './aging';
+export * from './approvals';
+export * from './contributions';
+export * from './document-kinds';
+export * from './panels';
+export * from './use-contributions';

package/dist/primitives/panels.d.ts

@@ -0,0 +1,68 @@
+import type { LineItemsTotals } from '../business/line-items';
+/** PartyCard: lo que se muestra de la contraparte. */
+export interface PartySummary {
+    id: string;
+    name: string;
+    tax_id?: string;
+    email?: string;
+    phone?: string;
+    currency?: string;
+    /** Filas extra (incluye las de extensiones `fiscal_data.*`). */
+    rows: Array<{
+        key: string;
+        label: string;
+        value: string;
+        tone?: 'ok' | 'warn' | 'err';
+    }>;
+    credit?: {
+        limit: number;
+        balance: number;
+        available: number;
+        overdue: number;
+        status?: 'active' | 'suspended' | 'delinquent';
+        hold_reason?: string;
+    };
+}
+/** TotalsPanel: desglose; los impuestos por tasa los aporta el addon fiscal o el core. */
+export interface TotalsBreakdown extends LineItemsTotals {
+    taxes: Array<{
+        label: string;
+        base: number;
+        amount: number;
+    }>;
+    /** Renglones extra (aplicaciones, saldo a favor, sin aplicar…). */
+    extra?: Array<{
+        label: string;
+        amount: number;
+        emphasis?: boolean;
+    }>;
+    amount_in_words?: string;
+}
+/** PreviewPanel: resultado de la acción de vista previa (`analyze: true`, no escribe). */
+export interface PreviewResult {
+    pdf_base64?: string;
+    xml?: string;
+    html?: string;
+    checks: ValidationCheck[];
+}
+/** ValidationChecklist: una revisión (local o del servidor). */
+export interface ValidationCheck {
+    key: string;
+    severity: 'ok' | 'warning' | 'error';
+    message: string;
+    /** Campo a enfocar al hacer clic. */
+    field?: string;
+    /** Si es error y `approval_policy` está, el botón ofrece «Pedir autorización». */
+    approval_policy?: string;
+}
+/** LoadFromDocument: candidato a cargar (venta, cotización, ticket, OT, factura origen de NC). */
+export interface LoadCandidate {
+    source: string;
+    id: string;
+    label: string;
+    party_id?: string;
+    total?: number;
+    state?: string;
+}
+export declare function blockingChecks(checks: readonly ValidationCheck[]): ValidationCheck[];
+//# sourceMappingURL=panels.d.ts.map

package/dist/primitives/panels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panels.d.ts","sourceRoot":"","sources":["../../src/primitives/panels.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAE7D,sDAAsD;AACtD,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gEAAgE;IAChE,IAAI,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,KAAK,CAAA;KAAE,CAAC,CAAA;IACxF,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,YAAY,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACxJ;AAED,0FAA0F;AAC1F,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACpD,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC7D,mEAAmE;IACnE,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IACpE,eAAe,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,0FAA0F;AAC1F,MAAM,WAAW,aAAa;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,eAAe,EAAE,CAAA;CAC5B;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAA;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kFAAkF;IAClF,eAAe,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,kGAAkG;AAClG,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,eAAe,EAAE,CAEpF"}

package/dist/primitives/panels.js

@@ -0,0 +1,3 @@
+export function blockingChecks(checks) {
+    return checks.filter(c => c.severity === 'error' && !c.approval_policy);
+}

package/dist/primitives/use-contributions.d.ts

@@ -0,0 +1,15 @@
+import { type InstalledAddonsValue } from '../installed-addons-context';
+import { type DocumentEditorContext, type DocumentRegion, type IsAddonInstalled, type ResolvedDocumentContribution } from './contributions';
+/**
+ * Predicado de instalación a partir del InstalledAddonsProvider. Sin provider
+ * devuelve siempre true: el host solo carga remotes de addons instalados, así
+ * que si la contribución existe, su addon está (el servidor revalida igual).
+ */
+export declare function installedPredicate(value: InstalledAddonsValue | null): IsAddonInstalled;
+/** `installedPredicate(useInstalledAddons())`, estable entre renders. */
+export declare function useIsAddonInstalled(): IsAddonInstalled;
+/** Re-pinta en cada register/dispose de contribuciones o modales federados. */
+export declare function useContributionsVersion(): number;
+/** Contribuciones aplicables a `region` del documento `ctx` (ya filtradas y ordenadas). */
+export declare function useDocumentContributions(ctx: DocumentEditorContext, region: DocumentRegion): ResolvedDocumentContribution<any>[];
+//# sourceMappingURL=use-contributions.d.ts.map

package/dist/primitives/use-contributions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-contributions.d.ts","sourceRoot":"","sources":["../../src/primitives/use-contributions.ts"],"names":[],"mappings":"AAKA,OAAO,EAAsB,KAAK,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAC3F,OAAO,EAIH,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,4BAA4B,EACpC,MAAM,iBAAiB,CAAA;AAExB;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,GAAG,gBAAgB,CAEvF;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,IAAI,gBAAgB,CAGtD;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,2FAA2F;AAC3F,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,cAAc,GAAG,4BAA4B,CAAC,GAAG,CAAC,EAAE,CAIhI"}

package/dist/primitives/use-contributions.js

@@ -0,0 +1,30 @@
+// Hooks de React sobre el registro de contribuciones (contributions.ts).
+// La lógica vive en las funciones puras; aquí solo se conecta con
+// useInstalledAddons y con la suscripción para re-pintar cuando un remote
+// registra o se desmonta.
+import { useMemo, useSyncExternalStore } from 'react';
+import { useInstalledAddons } from '../installed-addons-context';
+import { contributionsVersion, resolveContributions, subscribeContributions, } from './contributions';
+/**
+ * Predicado de instalación a partir del InstalledAddonsProvider. Sin provider
+ * devuelve siempre true: el host solo carga remotes de addons instalados, así
+ * que si la contribución existe, su addon está (el servidor revalida igual).
+ */
+export function installedPredicate(value) {
+    return value ? (key) => value.addons.has(key) : () => true;
+}
+/** `installedPredicate(useInstalledAddons())`, estable entre renders. */
+export function useIsAddonInstalled() {
+    const value = useInstalledAddons();
+    return useMemo(() => installedPredicate(value), [value]);
+}
+/** Re-pinta en cada register/dispose de contribuciones o modales federados. */
+export function useContributionsVersion() {
+    return useSyncExternalStore(subscribeContributions, contributionsVersion, contributionsVersion);
+}
+/** Contribuciones aplicables a `region` del documento `ctx` (ya filtradas y ordenadas). */
+export function useDocumentContributions(ctx, region) {
+    useContributionsVersion();
+    const isInstalled = useIsAddonInstalled();
+    return resolveContributions(ctx, region, isInstalled);
+}

package/dist/record-prefill-bar.d.ts

@@ -0,0 +1,11 @@
+import { type RecordFormMode } from '@asteby/metacore-sdk';
+export interface RecordPrefillBarProps {
+    model: string;
+    mode: RecordFormMode;
+    recordId?: string | null;
+    values: Record<string, any>;
+    allowedKeys: ReadonlySet<string>;
+    onApply: (patch: Record<string, any>) => void;
+}
+export declare function RecordPrefillBar({ model, mode, recordId, values, allowedKeys, onApply }: RecordPrefillBarProps): import("react").JSX.Element | null;
+//# sourceMappingURL=record-prefill-bar.d.ts.map

package/dist/record-prefill-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-prefill-bar.d.ts","sourceRoot":"","sources":["../src/record-prefill-bar.tsx"],"names":[],"mappings":"AAYA,OAAO,EAIH,KAAK,cAAc,EACtB,MAAM,sBAAsB,CAAA;AAG7B,MAAM,WAAW,qBAAqB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,cAAc,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC3B,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAChC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAA;CAChD;AAED,wBAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,qBAAqB,sCAgC9G"}

package/dist/record-prefill-bar.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// RecordPrefillBar — pinta los ayudantes de captura (record-prefill-registry de
+// @asteby/metacore-sdk) arriba del formulario genérico de un modelo.
+//
+// El formulario no conoce a los addons: sólo pregunta "¿quién aporta prefill
+// para <model> en <mode>?". Hoy: fiscal_mexico → «Cargar constancia» en
+// Customer/Supplier. Mañana: un vertical restaurante aporta «Importar menú» en
+// Product, un vertical ferretería «Leer código de proveedor», etc.
+//
+// Seguridad del patch: sólo se aplican claves que el formulario declara
+// (allowedKeys) — un addon no puede inyectar columnas ocultas (organization_id,
+// created_by…) por esta vía; el backend sigue validando como siempre.
+import { useCallback, useSyncExternalStore } from 'react';
+import { getRecordPrefills, recordPrefillsVersion, subscribeRecordPrefills, } from '@asteby/metacore-sdk';
+import { useCan } from './permissions-context';
+export function RecordPrefillBar({ model, mode, recordId, values, allowedKeys, onApply }) {
+    // Re-render cuando un remote registra/des-registra (carga tardía o unbind).
+    useSyncExternalStore(subscribeRecordPrefills, recordPrefillsVersion, recordPrefillsVersion);
+    const can = useCan();
+    const items = getRecordPrefills(model, mode).filter(c => !c.permission || can(c.permission));
+    const applyValues = useCallback((patch) => {
+        const safe = {};
+        for (const [k, v] of Object.entries(patch ?? {})) {
+            if (allowedKeys.has(k))
+                safe[k] = v;
+        }
+        if (Object.keys(safe).length > 0)
+            onApply(safe);
+    }, [allowedKeys, onApply]);
+    if (items.length === 0)
+        return null;
+    return (_jsx("div", { className: "flex flex-wrap items-center gap-2", "data-aby-record-prefill": "", children: items.map(({ id, component: C }) => (_jsx(C, { model: model, mode: mode, recordId: recordId ?? undefined, values: values, applyValues: applyValues }, id))) }));
+}