@asteby/metacore-runtime-react 45.0.0 → 45.3.0

package/dist/business/payment.js

@@ -0,0 +1,74 @@
+// Cobro mixto (POS/Caja, Apartado, Cobranza, Factura «Registrar pago», OT).
+// Lógica pura de <PaymentCapture>: resumen (pagado/pendiente/cambio) y validación.
+import { roundMoney, toAmount } from './format';
+let seq = 0;
+export function newTender(method, amount = 0) {
+    seq += 1;
+    return { key: `pt_${Date.now().toString(36)}_${seq}`, method, amount };
+}
+export function summarizePayment(total, tenders, methods) {
+    const byId = new Map(methods.map((m) => [m.id, m]));
+    let paid = 0;
+    let cash = 0;
+    for (const t of tenders) {
+        const a = Math.max(0, toAmount(t.amount));
+        paid += a;
+        if (byId.get(t.method)?.cash)
+            cash += a;
+    }
+    paid = roundMoney(paid);
+    const tot = roundMoney(total);
+    const excess = roundMoney(Math.max(0, paid - tot));
+    const change = roundMoney(Math.min(excess, cash));
+    return {
+        total: tot,
+        paid,
+        remaining: roundMoney(Math.max(0, tot - paid)),
+        change,
+        overpaid: roundMoney(excess - change),
+        settled: paid >= tot,
+    };
+}
+export function validatePayment(total, tenders, methods, policy = {}) {
+    const byId = new Map(methods.map((m) => [m.id, m]));
+    const errors = {};
+    tenders.forEach((t, i) => {
+        const m = byId.get(t.method);
+        const a = toAmount(t.amount);
+        if (!m)
+            errors[`${i}.method`] = 'Método de pago no disponible';
+        if (a <= 0)
+            errors[`${i}.amount`] = 'Captura un monto mayor a cero';
+        if (m?.maxAmount != null && a > m.maxAmount)
+            errors[`${i}.amount`] = `El máximo para ${m.label} es ${m.maxAmount}`;
+        if (m?.requiresReference && !t.reference?.trim())
+            errors[`${i}.reference`] = 'La referencia es obligatoria';
+        if (m?.requiresAccount && !t.account_id)
+            errors[`${i}.account_id`] = 'Elige la cuenta';
+    });
+    const s = summarizePayment(total, tenders, methods);
+    let form;
+    if (tenders.length === 0)
+        form = 'Agrega al menos un pago';
+    else if (s.overpaid > 0)
+        form = 'Solo el efectivo puede exceder el total (se devuelve como cambio)';
+    else if (!policy.allowPartial && !s.settled)
+        form = 'El pago no cubre el total';
+    return { errors, form, valid: !form && Object.keys(errors).length === 0 };
+}
+/** Payload hacia el backend: montos reales; el cambio no es un pago. */
+export function serializePayment(tenders, methods, total) {
+    const s = summarizePayment(total, tenders, methods);
+    return {
+        payments: tenders.map((t) => ({
+            method: t.method,
+            // Monto entregado por el cliente; el cambio va aparte en `change`.
+            amount: roundMoney(toAmount(t.amount)),
+            ...(t.reference?.trim() ? { reference: t.reference.trim() } : {}),
+            ...(t.account_id ? { account_id: t.account_id } : {}),
+        })),
+        paid: s.paid,
+        change: s.change,
+        remaining: s.remaining,
+    };
+}

package/dist/business/product-picker.d.ts

@@ -0,0 +1,24 @@
+import { type ProductQuery, type ProductResult, type ProductVariant } from './product-search';
+export interface ProductPickerProps {
+    /**
+     * Búsqueda: recibe la consulta ya clasificada (`barcode` | `tire_size` |
+     * `text`) para que el backend elija el índice. Debe ser estable (useCallback).
+     */
+    search: (query: Exclude<ProductQuery, {
+        kind: 'empty';
+    }>, signal: AbortSignal) => Promise<ProductResult[]>;
+    /** Se emite al elegir un producto o una variante concreta. */
+    onSelect: (product: ProductResult, variant?: ProductVariant) => void;
+    /** Almacén para mostrar/validar existencias; sin él, se suma el total. */
+    warehouseId?: string;
+    /** Un código de barras con un único resultado se selecciona solo al pulsar Enter. Default true. */
+    autoSelectBarcode?: boolean;
+    /** Permite elegir productos sin existencia (se marcan). Default true. */
+    allowOutOfStock?: boolean;
+    placeholder?: string;
+    autoFocus?: boolean;
+    currency?: string;
+    disabled?: boolean;
+}
+export declare function ProductPicker({ search, onSelect, warehouseId, autoSelectBarcode, allowOutOfStock, placeholder, autoFocus, currency, disabled, }: ProductPickerProps): import("react").JSX.Element;
+//# sourceMappingURL=product-picker.d.ts.map

package/dist/business/product-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-picker.d.ts","sourceRoot":"","sources":["../../src/business/product-picker.tsx"],"names":[],"mappings":"AAQA,OAAO,EAGH,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACtB,MAAM,kBAAkB,CAAA;AAGzB,MAAM,WAAW,kBAAkB;IAC/B;;;OAGG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAA;IAC1G,8DAA8D;IAC9D,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,IAAI,CAAA;IACpE,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mGAAmG;IACnG,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,yEAAyE;IACzE,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,wBAAgB,aAAa,CAAC,EAC1B,MAAM,EACN,QAAQ,EACR,WAAW,EACX,iBAAwB,EACxB,eAAsB,EACtB,WAAW,EACX,SAAS,EACT,QAAQ,EACR,QAAQ,GACX,EAAE,kBAAkB,+BA2HpB"}

package/dist/business/product-picker.js

@@ -0,0 +1,48 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// ProductPicker — una sola búsqueda para productos, llantas y variantes
+// (medida «205/55R16», SKU, código de barras, clave de proveedor). Benchmark §7.
+import { useCallback, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { Search } from 'lucide-react';
+import { Badge, Input } from '@asteby/metacore-ui';
+import { useFormatter } from './format';
+import { useAsyncSearch } from './use-async-search';
+import { availableStock, parseProductQuery, } from './product-search';
+import { EmptyState } from './feedback';
+export function ProductPicker({ search, onSelect, warehouseId, autoSelectBarcode = true, allowOutOfStock = true, placeholder, autoFocus, currency, disabled, }) {
+    const { t } = useTranslation();
+    const fmt = useFormatter({ currency });
+    const [text, setText] = useState('');
+    const parsed = parseProductQuery(text);
+    // Un código de barras es exacto: no se espera a 2 caracteres ni se debouncea mucho.
+    const run = useCallback((q, signal) => {
+        const p = parseProductQuery(q);
+        return p.kind === 'empty' ? Promise.resolve([]) : search(p, signal);
+    }, [search]);
+    const { results, loading, error } = useAsyncSearch(text, run, {
+        minChars: parsed.kind === 'barcode' ? 8 : 2,
+        delay: parsed.kind === 'barcode' ? 0 : 250,
+    });
+    const pick = (p, v) => {
+        const stock = availableStock(v ?? p, warehouseId);
+        if (!allowOutOfStock && stock != null && stock <= 0)
+            return;
+        onSelect(p, v);
+        setText('');
+    };
+    return (_jsxs("div", { "data-slot": "product-picker", className: "space-y-2", children: [_jsxs("div", { className: "relative", children: [_jsx(Search, { className: "pointer-events-none absolute left-2.5 top-2.5 size-4 text-muted-foreground", "aria-hidden": true }), _jsx(Input, { autoFocus: autoFocus, disabled: disabled, className: "pl-8", value: text, placeholder: placeholder ?? t('productPicker.placeholder', { defaultValue: 'Producto, medida (205/55R16), SKU o código de barras' }), onChange: (e) => setText(e.target.value), onKeyDown: (e) => {
+                            if (e.key === 'Enter' && autoSelectBarcode && parsed.kind === 'barcode' && results.length === 1) {
+                                e.preventDefault();
+                                const only = results[0];
+                                const exact = only.variants?.find((v) => v.barcode === parsed.barcode);
+                                pick(only, exact);
+                            }
+                        } })] }), parsed.kind === 'tire_size' && (_jsxs("p", { className: "text-xs text-muted-foreground", children: [t('productPicker.tireSize', { defaultValue: 'Medida de llanta' }), ": ", parsed.tire.normalized] })), loading && _jsx("p", { className: "text-sm text-muted-foreground", children: t('common.searching', { defaultValue: 'Buscando…' }) }), error && !loading && (_jsx("p", { role: "alert", className: "text-sm text-destructive", children: t('productPicker.error', { defaultValue: 'No se pudo buscar. Revisa tu conexión e inténtalo de nuevo.' }) })), !loading && !error && parsed.kind !== 'empty' && text.trim().length >= 2 && results.length === 0 && (_jsx(EmptyState, { title: t('productPicker.empty', { defaultValue: 'No encontramos ese producto' }), description: t('productPicker.emptyHint', { defaultValue: 'Prueba con otra medida, SKU o código de barras.' }) })), results.length > 0 && (_jsx("ul", { role: "listbox", className: "max-h-72 divide-y overflow-auto rounded-md border", children: results.map((p) => {
+                    const stock = availableStock(p, warehouseId);
+                    const hasVariants = (p.variants?.length ?? 0) > 0;
+                    return (_jsxs("li", { role: "option", "aria-selected": false, className: "px-2 py-1.5", children: [_jsxs("button", { type: "button", className: "flex w-full items-center justify-between gap-2 text-left disabled:opacity-50", disabled: hasVariants || (!allowOutOfStock && stock != null && stock <= 0), onClick: () => pick(p), children: [_jsxs("span", { children: [_jsx("span", { className: "block text-sm font-medium", children: p.name }), _jsx("span", { className: "block text-xs text-muted-foreground", children: [p.sku, p.tire?.normalized, p.supplier_sku && `Prov. ${p.supplier_sku}`].filter(Boolean).join(' · ') })] }), _jsxs("span", { className: "flex items-center gap-2", children: [stock != null && (_jsx(Badge, { variant: stock > 0 ? 'success' : 'danger', children: stock > 0 ? t('productPicker.inStock', { defaultValue: '{{n}} disp.', n: stock }) : t('productPicker.outOfStock', { defaultValue: 'Sin existencia' }) })), p.price != null && !hasVariants && _jsx("span", { className: "text-sm tabular-nums", children: fmt.money(p.price) })] })] }), hasVariants && (_jsx("ul", { className: "mt-1 space-y-0.5 pl-3", children: p.variants.map((v) => {
+                                    const vs = availableStock(v, warehouseId);
+                                    return (_jsx("li", { children: _jsxs("button", { type: "button", className: "flex w-full items-center justify-between gap-2 rounded px-1 py-0.5 text-left text-sm hover:bg-accent disabled:opacity-50", disabled: !allowOutOfStock && vs != null && vs <= 0, onClick: () => pick(p, v), children: [_jsx("span", { children: v.label }), _jsxs("span", { className: "flex items-center gap-2", children: [vs != null && _jsx(Badge, { variant: vs > 0 ? 'success' : 'danger', children: vs }), (v.price ?? p.price) != null && _jsx("span", { className: "tabular-nums", children: fmt.money(v.price ?? p.price) })] })] }) }, v.id));
+                                }) }))] }, p.id));
+                }) }))] }));
+}

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

@@ -0,0 +1,70 @@
+import type { LineItem } from './line-items';
+export interface TireSize {
+    width: number;
+    ratio: number;
+    rim: number;
+    /** Forma canónica `205/55R16`. */
+    normalized: string;
+}
+export type ProductQuery = {
+    kind: 'empty';
+    raw: string;
+} | {
+    kind: 'barcode';
+    raw: string;
+    barcode: string;
+} | {
+    kind: 'tire_size';
+    raw: string;
+    tire: TireSize;
+} | {
+    kind: 'text';
+    raw: string;
+    text: string;
+};
+export declare function parseTireSize(input: string): TireSize | null;
+export declare function parseProductQuery(raw: string): ProductQuery;
+export interface StockByWarehouse {
+    warehouse_id: string;
+    warehouse_name?: string;
+    available: number;
+}
+export interface ProductVariant {
+    id: string;
+    /** «Rin 16 · 205/55R16 · 91V». */
+    label: string;
+    sku?: string;
+    barcode?: string;
+    price?: number;
+    stock?: StockByWarehouse[];
+}
+export interface ProductResult {
+    id: string;
+    name: string;
+    sku?: string;
+    barcode?: string;
+    /** Clave del proveedor (búsqueda por SKU del proveedor). */
+    supplier_sku?: string;
+    kind?: 'product' | 'tire' | 'service' | 'bundle';
+    price?: number;
+    tax_rate?: number;
+    tire?: TireSize;
+    variants?: ProductVariant[];
+    stock?: StockByWarehouse[];
+    /** Paquetes automáticos: ids/nombres que se sugieren junto al producto. */
+    bundle_items?: Array<{
+        product_id: string;
+        name: string;
+        quantity: number;
+    }>;
+}
+/** Existencia disponible: de la variante o del producto, en un almacén o en total. */
+export declare function availableStock(source: {
+    stock?: StockByWarehouse[];
+}, warehouseId?: string): number | undefined;
+/** Producto (+ variante) → renglón listo para <LineItemsEditor>. */
+export declare function productToLine(p: ProductResult, variant?: ProductVariant, opts?: {
+    warehouseId?: string;
+    quantity?: number;
+}): LineItem;
+//# sourceMappingURL=product-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"product-search.d.ts","sourceRoot":"","sources":["../../src/business/product-search.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAG5C,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,MAAM,YAAY,GAClB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAMjD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAW5D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAO3D;AAED,MAAM,WAAW,gBAAgB;IAC7B,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAA;IAChD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAA;IAC3B,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC1B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC/E;AAED,sFAAsF;AACtF,wBAAgB,cAAc,CAC1B,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAAE,EACtC,WAAW,CAAC,EAAE,MAAM,GACrB,MAAM,GAAG,SAAS,CAKpB;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CACzB,CAAC,EAAE,aAAa,EAChB,OAAO,CAAC,EAAE,cAAc,EACxB,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GACvD,QAAQ,CAWV"}

package/dist/business/product-search.js

@@ -0,0 +1,51 @@
+import { makeLine } from './line-items';
+// 205/55R16, 205 55 16, 205-55-16, 205/55ZR16, 2055516 (sin separadores).
+const TIRE_RE = /^(\d{3})\s*[\/\-x\s]?\s*(\d{2})\s*[\/\-x\s]?\s*(?:z?r|-)?\s*(\d{2})$/i;
+const BARCODE_RE = /^\d{8,14}$/;
+export function parseTireSize(input) {
+    const s = input.trim();
+    // 7 dígitos pegados también son medida, pero 8+ dígitos es código de barras.
+    if (BARCODE_RE.test(s))
+        return null;
+    const m = TIRE_RE.exec(s);
+    if (!m)
+        return null;
+    const width = Number(m[1]);
+    const ratio = Number(m[2]);
+    const rim = Number(m[3]);
+    if (width < 125 || width > 395 || ratio < 25 || ratio > 95 || rim < 10 || rim > 26)
+        return null;
+    return { width, ratio, rim, normalized: `${width}/${ratio}R${rim}` };
+}
+export function parseProductQuery(raw) {
+    const s = raw.trim();
+    if (!s)
+        return { kind: 'empty', raw };
+    if (BARCODE_RE.test(s))
+        return { kind: 'barcode', raw, barcode: s };
+    const tire = parseTireSize(s);
+    if (tire)
+        return { kind: 'tire_size', raw, tire };
+    return { kind: 'text', raw, text: s };
+}
+/** Existencia disponible: de la variante o del producto, en un almacén o en total. */
+export function availableStock(source, warehouseId) {
+    if (!source.stock)
+        return undefined;
+    return source.stock
+        .filter((s) => !warehouseId || s.warehouse_id === warehouseId)
+        .reduce((n, s) => n + s.available, 0);
+}
+/** Producto (+ variante) → renglón listo para <LineItemsEditor>. */
+export function productToLine(p, variant, opts = {}) {
+    const src = variant ?? p;
+    return makeLine({
+        product_id: variant?.id ?? p.id,
+        sku: variant?.sku ?? p.sku,
+        description: variant ? `${p.name} · ${variant.label}` : p.name,
+        quantity: opts.quantity ?? 1,
+        unit_price: variant?.price ?? p.price ?? 0,
+        tax_rate: p.tax_rate ?? 0,
+        available: availableStock(src, opts.warehouseId) ?? availableStock(p, opts.warehouseId),
+    });
+}

package/dist/business/refund-destination.d.ts

@@ -0,0 +1,19 @@
+import { type RefundAllocation, type RefundDestinationOption, type RefundValidation } from './refund';
+export interface RefundDestinationProps {
+    /** Monto total a reembolsar. */
+    total: number;
+    value: RefundAllocation[];
+    onChange: (allocations: RefundAllocation[]) => void;
+    /** Destinos ofrecidos (default: los cinco). Filtra/limita según el documento. */
+    options?: RefundDestinationOption[];
+    /** Emite la validación tras cada cambio (para bloquear «Confirmar»). */
+    onValidate?: (v: RefundValidation) => void;
+    /** Errores del servidor `"<índice>.<campo>"`. */
+    serverErrors?: Record<string, string>;
+    /** Permite repartir entre varios destinos. Default false (un solo destino). */
+    allowSplit?: boolean;
+    currency?: string;
+    disabled?: boolean;
+}
+export declare function RefundDestination({ total, value, onChange, options, onValidate, serverErrors, allowSplit, currency, disabled, }: RefundDestinationProps): import("react").JSX.Element;
+//# sourceMappingURL=refund-destination.d.ts.map

package/dist/business/refund-destination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refund-destination.d.ts","sourceRoot":"","sources":["../../src/business/refund-destination.tsx"],"names":[],"mappings":"AAMA,OAAO,EAIH,KAAK,gBAAgB,EAErB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACxB,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,sBAAsB;IACnC,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,gBAAgB,EAAE,CAAA;IACzB,QAAQ,EAAE,CAAC,WAAW,EAAE,gBAAgB,EAAE,KAAK,IAAI,CAAA;IACnD,iFAAiF;IACjF,OAAO,CAAC,EAAE,uBAAuB,EAAE,CAAA;IACnC,wEAAwE;IACxE,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAC1C,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,+EAA+E;IAC/E,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,wBAAgB,iBAAiB,CAAC,EAC9B,KAAK,EACL,KAAK,EACL,QAAQ,EACR,OAAqC,EACrC,UAAU,EACV,YAAY,EACZ,UAAkB,EAClB,QAAQ,EACR,QAAQ,GACX,EAAE,sBAAsB,+BA6ExB"}

package/dist/business/refund-destination.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// RefundDestination — a dónde regresa el dinero: efectivo, tarjeta, monedero,
+// saldo a favor o NC CFDI (benchmark §7, POS-3/DEV-*).
+import { useMemo } from 'react';
+import { useTranslation } from 'react-i18next';
+import { Button, Input } from '@asteby/metacore-ui';
+import { useFormatter, roundMoney } from './format';
+import { DEFAULT_REFUND_DESTINATIONS, singleDestination, validateRefund, } from './refund';
+export function RefundDestination({ total, value, onChange, options = DEFAULT_REFUND_DESTINATIONS, onValidate, serverErrors, allowSplit = false, currency, disabled, }) {
+    const { t } = useTranslation();
+    const fmt = useFormatter({ currency });
+    const validation = useMemo(() => validateRefund(total, value, options), [total, value, options]);
+    const errors = { ...validation.errors, ...serverErrors };
+    const chosen = (k) => value.some((a) => a.kind === k);
+    const emit = (next) => {
+        onChange(next);
+        onValidate?.(validateRefund(total, next, options));
+    };
+    const toggle = (o) => {
+        if (!allowSplit)
+            return emit(singleDestination(o.kind, total));
+        if (chosen(o.kind))
+            return emit(value.filter((a) => a.kind !== o.kind));
+        emit([...value, { kind: o.kind, amount: Math.max(0, roundMoney(total - validation.allocated)) }]);
+    };
+    return (_jsxs("div", { "data-slot": "refund-destination", className: "space-y-2", children: [_jsxs("p", { className: "text-sm text-muted-foreground", children: [t('refund.amount', { defaultValue: 'Monto a reembolsar' }), ": ", _jsx("span", { className: "font-semibold text-foreground", children: fmt.money(total) })] }), _jsx("div", { role: allowSplit ? 'group' : 'radiogroup', className: "grid gap-2 sm:grid-cols-2", children: options.map((o) => {
+                    const off = o.available === false;
+                    const on = chosen(o.kind);
+                    return (_jsx(Button, { type: "button", variant: on ? 'default' : 'outline', role: allowSplit ? 'checkbox' : 'radio', "aria-checked": on, disabled: disabled || off, title: off ? o.disabledReason : undefined, className: "h-auto justify-start whitespace-normal py-2 text-left", onClick: () => toggle(o), children: _jsxs("span", { children: [_jsx("span", { className: "block", children: o.label }), off && o.disabledReason && _jsx("span", { className: "block text-xs opacity-70", children: o.disabledReason }), !off && o.maxAmount != null && _jsxs("span", { className: "block text-xs opacity-70", children: [t('refund.max', { defaultValue: 'Máx.' }), " ", fmt.money(o.maxAmount)] })] }) }, o.kind));
+                }) }), value.map((a, i) => (_jsxs("div", { className: "grid grid-cols-[1fr_8rem_10rem] items-start gap-2", children: [_jsx("span", { className: "pt-2 text-sm", children: options.find((o) => o.kind === a.kind)?.label ?? a.kind }), _jsxs("div", { children: [_jsx(Input, { inputMode: "decimal", className: "text-right", value: String(a.amount), disabled: disabled || !allowSplit, "aria-invalid": !!errors[`${i}.amount`], onChange: (e) => emit(value.map((x, j) => (j === i ? { ...x, amount: Number(e.target.value.replace(',', '.')) || 0 } : x))) }), errors[`${i}.amount`] && _jsx("p", { className: "mt-0.5 text-xs text-destructive", children: errors[`${i}.amount`] })] }), (a.kind === 'card' || a.kind === 'transfer' || a.kind === 'credit_note') && (_jsx(Input, { placeholder: a.kind === 'card' || a.kind === 'transfer' ? t('refund.cardRef', { defaultValue: 'Referencia' }) : t('refund.ncRef', { defaultValue: 'Folio / UUID relacionado' }), value: a.reference ?? '', disabled: disabled, onChange: (e) => emit(value.map((x, j) => (j === i ? { ...x, reference: e.target.value } : x))) })), errors[`${i}.kind`] && _jsx("p", { className: "col-span-3 text-xs text-destructive", children: errors[`${i}.kind`] })] }, a.kind))), validation.form && value.length > 0 && _jsx("p", { role: "alert", className: "text-sm text-destructive", children: validation.form })] }));
+}

package/dist/business/refund.d.ts

@@ -0,0 +1,29 @@
+export type RefundDestinationKind = 'cash' | 'card' | 'transfer' | 'wallet' | 'store_credit' | 'credit_note';
+export interface RefundDestinationOption {
+    kind: RefundDestinationKind;
+    label: string;
+    /** Tope reembolsable por este destino (p. ej. lo pagado con tarjeta). */
+    maxAmount?: number;
+    /** false → la opción se muestra deshabilitada con `disabledReason`. */
+    available?: boolean;
+    disabledReason?: string;
+}
+export interface RefundAllocation {
+    kind: RefundDestinationKind;
+    amount: number;
+    /** Referencia del reembolso a tarjeta / folio de NC relacionada. */
+    reference?: string;
+}
+/** Catálogo por defecto: el llamador filtra/limita según el documento. */
+export declare const DEFAULT_REFUND_DESTINATIONS: RefundDestinationOption[];
+export interface RefundValidation {
+    errors: Record<string, string>;
+    form?: string;
+    allocated: number;
+    remaining: number;
+    valid: boolean;
+}
+export declare function validateRefund(total: number, allocations: RefundAllocation[], options?: RefundDestinationOption[]): RefundValidation;
+/** Un solo destino cubriendo todo el monto (caso común). */
+export declare function singleDestination(kind: RefundDestinationKind, total: number): RefundAllocation[];
+//# sourceMappingURL=refund.d.ts.map

package/dist/business/refund.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refund.d.ts","sourceRoot":"","sources":["../../src/business/refund.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,cAAc,GAAG,aAAa,CAAA;AAE5G,MAAM,WAAW,uBAAuB;IACpC,IAAI,EAAE,qBAAqB,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uEAAuE;IACvE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,qBAAqB,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,0EAA0E;AAC1E,eAAO,MAAM,2BAA2B,EAAE,uBAAuB,EAOhE,CAAA;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,OAAO,CAAA;CACjB;AAED,wBAAgB,cAAc,CAC1B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,gBAAgB,EAAE,EAC/B,OAAO,GAAE,uBAAuB,EAAgC,GACjE,gBAAgB,CAqBlB;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAEhG"}

package/dist/business/refund.js

@@ -0,0 +1,44 @@
+// Destino de un reembolso (ReturnWizard, cancelación de apartado, anticipos).
+// Lógica pura de <RefundDestination>.
+import { roundMoney, toAmount } from './format';
+/** Catálogo por defecto: el llamador filtra/limita según el documento. */
+export const DEFAULT_REFUND_DESTINATIONS = [
+    { kind: 'cash', label: 'Efectivo' },
+    { kind: 'card', label: 'Tarjeta' },
+    { kind: 'transfer', label: 'Transferencia' },
+    { kind: 'wallet', label: 'Monedero' },
+    { kind: 'store_credit', label: 'Saldo a favor' },
+    { kind: 'credit_note', label: 'Nota de crédito (CFDI)' },
+];
+export function validateRefund(total, allocations, options = DEFAULT_REFUND_DESTINATIONS) {
+    const byKind = new Map(options.map((o) => [o.kind, o]));
+    const errors = {};
+    let allocated = 0;
+    const seen = new Set();
+    allocations.forEach((a, i) => {
+        const o = byKind.get(a.kind);
+        const amt = toAmount(a.amount);
+        allocated += amt;
+        if (!o || o.available === false)
+            errors[`${i}.kind`] = o?.disabledReason ?? 'Destino no disponible';
+        if (seen.has(a.kind))
+            errors[`${i}.kind`] = 'Ese destino ya está en la lista';
+        seen.add(a.kind);
+        if (amt <= 0)
+            errors[`${i}.amount`] = 'Captura un monto mayor a cero';
+        else if (o?.maxAmount != null && amt > o.maxAmount)
+            errors[`${i}.amount`] = `El máximo para ${o.label} es ${o.maxAmount}`;
+    });
+    allocated = roundMoney(allocated);
+    const remaining = roundMoney(total - allocated);
+    let form;
+    if (allocations.length === 0)
+        form = 'Elige a dónde se devuelve el dinero';
+    else if (remaining !== 0)
+        form = remaining > 0 ? 'Falta asignar parte del reembolso' : 'La suma excede el monto a reembolsar';
+    return { errors, form, allocated, remaining, valid: !form && Object.keys(errors).length === 0 };
+}
+/** Un solo destino cubriendo todo el monto (caso común). */
+export function singleDestination(kind, total) {
+    return [{ kind, amount: roundMoney(total) }];
+}

package/dist/business/return-wizard.d.ts

@@ -0,0 +1,23 @@
+import { type RefundDestinationOption } from './refund';
+import { type ReturnSubmitPayload, type ReturnableLine } from './return';
+export interface ReturnWizardProps {
+    lines: ReturnableLine[];
+    /** ¿Hay un addon de almacén que confirma la recepción? Sin él, «Recibir» es un paso. */
+    warehouseConnected?: boolean;
+    /** La venta está facturada: habilita la NC CFDI con relación 01/03 automática. */
+    invoiced?: boolean;
+    /** Destinos de reembolso; `credit_note` se deshabilita solo si no está facturada. */
+    refundOptions?: RefundDestinationOption[];
+    reasons?: {
+        value: string;
+        label: string;
+    }[];
+    currency?: string;
+    submitting?: boolean;
+    /** Errores del servidor (`"<key>.<campo>"`). */
+    serverErrors?: Record<string, string>;
+    onSubmit: (payload: ReturnSubmitPayload) => void | Promise<void>;
+    onCancel?: () => void;
+}
+export declare function ReturnWizard({ lines, warehouseConnected, invoiced, refundOptions, reasons, currency, submitting, serverErrors, onSubmit, onCancel, }: ReturnWizardProps): import("react").JSX.Element;
+//# sourceMappingURL=return-wizard.d.ts.map

package/dist/business/return-wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"return-wizard.d.ts","sourceRoot":"","sources":["../../src/business/return-wizard.tsx"],"names":[],"mappings":"AAQA,OAAO,EAGH,KAAK,uBAAuB,EAC/B,MAAM,UAAU,CAAA;AACjB,OAAO,EAcH,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACtB,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,wFAAwF;IACxF,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,qFAAqF;IACrF,aAAa,CAAC,EAAE,uBAAuB,EAAE,CAAA;IACzC,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,QAAQ,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACxB;AAYD,wBAAgB,YAAY,CAAC,EACzB,KAAK,EACL,kBAA0B,EAC1B,QAAgB,EAChB,aAA2C,EAC3C,OAAyB,EACzB,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,QAAQ,GACX,EAAE,iBAAiB,+BAyJnB"}

package/dist/business/return-wizard.js

@@ -0,0 +1,59 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+// ReturnWizard («Devolver mercancía») — un solo componente para POS, Pedido,
+// Factura, RMA y OT (benchmark §7, DEV-2). No conoce endpoints: recibe los
+// renglones devolvibles y entrega un payload por `onSubmit`.
+import { useMemo, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { Button, Input } from '@asteby/metacore-ui';
+import { useFormatter } from './format';
+import { RefundDestination } from './refund-destination';
+import { DEFAULT_REFUND_DESTINATIONS, } from './refund';
+import { RETURN_CONDITION_DESTINATIONS, computeReturnTotals, creditNoteRelation, defaultStockDestination, returnSteps, returnableQty, serializeReturn, validateReturnChoices, validateReturnRefund, } from './return';
+const DEFAULT_REASONS = [
+    { value: 'not_wanted', label: 'No lo quiso' },
+    { value: 'defective', label: 'Defectuoso' },
+    { value: 'wrong_item', label: 'Producto equivocado' },
+    { value: 'warranty', label: 'Garantía' },
+];
+const STOCK_LABEL = { stock: 'Regresa a stock', scrap: 'Merma', warranty: 'Garantía con proveedor' };
+const STEP_LABEL = { lines: 'Renglones', condition: 'Condición', receive: 'Recibir', refund: 'Reembolso' };
+export function ReturnWizard({ lines, warehouseConnected = false, invoiced = false, refundOptions = DEFAULT_REFUND_DESTINATIONS, reasons = DEFAULT_REASONS, currency, submitting, serverErrors, onSubmit, onCancel, }) {
+    const { t } = useTranslation();
+    const fmt = useFormatter({ currency });
+    const steps = useMemo(() => returnSteps({ warehouseConnected }), [warehouseConnected]);
+    const [stepIdx, setStepIdx] = useState(0);
+    const [choices, setChoices] = useState({});
+    const [reason, setReason] = useState('');
+    const [notes, setNotes] = useState('');
+    const [received, setReceived] = useState(false);
+    const [refund, setRefund] = useState([]);
+    const step = steps[stepIdx];
+    const totals = useMemo(() => computeReturnTotals(lines, choices), [lines, choices]);
+    const validation = useMemo(() => validateReturnChoices(lines, choices, reason), [lines, choices, reason]);
+    const relation = useMemo(() => creditNoteRelation(lines, choices), [lines, choices]);
+    const options = useMemo(() => refundOptions.map((o) => o.kind === 'credit_note' && !invoiced
+        ? { ...o, available: false, disabledReason: 'La venta no está facturada' }
+        : o.kind === 'credit_note'
+            ? { ...o, label: `${o.label} · relación ${relation}` }
+            : o), [refundOptions, invoiced, relation]);
+    const refundValidation = useMemo(() => validateReturnRefund(totals.total, refund, options), [totals.total, refund, options]);
+    const errors = { ...validation.errors, ...serverErrors };
+    const setChoice = (key, patch) => setChoices((prev) => {
+        const cur = prev[key] ?? { quantity: 0, condition: 'sellable', destination: 'stock' };
+        const next = { ...cur, ...patch };
+        if (patch.condition && !patch.destination)
+            next.destination = defaultStockDestination(patch.condition);
+        return { ...prev, [key]: next };
+    });
+    const canNext = step === 'lines' ? validation.valid
+        : step === 'condition' ? validation.valid
+            : step === 'receive' ? received
+                : refundValidation.valid;
+    const submit = () => onSubmit(serializeReturn({ lines, choices, reason, notes, received: warehouseConnected ? false : received, refund }));
+    return (_jsxs("div", { "data-slot": "return-wizard", className: "space-y-4", children: [_jsxs("ol", { className: "flex flex-wrap gap-2 text-xs", children: [steps.map((s, i) => (_jsxs("li", { "aria-current": i === stepIdx ? 'step' : undefined, className: i === stepIdx ? 'font-semibold text-foreground' : 'text-muted-foreground', children: [i + 1, ". ", t(`returns.step.${s}`, { defaultValue: STEP_LABEL[s] })] }, s))), warehouseConnected && (_jsx("li", { className: "text-muted-foreground", children: t('returns.step.warehouse', { defaultValue: 'Almacén confirma la recepción' }) }))] }), (step === 'lines' || step === 'condition') && (_jsxs("div", { className: "space-y-2", children: [lines.map((l) => {
+                        const c = choices[l.key];
+                        const max = returnableQty(l);
+                        return (_jsxs("div", { className: "grid gap-2 rounded-md border p-2 sm:grid-cols-[1fr_6rem_auto]", children: [_jsxs("div", { children: [_jsx("p", { className: "text-sm font-medium", children: l.description }), _jsxs("p", { className: "text-xs text-muted-foreground", children: [t('returns.sold', { defaultValue: 'Vendido' }), ": ", l.sold, " \u00B7 ", t('returns.returnable', { defaultValue: 'Por devolver' }), ": ", max, " \u00B7 ", fmt.money(l.unit_price)] })] }), step === 'lines' ? (_jsxs("div", { children: [_jsx(Input, { inputMode: "decimal", className: "text-right", "aria-label": l.description, disabled: max === 0, value: c ? String(c.quantity) : '', placeholder: "0", onChange: (e) => setChoice(l.key, { quantity: Number(e.target.value.replace(',', '.')) || 0 }) }), errors[`${l.key}.quantity`] && _jsx("p", { className: "mt-0.5 text-xs text-destructive", children: errors[`${l.key}.quantity`] })] })) : ((c?.quantity ?? 0) > 0 && (_jsxs("div", { className: "sm:col-span-2 flex flex-wrap items-center gap-2", children: [['sellable', 'defective'].map((cond) => (_jsx(Button, { type: "button", size: "sm", variant: c.condition === cond ? 'default' : 'outline', onClick: () => setChoice(l.key, { condition: cond }), children: cond === 'sellable' ? t('returns.sellable', { defaultValue: 'Vendible' }) : t('returns.defective', { defaultValue: 'Defectuoso' }) }, cond))), RETURN_CONDITION_DESTINATIONS[c.condition].length > 1 &&
+                                            RETURN_CONDITION_DESTINATIONS[c.condition].map((d) => (_jsx(Button, { type: "button", size: "sm", variant: c.destination === d ? 'secondary' : 'ghost', onClick: () => setChoice(l.key, { destination: d }), children: STOCK_LABEL[d] }, d))), RETURN_CONDITION_DESTINATIONS[c.condition].length === 1 && (_jsx("span", { className: "text-xs text-muted-foreground", children: STOCK_LABEL[c.destination] })), errors[`${l.key}.destination`] && _jsx("p", { className: "w-full text-xs text-destructive", children: errors[`${l.key}.destination`] })] })))] }, l.key));
+                    }), step === 'lines' && (_jsxs("div", { className: "grid gap-2 sm:grid-cols-2", children: [_jsxs("select", { className: "h-9 rounded-md border bg-background px-2 text-sm", value: reason, onChange: (e) => setReason(e.target.value), "aria-label": t('returns.reason', { defaultValue: 'Motivo' }), children: [_jsxs("option", { value: "", children: [t('returns.reason', { defaultValue: 'Motivo' }), "\u2026"] }), reasons.map((r) => (_jsx("option", { value: r.value, children: r.label }, r.value)))] }), _jsx(Input, { value: notes, onChange: (e) => setNotes(e.target.value), placeholder: t('returns.notes', { defaultValue: 'Notas (opcional)' }) })] })), validation.form && stepIdx === 0 && Object.keys(choices).length > 0 && _jsx("p", { role: "alert", className: "text-sm text-destructive", children: validation.form })] })), step === 'receive' && (_jsxs("label", { className: "flex items-start gap-2 rounded-md border p-3 text-sm", children: [_jsx("input", { type: "checkbox", className: "mt-1", checked: received, onChange: (e) => setReceived(e.target.checked) }), _jsx("span", { children: t('returns.receiveHere', { defaultValue: 'Confirmo que la mercancía ya está en tienda. No hay almacén que la reciba, así que la recepción se registra aquí.' }) })] })), step === 'refund' && (_jsx(RefundDestination, { total: totals.total, value: refund, onChange: setRefund, options: options, currency: currency, allowSplit: true, serverErrors: serverErrors })), _jsxs("div", { className: "flex items-center justify-between gap-2 border-t pt-3", children: [_jsxs("span", { className: "text-sm", children: [t('returns.total', { defaultValue: 'Total a devolver' }), ": ", _jsx("strong", { children: fmt.money(totals.total) })] }), _jsxs("div", { className: "flex gap-2", children: [onCancel && stepIdx === 0 && _jsx(Button, { type: "button", variant: "outline", onClick: onCancel, children: t('common.cancel', { defaultValue: 'Cancelar' }) }), stepIdx > 0 && _jsx(Button, { type: "button", variant: "outline", onClick: () => setStepIdx(stepIdx - 1), children: t('common.back', { defaultValue: 'Atrás' }) }), stepIdx < steps.length - 1 ? (_jsx(Button, { type: "button", disabled: !canNext, onClick: () => setStepIdx(stepIdx + 1), children: t('common.next', { defaultValue: 'Siguiente' }) })) : (_jsxs(Button, { type: "button", disabled: !canNext || submitting, onClick: submit, children: [t('returns.confirm', { defaultValue: 'Confirmar devolución' }), " ", fmt.money(totals.total)] }))] })] })] }));
+}

package/dist/business/return.d.ts

@@ -0,0 +1,90 @@
+import { type RefundAllocation, type RefundDestinationOption } from './refund';
+/** Estado físico de lo que regresa. */
+export type ReturnCondition = 'sellable' | 'defective';
+/** A dónde va la mercancía: stock vendible, merma o garantía (reclamo al proveedor). */
+export type ReturnStockDestination = 'stock' | 'scrap' | 'warranty';
+export declare const RETURN_CONDITION_DESTINATIONS: Record<ReturnCondition, ReturnStockDestination[]>;
+/** Destino por defecto de una condición (vendible → stock, defectuoso → merma). */
+export declare function defaultStockDestination(condition: ReturnCondition): ReturnStockDestination;
+/** Renglón devolvible: lo vendido menos lo ya devuelto. */
+export interface ReturnableLine {
+    key: string;
+    product_id?: string;
+    description: string;
+    sold: number;
+    alreadyReturned?: number;
+    /** Precio unitario neto de descuento tal como se vendió (congelado). */
+    unit_price: number;
+    /** Fracción (0.16). */
+    tax_rate?: number;
+}
+export interface ReturnLineChoice {
+    quantity: number;
+    condition: ReturnCondition;
+    destination: ReturnStockDestination;
+}
+export type ReturnChoices = Record<string, ReturnLineChoice>;
+export declare function returnableQty(l: ReturnableLine): number;
+export interface ReturnTotals {
+    base: number;
+    tax: number;
+    total: number;
+    goodsLines: number;
+}
+export declare function computeReturnTotals(lines: ReturnableLine[], choices: ReturnChoices): ReturnTotals;
+/**
+ * Relación SAT (c_TipoRelacion) de la NC: 03 «devolución de mercancía» si regresan
+ * renglones con producto; 01 «nota de crédito de los documentos relacionados» si es
+ * solo ajuste de importe. Misma regla que aplica el backend al proyectar la NC.
+ */
+export declare function creditNoteRelation(lines: ReturnableLine[], choices: ReturnChoices): '01' | '03';
+export interface ReturnValidation {
+    errors: Record<string, string>;
+    form?: string;
+    valid: boolean;
+}
+export declare function validateReturnChoices(lines: ReturnableLine[], choices: ReturnChoices, reason?: string, requireReason?: boolean): ReturnValidation;
+/** Pasos visibles. Sin almacén, «Recibir» es un paso del mismo asistente (PIT-021). */
+export type ReturnStep = 'lines' | 'condition' | 'receive' | 'refund';
+export declare function returnSteps(opts: {
+    warehouseConnected: boolean;
+}): ReturnStep[];
+export interface ReturnSubmitPayload {
+    reason: string;
+    notes?: string;
+    /** true cuando el asistente confirmó la recepción (sin almacén). */
+    received: boolean;
+    lines: {
+        key: string;
+        product_id?: string;
+        quantity: number;
+        condition: ReturnCondition;
+        destination: ReturnStockDestination;
+    }[];
+    refund: RefundAllocation[];
+    /** Presente solo si el reembolso incluye una NC CFDI. */
+    credit_note?: {
+        relation: '01' | '03';
+    };
+    totals: ReturnTotals;
+}
+/** Única puerta de salida hacia el backend: solo renglones con cantidad > 0. */
+export declare function serializeReturn(args: {
+    lines: ReturnableLine[];
+    choices: ReturnChoices;
+    reason: string;
+    notes?: string;
+    received: boolean;
+    refund: RefundAllocation[];
+}): ReturnSubmitPayload;
+/** Valida el paso de reembolso contra el total de la devolución. */
+export declare function validateReturnRefund(total: number, refund: RefundAllocation[], options?: RefundDestinationOption[]): import("./refund").RefundValidation;
+export type RmaState = 'draft' | 'authorized' | 'received' | 'settled' | 'closed' | 'rejected' | 'cancelled';
+export declare const RMA_TRANSITIONS: Record<RmaState, RmaState[]>;
+/** Estados a los que se llega con motivo obligatorio. */
+export declare const RMA_REASON_REQUIRED: RmaState[];
+export declare function canTransitionRma(from: RmaState, to: RmaState, reason?: string): {
+    ok: boolean;
+    error?: string;
+};
+//# sourceMappingURL=return.d.ts.map

package/dist/business/return.d.ts.map

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