arcli 2.1.0 → 2.2.1

package/dist/cli/help.js

@@ -1,17 +1,19 @@
+import { Help } from 'commander';
 import { CERTIFICATE_GUIDE_URL } from '../lib/links.js';
-import { getVoucherKindByFamilyAndLetter, getVoucherKindByShortcut, VOUCHER_LETTERS, } from '../modules/billing/voucher-kind-map.js';
+import { getVoucherKindByFamilyAndLetter, getVoucherKindByShortcut, VOUCHER_FAMILIES, VOUCHER_LETTERS, } from '../modules/billing/voucher-kind-map.js';
 import { CONFIG_LABELS, CONFIG_SECTIONS } from '../modules/config/config.sections.js';
-import { buildMinimalFamilyExample, buildMinimalShortcutExample } from '../modules/examples/examples.js';
+import { buildMinimalFamilyExample, buildMinimalShortcutExample, EXPORT_MINIMAL_EXAMPLE, } from '../modules/examples/examples.js';
+import { EXPORT_VOUCHER_KIND } from '../modules/export/export.types.js';
 import { CONFIG_FIELDS } from '../modules/interactive/config-fields.js';
 import { renderLogo } from '../ui/index.js';
 import { CLI_VERSION } from './version.js';
 const FAMILY_LABELS = {
     factura: 'Factura',
-    'factura-credito-electronica': 'Factura de credito electronica',
-    'nota-credito': 'Nota de credito',
-    'nota-credito-electronica': 'Nota de credito electronica',
-    'nota-debito': 'Nota de debito',
-    'nota-debito-electronica': 'Nota de debito electronica',
+    'factura-credito-electronica': 'Factura de crédito electrónica',
+    'nota-credito': 'Nota de crédito',
+    'nota-credito-electronica': 'Nota de crédito electrónica',
+    'nota-debito': 'Nota de débito',
+    'nota-debito-electronica': 'Nota de débito electrónica',
 };
 const FAMILY_SHORTCUTS = {
     factura: ['fa', 'fb', 'fc'],
@@ -21,347 +23,115 @@ const FAMILY_SHORTCUTS = {
     'nota-debito': ['nda', 'ndb', 'ndc'],
     'nota-debito-electronica': ['ndea', 'ndeb', 'ndec'],
 };
-const AVAILABLE_GENERAL_OPTIONS = [
-    '  - --monto <number> | todas | importe total del comprobante',
-    '  - --punto-venta <number> | --pv <number> | todas | punto de venta emisor',
-    '  - --fecha <fecha> | todas | fecha del comprobante; si falta usa hoy',
-    '  - --concepto <tipo> | -c | todas | productos, servicios o productos-servicios',
-    '  - --cs | --cp | --csp | todas | atajos para concepto',
-    '  - --moneda <codigo> | --mda <codigo> | todas | codigo de moneda, por ejemplo ARS o USD',
-    '  - --cotizacion-moneda <number> | --cm <number> | todas | cotizacion de la moneda elegida; obligatoria en moneda extranjera',
-    '  - --misma-moneda | todas | el pago se cancela en la moneda extranjera; usa la cotizacion oficial de ARCA',
-    '  - --cargar <path> | todas | cargar un comprobante o lote desde JSON',
-    '  - --alicuota <tasa> | letras A y B | general (21), reducida (10.5), incrementada (27), cero (0), 5 o 2.5; por defecto config alicuota o 21',
-    '  - --alicuota <tasa>:<monto> | letras A y B | repetible para varias alicuotas; el monto lleva IVA incluido y --monto pasa a ser opcional',
-    '  - --exento <number> | letras A y B | parte exenta del monto total',
-    '  - --nogravado <number> | letras A y B | parte no gravada del monto total',
-].join('\n');
-const AVAILABLE_IDENTITY_OPTIONS = [
-    '  - --cuit <number> | todas | CUIT del receptor',
-    '  - --cuil <number> | todas | CUIL del receptor',
-    '  - --dni <number> | todas | DNI del receptor',
-    '  - --consumidor-final | --cfinal | todas | consumidor final con documento 0',
-    '  - --iva-receptor <tipo> | --ir <tipo> | todas | condicion IVA del receptor',
-    '  - --ir-* | todas | atajos para IVA receptor, por ejemplo --ir-cf o --ir-ri',
-].join('\n');
-const AVAILABLE_SERVICE_OPTIONS = [
-    '  - -d, --dia <1-31> | servicios o productos-servicios | dia de vencimiento o referencia de servicio',
-    '  - --servicio-desde <fecha> | --sd <fecha> | servicios o productos-servicios | inicio del servicio',
-    '  - --servicio-hasta <fecha> | --sh <fecha> | servicios o productos-servicios | fin del servicio',
-    '  - --vencimiento <fecha> | --vto <fecha> | servicios, productos-servicios y facturas FCE | vencimiento del pago; por defecto el fin del servicio',
-].join('\n');
-const AVAILABLE_ASSOCIATED_OPTIONS = [
-    '  - --ac <shortcut> | notas | shortcut del comprobante asociado',
-    '  - --at <number> | notas | tipo ARCA del comprobante asociado',
-    '  - --asociado-punto-venta <number> | --apv <number> | notas | punto de venta del asociado',
-    '  - --ar <number> | notas | numero del comprobante asociado',
-    '  - --acuit <number> | notas | CUIT del comprobante asociado; en NC/ND FCE por defecto el CUIT emisor',
-    '  - --afecha <fecha> | notas | fecha del comprobante asociado; obligatoria en NC/ND FCE',
-    '  - --periodo-desde <fecha> | --pd <fecha> | notas comunes | inicio del periodo asociado; alternativa a --ac',
-    '  - --periodo-hasta <fecha> | --ph <fecha> | notas comunes | fin del periodo asociado',
-].join('\n');
-const AVAILABLE_FCE_INVOICE_OPTIONS = [
-    '  - --cbu <22 digitos> | facturas FCE | CBU del emisor; obligatorio (o config cbu)',
-    '  - --alias <alias> | facturas FCE | alias del CBU (o config aliasCbu)',
-    '  - --transferencia <sca|adc> | facturas FCE | modalidad de transferencia; por defecto sca',
-].join('\n');
-const AVAILABLE_FCE_NOTE_OPTIONS = [
-    '  - --anulacion | NC/ND FCE | la nota anula una factura rechazada por el comprador',
-].join('\n');
-function resolveFceOptions(isElectronicCredit, isNote) {
-    if (!isElectronicCredit) {
-        return '  - No aplica para este comprobante.';
+/** Lo que vale para cualquier comprobante. */
+const CORE_RULES = [
+    'Usá --emitir o --previsualizar, no los dos.',
+    'Una sola identidad del receptor: --cuit, --cuil, --dni o --consumidor-final.',
+    'Un solo IVA receptor: --iva-receptor o un flag --ir-*.',
+    'Un solo concepto: --concepto o uno entre --cs, --cp y --csp.',
+    'Con servicios: --servicio-desde y --servicio-hasta, o --dia para el día de vencimiento.',
+    'Sin --fecha usa hoy. Lo que no pasás por flag sale del JSON de --cargar o de la config.',
+];
+/** Las reglas que dependen del comprobante; la lista de opciones ya muestra solo las que aplican. */
+function createRules(scope) {
+    const rules = [...CORE_RULES];
+    if (scope.letters.some((letter) => letter !== 'c')) {
+        rules.push('IVA (A y B): --alicuota usa 21 por defecto, o la clave alícuota de la config. Para varias, repetí --alicuota TASA:MONTO con el IVA incluido; --monto pasa a ser opcional.');
+    }
+    if (scope.isNote) {
+        rules.push(scope.isElectronicCredit
+            ? 'Asociado: la factura FCE con --ac o --at, --apv, --ar y --afecha; --acuit toma tu CUIT. Con --anulacion, anula una factura que rechazó el comprador.'
+            : 'Asociado: el comprobante con --ac o --at, --apv, --ar y --acuit, o un período con --periodo-desde y --periodo-hasta.');
     }
-    return isNote ? AVAILABLE_FCE_NOTE_OPTIONS : AVAILABLE_FCE_INVOICE_OPTIONS;
+    else if (scope.isElectronicCredit) {
+        rules.push('FCE: necesita CBU (--cbu o la clave cbu de la config); --transferencia es sca por defecto.');
+    }
+    return section('Reglas', compactList(rules));
 }
-const AVAILABLE_EXECUTION_OPTIONS = [
-    '  - --previsualizar | todas | muestra el payload antes de hablar con ARCA',
-    '  - --emitir | todas | emite realmente el comprobante',
-    '  - --testing | todas | fuerza entorno testing en esta corrida',
-    '  - --produccion | todas | fuerza entorno produccion en esta corrida',
-    '  - --json | todas | salida estructurada para scripts',
-    '  - --bruto | todas | agrega respuesta cruda de ARCA cuando exista',
-].join('\n');
-const CORE_RULES = [
-    '  - ARCLI arma datos desde flags, JSON cargado, config y defaults internos.',
-    '  - Si no pasa fecha, usa hoy.',
-    '  - Use --emitir o --previsualizar, pero no ambos.',
-    '  - Use una sola identidad de receptor: --consumidor-final o --cfinal, o bien --cuit, --cuil o --dni.',
-    '  - Use --iva-receptor, --ir o un solo flag --ir-*, pero no varios a la vez.',
-    '  - Use --concepto o un solo flag entre --cs, --cp y --csp, pero no ambos.',
-].join('\n');
 function section(title, body) {
     return [title, body].join('\n');
 }
 function compactList(values) {
     return values.map((value) => `  - ${value}`).join('\n');
 }
-function formatFamilyShortcuts(family) {
-    const [a, b, c] = FAMILY_SHORTCUTS[family];
-    return compactList([`A -> ${a}`, `B -> ${b}`, `C -> ${c}`]);
-}
-function createProgramQuickStart() {
-    return [
-        'Uso minimo',
-        '  - TL;DR: arcli fc -m 300000 --cs --consumidor-final --ir-cf',
-        '  - Ese ejemplo asume que ya resolviste CUIT emisor, credenciales y punto de venta.',
-        '  - Si todavía no lo hiciste, empezá por: arcli config revisar',
-        '  - Emitir de verdad: arcli fa -m 1 --cs --cuit 20168598204 --ir-ri --emitir --bruto',
-    ].join('\n');
-}
-function createProgramMentalModel() {
-    return [
-        'Como pensar rapido un comando',
-        '  - 1. Elegí el comprobante: fc, fa, nca, ndeb, fcec.',
-        '  - 2. Definí el monto: --monto.',
-        '  - 3. Elegí el concepto: --cs, --cp, --csp o --concepto.',
-        '  - 4. Definí la identidad: --cuit, --cuil, --dni o --consumidor-final.',
-        '  - 5. Definí el IVA receptor: --ir-*, --ir o --iva-receptor.',
-    ].join('\n');
-}
-function createProgramFamilies() {
-    return section('Familias y shortcuts', [
-        '  - factura -> fa, fb, fc',
-        '  - nota-credito -> nca, ncb, ncc',
-        '  - nota-debito -> nda, ndb, ndc',
-        '  - factura-credito-electronica -> fcea, fceb, fcec',
-        '  - nota-credito-electronica -> ncea, nceb, ncec',
-        '  - nota-debito-electronica -> ndea, ndeb, ndec',
-    ].join('\n'));
-}
-function createProgramCommands() {
-    return section('Comandos importantes', [
-        '  - Emitir comprobantes por shortcut: arcli fc ...',
-        '  - Emitir por familia y letra: arcli factura c ...',
-        '  - Ver y guardar config: arcli config',
-        '  - Revisar entorno y credenciales: arcli config revisar',
-        '  - Ver ejemplos listos para copiar: arcli ejemplos',
-        '  - Consultar si un receptor esta obligado a FCE: arcli fce-obligado <cuit>',
-        '  - Ver nombre, domicilio y condicion IVA de un CUIT: arcli padron <cuit>',
-        '  - Asistente paso a paso: arcli (sin argumentos) o arcli interactivo',
-        '  - Ver los ultimos comprobantes emitidos: arcli ultimos fb',
-        '  - Ver el detalle de un comprobante: arcli consultar fb 14',
-        '  - Ver si ARCA responde y el punto de venta esta habilitado: arcli estado',
-        '  - Ver tablas de ARCA (puntos de venta, alicuotas, cotizacion): arcli parametros',
-        '  - Generar el PDF al emitir: arcli fc ... --emitir --exportar-pdf (plugin: arcli pdf instalar)',
-        '  - Ver escenas de UI: arcli storybook',
-    ].join('\n'));
-}
-function createProgramExamples() {
-    return section('Ejemplos utiles', [
-        '  - Basico: arcli fc -m 300000 --cs --consumidor-final --ir-cf',
-        '  - Con CUIT: arcli fa -m 1 --cs --cuit 20168598204 --ir-ri',
-        '  - Nota: arcli nca -m 1 --cs --cuit 20168598204 --ir-ri --ac fa --apv 3 --ar 6 --acuit 20409509763',
-    ].join('\n'));
-}
-function createProgramSafety() {
-    return section('Ejecucion y seguridad', [
-        '  - --previsualizar muestra la solicitud antes de emitir.',
-        '  - --emitir habla de verdad con ARCA.',
-        '  - --produccion cambia al entorno real.',
-        '  - Sin --emitir, en una terminal pregunta antes de emitir (salvo emitir=true en la config).',
-        '  - Para scripts o pipelines, usá --json y evitá automatizar sobre salida humana.',
-    ].join('\n'));
-}
-function createProgramProject() {
-    return section('Proyecto y actualizaciones', [
-        '  - Repositorio: https://github.com/LcsGrz/arcli',
-        '  - Actualizar a la ultima version: npm install -g arcli@latest',
-        '  - Ver la version instalada: arcli --version',
+/** La letra E (exportacion, WSFEX) solo existe en la familia `factura`. */
+function familyShortcuts(family) {
+    return family === EXPORT_VOUCHER_KIND.family
+        ? [...FAMILY_SHORTCUTS[family], EXPORT_VOUCHER_KIND.shortcut]
+        : FAMILY_SHORTCUTS[family];
+}
+/** Los atajos en una tabla familia × letra, en lugar de un renglon por atajo en la lista de comandos. */
+function createProgramVoucherTable() {
+    const width = Math.max(...VOUCHER_FAMILIES.map((family) => family.length)) + 2;
+    const column = (value) => value.padEnd(7);
+    const rows = VOUCHER_FAMILIES.map((family) => `  ${family.padEnd(width)}${familyShortcuts(family).map(column).join('').trimEnd()}`);
+    return section('Comprobantes (atajo por familia y letra)', [
+        `  ${''.padEnd(width)}${['A', 'B', 'C', 'E'].map(column).join('').trimEnd()}`,
+        ...rows,
+        '  arcli fc ... es lo mismo que arcli factura c ...; cada uno tiene su ayuda: arcli fc --ayuda',
     ].join('\n'));
 }
-function createProgramDiscovery() {
-    return section('Descubrimiento', [
-        '  - Ayuda general: arcli ayuda',
-        '  - Ayuda de un shortcut: arcli fc ayuda',
-        '  - Ayuda de una familia: arcli factura ayuda',
-        '  - Ayuda de config: arcli config ayuda',
-        '  - Ayuda de ejemplos: arcli ejemplos ayuda',
-        '  - Ayuda de storybook: arcli storybook ayuda',
-    ].join('\n'));
-}
-function createProgramFrequentErrors() {
-    return section('Errores frecuentes', [
-        '  - Identidad duplicada: no uses --cuit y --consumidor-final juntos.',
-        '  - Falta IVA receptor: elegí --ir-* o --iva-receptor.',
-        '  - Flags incompatibles: no mezcles --emitir y --previsualizar.',
-        '  - JSON invalido o incompleto: revisá el archivo pasado a --cargar.',
-    ].join('\n'));
-}
-function createVoucherSummary(shortcut) {
-    const definition = getVoucherKindByShortcut(shortcut);
-    if (!definition) {
-        return '';
-    }
-    const whenToUse = definition.requiresAssociatedVoucher
-        ? 'Use este shortcut cuando ya sabe el comprobante exacto y necesita informar un asociado compatible.'
-        : 'Use este shortcut cuando ya sabe exactamente que comprobante quiere emitir y quiere escribir menos.';
-    return section('Resumen', [
-        `  - Comprobante: ${definition.displayName}`,
-        `  - Shortcut: arcli ${shortcut}`,
-        `  - Comando largo: arcli ${definition.family} ${definition.letter}`,
-        `  - Tipo ARCA: ${definition.arcaType}`,
-        `  - Cuando usarlo: ${whenToUse}`,
-    ].join('\n'));
-}
-function createShortcutMinimum(shortcut) {
-    const definition = getVoucherKindByShortcut(shortcut);
-    if (!definition) {
-        return '';
-    }
-    const example = `  - Ejemplo minimo: ${buildMinimalShortcutExample(definition)}`;
-    return section('Para empezar', [
-        example,
-        definition.requiresAssociatedVoucher
-            ? '  - Ademas de la estructura base, este comprobante siempre necesita asociado.'
-            : '  - Con eso ya tenés una base funcional para previsualizar o emitir.',
-    ].join('\n'));
-}
-function createShortcutExamples(shortcut) {
+function createProgramQuickStart() {
+    return section('Para empezar', compactList([
+        'Revisá que esté todo listo: arcli config revisar',
+        'Vista previa: arcli fc -m 300000 --cs --consumidor-final --ir-cf',
+        'Emitir: agregá --emitir (sin el flag, en una terminal te pregunta). --produccion usa el entorno real.',
+        'Paso a paso, sin flags: arcli (sin argumentos)',
+        'Un comando se arma con el comprobante, --monto, el concepto (--cs, --cp, --csp), el receptor (--cuit, --dni o --consumidor-final) y su IVA (--ir-*).',
+    ]));
+}
+function createProgramMore() {
+    return section('Más ayuda', compactList([
+        'Ejemplos listos para copiar: arcli ejemplos',
+        'Autocompletado con Tab de comandos y flags: arcli completado instalar',
+        'Para scripts, usá --json: la salida en texto puede cambiar.',
+        'Repositorio: https://github.com/LcsGrz/arcli · Actualizar: npm install -g arcli@latest',
+    ]));
+}
+function createShortcutSummary(shortcut) {
     const definition = getVoucherKindByShortcut(shortcut);
     if (!definition) {
         return '';
     }
     const minimal = buildMinimalShortcutExample(definition);
-    const examples = [
-        `  - Previsualizar: ${minimal} --previsualizar`,
-        `  - Emitir: ${minimal} --emitir --bruto`,
-        `  - JSON: arcli ${shortcut} --cargar ./voucher.json --json`,
-    ];
-    return section('Ejemplos', examples.join('\n'));
-}
-function createShortcutImportantFlags(shortcut) {
-    const definition = getVoucherKindByShortcut(shortcut);
-    if (!definition) {
-        return '';
-    }
-    return section('Flags importantes', [
-        '  - Estructura base: --monto, --concepto/--cs/--cp/--csp, identidad y IVA receptor.',
-        '  - Datos comunes: --pv, --fecha, --moneda, --cm, --cargar.',
-        '  - Servicio: --dia, --sd y --sh cuando el concepto usa servicios.',
-        definition.requiresAssociatedVoucher
-            ? definition.isElectronicCredit
-                ? '  - Asociado: --ac o --at, mas --apv, --ar y --afecha.'
-                : '  - Asociado: --ac o --at, mas --apv, --ar y --acuit; o un periodo con --pd y --ph.'
-            : '  - Asociado: no aplica para este comprobante.',
-        ...(definition.isElectronicCredit
-            ? [
-                definition.requiresAssociatedVoucher
-                    ? '  - FCE: --afecha obligatoria y --anulacion si anula una factura rechazada.'
-                    : '  - FCE: --cbu obligatorio (o config cbu), --alias y --transferencia sca|adc.',
-            ]
-            : []),
-        '  - Salida y ejecucion: --previsualizar, --emitir, --json, --bruto, --testing, --produccion.',
-    ].join('\n'));
-}
-function createShortcutAvailableFlags(shortcut) {
-    const definition = getVoucherKindByShortcut(shortcut);
-    if (!definition) {
-        return '';
-    }
-    return section('Mas parametros disponibles', [
-        'Generales',
-        AVAILABLE_GENERAL_OPTIONS,
-        '',
-        'Receptor e IVA',
-        AVAILABLE_IDENTITY_OPTIONS,
-        '',
-        'Servicio',
-        AVAILABLE_SERVICE_OPTIONS,
-        '',
-        'Comprobante asociado',
-        definition.requiresAssociatedVoucher ? AVAILABLE_ASSOCIATED_OPTIONS : '  - No aplica para este comprobante.',
-        '',
-        'Credito electronico (FCE)',
-        resolveFceOptions(definition.isElectronicCredit, definition.requiresAssociatedVoucher),
-        '',
-        'Ejecucion y salida',
-        AVAILABLE_EXECUTION_OPTIONS,
-    ].join('\n'));
-}
-function createShortcutFrequentErrors(shortcut) {
-    const definition = getVoucherKindByShortcut(shortcut);
-    if (!definition) {
-        return '';
-    }
-    const lines = [
-        '  - No mezcle identidades del receptor.',
-        '  - No mezcle --emitir y --previsualizar.',
-        '  - Si usa --cargar, revise que el JSON tenga claves validas.',
-    ];
-    if (definition.requiresAssociatedVoucher) {
-        lines.push('  - Este comprobante exige asociado; complete --ac, --apv, --ar y --acuit cuando corresponda.');
-    }
-    return section('Errores frecuentes', lines.join('\n'));
+    return [
+        section('Comprobante', compactList([
+            `${definition.displayName}, tipo ARCA ${definition.arcaType}. Es lo mismo que arcli ${definition.family} ${definition.letter}.`,
+        ])),
+        '',
+        section('Ejemplos', compactList([
+            `Vista previa: ${minimal}`,
+            `Emitir: ${minimal} --emitir`,
+            `Desde un JSON: arcli ${shortcut} --cargar ./voucher.json --json`,
+            'Más ejemplos: arcli ejemplos',
+        ])),
+    ].join('\n');
 }
 function createFamilySummary(family) {
-    return section('Resumen', [
-        `  - Familia: ${FAMILY_LABELS[family]}`,
-        `  - Uso: arcli ${family} <a|b|c>`,
-        '  - Letras validas: a, b, c',
-        '  - Use la familia cuando quiera cambiar solo la letra sin aprender todos los shortcuts.',
-        '  - Si ya sabés el comprobante exacto, el shortcut suele ser mas rapido.',
-    ].join('\n'));
-}
-function createFamilyExamples(family) {
-    return section('Ejemplos por letra', [
-        ...VOUCHER_LETTERS.map((letter) => {
-            const definition = getVoucherKindByFamilyAndLetter(family, letter);
-            return definition ? `  - Letra ${letter.toUpperCase()}: ${buildMinimalFamilyExample(definition)}` : '';
-        }),
-        `  - Con JSON: arcli ${family} c --cargar ./voucher.json --json`,
-    ].join('\n'));
-}
-function createFamilySharedFlags(family) {
+    const [a, b, c] = FAMILY_SHORTCUTS[family];
+    const hasExport = family === EXPORT_VOUCHER_KIND.family;
+    const summary = hasExport
+        ? `${FAMILY_LABELS[family]}, letras A, B, C y E (exportación): arcli ${family} <a|b|c|e>. Atajos: ${a}, ${b}, ${c} y ${EXPORT_VOUCHER_KIND.shortcut}. Los flags que no aplican a la letra se saltean con un aviso.`
+        : `${FAMILY_LABELS[family]}, letras A, B y C: arcli ${family} <a|b|c>. Atajos: ${a}, ${b} y ${c}.`;
     return [
-        section('Shortcuts relacionados', formatFamilyShortcuts(family)),
-        '',
-        section('Flags importantes', [
-            '  - Base comun: --monto, --concepto/--cs/--cp/--csp, identidad e IVA receptor.',
-            '  - Datos comunes: --pv, --fecha, --moneda, --cm, --cargar.',
-            '  - Servicio: --dia, --sd y --sh cuando el concepto usa servicios.',
-            family.includes('nota')
-                ? '  - Asociado: esta familia lo exige; usá --ac o --at, mas --apv, --ar y --acuit.'
-                : '  - Asociado: no aplica para esta familia.',
-            '  - Ejecucion y salida: --previsualizar, --emitir, --json, --bruto, --testing, --produccion.',
-        ].join('\n')),
-        '',
-        section('Mas parametros disponibles', [
-            'Generales',
-            AVAILABLE_GENERAL_OPTIONS,
-            '',
-            'Receptor e IVA',
-            AVAILABLE_IDENTITY_OPTIONS,
-            '',
-            'Servicio',
-            AVAILABLE_SERVICE_OPTIONS,
-            '',
-            'Comprobante asociado',
-            family.includes('nota') ? AVAILABLE_ASSOCIATED_OPTIONS : '  - No aplica para esta familia.',
-            '',
-            'Credito electronico (FCE)',
-            resolveFceOptions(family.includes('electronica'), family.includes('nota')),
-            '',
-            'Ejecucion y salida',
-            AVAILABLE_EXECUTION_OPTIONS,
-        ].join('\n')),
+        section('Familia', compactList([summary])),
+        '',
+        section('Ejemplos', compactList([
+            ...VOUCHER_LETTERS.flatMap((letter) => {
+                const definition = getVoucherKindByFamilyAndLetter(family, letter);
+                return definition ? [`Letra ${letter.toUpperCase()}: ${buildMinimalFamilyExample(definition)}`] : [];
+            }),
+            ...(hasExport
+                ? [`Letra E: ${EXPORT_MINIMAL_EXAMPLE.replace('arcli fe -m', `arcli ${family} e --monto`)}`]
+                : []),
+            `Desde un JSON: arcli ${family} c --cargar ./voucher.json --json`,
+        ])),
     ].join('\n');
 }
-function createFamilyFrequentErrors(family) {
-    const lines = [
-        '  - La letra debe ser a, b o c.',
-        '  - No mezcle identidades o conceptos incompatibles.',
-        '  - Si carga JSON, la letra del comando y el contenido deben representar el mismo comprobante.',
-    ];
-    if (family.includes('nota')) {
-        lines.push('  - Las notas requieren un asociado compatible; sin eso ARCLI no puede armar el payload final.');
-    }
-    return section('Errores frecuentes', lines.join('\n'));
-}
 const BOOLEAN_CONFIG_VALUES = 'true/false, si/no o 1/0';
 /** Valores de las claves que el asistente no edita o que, siendo booleanas, aceptan mas formas que si/no. */
 const CONFIG_VALUE_OVERRIDES = {
-    alicuota: 'general, reducida, incrementada, cero o el numero: 0, 2.5, 5, 10.5, 21, 27; por defecto 21',
+    alicuota: 'general, reducida, incrementada, cero o el número: 0, 2.5, 5, 10.5, 21, 27; por defecto 21',
     bruto: BOOLEAN_CONFIG_VALUES,
     consultarPadron: `${BOOLEAN_CONFIG_VALUES}; por defecto si`,
     emitir: BOOLEAN_CONFIG_VALUES,
@@ -402,16 +172,16 @@ export function createConfigHelp() {
         section('Para que sirve', [
             '  - Guardar defaults del CLI para no repetir flags en cada corrida.',
             '  - Definir rutas de certificados y claves por entorno.',
-            '  - Revisar si el entorno esta listo antes de emitir.',
+            '  - Revisar si el entorno está listo antes de emitir.',
         ].join('\n')),
         '',
         section('Casos comunes', [
             '  - Guardar defaults para no repetir flags como puntoVenta, concepto o IVA receptor.',
-            '  - Revisar si testing o produccion tienen credenciales y contexto validos.',
+            '  - Revisar si testing o producción tienen credenciales y contexto válidos.',
             '  - Debuggear por que un comando pide datos que pensabas tener guardados.',
         ].join('\n')),
         '',
-        section('Comandos mas usados', [
+        section('Comandos más usados', [
             '  - Ver config actual: arcli config',
             '  - Revisar entorno: arcli config revisar',
             '  - Ver ruta del archivo: arcli config ruta',
@@ -422,7 +192,7 @@ export function createConfigHelp() {
         createConfigKeysSection(),
         '',
         section('Ejemplos', [
-            '  - arcli config establecer cuit 20409509763',
+            '  - arcli config establecer cuit 20333333334',
             '  - arcli config establecer entorno produccion',
             '  - arcli config establecer ivaReceptor consumidor-final',
             '  - arcli config establecer key.produccion /ruta/clave.key',
@@ -431,12 +201,12 @@ export function createConfigHelp() {
         ].join('\n')),
         '',
         section('Errores frecuentes', [
-            '  - Faltan cert.testing o key.testing: corra arcli config revisar.',
-            '  - Punto de venta no configurado: guarde puntoVenta o paselo por flag.',
-            '  - Emitir por defecto activado sin querer: revise el valor de emitir.',
+            '  - Faltan cert.testing o key.testing: corré arcli config revisar.',
+            '  - Punto de venta no configurado: guardá puntoVenta o pasalo por flag.',
+            '  - Emitir por defecto activado sin querer: revisá el valor de emitir.',
         ].join('\n')),
         '',
-        section('No tenes certificado todavia?', ['  - Guia paso a paso (testing y produccion), con capturas de ARCA:', `    ${CERTIFICATE_GUIDE_URL}`].join('\n')),
+        section('No tenés certificado todavía?', ['  - Guía paso a paso (testing y producción), con capturas de ARCA:', `    ${CERTIFICATE_GUIDE_URL}`].join('\n')),
         '',
     ].join('\n');
 }
@@ -467,19 +237,19 @@ export function createExamplesHelp() {
         section('Para que sirve', [
             '  - Mostrar ejemplos seguros y listos para copiar de todos los comprobantes soportados.',
             '  - Comparar la forma larga y la forma corta del mismo comando.',
-            '  - Ver rapido que cambia entre una variante minima y una full.',
+            '  - Ver rápido que cambia entre una variante mínima y una full.',
         ].join('\n')),
         '',
         section('Como leer la salida', [
-            '  - Minima: datos esenciales del comprobante.',
-            '  - Full: mas campos explicitados para el mismo flujo.',
+            '  - Mínima: datos esenciales del comprobante.',
+            '  - Full: más campos explicitados para el mismo flujo.',
             '  - Larga: comando largo y flags descriptivos.',
             '  - Corta: shortcut y aliases practicos.',
         ].join('\n')),
         '',
         section('Seguridad', [
             '  - Todos los ejemplos usan --previsualizar para evitar emisiones reales por error.',
-            '  - Si queres emitir, reemplaza --previsualizar por --emitir.',
+            '  - Si querés emitir, reemplaza --previsualizar por --emitir.',
         ].join('\n')),
         '',
     ].join('\n');
@@ -488,8 +258,8 @@ export function createFceObligationHelp() {
     return [
         '',
         section('Para que sirve', [
-            '  - Saber si a un receptor le corresponde factura comun o Factura de Credito Electronica (FCE).',
-            '  - ARCA informa si esta obligado a recibir FCE y desde que monto.',
+            '  - Saber si a un receptor le corresponde factura comun o Factura de Crédito Electrónica (FCE).',
+            '  - ARCA informa si está obligado a recibir FCE y desde que monto.',
         ].join('\n')),
         '',
         section('Ejemplos', ['  - arcli fce-obligado 30546689979', '  - arcli fce-obligado 30546689979 --fecha 15/10 --json'].join('\n')),
@@ -505,7 +275,7 @@ export function createPadronHelp() {
     return [
         '',
         section('Para que sirve', [
-            '  - Ver razon social, domicilio fiscal, condicion IVA, impuestos y actividad de un CUIT.',
+            '  - Ver razón social, domicilio fiscal, condición IVA, impuestos y actividad de un CUIT.',
             '  - Al facturar con --cuit, arcli usa el mismo dato para completar el IVA receptor si no pasa --ir.',
         ].join('\n')),
         '',
@@ -518,6 +288,24 @@ export function createPadronHelp() {
         '',
     ].join('\n');
 }
+export function createCompletionHelp() {
+    return [
+        '',
+        section('Para que sirve', compactList([
+            'Completar con Tab comandos, flags y valores: arcli f<Tab>, arcli fc --ir<Tab>, arcli config establecer <Tab>.',
+            'La lista sale de la versión instalada: después de actualizar arcli no hay que reinstalar nada.',
+        ])),
+        '',
+        section('Uso', compactList([
+            'Instalar: arcli completado instalar (usa el shell de $SHELL; o arcli completado instalar zsh)',
+            'Ver si está instalado: arcli completado',
+            'Desinstalar: arcli completado desinstalar',
+            'Ver el script sin instalarlo: arcli completado zsh',
+            'Después de instalar, abrí una terminal nueva.',
+        ])),
+        '',
+    ].join('\n');
+}
 export function createVoucherQueryHelp() {
     return [
         '',
@@ -537,63 +325,82 @@ export function createVoucherQueryHelp() {
     ].join('\n');
 }
 export function createShortcutHelp(shortcut) {
+    const definition = getVoucherKindByShortcut(shortcut);
+    if (!definition) {
+        return '';
+    }
     return [
         '',
-        createVoucherSummary(shortcut),
-        '',
-        createShortcutMinimum(shortcut),
-        '',
-        createShortcutImportantFlags(shortcut),
-        '',
-        createShortcutExamples(shortcut),
-        '',
-        createShortcutAvailableFlags(shortcut),
-        '',
-        section('Reglas clave', CORE_RULES),
+        createShortcutSummary(shortcut),
         '',
-        createShortcutFrequentErrors(shortcut),
+        createRules({
+            isElectronicCredit: definition.isElectronicCredit,
+            isNote: definition.requiresAssociatedVoucher,
+            letters: [definition.letter],
+        }),
         '',
     ].join('\n');
 }
-export function createFamilyHelp(family) {
+/** Ayuda de `arcli fe`: la E no tiene concepto, IVA ni receptor argentino, asi que no usa las reglas de A, B y C. */
+export function createExportShortcutHelp() {
+    const { arcaType, displayName, family, letter, shortcut } = EXPORT_VOUCHER_KIND;
     return [
         '',
-        createFamilySummary(family),
-        '',
-        createFamilyExamples(family),
-        '',
-        createFamilySharedFlags(family),
-        '',
-        section('Reglas clave', CORE_RULES),
-        '',
-        createFamilyFrequentErrors(family),
+        section('Comprobante', compactList([
+            `${displayName}, tipo ARCA ${arcaType}, por WSFEX. Es lo mismo que arcli ${family} ${letter}.`,
+            'Sin flags sale de servicios (--tipo-expo 2), en dólares (DOL) y con forma de pago "Transferencia Internacional".',
+            'La actividad sale de --actividad o de exportacion.actividad en la config.',
+            '--numero es obligatorio: arcli todavía no puede consultar en WSFEX el último comprobante emitido.',
+        ])),
+        '',
+        section('Ejemplos', compactList([
+            `Vista previa: ${EXPORT_MINIMAL_EXAMPLE}`,
+            `Emitir: ${EXPORT_MINIMAL_EXAMPLE} --emitir`,
+            `Con items, que tienen que sumar --monto: ${EXPORT_MINIMAL_EXAMPLE} --item "001|Consultoría|10|150|unidades"`,
+            `Desde un JSON: arcli ${shortcut} --cargar ./factura-e.json --json`,
+            'Más ejemplos: arcli ejemplos',
+        ])),
         '',
     ].join('\n');
 }
-export function createProgramHelp() {
+export function createFamilyHelp(family) {
     return [
         '',
-        createProgramQuickStart(),
-        '',
-        createProgramMentalModel(),
-        '',
-        createProgramFamilies(),
-        '',
-        createProgramCommands(),
-        '',
-        createProgramExamples(),
-        '',
-        createProgramSafety(),
-        '',
-        createProgramDiscovery(),
-        '',
-        createProgramFrequentErrors(),
+        createFamilySummary(family),
         '',
-        createProgramProject(),
+        createRules({
+            isElectronicCredit: family.includes('electronica'),
+            isNote: family.includes('nota'),
+            letters: VOUCHER_LETTERS,
+        }),
         '',
     ].join('\n');
 }
+export function createProgramHelp() {
+    return ['', createProgramVoucherTable(), '', createProgramQuickStart(), '', createProgramMore(), ''].join('\n');
+}
+/** Lo que commander escribe en ingles en la ayuda. */
+const HELP_TITLES = {
+    'Arguments:': 'Argumentos:',
+    'Commands:': 'Comandos:',
+    'Global Options:': 'Opciones globales:',
+    'Options:': 'Opciones:',
+    'Usage:': 'Uso:',
+};
+const HELP_TERMS = [
+    [/\[options\]/g, '[opciones]'],
+    [/\[command\]/g, '[comando]'],
+];
+function translateHelpTerms(text) {
+    return HELP_TERMS.reduce((result, [pattern, replacement]) => result.replace(pattern, replacement), text);
+}
+const defaultHelp = new Help();
 export function configureSpanishHelp(command) {
+    command.configureHelp({
+        commandUsage: (cmd) => translateHelpTerms(defaultHelp.commandUsage(cmd)),
+        styleTitle: (title) => HELP_TITLES[title] ?? title,
+        subcommandTerm: (cmd) => translateHelpTerms(defaultHelp.subcommandTerm(cmd)),
+    });
     command.helpCommand(false);
     command.helpOption('--ayuda', 'mostrar ayuda');
     command.showHelpAfterError('(usa "ayuda" para ver ejemplos y opciones)');
@@ -601,4 +408,3 @@ export function configureSpanishHelp(command) {
 export function createProgramHeader() {
     return renderLogo(CLI_VERSION);
 }
-//# sourceMappingURL=help.js.map