feat: add "Add Page Labels" tool to the application

- Introduced a new tool for adding page labels to PDF documents, allowing users to apply Roman numerals, prefixes, and custom numbering ranges.
- Created a new HTML page for the tool with a user-friendly interface for file upload and label rule configuration.
- Implemented logic for handling file uploads, processing PDF files, and applying page labels based on user-defined rules.
- Added necessary types and utility functions for managing page label styles and normalization of start values.
- Updated main application configuration to include the new tool in the navigation.
- Added tests for page label utilities to ensure correct functionality.

public/locales/es/tools.json

@@ -86,6 +86,65 @@
     "name": "Números de Página",
     "subtitle": "Inserta números de página en tu documento."
   },
+  "addPageLabels": {
+    "name": "Agregar etiquetas de página",
+    "subtitle": "Aplica etiquetas de página PDF con números romanos, prefijos y valores iniciales personalizados.",
+    "uploadHint": "Archivo PDF",
+    "howLabelsWorkTitle": "Cómo funcionan las etiquetas",
+    "howLabelsWorkStep1": "Deja vacío el rango de páginas para etiquetar todas las páginas.",
+    "howLabelsWorkStep2": "Usa estilos como números romanos para las páginas preliminares y numeración decimal para el cuerpo principal.",
+    "howLabelsWorkStep3": "Usa un prefijo con valor inicial 0 para crear etiquetas como A-0, A-1 y A-2.",
+    "howLabelsWorkStep4": "Activa la progresión cuando una regla use un rango discontinuo como 1-9,30-40 o páginas impares.",
+    "labelRulesTitle": "Reglas de etiquetas",
+    "addRule": "Agregar regla",
+    "removeExistingLabels": "Eliminar las etiquetas de página existentes antes de aplicar estas reglas",
+    "cpdfNote": "Esta herramienta usa CoherentPDF en tu navegador. Si CoherentPDF no está configurado, se te pedirá configurarlo en Ajustes de WASM.",
+    "processButton": "Agregar etiquetas de página",
+    "howItWorksUploadTitle": "Subir archivo",
+    "howItWorksUploadDescription": "Elige el PDF que quieres volver a etiquetar.",
+    "howItWorksDefineTitle": "Definir reglas",
+    "howItWorksDefineDescription": "Configura una o más reglas de etiquetas de página con rangos, estilos, prefijos y valores iniciales.",
+    "howItWorksDownloadTitle": "Descargar",
+    "howItWorksDownloadDescription": "Guarda el PDF actualizado con sus nuevas etiquetas de página.",
+    "relatedToolsTitle": "Herramientas PDF relacionadas",
+    "faqWhatIsQuestion": "¿Qué es una etiqueta de página?",
+    "faqWhatIsAnswer": "Una etiqueta de página es la numeración que los lectores PDF muestran en miniaturas, navegación de páginas y cuadros de impresión. No imprime texto nuevo sobre la propia página.",
+    "faqMixQuestion": "¿Puedo mezclar números romanos y números normales?",
+    "faqMixAnswer": "Sí. Agrega varias reglas, como 1-4 con LowercaseRoman y 5-20 con DecimalArabic.",
+    "faqPrivacyQuestion": "¿Mis archivos siguen siendo privados?",
+    "faqPrivacyAnswer": "Sí. El procesamiento ocurre en tu navegador usando CoherentPDF WASM. Tu PDF no sale de tu dispositivo.",
+    "invalidFileTitle": "Archivo no válido",
+    "invalidFileMessage": "Por favor, sube un archivo PDF válido.",
+    "loadingPdf": "Cargando PDF...",
+    "protectedPdfTitle": "PDF protegido",
+    "protectedPdfMessage": "Este PDF está protegido con contraseña. Usa primero la herramienta Desencriptar o Cambiar permisos.",
+    "loadErrorMessage": "No se pudo cargar el archivo PDF. El archivo puede ser inválido, estar dañado o protegido con contraseña.",
+    "fileMeta": "{{size}} • {{count}} páginas",
+    "ruleTitle": "Regla de etiqueta {{number}}",
+    "pageRangeLabel": "Rango de páginas",
+    "pageRangePlaceholder": "Todas las páginas, o por ejemplo 1-4, 7, impares",
+    "labelStyleLabel": "Estilo de etiqueta",
+    "labelPrefixLabel": "Prefijo de etiqueta",
+    "labelPrefixPlaceholder": "Prefijo opcional, por ejemplo A-",
+    "startValueLabel": "Valor inicial",
+    "continueNumbering": "Continuar la numeración en rangos discontinuos",
+    "examplesNote": "Ejemplos: 1-4 para preliminares en números romanos, 15-20 con prefijo A- y valor inicial 0, o páginas impares con progresión activada.",
+    "uploadFirstMessage": "Primero sube un archivo PDF.",
+    "applyingLabels": "Aplicando etiquetas de página...",
+    "invalidRangeMessage": "La regla {{number}} tiene un rango de páginas no válido: {{range}}",
+    "allPages": "todas las páginas",
+    "emptyOutputMessage": "CoherentPDF produjo un archivo vacío.",
+    "successMessage": "¡Las etiquetas de página se agregaron correctamente!",
+    "processErrorMessage": "No se pudieron agregar las etiquetas de página.",
+    "styleOptions": {
+      "DecimalArabic": "Números decimales",
+      "LowercaseRoman": "Números romanos en minúscula",
+      "UppercaseRoman": "Números romanos en mayúscula",
+      "LowercaseLetters": "Letras minúsculas",
+      "UppercaseLetters": "Letras mayúsculas",
+      "NoLabelPrefixOnly": "Solo prefijo sin numeración"
+    }
+  },
   "batesNumbering": {
     "name": "Numeración Bates",
     "subtitle": "Añadir números Bates secuenciales en uno o más archivos PDF."