@asteby/metacore-runtime-react 45.0.0 → 45.3.0

package/dist/document/document-timeline.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// DocumentTimeline — línea de tiempo de eventos de negocio del documento
+// («creó», «timbró», «envió a…», «abrió», «pagó», «solicitó cancelación»,
+// «respuesta del SAT»). Complementa a <RecordHistory> (que muestra diffs de
+// campos): aquí cada entrada es un hecho legible, con actor y hora.
+import { useTranslation } from 'react-i18next';
+import { Circle } from 'lucide-react';
+import { cn } from '@asteby/metacore-ui/lib';
+import { DynamicIcon } from '../dynamic-icon';
+import { formatFieldValue } from './format';
+const TONE_DOT = {
+    neutral: 'text-muted-foreground',
+    info: 'text-[var(--info,oklch(0.55_0.13_235))]',
+    success: 'text-[var(--success,oklch(0.6_0.15_155))]',
+    caution: 'text-[var(--warning,oklch(0.6_0.15_65))]',
+    warning: 'text-[var(--warning,oklch(0.6_0.15_65))]',
+    critical: 'text-destructive',
+};
+export function DocumentTimeline({ entries, emptyText, className, ...fmt }) {
+    const { t } = useTranslation();
+    if (entries.length === 0) {
+        return (_jsx("p", { className: 'rounded-md border border-dashed p-6 text-center text-sm text-muted-foreground', children: emptyText ?? t('document.timeline_empty', { defaultValue: 'Aún no hay actividad en este documento.' }) }));
+    }
+    const sorted = [...entries].sort((a, b) => new Date(b.at).getTime() - new Date(a.at).getTime());
+    return (_jsx("ol", { className: cn('relative flex flex-col gap-4 border-l pl-5', className), "data-document-timeline": '', children: sorted.map((e) => (_jsxs("li", { className: 'relative', children: [_jsx("span", { className: cn('absolute -left-[1.85rem] flex h-5 w-5 items-center justify-center rounded-full bg-card', TONE_DOT[e.tone ?? 'neutral']), children: e.icon ? _jsx(DynamicIcon, { name: e.icon, className: 'h-4 w-4' }) : _jsx(Circle, { className: 'h-3 w-3 fill-current' }) }), _jsx("p", { className: 'text-sm font-medium', children: t(e.label, { defaultValue: e.label }) }), _jsxs("p", { className: 'text-xs text-muted-foreground', children: [formatFieldValue(e.at, 'datetime', fmt), e.actor ? ` · ${e.actor}` : ''] }), e.detail ? _jsx("p", { className: 'mt-1 whitespace-pre-wrap text-sm text-muted-foreground', children: e.detail }) : null] }, e.id))) }));
+}

package/dist/document/evaluate.d.ts

@@ -0,0 +1,31 @@
+import type { DocumentContext, DocumentSpec, Predicate, ResolvedActionLayout, StatusDef, StatusMachine, When } from './types';
+/** Máximo de secundarias visibles; el resto pasa a «Más…» (§5.2 / §6.2). */
+export declare 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 declare function readPath(ctx: DocumentContext, path: string): unknown;
+export declare function evaluatePredicate(p: Predicate, ctx: DocumentContext): boolean;
+/** Un arreglo es un AND; sin condición siempre se cumple. */
+export declare function evaluateWhen(when: When | undefined, ctx: DocumentContext): boolean;
+/** Estado actual de una máquina para el registro (o su fallback / un estado desconocido explícito). */
+export declare function resolveStatus(machine: StatusMachine, ctx: DocumentContext): StatusDef | undefined;
+/**
+ * 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 declare function resolveActions(spec: DocumentSpec, ctx: DocumentContext): ResolvedActionLayout;
+/** Interpola `{{campo}}` con valores del registro (sin evaluar código). */
+export declare function interpolate(template: string, ctx: DocumentContext): string;
+/** Título: la interpolación puede dejar vacío el resultado; se prueban alternativas separadas por `||`. */
+export declare function resolveTitle(template: string, ctx: DocumentContext): string;
+/**
+ * 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 declare function pruneUnavailableActions(spec: DocumentSpec, availableModelActions: Iterable<string>): DocumentSpec;
+//# sourceMappingURL=evaluate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/document/evaluate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGR,eAAe,EACf,YAAY,EACZ,SAAS,EAET,oBAAoB,EACpB,SAAS,EACT,aAAa,EACb,IAAI,EACP,MAAM,SAAS,CAAA;AAEhB,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,IAAI,CAAA;AAEtC;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAuBpE;AAkBD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CA0B7E;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAIlF;AAED,uGAAuG;AACvG,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,eAAe,GAAG,SAAS,GAAG,SAAS,CAQjG;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,eAAe,GAAG,oBAAoB,CAoC7F;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,MAAM,CAK1E;AAED,2GAA2G;AAC3G,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,MAAM,CAM3E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,EAAE,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,YAAY,CAMjH"}

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] }));
+}