feat: translate comments and logs to English for better accessibility

src/types/cli.types.ts

@@ -1,6 +1,6 @@
 /**
- * Opciones recibidas desde la línea de comandos (Commander).
- * Desacoplada del framework CLI para permitir su uso desde un backend u otro entrypoint.
+ * Options received from the command line (Commander).
+ * Decoupled from the CLI framework to allow use from a backend or other entry points.
  */
 export interface CliOptions {
   input: string;

src/types/generation.types.ts

@@ -1,5 +1,5 @@
 /**
- * Contadores acumulativos de artefactos generados durante el proceso.
+ * Cumulative counters of artifacts generated during the process.
  */
 export interface GeneratedCount {
   models: number;
@@ -10,7 +10,7 @@ export interface GeneratedCount {
 }
 
 /**
- * Reporte final de generación que se persiste como `generation-report.json`.
+ * Final generation report persisted as `generation-report.json`.
  */
 export interface GenerationReport {
   timestamp: string;

src/types/index.ts

@@ -1,6 +1,6 @@
 /**
  * @module types
- * @description Barrel que re-exporta todos los tipos e interfaces compartidos del proyecto.
+ * @description Barrel that re-exports all shared types and interfaces for the project.
  */
 export * from './cli.types';
 export * from './swagger.types';

src/types/openapi.types.ts

@@ -1,5 +1,5 @@
 /**
- * Resumen de un endpoint para mostrar en la pantalla de selección interactiva.
+ * Summary of a single endpoint for display on the interactive selection screen.
  */
 export interface OperationSummary {
   nickname: string;
@@ -9,7 +9,7 @@ export interface OperationSummary {
 }
 
 /**
- * Tag con sus endpoints resumidos, para la pantalla de selección interactiva.
+ * Tag with its summarised endpoints, used on the interactive selection screen.
  */
 export interface TagSummary {
   tag: string;
@@ -17,13 +17,13 @@ export interface TagSummary {
 }
 
 /**
- * Mapa de filtro de selección: tag → array de nicknames de operaciones seleccionadas.
+ * Selection filter map: tag → array of selected operation nicknames.
  */
 export type SelectionFilter = Record<string, string[]>;
 
 /**
- * Representación simplificada de un schema de componente OpenAPI.
- * Se utiliza para generar modelos (entidades) y mappers.
+ * Simplified representation of an OpenAPI component schema.
+ * Used to generate domain models (entities) and mappers.
  */
 export interface OpenApiSchema {
   properties?: Record<
@@ -40,8 +40,8 @@ export interface OpenApiSchema {
 }
 
 /**
- * Representación de una operación OpenAPI (GET, POST, etc.) dentro de un path.
- * Contiene la información necesaria para generar repositorios y casos de uso.
+ * Representation of an OpenAPI operation (GET, POST, etc.) within a path.
+ * Contains the information needed to generate repositories and use cases.
  */
 export interface OpenApiOperation {
   tags?: string[];
@@ -85,8 +85,7 @@ export interface OpenApiOperation {
 }
 
 /**
- * Operación normalizada y lista para ser consumida por los templates Mustache.
- * Cada instancia representa un endpoint agrupado bajo un tag del API.
+ * A single parameter of a normalised API operation, ready for Mustache template consumption.
  */
 export interface TagOperationParam {
   paramName: string;
@@ -96,6 +95,10 @@ export interface TagOperationParam {
   '-last': boolean;
 }
 
+/**
+ * Normalised operation ready to be consumed by Mustache templates.
+ * Each instance represents an endpoint grouped under an API tag.
+ */
 export interface TagOperation {
   nickname: string;
   summary: string;

src/types/swagger.types.ts

@@ -1,6 +1,6 @@
 /**
- * Resultado del análisis de un archivo OpenAPI/Swagger.
- * Contiene las estructuras crudas extraídas del spec para su posterior procesamiento.
+ * Result of parsing an OpenAPI/Swagger file.
+ * Contains the raw structures extracted from the spec for further processing.
  */
 export interface SwaggerAnalysis {
   tags: unknown[];