han-excel-builder 1.1.0 → 1.1.1

package/README.md

@@ -1,80 +1,80 @@
 # Han Excel Builder
 
-🚀 **Generador avanzado de archivos Excel con soporte TypeScript, estilos completos y rendimiento optimizado**
-
-Una biblioteca moderna y completamente tipada para crear reportes Excel complejos con múltiples hojas de cálculo, estilos avanzados y alto rendimiento.
-
-## ✨ Características
-
-### 📊 Estructura de Datos
-- ✅ **Múltiples Hojas de Cálculo** - Crea workbooks complejos con múltiples hojas
-- ✅ **Múltiples Tablas por Hoja** - Crea varias tablas independientes en una sola hoja
-- ✅ **Headers Anidados** - Soporte completo para headers con múltiples niveles de anidación
-- ✅ **Datos Jerárquicos** - Soporte para datos con estructura de children (datos anidados)
-
-### 📈 Tipos de Datos
-- ✅ **STRING** - Valores de texto
-- ✅ **NUMBER** - Valores numéricos
-- ✅ **BOOLEAN** - Valores verdadero/falso
-- ✅ **DATE** - Valores de fecha
-- ✅ **PERCENTAGE** - Valores de porcentaje
-- ✅ **CURRENCY** - Valores de moneda
-- ✅ **LINK** - Hipervínculos con texto personalizable
-- ✅ **FORMULA** - Fórmulas de Excel
-
-### 🎨 Estilos Avanzados
-- ✅ **API Fluida** - StyleBuilder con métodos encadenables
-- ✅ **Fuentes** - Control completo sobre nombre, tamaño, color, negrita, cursiva, subrayado
-- ✅ **Colores** - Fondos, colores de texto con soporte para hex, RGB y temas
-- ✅ **Bordes** - Bordes personalizables en todos los lados con múltiples estilos
-- ✅ **Alineación** - Horizontal (izquierda, centro, derecha, justificar) y vertical (arriba, medio, abajo)
-- ✅ **Texto** - Ajuste de texto, contracción para ajustar, rotación de texto
-- ✅ **Formatos de Número** - Múltiples formatos predefinidos y personalizados
-- ✅ **Filas Alternadas** - Soporte para rayas alternadas en tablas
-
-### 🔧 Funcionalidades Avanzadas
-- ✅ **TypeScript First** - Seguridad de tipos completa con interfaces exhaustivas
-- ✅ **Sistema de Eventos** - EventEmitter para monitorear el proceso de construcción
-- ✅ **Validación** - Sistema robusto de validación de datos
-- ✅ **Metadata** - Soporte completo para metadata del workbook (autor, título, descripción, etc.)
-- ✅ **Múltiples Formatos de Exportación** - Descarga directa, Buffer, Blob
-- ✅ **Lectura de Excel** - Lee archivos Excel y convierte a JSON
-- ✅ **Hipervínculos** - Creación de enlaces con texto personalizable
-- ✅ **Merge de Celdas** - Fusión horizontal y vertical de celdas
-- ✅ **Dimensiones Personalizadas** - Ancho de columnas y alto de filas personalizables
-
-## 📦 Instalación
+🚀 **Advanced Excel file generator with TypeScript support, comprehensive styling, and optimized performance**
+
+A modern, fully-typed library for creating complex Excel reports with multiple worksheets, advanced styling, and high performance.
+
+## ✨ Features
+
+### 📊 Data Structure
+- ✅ **Multiple Worksheets** - Create complex workbooks with multiple sheets
+- ✅ **Multiple Tables per Sheet** - Create multiple independent tables in a single sheet
+- ✅ **Nested Headers** - Full support for headers with multiple nesting levels
+- ✅ **Hierarchical Data** - Support for data with children structure (nested data)
+
+### 📈 Data Types
+- ✅ **STRING** - Text values
+- ✅ **NUMBER** - Numeric values
+- ✅ **BOOLEAN** - True/false values
+- ✅ **DATE** - Date values
+- ✅ **PERCENTAGE** - Percentage values
+- ✅ **CURRENCY** - Currency values
+- ✅ **LINK** - Hyperlinks with customizable text
+- ✅ **FORMULA** - Excel formulas
+
+### 🎨 Advanced Styling
+- ✅ **Fluent API** - StyleBuilder with chainable methods
+- ✅ **Fonts** - Full control over name, size, color, bold, italic, underline
+- ✅ **Colors** - Backgrounds, text colors with support for hex, RGB and themes
+- ✅ **Borders** - Customizable borders on all sides with multiple styles
+- ✅ **Alignment** - Horizontal (left, center, right, justify) and vertical (top, middle, bottom)
+- ✅ **Text** - Text wrapping, shrink to fit, text rotation
+- ✅ **Number Formats** - Multiple predefined and custom formats
+- ✅ **Alternating Rows** - Support for alternating stripes in tables
+
+### 🔧 Advanced Features
+- ✅ **TypeScript First** - Complete type safety with comprehensive interfaces
+- ✅ **Event System** - EventEmitter to monitor the build process
+- ✅ **Validation** - Robust data validation system
+- ✅ **Metadata** - Full support for workbook metadata (author, title, description, etc.)
+- ✅ **Multiple Export Formats** - Direct download, Buffer, Blob
+- ✅ **Excel Reading** - Read Excel files and convert to JSON
+- ✅ **Hyperlinks** - Create links with customizable text
+- ✅ **Cell Merging** - Horizontal and vertical cell merging
+- ✅ **Custom Dimensions** - Customizable column width and row height
+
+## 📦 Installation
 
 ```bash
 npm install han-excel-builder
-# o
+# or
 yarn add han-excel-builder
-# o
+# or
 pnpm add han-excel-builder
 ```
 
-## 🚀 Inicio Rápido
+## 🚀 Quick Start
 
-### Ejemplo Básico
+### Basic Example
 
 ```typescript
 import { ExcelBuilder, CellType, NumberFormat, StyleBuilder, BorderStyle } from 'han-excel-builder';
 
-// Crear un reporte simple
+// Create a simple report
 const builder = new ExcelBuilder({
   metadata: {
-    title: 'Reporte de Ventas',
-    author: 'Mi Empresa',
-    description: 'Reporte mensual de ventas'
+    title: 'Sales Report',
+    author: 'My Company',
+    description: 'Monthly sales report'
   }
 });
 
-const worksheet = builder.addWorksheet('Ventas');
+const worksheet = builder.addWorksheet('Sales');
 
-// Agregar header principal
+// Add main header
 worksheet.addHeader({
   key: 'title',
-  value: 'Reporte Mensual de Ventas',
+  value: 'Monthly Sales Report',
   type: CellType.STRING,
   mergeCell: true,
   styles: new StyleBuilder()
@@ -88,11 +88,11 @@ worksheet.addHeader({
     .build()
 });
 
-// Agregar sub-headers
+// Add sub-headers
 worksheet.addSubHeaders([
   {
-    key: 'producto',
-    value: 'Producto',
+    key: 'product',
+    value: 'Product',
     type: CellType.STRING,
     colWidth: 20,
     styles: new StyleBuilder()
@@ -104,8 +104,8 @@ worksheet.addSubHeaders([
       .build()
   },
   {
-    key: 'ventas',
-    value: 'Ventas',
+    key: 'sales',
+    value: 'Sales',
     type: CellType.CURRENCY,
     colWidth: 15,
     numberFormat: '$#,##0',
@@ -119,43 +119,43 @@ worksheet.addSubHeaders([
   }
 ]);
 
-// Agregar datos
+// Add data
 worksheet.addRow([
   {
-    key: 'producto-1',
-    value: 'Producto A',
+    key: 'product-1',
+    value: 'Product A',
     type: CellType.STRING,
-    header: 'Producto'
+    header: 'Product'
   },
   {
-    key: 'ventas-1',
+    key: 'sales-1',
     value: 1500.50,
     type: CellType.CURRENCY,
-    header: 'Ventas',
+    header: 'Sales',
     numberFormat: '$#,##0.00'
   }
 ]);
 
-// Generar y descargar
-await builder.generateAndDownload('reporte-ventas.xlsx');
+// Generate and download
+await builder.generateAndDownload('sales-report.xlsx');
 ```
 
-## 📚 Documentación de API
+## 📚 API Documentation
 
-### Clases Principales
+### Core Classes
 
 #### `ExcelBuilder`
 
-Clase principal para crear workbooks de Excel.
+Main class for creating Excel workbooks.
 
 ```typescript
 const builder = new ExcelBuilder({
   metadata: {
-    title: 'Mi Reporte',
-    author: 'Mi Nombre',
-    company: 'Mi Empresa',
-    description: 'Descripción del reporte',
-    keywords: 'excel, reporte, datos',
+    title: 'My Report',
+    author: 'My Name',
+    company: 'My Company',
+    description: 'Report description',
+    keywords: 'excel, report, data',
     created: new Date(),
     modified: new Date()
   },
@@ -166,20 +166,20 @@ const builder = new ExcelBuilder({
   maxColumnsPerWorksheet: 16384
 });
 
-// Métodos principales
-builder.addWorksheet(name, config);      // Agregar una hoja
-builder.getWorksheet(name);              // Obtener una hoja
-builder.removeWorksheet(name);           // Eliminar una hoja
-builder.setCurrentWorksheet(name);       // Establecer hoja actual
-builder.build(options);                  // Construir y obtener ArrayBuffer
-builder.generateAndDownload(fileName);    // Generar y descargar
-builder.toBuffer(options);               // Obtener como Buffer
-builder.toBlob(options);                // Obtener como Blob
-builder.validate();                      // Validar workbook
-builder.clear();                         // Limpiar todas las hojas
-builder.getStats();                      // Obtener estadísticas
-
-// Sistema de eventos
+// Main methods
+builder.addWorksheet(name, config);      // Add a worksheet
+builder.getWorksheet(name);              // Get a worksheet
+builder.removeWorksheet(name);           // Remove a worksheet
+builder.setCurrentWorksheet(name);       // Set current worksheet
+builder.build(options);                  // Build and get ArrayBuffer
+builder.generateAndDownload(fileName);    // Generate and download
+builder.toBuffer(options);               // Get as Buffer
+builder.toBlob(options);                // Get as Blob
+builder.validate();                      // Validate workbook
+builder.clear();                         // Clear all worksheets
+builder.getStats();                      // Get statistics
+
+// Event system
 builder.on(eventType, listener);
 builder.off(eventType, listenerId);
 builder.removeAllListeners(eventType);
@@ -187,77 +187,77 @@ builder.removeAllListeners(eventType);
 
 #### `ExcelReader`
 
-Clase para leer archivos Excel y convertirlos a JSON con 3 formatos de salida diferentes.
+Class for reading Excel files and converting them to JSON with 3 different output formats.
 
-**Formatos disponibles:**
-- `worksheet` (por defecto) - Estructura completa con hojas, filas y celdas
-- `detailed` - Cada celda con información de posición (texto, columna, fila)
-- `flat` - Solo los datos, sin estructura
+**Available formats:**
+- `worksheet` (default) - Complete structure with sheets, rows and cells
+- `detailed` - Each cell with position information (text, column, row)
+- `flat` - Just the data, without structure
 
 ```typescript
 import { ExcelReader, OutputFormat } from 'han-excel-builder';
 
-// ===== FORMATO 1: WORKSHEET (por defecto) =====
-// Estructura completa organizada por hojas
+// ===== FORMAT 1: WORKSHEET (default) =====
+// Complete structure organized by sheets
 const result = await ExcelReader.fromFile(file, {
-  outputFormat: OutputFormat.WORKSHEET, // o 'worksheet'
+  outputFormat: OutputFormat.WORKSHEET, // or 'worksheet'
   useFirstRowAsHeaders: true
 });
 
 if (result.success) {
   const workbook = result.data;
-  // workbook.sheets[] - Array de hojas
-  // workbook.sheets[0].rows[] - Array de filas
-  // workbook.sheets[0].rows[0].cells[] - Array de celdas
-  // workbook.sheets[0].rows[0].data - Objeto con datos (si useFirstRowAsHeaders)
+  // workbook.sheets[] - Array of sheets
+  // workbook.sheets[0].rows[] - Array of rows
+  // workbook.sheets[0].rows[0].cells[] - Array of cells
+  // workbook.sheets[0].rows[0].data - Object with data (if useFirstRowAsHeaders)
 }
 
-// ===== FORMATO 2: DETAILED =====
-// Cada celda con información de posición
+// ===== FORMAT 2: DETAILED =====
+// Each cell with position information
 const result = await ExcelReader.fromFile(file, {
-  outputFormat: OutputFormat.DETAILED, // o 'detailed'
+  outputFormat: OutputFormat.DETAILED, // or 'detailed'
   includeFormatting: true
 });
 
 if (result.success) {
   const detailed = result.data;
-  // detailed.cells[] - Array de todas las celdas con:
-  //   - value: valor de la celda
-  //   - text: texto de la celda
-  //   - column: número de columna (1-based)
-  //   - columnLetter: letra de columna (A, B, C...)
-  //   - row: número de fila (1-based)
-  //   - reference: referencia de celda (A1, B2...)
-  //   - sheet: nombre de la hoja
+  // detailed.cells[] - Array of all cells with:
+  //   - value: cell value
+  //   - text: cell text
+  //   - column: column number (1-based)
+  //   - columnLetter: column letter (A, B, C...)
+  //   - row: row number (1-based)
+  //   - reference: cell reference (A1, B2...)
+  //   - sheet: sheet name
   detailed.cells.forEach(cell => {
     console.log(`${cell.sheet}!${cell.reference}: ${cell.text}`);
   });
 }
 
-// ===== FORMATO 3: FLAT =====
-// Solo los datos, sin estructura
+// ===== FORMAT 3: FLAT =====
+// Just the data, without structure
 const result = await ExcelReader.fromFile(file, {
-  outputFormat: OutputFormat.FLAT, // o 'flat'
+  outputFormat: OutputFormat.FLAT, // or 'flat'
   useFirstRowAsHeaders: true
 });
 
 if (result.success) {
   const flat = result.data;
   
-  // Si es una sola hoja:
+  // If single sheet:
   if ('data' in flat) {
-    // flat.data[] - Array de objetos o arrays
-    // flat.headers[] - Headers (si useFirstRowAsHeaders)
+    // flat.data[] - Array of objects or arrays
+    // flat.headers[] - Headers (if useFirstRowAsHeaders)
     flat.data.forEach(row => {
-      console.log(row); // { Producto: 'A', Precio: 100 } o ['A', 100]
+      console.log(row); // { Product: 'A', Price: 100 } or ['A', 100]
     });
   }
   
-  // Si son múltiples hojas:
+  // If multiple sheets:
   if ('sheets' in flat) {
-    // flat.sheets['NombreHoja'].data[] - Datos por hoja
+    // flat.sheets['SheetName'].data[] - Data by sheet
     Object.keys(flat.sheets).forEach(sheetName => {
-      console.log(`Hoja: ${sheetName}`);
+      console.log(`Sheet: ${sheetName}`);
       flat.sheets[sheetName].data.forEach(row => {
         console.log(row);
       });
@@ -265,25 +265,25 @@ if (result.success) {
   }
 }
 
-// ===== USANDO MAPPER PARA TRANSFORMAR DATOS =====
-// El mapper permite transformar la respuesta antes de devolverla
+// ===== USING MAPPER TO TRANSFORM DATA =====
+// The mapper allows transforming the response before returning it
 const result = await ExcelReader.fromFile(file, {
   outputFormat: OutputFormat.WORKSHEET,
   useFirstRowAsHeaders: true,
-  // Mapper recibe el payload y devuelve la transformación
+  // Mapper receives the payload and returns the transformation
   mapper: (data) => {
-    // Transformar datos según necesidades
+    // Transform data according to needs
     const transformed = {
       totalSheets: data.totalSheets,
       sheets: data.sheets.map(sheet => ({
         name: sheet.name,
-        // Convertir filas a objetos con datos transformados
+        // Convert rows to objects with transformed data
         rows: sheet.rows.map(row => {
           if (row.data) {
-            // Transformar cada campo
+            // Transform each field
             return {
               ...row.data,
-              // Agregar campos calculados
+              // Add calculated fields
               total: Object.values(row.data).reduce((sum, val) => {
                 return sum + (typeof val === 'number' ? val : 0);
               }, 0)
@@ -297,16 +297,16 @@ const result = await ExcelReader.fromFile(file, {
   }
 });
 
-// Ejemplo con formato FLAT y mapper
+// Example with FLAT format and mapper
 const result = await ExcelReader.fromFile(file, {
   outputFormat: OutputFormat.FLAT,
   useFirstRowAsHeaders: true,
   mapper: (data) => {
-    // Si es formato flat de una sola hoja
+    // If flat format from single sheet
     if ('data' in data && Array.isArray(data.data)) {
       return data.data.map((row: any) => ({
         ...row,
-        // Agregar validaciones o transformaciones
+        // Add validations or transformations
         isValid: Object.values(row).every(val => val !== null && val !== undefined)
       }));
     }
@@ -314,11 +314,11 @@ const result = await ExcelReader.fromFile(file, {
   }
 });
 
-// Ejemplo con formato DETAILED y mapper
+// Example with DETAILED format and mapper
 const result = await ExcelReader.fromFile(file, {
   outputFormat: OutputFormat.DETAILED,
   mapper: (data) => {
-    // Agrupar celdas por hoja
+    // Group cells by sheet
     const groupedBySheet: Record<string, typeof data.cells> = {};
     data.cells.forEach(cell => {
       if (!groupedBySheet[cell.sheet]) {
@@ -336,38 +336,38 @@ const result = await ExcelReader.fromFile(file, {
 });
 ```
 
-**Opciones de lectura:**
+**Reading options:**
 
 ```typescript
 interface IExcelReaderOptions {
-  outputFormat?: 'worksheet' | 'detailed' | 'flat' | OutputFormat; // Formato de salida
-  mapper?: (data: IJsonWorkbook | IDetailedFormat | IFlatFormat | IFlatFormatMultiSheet) => unknown; // Función para transformar la respuesta
-  useFirstRowAsHeaders?: boolean;    // Usar primera fila como headers
-  includeEmptyRows?: boolean;        // Incluir filas vacías
-  headers?: string[] | Record<number, string>; // Headers personalizados
-  sheetName?: string | number;       // Nombre o índice de hoja
-  startRow?: number;                 // Fila inicial (1-based)
-  endRow?: number;                    // Fila final (1-based)
-  startColumn?: number;               // Columna inicial (1-based)
-  endColumn?: number;                 // Columna final (1-based)
-  includeFormatting?: boolean;        // Incluir información de formato
-  includeFormulas?: boolean;          // Incluir fórmulas
-  datesAsISO?: boolean;               // Convertir fechas a ISO string
+  outputFormat?: 'worksheet' | 'detailed' | 'flat' | OutputFormat; // Output format
+  mapper?: (data: IJsonWorkbook | IDetailedFormat | IFlatFormat | IFlatFormatMultiSheet) => unknown; // Function to transform the response
+  useFirstRowAsHeaders?: boolean;    // Use first row as headers
+  includeEmptyRows?: boolean;        // Include empty rows
+  headers?: string[] | Record<number, string>; // Custom headers
+  sheetName?: string | number;       // Sheet name or index
+  startRow?: number;                 // Starting row (1-based)
+  endRow?: number;                    // Ending row (1-based)
+  startColumn?: number;               // Starting column (1-based)
+  endColumn?: number;                 // Ending column (1-based)
+  includeFormatting?: boolean;        // Include formatting information
+  includeFormulas?: boolean;          // Include formulas
+  datesAsISO?: boolean;               // Convert dates to ISO string
 }
 ```
 
-**Formatos de salida:**
+**Output formats:**
 
-- **`worksheet`** (por defecto): Estructura completa con hojas, filas y celdas
-- **`detailed`**: Array de celdas con información de posición (texto, columna, fila, referencia)
-- **`flat`**: Solo los datos, sin estructura (arrays u objetos planos)
+- **`worksheet`** (default): Complete structure with sheets, rows and cells
+- **`detailed`**: Array of cells with position information (text, column, row, reference)
+- **`flat`**: Just the data, without structure (flat arrays or objects)
 
 #### `Worksheet`
 
-Representa una hoja de cálculo individual.
+Represents an individual worksheet.
 
 ```typescript
-const worksheet = builder.addWorksheet('Mi Hoja', {
+const worksheet = builder.addWorksheet('My Sheet', {
   tabColor: '#FF0000',
   defaultRowHeight: 20,
   defaultColWidth: 15,
@@ -377,31 +377,31 @@ const worksheet = builder.addWorksheet('Mi Hoja', {
   }
 });
 
-// Métodos principales
-worksheet.addHeader(header);             // Agregar header principal
-worksheet.addSubHeaders(headers);        // Agregar sub-headers
-worksheet.addRow(row);                   // Agregar fila de datos
-worksheet.addFooter(footer);             // Agregar footer
-worksheet.addTable(config);              // Crear nueva tabla
-worksheet.finalizeTable();               // Finalizar tabla actual
-worksheet.getTable(name);                // Obtener tabla por nombre
-worksheet.validate();                    // Validar hoja
+// Main methods
+worksheet.addHeader(header);             // Add main header
+worksheet.addSubHeaders(headers);        // Add sub-headers
+worksheet.addRow(row);                   // Add data row
+worksheet.addFooter(footer);             // Add footer
+worksheet.addTable(config);              // Create new table
+worksheet.finalizeTable();               // Finalize current table
+worksheet.getTable(name);                // Get table by name
+worksheet.validate();                    // Validate sheet
 ```
 
-### Tipos de Datos
+### Data Types
 
 #### `CellType`
 
 ```typescript
 enum CellType {
-  STRING = 'string',        // Texto
-  NUMBER = 'number',        // Número
-  BOOLEAN = 'boolean',      // Verdadero/Falso
-  DATE = 'date',            // Fecha
-  PERCENTAGE = 'percentage', // Porcentaje
-  CURRENCY = 'currency',    // Moneda
-  LINK = 'link',           // Hipervínculo
-  FORMULA = 'formula'      // Fórmula
+  STRING = 'string',        // Text
+  NUMBER = 'number',        // Number
+  BOOLEAN = 'boolean',      // True/False
+  DATE = 'date',            // Date
+  PERCENTAGE = 'percentage', // Percentage
+  CURRENCY = 'currency',    // Currency
+  LINK = 'link',           // Hyperlink
+  FORMULA = 'formula'      // Formula
 }
 ```
 
@@ -423,15 +423,15 @@ enum NumberFormat {
 }
 ```
 
-### Estilos
+### Styling
 
 #### `StyleBuilder`
 
-API fluida para crear estilos de celdas.
+Fluent API for creating cell styles.
 
 ```typescript
 const style = new StyleBuilder()
-  // Fuentes
+  // Fonts
   .fontName('Arial')
   .fontSize(12)
   .fontBold()
@@ -439,7 +439,7 @@ const style = new StyleBuilder()
   .fontUnderline()
   .fontColor('#FF0000')
   
-  // Fondos y bordes
+  // Backgrounds and borders
   .backgroundColor('#FFFF00')
   .border(BorderStyle.THIN, '#000000')
   .borderTop(BorderStyle.MEDIUM, '#000000')
@@ -447,7 +447,7 @@ const style = new StyleBuilder()
   .borderBottom(BorderStyle.THIN, '#000000')
   .borderRight(BorderStyle.THIN, '#000000')
   
-  // Alineación
+  // Alignment
   .centerAlign()
   .leftAlign()
   .rightAlign()
@@ -455,11 +455,11 @@ const style = new StyleBuilder()
   .verticalAlign(VerticalAlignment.MIDDLE)
   .wrapText()
   
-  // Formatos
+  // Formats
   .numberFormat('$#,##0.00')
   .striped()
   
-  // Formato condicional
+  // Conditional formatting
   .conditionalFormat({
     type: 'cellIs',
     operator: 'greaterThan',
@@ -472,7 +472,7 @@ const style = new StyleBuilder()
   
   .build();
 
-// Método estático alternativo
+// Alternative static method
 const style2 = StyleBuilder.create()
   .fontBold()
   .fontSize(14)
@@ -499,28 +499,28 @@ enum BorderStyle {
 }
 ```
 
-## 🎯 Ejemplos Avanzados
+## 🎯 Advanced Examples
 
-### Múltiples Tablas en una Hoja
+### Multiple Tables in a Sheet
 
 ```typescript
 import { ExcelBuilder, CellType, StyleBuilder, BorderStyle } from 'han-excel-builder';
 
 const builder = new ExcelBuilder();
-const worksheet = builder.addWorksheet('Reporte Completo');
+const worksheet = builder.addWorksheet('Complete Report');
 
-// ===== PRIMERA TABLA =====
+// ===== FIRST TABLE =====
 worksheet.addTable({
-  name: 'Ventas',
+  name: 'Sales',
   showBorders: true,
   showStripes: true,
   style: 'TableStyleLight1'
 });
 
 worksheet.addHeader({
-  key: 'header-ventas',
+  key: 'header-sales',
   type: CellType.STRING,
-  value: 'RESUMEN DE VENTAS',
+  value: 'SALES SUMMARY',
   mergeCell: true,
   styles: new StyleBuilder()
     .fontBold()
@@ -532,29 +532,29 @@ worksheet.addHeader({
 });
 
 worksheet.addSubHeaders([
-  { key: 'producto', type: CellType.STRING, value: 'Producto' },
-  { key: 'ventas', type: CellType.CURRENCY, value: 'Ventas' }
+  { key: 'product', type: CellType.STRING, value: 'Product' },
+  { key: 'sales', type: CellType.CURRENCY, value: 'Sales' }
 ]);
 
 worksheet.addRow([
-  { key: 'p1', type: CellType.STRING, value: 'Producto A', header: 'Producto' },
-  { key: 'v1', type: CellType.CURRENCY, value: 1500, header: 'Ventas' }
+  { key: 'p1', type: CellType.STRING, value: 'Product A', header: 'Product' },
+  { key: 'v1', type: CellType.CURRENCY, value: 1500, header: 'Sales' }
 ]);
 
 worksheet.finalizeTable();
 
-// ===== SEGUNDA TABLA =====
+// ===== SECOND TABLE =====
 worksheet.addTable({
-  name: 'Empleados',
+  name: 'Employees',
   showBorders: true,
   showStripes: true,
   style: 'TableStyleMedium1'
 });
 
 worksheet.addHeader({
-  key: 'header-empleados',
+  key: 'header-employees',
   type: CellType.STRING,
-  value: 'TOP EMPLEADOS',
+  value: 'TOP EMPLOYEES',
   mergeCell: true,
   styles: new StyleBuilder()
     .fontBold()
@@ -566,13 +566,13 @@ worksheet.addHeader({
 });
 
 worksheet.addSubHeaders([
-  { key: 'nombre', type: CellType.STRING, value: 'Nombre' },
-  { key: 'ventas', type: CellType.CURRENCY, value: 'Ventas' }
+  { key: 'name', type: CellType.STRING, value: 'Name' },
+  { key: 'sales', type: CellType.CURRENCY, value: 'Sales' }
 ]);
 
 worksheet.addRow([
-  { key: 'e1', type: CellType.STRING, value: 'Juan Pérez', header: 'Nombre' },
-  { key: 've1', type: CellType.CURRENCY, value: 150000, header: 'Ventas' }
+  { key: 'e1', type: CellType.STRING, value: 'John Doe', header: 'Name' },
+  { key: 've1', type: CellType.CURRENCY, value: 150000, header: 'Sales' }
 ]);
 
 worksheet.finalizeTable();
@@ -580,39 +580,39 @@ worksheet.finalizeTable();
 await builder.generateAndDownload('multiple-tables.xlsx');
 ```
 
-### Headers Anidados
+### Nested Headers
 
 ```typescript
 worksheet.addSubHeaders([
   {
-    key: 'ventas',
-    value: 'Ventas',
+    key: 'sales',
+    value: 'Sales',
     type: CellType.STRING,
     children: [
       {
-        key: 'ventas-q1',
+        key: 'sales-q1',
         value: 'Q1',
         type: CellType.STRING
       },
       {
-        key: 'ventas-q2',
+        key: 'sales-q2',
         value: 'Q2',
         type: CellType.STRING
       }
     ]
   },
   {
-    key: 'gastos',
-    value: 'Gastos',
+    key: 'expenses',
+    value: 'Expenses',
     type: CellType.STRING,
     children: [
       {
-        key: 'gastos-q1',
+        key: 'expenses-q1',
         value: 'Q1',
         type: CellType.STRING
       },
       {
-        key: 'gastos-q2',
+        key: 'expenses-q2',
         value: 'Q2',
         type: CellType.STRING
       }
@@ -621,57 +621,57 @@ worksheet.addSubHeaders([
 ]);
 ```
 
-### Hipervínculos
+### Hyperlinks
 
 ```typescript
 worksheet.addRow([
   {
     key: 'link-1',
     type: CellType.LINK,
-    value: 'Visitar sitio',
+    value: 'Visit site',
     link: 'https://example.com',
-    mask: 'Haz clic aquí', // Texto visible
-    header: 'Enlace'
+    mask: 'Click here', // Visible text
+    header: 'Link'
   }
 ]);
 ```
 
-### Datos con Children (Estructura Jerárquica)
+### Data with Children (Hierarchical Structure)
 
 ```typescript
 worksheet.addRow([
   {
     key: 'row-1',
     type: CellType.STRING,
-    value: 'Categoría Principal',
-    header: 'Categoría',
+    value: 'Main Category',
+    header: 'Category',
     children: [
       {
         key: 'child-1',
         type: CellType.STRING,
-        value: 'Subcategoría 1',
-        header: 'Subcategoría'
+        value: 'Subcategory 1',
+        header: 'Subcategory'
       },
       {
         key: 'child-2',
         type: CellType.NUMBER,
         value: 100,
-        header: 'Valor'
+        header: 'Value'
       }
     ]
   }
 ]);
 ```
 
-### Formato Condicional
+### Conditional Formatting
 
 ```typescript
 worksheet.addRow([
   {
-    key: 'ventas-1',
+    key: 'sales-1',
     type: CellType.NUMBER,
     value: 1500,
-    header: 'Ventas',
+    header: 'Sales',
     styles: new StyleBuilder()
       .conditionalFormat({
         type: 'cellIs',
@@ -687,77 +687,77 @@ worksheet.addRow([
 ]);
 ```
 
-### Múltiples Hojas de Cálculo
+### Multiple Worksheets
 
 ```typescript
 const builder = new ExcelBuilder();
 
-// Hoja 1: Resumen
-const summarySheet = builder.addWorksheet('Resumen');
+// Sheet 1: Summary
+const summarySheet = builder.addWorksheet('Summary');
 summarySheet.addHeader({
   key: 'title',
-  value: 'Resumen Ejecutivo',
+  value: 'Executive Summary',
   type: CellType.STRING,
   mergeCell: true
 });
 
-// Hoja 2: Detalles
-const detailsSheet = builder.addWorksheet('Detalles');
+// Sheet 2: Details
+const detailsSheet = builder.addWorksheet('Details');
 detailsSheet.addSubHeaders([
-  { key: 'fecha', value: 'Fecha', type: CellType.DATE },
-  { key: 'monto', value: 'Monto', type: CellType.CURRENCY }
+  { key: 'date', value: 'Date', type: CellType.DATE },
+  { key: 'amount', value: 'Amount', type: CellType.CURRENCY }
 ]);
 
 await builder.generateAndDownload('multi-sheet-report.xlsx');
 ```
 
-### Exportación en Diferentes Formatos
+### Export in Different Formats
 
 ```typescript
-// Descarga directa (navegador)
-await builder.generateAndDownload('reporte.xlsx');
+// Direct download (browser)
+await builder.generateAndDownload('report.xlsx');
 
-// Obtener como Buffer
+// Get as Buffer
 const bufferResult = await builder.toBuffer();
 if (bufferResult.success) {
   const buffer = bufferResult.data;
-  // Usar buffer...
+  // Use buffer...
 }
 
-// Obtener como Blob
+// Get as Blob
 const blobResult = await builder.toBlob();
 if (blobResult.success) {
   const blob = blobResult.data;
-  // Usar blob...
+  // Use blob...
 }
 ```
 
-### Sistema de Eventos
+### Event System
 
 ```typescript
 builder.on('build:started', (event) => {
-  console.log('Construcción iniciada');
+  console.log('Build started');
 });
 
 builder.on('build:completed', (event) => {
-  console.log('Construcción completada', event.data);
+  console.log('Build completed', event.data);
 });
 
 builder.on('build:error', (event) => {
-  console.error('Error en construcción', event.data.error);
+  console.error('Build error', event.data.error);
 });
 
-// Remover listener
+// Remove listener
 const listenerId = builder.on('build:started', handler);
 builder.off('build:started', listenerId);
 ```
 
-### Leer Excel y Convertir a JSON
+### Read Excel and Convert to JSON
 
 ```typescript
 import { ExcelReader } from 'han-excel-builder';
 
-// Leer desde un archivo (navegador)
+// Read from a file (browser)
 const fileInput = document.querySelector('input[type="file"]');
 fileInput.addEventListener('change', async (e) => {
   const file = (e.target as HTMLInputElement).files?.[0];
@@ -772,44 +772,44 @@ fileInput.addEventListener('change', async (e) => {
   if (result.success) {
     const workbook = result.data;
     
-    // Procesar cada hoja
+    // Process each sheet
     workbook.sheets.forEach(sheet => {
-      console.log(`Procesando hoja: ${sheet.name}`);
+      console.log(`Processing sheet: ${sheet.name}`);
       
-      // Convertir a array de objetos (si usamos headers)
+      // Convert to array of objects (if using headers)
       const data = sheet.rows.map(row => row.data || {});
-      console.log('Datos:', data);
+      console.log('Data:', data);
     });
   }
 });
 
-// Leer desde ArrayBuffer (desde API)
+// Read from ArrayBuffer (from API)
 async function readExcelFromAPI() {
   const response = await fetch('/api/excel-file');
   const buffer = await response.arrayBuffer();
   
   const result = await ExcelReader.fromBuffer(buffer, {
     useFirstRowAsHeaders: true,
-    sheetName: 'Ventas' // Leer solo la hoja 'Ventas'
+    sheetName: 'Sales' // Read only 'Sales' sheet
   });
 
   if (result.success) {
     const sheet = result.data.sheets[0];
-    const ventas = sheet.rows.map(row => row.data);
-    return ventas;
+    const sales = sheet.rows.map(row => row.data);
+    return sales;
   }
 }
 
-// Leer desde ruta (Node.js)
+// Read from path (Node.js)
 async function readExcelFromPath() {
-  const result = await ExcelReader.fromPath('./reporte.xlsx', {
+  const result = await ExcelReader.fromPath('./report.xlsx', {
     useFirstRowAsHeaders: true,
-    startRow: 2, // Saltar header
+    startRow: 2, // Skip header
     includeFormulas: true
   });
 
   if (result.success) {
-    console.log(`Tiempo de procesamiento: ${result.processingTime}ms`);
+    console.log(`Processing time: ${result.processingTime}ms`);
     return result.data;
   }
 }
@@ -818,49 +818,49 @@ async function readExcelFromPath() {
 ## 🧪 Testing
 
 ```bash
-# Ejecutar tests
+# Run tests
 npm test
 
-# Ejecutar tests con cobertura
+# Run tests with coverage
 npm run test:coverage
 
-# Ejecutar tests en modo watch
+# Run tests in watch mode
 npm run test:watch
 ```
 
-## 🛠️ Desarrollo
+## 🛠️ Development
 
 ```bash
-# Instalar dependencias
+# Install dependencies
 npm install
 
-# Iniciar servidor de desarrollo
+# Start development server
 npm run dev
 
-# Construir para producción
+# Build for production
 npm run build
 
-# Ejecutar linting
+# Run linting
 npm run lint
 
-# Formatear código
+# Format code
 npm run format
 
-# Verificar tipos
+# Type checking
 npm run type-check
 
-# Generar documentación
+# Generate documentation
 npm run docs
 ```
 
-## 📋 Migración desde legacy-excel
+## 📋 Migration from legacy-excel
 
-Si estás migrando desde la versión legacy, aquí hay una comparación rápida:
+If you're migrating from the legacy version, here's a quick comparison:
 
 ```typescript
-// Forma legacy
+// Legacy way
 const worksheets: IWorksheets[] = [{
-  name: "Reporte",
+  name: "Report",
   tables: [{
     headers: [...],
     subHeaders: [...],
@@ -868,42 +868,42 @@ const worksheets: IWorksheets[] = [{
     footers: [...]
   }]
 }];
-await fileBuilder(worksheets, "reporte");
+await fileBuilder(worksheets, "report");
 
-// Nueva forma
+// New way
 const builder = new ExcelBuilder();
-const worksheet = builder.addWorksheet('Reporte');
+const worksheet = builder.addWorksheet('Report');
 worksheet.addHeader({...});
 worksheet.addSubHeaders([...]);
 worksheet.addRow([...]);
 worksheet.addFooter([...]);
-await builder.generateAndDownload('reporte');
+await builder.generateAndDownload('report');
 ```
 
-## 📚 Recursos Adicionales
+## 📚 Additional Resources
 
-- 📖 [Guía de Múltiples Tablas](./MULTIPLE-TABLES-GUIDE.md)
-- 📖 [Mejoras Implementadas](./IMPROVEMENTS.md)
-- 📖 [Resultados de Pruebas](./TEST-RESULTS.md)
+- 📖 [Multiple Tables Guide](./MULTIPLE-TABLES-GUIDE.md)
+- 📖 [Implemented Improvements](./IMPROVEMENTS.md)
+- 📖 [Test Results](./TEST-RESULTS.md)
 
-## 🤝 Contribuir
+## 🤝 Contributing
 
-1. Fork el repositorio
-2. Crea una rama de feature (`git checkout -b feature/mi-caracteristica`)
-3. Commit tus cambios (`git commit -m 'Agregar mi característica'`)
-4. Push a la rama (`git push origin feature/mi-caracteristica`)
-5. Abre un Pull Request
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/my-feature`)
+3. Commit your changes (`git commit -m 'Add my feature'`)
+4. Push to the branch (`git push origin feature/my-feature`)
+5. Open a Pull Request
 
-## 📄 Licencia
+## 📄 License
 
-Este proyecto está licenciado bajo la Licencia MIT - ver el archivo [LICENSE](LICENSE) para más detalles.
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
-## 🆘 Soporte
+## 🆘 Support
 
-- 📖 [Documentación](https://github.com/hannndler/-han-excel)
+- 📖 [Documentation](https://github.com/hannndler/-han-excel)
 - 🐛 [Issues](https://github.com/hannndler/-han-excel/issues)
 - 💬 [Discussions](https://github.com/hannndler/-han-excel/discussions)
 
 ---
 
-Hecho con ❤️ por el equipo de Han Excel
+Made with ❤️ by the Han Excel Team

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "han-excel-builder",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Advanced Excel file generator with TypeScript support, comprehensive styling, and optimized performance",
   "type": "module",
   "main": "dist/han-excel.cjs.js",