@asteby/metacore-runtime-react 46.2.3 → 46.3.0

package/src/business/business.test.ts

@@ -2,12 +2,15 @@ import { describe, expect, it } from 'vitest'
 import { createFormatter, formatDate, formatDateTime, formatMoney, roundMoney, toAmount } from './format'
 import { mapApiError } from './field-errors'
 import {
+    computeLine,
     computeTotals,
     makeLine,
     parseLineItems,
     serializeLineItems,
+    taxBreakdown,
     validateLineItems,
 } from './line-items'
+import { addProductLine, lineGridKeyCommand, priceFromProduct } from './document-lines'
 import { newTender, serializePayment, summarizePayment, validatePayment, type PaymentMethodOption } from './payment'
 import { singleDestination, validateRefund } from './refund'
 import { parseProductQuery, parseTireSize, productToLine } from './product-search'
@@ -94,8 +97,48 @@ describe('line items', () => {
         expect(out[0]).toEqual({ position: 1, kind: 'item', description: 'Llanta', quantity: 2, unit_price: 0, discount: 0, tax_rate: 0, lot: 'L1' })
         expect(out[1]).toEqual({ position: 2, kind: 'note', description: 'Nota' })
         expect(out[0]).not.toHaveProperty('key')
+        expect(out[0]).not.toHaveProperty('catalog_price')
+        expect(out[0]).not.toHaveProperty('discount_kind')
+        expect(out[0]).not.toHaveProperty('unit')
         expect(parseLineItems(out)).toHaveLength(2)
     })
+    it('2 × 800 es 1600 neto; el IVA 16% suma 256 y el total 1856', () => {
+        const line = makeLine({ quantity: 2, unit_price: 800, tax_rate: 0.16 })
+        expect(computeLine(line)).toMatchObject({ gross: 1600, net: 1600, tax: 256, total: 1856 })
+        expect(computeTotals([line])).toMatchObject({ subtotal: 1600, tax: 256, total: 1856 })
+        expect(taxBreakdown([line])).toEqual([{ rate: 0.16, base: 1600, tax: 256 }])
+    })
+    it('descuento en importe y tope de cantidad', () => {
+        const line = makeLine({ description: 'x', quantity: 1, unit_price: 100, discount: 15, discount_kind: 'amount' })
+        expect(computeLine(line)).toMatchObject({ discount: 15, net: 85, total: 85 })
+        expect(validateLineItems([makeLine({ description: 'x', quantity: 3, max_quantity: 2 })]).errors['0.quantity']).toMatch(/máximo/)
+        expect(validateLineItems([makeLine({ description: 'x', quantity: 0 })], { allowZeroQuantity: true }).valid).toBe(true)
+        const out = serializeLineItems([makeLine({ description: 'A', unit: 'pza', catalog_price: 800, discount_kind: 'amount', discount: 10 })])
+        expect(out[0]).toMatchObject({ unit: 'pza', catalog_price: 800, discount_kind: 'amount', discount: 10 })
+        expect(out[0]).not.toHaveProperty('cost')
+        expect(out[0]).not.toHaveProperty('max_quantity')
+    })
+})
+
+describe('document lines', () => {
+    const tire = { id: 'p1', name: 'Llanta X', sku: 'LX', price: 1200, cost: 800, tax_rate: 0.16 }
+    it('compras usa el costo y un segundo clic suma cantidad', () => {
+        expect(priceFromProduct(tire, undefined, 'cost')).toBe(800)
+        expect(priceFromProduct(tire, undefined, 'sale')).toBe(1200)
+        const once = addProductLine([], tire, undefined, { priceSource: 'cost' })
+        expect(once[0]).toMatchObject({ quantity: 1, unit_price: 800, catalog_price: 800, sku: 'LX', description: 'Llanta X' })
+        const twice = addProductLine(once, tire, undefined, { priceSource: 'cost' })
+        expect(twice).toHaveLength(1)
+        expect(twice[0]!.quantity).toBe(2)
+        expect(computeLine(twice[0]!)).toMatchObject({ net: 1600, tax: 256, total: 1856 })
+    })
+    it('teclado: Enter agrega, Supr en celda vacía borra, no con sugerencias abiertas', () => {
+        expect(lineGridKeyCommand('Enter', { mode: 'free' })).toBe('add')
+        expect(lineGridKeyCommand('Enter', { suggestionsOpen: true })).toBe('none')
+        expect(lineGridKeyCommand('Enter', { mode: 'from_source' })).toBe('none')
+        expect(lineGridKeyCommand('Backspace', { cellEmpty: true })).toBe('delete')
+        expect(lineGridKeyCommand('Tab')).toBe('next')
+    })
 })
 
 describe('payment', () => {

package/src/business/catalog.ts

@@ -34,12 +34,24 @@ export const BUSINESS_COMPONENTS: readonly BusinessComponentSpec[] = [
         helpers: ['parseProductQuery', 'parseTireSize', 'availableStock', 'productToLine'],
     },
     {
-        name: 'LineItemsEditor',
-        value: 'value: LineItem[]',
+        name: 'DocumentLinesGrid',
+        value: 'value: LineItem[] (LineItemsEditor es el mismo componente)',
         events: ['onChange', 'onValidate', 'onRequestProduct'],
         permissions: ['editPermission (prop, opcional)'],
-        usedBy: ['Cotización', 'Pedido', 'Factura', 'OC', 'Recepción', 'OT', 'RMA', 'NC'],
-        helpers: ['makeLine', 'computeLine', 'computeTotals', 'validateLineItems', 'serializeLineItems', 'parseLineItems'],
+        usedBy: ['Cotización', 'Pedido', 'Factura', 'OC', 'Recepción', 'OT', 'RMA', 'NC', 'Devolución'],
+        helpers: [
+            'makeLine',
+            'computeLine',
+            'computeTotals',
+            'taxBreakdown',
+            'validateLineItems',
+            'serializeLineItems',
+            'parseLineItems',
+            'priceFromProduct',
+            'applyProductToLine',
+            'addProductLine',
+            'lineGridKeyCommand',
+        ],
     },
     {
         name: 'PaymentCapture',

package/src/business/document-lines.ts

@@ -0,0 +1,91 @@
+// Helpers del editor único de renglones (DocumentLinesGrid / LineItemsEditor).
+// Puros: el componente solo pinta. `serializeLineItems` sigue siendo la puerta al backend.
+import { toAmount } from './format'
+import { makeLine, type LineItem } from './line-items'
+import { availableStock, type ProductResult, type ProductVariant } from './product-search'
+
+export type PriceSource = 'sale' | 'cost' | 'origin'
+export type DocumentLinesMode = 'free' | 'from_source'
+
+/** Precio que se escribe en el renglón según el documento. */
+export function priceFromProduct(
+    product: ProductResult,
+    variant: ProductVariant | undefined,
+    source: PriceSource,
+): number {
+    const list = variant?.price ?? product.price
+    const cost = variant?.cost ?? product.cost
+    if (source === 'cost') return cost ?? list ?? 0
+    return list ?? 0
+}
+
+/** Rellena un renglón con el producto elegido (nombre, SKU, precio, costo de catálogo, existencia). */
+export function applyProductToLine(
+    line: LineItem,
+    product: ProductResult,
+    variant?: ProductVariant,
+    opts: { priceSource?: PriceSource; warehouseId?: string; quantity?: number } = {},
+): LineItem {
+    const source = opts.priceSource ?? 'sale'
+    const src = variant ?? product
+    const list = variant?.price ?? product.price
+    const cost = variant?.cost ?? product.cost
+    const catalog = source === 'cost' ? (cost ?? list) : list
+    return {
+        ...line,
+        kind: 'item',
+        product_id: variant?.id ?? product.id,
+        sku: variant?.sku ?? product.sku,
+        description: variant ? `${product.name} · ${variant.label}` : product.name,
+        quantity: opts.quantity ?? (toAmount(line.quantity) || 1),
+        unit_price: priceFromProduct(product, variant, source),
+        catalog_price: catalog,
+        cost,
+        tax_rate: product.tax_rate ?? line.tax_rate ?? 0,
+        available: availableStock(src, opts.warehouseId) ?? availableStock(product, opts.warehouseId),
+    }
+}
+
+/**
+ * Agrega el producto como renglón. Por defecto, un segundo clic del mismo
+ * producto incrementa la cantidad (como el catálogo de Compras) y respeta `max_quantity`.
+ */
+export function addProductLine(
+    lines: LineItem[],
+    product: ProductResult,
+    variant?: ProductVariant,
+    opts: {
+        priceSource?: PriceSource
+        warehouseId?: string
+        quantity?: number
+        mergeSameProduct?: boolean
+    } = {},
+): LineItem[] {
+    const id = variant?.id ?? product.id
+    const addQty = opts.quantity ?? 1
+    if (opts.mergeSameProduct !== false) {
+        const idx = lines.findIndex((l) => l.kind === 'item' && l.product_id === id)
+        if (idx >= 0) {
+            return lines.map((l, i) => {
+                if (i !== idx) return l
+                const next = toAmount(l.quantity) + addQty
+                const capped = l.max_quantity != null ? Math.min(next, toAmount(l.max_quantity)) : next
+                return { ...l, quantity: capped }
+            })
+        }
+    }
+    return [...lines, applyProductToLine(makeLine(), product, variant, { ...opts, quantity: addQty })]
+}
+
+export type LineGridCommand = 'add' | 'next' | 'delete' | 'none'
+
+/** Enter agrega, Tab avanza, Supr/Backspace en celda vacía borra. No actúa si hay sugerencias abiertas. */
+export function lineGridKeyCommand(
+    key: string,
+    opts: { suggestionsOpen?: boolean; cellEmpty?: boolean; mode?: DocumentLinesMode } = {},
+): LineGridCommand {
+    if (key === 'Tab') return 'next'
+    if (key === 'Enter' && !opts.suggestionsOpen && opts.mode !== 'from_source') return 'add'
+    if ((key === 'Delete' || key === 'Backspace') && opts.cellEmpty && opts.mode !== 'from_source') return 'delete'
+    return 'none'
+}

package/src/business/index.ts

@@ -2,6 +2,7 @@ export * from './format'
 export * from './field-errors'
 export * from './feedback'
 export * from './line-items'
+export * from './document-lines'
 export * from './line-items-editor'
 export * from './payment'
 export * from './payment-capture'