@asteby/metacore-runtime-react 45.0.0 → 45.2.0

package/dist/document/evaluate.js

@@ -0,0 +1,170 @@
+/** Máximo de secundarias visibles; el resto pasa a «Más…» (§5.2 / §6.2). */
+export const MAX_VISIBLE_SECONDARY = 3;
+/**
+ * Lee una ruta del contexto. `$.x` son los derivados; `sources.k.length` es el
+ * total de una fuente; el resto cuelga del registro (`record.x` o `x`).
+ */
+export function readPath(ctx, path) {
+    if (!path)
+        return undefined;
+    let parts = path.split('.');
+    let cur;
+    if (parts[0] === '$') {
+        cur = ctx.derived;
+        parts = parts.slice(1);
+    }
+    else if (parts[0] === 'sources') {
+        cur = ctx.sources;
+        parts = parts.slice(1);
+    }
+    else {
+        cur = ctx.record;
+        if (parts[0] === 'record')
+            parts = parts.slice(1);
+    }
+    for (const p of parts) {
+        if (cur == null)
+            return undefined;
+        if (p === 'length' && Array.isArray(cur)) {
+            cur = cur.length;
+            continue;
+        }
+        cur = cur[p];
+    }
+    return cur;
+}
+function sameValue(a, b) {
+    if (a == null || b == null)
+        return a == b;
+    return String(a) === String(b);
+}
+function isTruthy(v) {
+    if (v == null || v === false || v === '' || v === 0)
+        return false;
+    if (Array.isArray(v))
+        return v.length > 0;
+    return true;
+}
+function toNumber(v) {
+    const n = typeof v === 'number' ? v : parseFloat(String(v));
+    return Number.isFinite(n) ? n : NaN;
+}
+export function evaluatePredicate(p, ctx) {
+    const v = readPath(ctx, p.field);
+    switch (p.op) {
+        case 'eq':
+            return sameValue(v, p.value);
+        case 'neq':
+            return !sameValue(v, p.value);
+        case 'in':
+            return Array.isArray(p.value) && p.value.some((x) => sameValue(v, x));
+        case 'not_in':
+            return !(Array.isArray(p.value) && p.value.some((x) => sameValue(v, x)));
+        case 'truthy':
+            return isTruthy(v);
+        case 'falsy':
+            return !isTruthy(v);
+        case 'gt':
+            return toNumber(v) > toNumber(p.value);
+        case 'gte':
+            return toNumber(v) >= toNumber(p.value);
+        case 'lt':
+            return toNumber(v) < toNumber(p.value);
+        case 'lte':
+            return toNumber(v) <= toNumber(p.value);
+        default:
+            return false;
+    }
+}
+/** Un arreglo es un AND; sin condición siempre se cumple. */
+export function evaluateWhen(when, ctx) {
+    if (!when)
+        return true;
+    const list = Array.isArray(when) ? when : [when];
+    return list.every((p) => evaluatePredicate(p, ctx));
+}
+/** Estado actual de una máquina para el registro (o su fallback / un estado desconocido explícito). */
+export function resolveStatus(machine, ctx) {
+    const raw = readPath(ctx, machine.field);
+    const value = raw == null ? '' : String(raw);
+    const found = machine.states.find((s) => s.value === value);
+    if (found)
+        return found;
+    if (machine.fallback)
+        return machine.fallback;
+    if (!value)
+        return undefined;
+    return { value, label: value, tone: 'neutral' };
+}
+/**
+ * Distribución de acciones para el estado actual. Una acción `hiddenWhen` se
+ * omite; una `blockedWhen` queda deshabilitada con motivo. Más de
+ * `MAX_VISIBLE_SECONDARY` secundarias se derraman a «Más…»; una acción marcada
+ * `destructive` siempre va a la zona destructiva aunque el layout la ponga en otro lado.
+ */
+export function resolveActions(spec, ctx) {
+    const byKey = new Map(spec.actions.map((a) => [a.key, a]));
+    const layout = spec.layouts.find((r) => evaluateWhen(r.when, ctx))?.layout ?? spec.defaultLayout ?? {};
+    const resolve = (key) => {
+        if (!key)
+            return undefined;
+        const def = byKey.get(key);
+        if (!def || (def.hiddenWhen && evaluateWhen(def.hiddenWhen, ctx)))
+            return undefined;
+        const rules = def.blockedWhen ? (Array.isArray(def.blockedWhen) ? def.blockedWhen : [def.blockedWhen]) : [];
+        const hit = rules.find((r) => evaluateWhen(r.when, ctx));
+        return { def, blockedReason: hit?.reason };
+    };
+    const many = (keys) => (keys ?? []).map(resolve).filter((a) => !!a);
+    const destructive = many(layout.destructive);
+    const secondary = [];
+    const more = [];
+    for (const a of [...many(layout.secondary)]) {
+        if (a.def.destructive)
+            destructive.push(a);
+        else
+            secondary.push(a);
+    }
+    for (const a of many(layout.more)) {
+        if (a.def.destructive)
+            destructive.push(a);
+        else
+            more.push(a);
+    }
+    const overflow = secondary.splice(MAX_VISIBLE_SECONDARY);
+    more.unshift(...overflow);
+    let primary = resolve(layout.primary);
+    if (primary?.def.destructive) {
+        destructive.unshift(primary);
+        primary = undefined;
+    }
+    return { primary, secondary, more, destructive };
+}
+/** Interpola `{{campo}}` con valores del registro (sin evaluar código). */
+export function interpolate(template, ctx) {
+    return template.replace(/\{\{\s*([\w.$]+)\s*\}\}/g, (_, path) => {
+        const v = readPath(ctx, path);
+        return v == null ? '' : String(v);
+    });
+}
+/** Título: la interpolación puede dejar vacío el resultado; se prueban alternativas separadas por `||`. */
+export function resolveTitle(template, ctx) {
+    for (const alt of template.split('||')) {
+        const out = interpolate(alt.trim(), ctx).trim();
+        if (out)
+            return out;
+    }
+    return '';
+}
+/**
+ * Quita del spec las acciones que dependen de una acción del modelo que el
+ * backend (o el addon que la aporta) no declara: mejor un botón menos que uno
+ * que abre un modal vacío. Las que resuelve la propia página (`href`/`openUrl`/`tab`) siempre se conservan.
+ */
+export function pruneUnavailableActions(spec, availableModelActions) {
+    const have = new Set(availableModelActions);
+    return {
+        ...spec,
+        actions: spec.actions.filter((a) => a.href || a.openUrl || a.tab || have.has(a.modelAction ?? a.key)),
+    };
+}

package/dist/document/format.d.ts

@@ -0,0 +1,9 @@
+import type { DocumentFieldDef } from './types';
+export interface FieldFormatOptions {
+    locale?: string;
+    currency?: string;
+    timeZone?: string;
+}
+/** Formatea un valor de campo; vacío → «—». Moneda y zona horaria son config de la org, no se hardcodean. */
+export declare function formatFieldValue(value: unknown, format?: DocumentFieldDef['format'], opts?: FieldFormatOptions): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/document/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/document/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,6GAA6G;AAC7G,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,OAAO,EACd,MAAM,GAAE,gBAAgB,CAAC,QAAQ,CAAU,EAC3C,IAAI,GAAE,kBAAuB,GAC9B,MAAM,CA6CR"}

package/dist/document/format.js

@@ -0,0 +1,52 @@
+/** Formatea un valor de campo; vacío → «—». Moneda y zona horaria son config de la org, no se hardcodean. */
+export function formatFieldValue(value, format = 'text', opts = {}) {
+    if (value === null || value === undefined || value === '')
+        return '—';
+    const locale = opts.locale || 'es-MX';
+    // Relación resuelta por el kernel: `{value,label}` o un objeto con `name`.
+    if (typeof value === 'object' && !(value instanceof Date)) {
+        const o = value;
+        const text = o.label ?? o.name ?? o.title;
+        return text == null || text === '' ? '—' : String(text);
+    }
+    switch (format) {
+        case 'money': {
+            const n = typeof value === 'number' ? value : parseFloat(String(value));
+            if (!Number.isFinite(n))
+                return '—';
+            try {
+                return new Intl.NumberFormat(locale, {
+                    style: 'currency',
+                    currency: opts.currency || 'USD',
+                }).format(n);
+            }
+            catch {
+                return n.toFixed(2);
+            }
+        }
+        case 'percent': {
+            const n = typeof value === 'number' ? value : parseFloat(String(value));
+            return Number.isFinite(n) ? `${n}%` : '—';
+        }
+        case 'date':
+        case 'datetime': {
+            const d = new Date(String(value));
+            if (Number.isNaN(d.getTime()))
+                return String(value);
+            try {
+                return new Intl.DateTimeFormat(locale, {
+                    dateStyle: 'medium',
+                    ...(format === 'datetime' ? { timeStyle: 'short' } : {}),
+                    timeZone: opts.timeZone || undefined,
+                }).format(d);
+            }
+            catch {
+                return d.toISOString();
+            }
+        }
+        case 'boolean':
+            return value ? 'Sí' : 'No';
+        default:
+            return String(value);
+    }
+}

package/dist/document/index.d.ts

@@ -0,0 +1,13 @@
+export * from './types';
+export { MAX_VISIBLE_SECONDARY, evaluatePredicate, evaluateWhen, interpolate, pruneUnavailableActions, readPath, resolveActions, resolveStatus, resolveTitle, } from './evaluate';
+export { formatFieldValue, type FieldFormatOptions } from './format';
+export { StatusBadge, STATUS_TONE_STYLE, type StatusBadgeProps } from './status-badge';
+export { ActionBar, type ActionBarProps } from './action-bar';
+export { DocumentHeader, type DocumentHeaderProps, type HeaderBadge, type HeaderMetric } from './document-header';
+export { SmartButtons, type SmartButtonItem, type SmartButtonsProps } from './smart-buttons';
+export { DocumentTimeline, type DocumentTimelineProps, type TimelineEntry } from './document-timeline';
+export { CancelWithReason, type CancelPayload, type CancelReason, type CancelWithReasonProps } from './cancel-with-reason';
+export { DocumentPage, type DocumentPageProps } from './document-page';
+export { useDocumentSources, type DocumentSourcesState } from './use-document-sources';
+export { clearDocumentPages, findStatusMachine, getDocumentPage, registerDocumentPage, type DocumentPageRegistration, } from './registry';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/document/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,OAAO,EACH,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,uBAAuB,EACvB,QAAQ,EACR,cAAc,EACd,aAAa,EACb,YAAY,GACf,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AACpE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtF,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACjH,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC5F,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACtG,OAAO,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC1H,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AACtF,OAAO,EACH,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,KAAK,wBAAwB,GAChC,MAAM,YAAY,CAAA"}

package/dist/document/index.js

@@ -0,0 +1,12 @@
+export * from './types';
+export { MAX_VISIBLE_SECONDARY, evaluatePredicate, evaluateWhen, interpolate, pruneUnavailableActions, readPath, resolveActions, resolveStatus, resolveTitle, } from './evaluate';
+export { formatFieldValue } from './format';
+export { StatusBadge, STATUS_TONE_STYLE } from './status-badge';
+export { ActionBar } from './action-bar';
+export { DocumentHeader } from './document-header';
+export { SmartButtons } from './smart-buttons';
+export { DocumentTimeline } from './document-timeline';
+export { CancelWithReason } from './cancel-with-reason';
+export { DocumentPage } from './document-page';
+export { useDocumentSources } from './use-document-sources';
+export { clearDocumentPages, findStatusMachine, getDocumentPage, registerDocumentPage, } from './registry';

package/dist/document/registry.d.ts

@@ -0,0 +1,20 @@
+import type { DocumentContext, DocumentSpec, StatusMachine } from './types';
+export interface DocumentPageRegistration {
+    spec: DocumentSpec;
+    /**
+     * Calcula derivados (`$.x`) a partir del registro y las fuentes cargadas —
+     * p. ej. el estado fiscal a partir de fiscal_documents y el de cobro a
+     * partir de saldo y vencimiento. Función pura, sin efectos.
+     */
+    derive?: (ctx: Omit<DocumentContext, 'derived'>) => Record<string, unknown>;
+}
+/**
+ * Registra la página bajo `spec.model` y, opcionalmente, bajo alias (la ruta
+ * `/m/<model>` puede llegar como `invoices` o `Invoice` según el enlace).
+ */
+export declare function registerDocumentPage(reg: DocumentPageRegistration, aliases?: string[]): void;
+export declare function getDocumentPage(model: string): DocumentPageRegistration | undefined;
+export declare function clearDocumentPages(): void;
+/** Catálogo compartido de estados por id de máquina (lo usan las columnas `status` de las pestañas). */
+export declare function findStatusMachine(spec: DocumentSpec, id: string): StatusMachine | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/dist/document/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/document/registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE3E,MAAM,WAAW,wBAAwB;IACrC,IAAI,EAAE,YAAY,CAAA;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9E;AAID;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,wBAAwB,EAAE,OAAO,GAAE,MAAM,EAAO,GAAG,IAAI,CAGhG;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,wBAAwB,GAAG,SAAS,CAEnF;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,wGAAwG;AACxG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE3F"}

package/dist/document/registry.js

@@ -0,0 +1,20 @@
+const registry = new Map();
+/**
+ * Registra la página bajo `spec.model` y, opcionalmente, bajo alias (la ruta
+ * `/m/<model>` puede llegar como `invoices` o `Invoice` según el enlace).
+ */
+export function registerDocumentPage(reg, aliases = []) {
+    registry.set(reg.spec.model, reg);
+    for (const a of aliases)
+        registry.set(a, reg);
+}
+export function getDocumentPage(model) {
+    return registry.get(model);
+}
+export function clearDocumentPages() {
+    registry.clear();
+}
+/** Catálogo compartido de estados por id de máquina (lo usan las columnas `status` de las pestañas). */
+export function findStatusMachine(spec, id) {
+    return spec.statuses.find((s) => s.id === id) ?? spec.catalogs?.find((s) => s.id === id);
+}

package/dist/document/smart-buttons.d.ts

@@ -0,0 +1,16 @@
+export interface SmartButtonItem {
+    key: string;
+    label: string;
+    icon?: string;
+    /** undefined = botón sin contador (p. ej. «Pedido origen»). */
+    count?: number;
+    /** Deshabilitado (sin destino / vacío). */
+    disabled?: boolean;
+    onClick?: () => void;
+}
+export interface SmartButtonsProps {
+    items: SmartButtonItem[];
+    className?: string;
+}
+export declare function SmartButtons({ items, className }: SmartButtonsProps): import("react").JSX.Element | null;
+//# sourceMappingURL=smart-buttons.d.ts.map

package/dist/document/smart-buttons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-buttons.d.ts","sourceRoot":"","sources":["../../src/document/smart-buttons.tsx"],"names":[],"mappings":"AAOA,MAAM,WAAW,eAAe;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,eAAe,EAAE,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,iBAAiB,sCA8BnE"}

package/dist/document/smart-buttons.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// SmartButtons — accesos con contador al estilo Odoo (Pagos (2) · REP (1) ·
+// Notas de crédito (0)…). Un botón sin registros se ve atenuado, no oculto,
+// salvo que la definición pida `hideWhenEmpty`.
+import { useTranslation } from 'react-i18next';
+import { cn } from '@asteby/metacore-ui/lib';
+import { DynamicIcon } from '../dynamic-icon';
+export function SmartButtons({ items, className }) {
+    const { t } = useTranslation();
+    if (items.length === 0)
+        return null;
+    return (_jsx("nav", { "aria-label": t('document.related', { defaultValue: 'Relacionados' }), className: cn('flex flex-wrap gap-2', className), "data-smart-buttons": '', children: items.map((it) => {
+            const empty = it.count === 0;
+            return (_jsxs("button", { type: 'button', disabled: it.disabled, onClick: it.onClick, "data-smart-button": it.key, className: cn('inline-flex items-center gap-2 rounded-md border bg-card px-3 py-1.5 text-sm transition-colors', 'hover:bg-accent disabled:cursor-default disabled:opacity-50 disabled:hover:bg-card', empty && 'text-muted-foreground'), children: [it.icon ? _jsx(DynamicIcon, { name: it.icon, className: 'h-4 w-4' }) : null, _jsx("span", { children: t(it.label, { defaultValue: it.label }) }), it.count !== undefined ? (_jsx("span", { className: 'rounded-full bg-muted px-1.5 text-xs font-semibold tabular-nums', children: it.count })) : null] }, it.key));
+        }) }));
+}

package/dist/document/status-badge.d.ts

@@ -0,0 +1,16 @@
+import { type LucideIcon } from 'lucide-react';
+import type { StatusDef, StatusTone } from './types';
+type BadgeVariant = 'muted' | 'info' | 'success' | 'warning' | 'danger';
+export declare const STATUS_TONE_STYLE: Record<StatusTone, {
+    variant: BadgeVariant;
+    icon: LucideIcon;
+}>;
+export interface StatusBadgeProps {
+    status: Pick<StatusDef, 'label' | 'tone' | 'strike'>;
+    /** Descripción para lectores de pantalla («Estado fiscal»). */
+    srLabel?: string;
+    className?: string;
+}
+export declare function StatusBadge({ status, srLabel, className }: StatusBadgeProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=status-badge.d.ts.map

package/dist/document/status-badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-badge.d.ts","sourceRoot":"","sources":["../../src/document/status-badge.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAkE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AAG9G,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEpD,KAAK,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;AAEvE,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAO7F,CAAA;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAA;IACpD,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,gBAAgB,+BAgB3E"}

package/dist/document/status-badge.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// StatusBadge — badge semántico con texto explícito e ícono por tono: el color
+// nunca es la única señal (benchmark §6.3). El catálogo de estados de cada
+// documento vive en su `StatusMachine`; aquí solo se pinta.
+import { useTranslation } from 'react-i18next';
+import { AlertOctagon, AlertTriangle, CheckCircle2, Circle, Clock, Info } from 'lucide-react';
+import { Badge } from '@asteby/metacore-ui/primitives';
+import { cn } from '@asteby/metacore-ui/lib';
+export const STATUS_TONE_STYLE = {
+    neutral: { variant: 'muted', icon: Circle },
+    info: { variant: 'info', icon: Info },
+    success: { variant: 'success', icon: CheckCircle2 },
+    caution: { variant: 'warning', icon: Clock },
+    warning: { variant: 'warning', icon: AlertTriangle },
+    critical: { variant: 'danger', icon: AlertOctagon },
+};
+export function StatusBadge({ status, srLabel, className }) {
+    const { t } = useTranslation();
+    const style = STATUS_TONE_STYLE[status.tone] ?? STATUS_TONE_STYLE.neutral;
+    const Icon = style.icon;
+    const text = t(status.label, { defaultValue: status.label });
+    return (_jsxs(Badge, { variant: style.variant, "data-tone": status.tone, className: cn(status.strike && 'line-through', className), children: [_jsx(Icon, { "aria-hidden": true }), srLabel ? _jsxs("span", { className: 'sr-only', children: [srLabel, ": "] }) : null, text] }));
+}

package/dist/document/types.d.ts

@@ -0,0 +1,196 @@
+import type { ReactNode } from 'react';
+/** Tono semántico de un estado. El color nunca es la única señal: cada tono trae ícono y texto. */
+export type StatusTone = 'neutral' | 'info' | 'success' | 'caution' | 'warning' | 'critical';
+/** Un estado del catálogo de un documento. */
+export interface StatusDef {
+    value: string;
+    /** Texto explícito (o clave i18n; se traduce con `t`). */
+    label: string;
+    tone: StatusTone;
+    /** Texto tachado (Cancelada, Anulada): conserva el rastro sin alarmar. */
+    strike?: boolean;
+}
+/** Una máquina de estados con su propio badge (p. ej. fiscal y cobro, independientes). */
+export interface StatusMachine {
+    id: string;
+    /** Etiqueta accesible del badge («Estado fiscal»). */
+    label?: string;
+    /** Ruta del valor en el contexto de evaluación (`record.x`, `$.x`). */
+    field: string;
+    states: StatusDef[];
+    /** Estado a mostrar cuando el valor no está en el catálogo. */
+    fallback?: StatusDef;
+}
+export type PredicateOp = 'eq' | 'neq' | 'in' | 'not_in' | 'truthy' | 'falsy' | 'gt' | 'gte' | 'lt' | 'lte';
+/** Condición sobre una ruta del contexto. Un arreglo de predicados es un AND. */
+export interface Predicate {
+    field: string;
+    op: PredicateOp;
+    value?: unknown;
+}
+export type When = Predicate | Predicate[];
+/** Regla de bloqueo: si `when` se cumple, la acción se ve deshabilitada y `reason` explica qué hacer antes. */
+export interface BlockRule {
+    when: When;
+    reason: string;
+}
+/** Un botón del documento (acción). `key` enlaza con `ActionDefinition.key` del modelo si existe. */
+export interface DocumentActionDef {
+    key: string;
+    label: string;
+    /** Nombre de ícono lucide. */
+    icon?: string;
+    /** Acción del modelo (metadata) que se dispara; por defecto `key`. */
+    modelAction?: string;
+    /**
+     * Acciones que resuelve la propia página sin acción del modelo (las plantillas
+     * interpolan `{{campo}}` / `{{$.derivado}}`):
+     *  - `href`: navega dentro de la app (`onNavigate` del host).
+     *  - `openUrl`: abre una URL en otra pestaña (descargar PDF/XML).
+     *  - `tab`: selecciona una pestaña (ver detalle del error, ver pagos).
+     */
+    href?: string;
+    openUrl?: string;
+    tab?: string;
+    /** Estilo crítico: siempre va en la zona destructiva. */
+    destructive?: boolean;
+    /** Se muestra deshabilitada con el motivo en lugar de desaparecer. */
+    blockedWhen?: BlockRule | BlockRule[];
+    /** Se oculta por completo cuando se cumple (p. ej. sin permiso o sin conector). */
+    hiddenWhen?: When;
+}
+/** Distribución de acciones para un estado (§5.4): 1 primaria, 2–3 secundarias, resto en «Más…». */
+export interface ActionLayout {
+    primary?: string;
+    secondary?: string[];
+    more?: string[];
+    destructive?: string[];
+}
+/** Regla: si `when` se cumple, se usa `layout`. Gana la primera que coincide. */
+export interface ActionLayoutRule {
+    when: When;
+    layout: ActionLayout;
+}
+/** Botón inteligente con contador (estilo Odoo): navega a lo relacionado. */
+export interface SmartButtonDef {
+    key: string;
+    label: string;
+    icon?: string;
+    /** Fuente (`DocumentSourceDef.key`) cuyo total alimenta el contador; sin ella no hay contador. */
+    source?: string;
+    /** Ruta de un valor del registro cuyo truthy activa el botón sin fuente (p. ej. «Pedido origen»). */
+    field?: string;
+    /** Modelo destino para navegar a la lista filtrada. */
+    href?: string;
+    /** No se muestra cuando el contador es 0 (por defecto se muestra deshabilitado). */
+    hideWhenEmpty?: boolean;
+    /** Selecciona esta pestaña al hacer clic. */
+    tab?: string;
+}
+/** Consulta a un modelo relacionado con el registro (`{{id}}` se interpola). */
+export interface DocumentSourceDef {
+    key: string;
+    model: string;
+    /** Columna del modelo relacionado que apunta al registro. */
+    foreignKey: string;
+    /** Filtros estáticos extra (`f_<col>=eq:<val>`). */
+    where?: Record<string, string>;
+    limit?: number;
+    /**
+     * Relación de dos saltos: en vez de filtrar por el id del registro, filtra
+     * `foreignKey` con los valores de `field` de las filas de otra fuente ya
+     * cargada (`via.source`). Ej.: los REP de una factura cuelgan del pago
+     * (`source_id = payment_id`), y los pagos salen de las aplicaciones.
+     */
+    via?: {
+        source: string;
+        field: string;
+    };
+}
+export interface DocumentFieldDef {
+    label: string;
+    /** Ruta en el contexto. */
+    path: string;
+    format?: 'text' | 'money' | 'date' | 'datetime' | 'mono' | 'percent' | 'boolean';
+    /** Ancho completo de la rejilla. */
+    wide?: boolean;
+    /** Oculta el campo cuando el valor está vacío. */
+    hideEmpty?: boolean;
+}
+export interface DocumentFieldGroup {
+    title?: string;
+    fields: DocumentFieldDef[];
+}
+export interface DocumentColumnDef {
+    label: string;
+    path: string;
+    format?: DocumentFieldDef['format'];
+    /** Catálogo de estados (id de máquina registrada) para pintar un badge. */
+    status?: string;
+}
+export type DocumentTabDef = {
+    key: string;
+    label: string;
+    kind: 'fields';
+    groups: DocumentFieldGroup[];
+} | {
+    key: string;
+    label: string;
+    kind: 'records';
+    source: string;
+    columns: DocumentColumnDef[];
+    empty?: string;
+} | {
+    key: string;
+    label: string;
+    kind: 'slot';
+    slot: string;
+    count?: string;
+};
+/** Métrica del encabezado (total, saldo, fechas…). */
+export interface DocumentMetricDef extends DocumentFieldDef {
+    tone?: 'default' | 'critical';
+}
+export interface DocumentSpec {
+    /** Clave del modelo (`invoices`). */
+    model: string;
+    /** Rutas candidatas para el título, en orden; `{{a}}{{b}}` se interpola. */
+    title: string;
+    /** Texto bajo el título (cliente…). */
+    subtitle?: DocumentFieldDef;
+    /** Campo que se copia con botón (UUID). */
+    copyable?: DocumentFieldDef;
+    /** Badges independientes (fiscal, cobro…). */
+    statuses: StatusMachine[];
+    /** Catálogos extra que solo pintan celdas de pestañas (`column.status`), sin badge en la cabecera. */
+    catalogs?: StatusMachine[];
+    metrics?: DocumentMetricDef[];
+    actions: DocumentActionDef[];
+    layouts: ActionLayoutRule[];
+    /** Layout si ninguna regla coincide. */
+    defaultLayout?: ActionLayout;
+    smartButtons?: SmartButtonDef[];
+    sources?: DocumentSourceDef[];
+    tabs: DocumentTabDef[];
+}
+/** Contexto de evaluación: registro, fuentes cargadas y derivados. */
+export interface DocumentContext {
+    record: Record<string, unknown>;
+    /** Filas por fuente (`sources[key]`). */
+    sources: Record<string, Record<string, unknown>[]>;
+    /** Derivados (`$`). */
+    derived: Record<string, unknown>;
+}
+export interface ResolvedAction {
+    def: DocumentActionDef;
+    /** Motivo cuando la acción está bloqueada. */
+    blockedReason?: string;
+}
+export interface ResolvedActionLayout {
+    primary?: ResolvedAction;
+    secondary: ResolvedAction[];
+    more: ResolvedAction[];
+    destructive: ResolvedAction[];
+}
+export type DocumentSlotRenderer = (ctx: DocumentContext) => ReactNode;
+//# sourceMappingURL=types.d.ts.map

package/dist/document/types.d.ts.map

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

package/dist/document/types.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,14 @@
+import type { DocumentSourceDef } from './types';
+export interface DocumentSourcesState {
+    sources: Record<string, Record<string, unknown>[]>;
+    loading: boolean;
+    /** Vuelve a pedir todas las fuentes (tras ejecutar una acción). */
+    reload: () => void;
+}
+/**
+ * Carga las filas relacionadas con el documento (pagos, REP, notas de crédito…)
+ * que alimentan contadores, pestañas y derivados. Un fallo en una fuente deja
+ * esa fuente vacía: la página sigue siendo usable.
+ */
+export declare function useDocumentSources(defs: DocumentSourceDef[] | undefined, recordId: string | number | undefined): DocumentSourcesState;
+//# sourceMappingURL=use-document-sources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-document-sources.d.ts","sourceRoot":"","sources":["../../src/document/use-document-sources.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAQhD,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;IAClD,OAAO,EAAE,OAAO,CAAA;IAChB,mEAAmE;IACnE,MAAM,EAAE,MAAM,IAAI,CAAA;CACrB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAC9B,IAAI,EAAE,iBAAiB,EAAE,GAAG,SAAS,EACrC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GACtC,oBAAoB,CAgEtB"}