@jjlmoya/utils-hardware 1.24.0 → 1.25.0

package/src/tool/keyboardChatterTest/i18n/es.ts

@@ -0,0 +1,232 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { KeyboardChatterTestUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'test-chatter-teclado';
+const title = 'Test de Chatter de Teclado';
+const description = 'Detecta chattering en teclados mecánicos, doble escritura y rebote de interruptor defectuoso comprobando cuán rápido aparece la misma tecla dos veces.';
+
+const faqData = [
+  {
+    question: '¿Qué es el chattering de teclado?',
+    answer: 'El chattering de teclado es un fallo de hardware donde una pulsación física se registra como múltiples pulsaciones. Es común en interruptores mecánicos sucios, desgastados, oxidados o mal debounced.',
+  },
+  {
+    question: '¿Cómo funciona este test de chattering de teclado?',
+    answer: 'Presiona la misma tecla sospechosa lentamente, una pulsación a la vez. Si el registro muestra pulsaciones repetidas a solo unos milisegundos de distancia, el interruptor puede estar rebotando y produciendo dobles letras.',
+  },
+  {
+    question: '¿Qué delta significa que mi teclado está haciendo doble escritura?',
+    answer: 'Una pulsación repetida por debajo de 30 ms es fuertemente sospechosa de chattering. Repeticiones de 30 a 50 ms merecen atención. Las repeticiones intencionadas normales suelen estar por encima de 50 ms para la mayoría de usuarios.',
+  },
+  {
+    question: '¿Por qué la primera pulsación no muestra delta?',
+    answer: 'Un delta necesita una pulsación previa de la misma tecla. La primera pulsación establece la línea base, y las posteriores muestran el intervalo de tiempo en milisegundos.',
+  },
+  {
+    question: '¿Puede el software arreglar el chattering de teclado?',
+    answer: 'El software de debounce puede ocultar algunos síntomas, pero no repara el interruptor. Limpiar, reasentar interruptores hot-swap, reemplazar el interruptor o reparar la PCB del teclado puede ser necesario.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Abre la herramienta y presiona teclas normalmente',
+    text: 'No hay botón de inicio. Haz clic en la herramienta si es necesario, luego presiona la tecla que ha estado escribiendo doble.',
+  },
+  {
+    name: 'Pulsa la tecla sospechosa de una en una',
+    text: 'Presiona la tecla que escribe doble. Si una pulsación física crea varias filas en el registro con deltas diminutos, el interruptor probablemente está haciendo chattering.',
+  },
+  {
+    name: 'Lee el código de colores',
+    text: 'Verde significa normal por encima de 50 ms, amarillo significa sospechoso de 30 a 50 ms y rojo significa chattering detectado por debajo de 30 ms.',
+  },
+  {
+    name: 'Exporta el registro si es necesario',
+    text: 'Usa el botón de descarga para guardar un registro CSV que puede ayudar a comparar teclas o documentar un fallo intermitente.',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
+  inLanguage: 'es',
+};
+
+export const content: ToolLocaleContent<KeyboardChatterTestUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  bibliography,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Test de Doble Escritura de Teclado Mecánico',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Este test de chattering de teclado ayuda a diagnosticar un teclado mecánico que escribe dos letras de una pulsación, pierde liberaciones limpias o produce caracteres repetidos sin que pulses dos veces intencionalmente. Úsalo antes de limpiar interruptores, cambiar la configuración de debounce del firmware, abrir una reclamación de garantía o reemplazar un interruptor hot-swap.',
+    },
+    {
+      type: 'diagnostic',
+      variant: 'info',
+      title: 'Cómo leer el resultado',
+      badge: 'Umbrales de delta',
+      html: '<p><strong>Normal</strong> significa que la repetición fue superior a 50 ms y suele ser intencionada. <strong>Sospechoso</strong> significa 30-50 ms y debe volver a probarse en la misma tecla. <strong>Chattering detectado</strong> significa por debajo de 30 ms, lo que probablemente es una pulsación física que rebota en múltiples contactos eléctricos.</p>',
+    },
+    {
+      type: 'title',
+      text: 'Por Qué los Interruptores Mecánicos Hacen Chattering',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Un interruptor mecánico no se cierra como una señal digital perfectamente limpia. Los contactos metálicos pueden rebotar durante unos milisegundos antes de asentarse. El firmware del teclado normalmente filtra ese rebote con una ventana de debounce. El chattering ocurre cuando el contacto está sucio, desgastado, oxidado, flojo, agrietado o mal ajustado hasta el punto de que el teclado reporta pulsaciones extra después de que el filtro de debounce debería haberlas manejado.',
+    },
+    {
+      type: 'table',
+      headers: ['Síntoma', 'Causa probable', 'Qué intentar primero'],
+      rows: [
+        ['Una tecla escribe la misma letra dos veces', 'Contacto del interruptor sucio o desgastado', 'Retira la tecla, sopla el polvo y prueba de nuevo antes de reemplazar el interruptor.'],
+        ['Varias teclas hot-swap hacen chattering tras una construcción', 'Pines del interruptor no asentados correctamente', 'Extrae y reasienta el interruptor, verificando pines doblados o un socket flojo.'],
+        ['Solo ocurre después de derrames o humedad', 'Oxidación o residuos en los contactos', 'Desconecta el teclado y limpia según la guía del fabricante.'],
+        ['Muchas teclas muestran deltas diminutos', 'Debounce del firmware demasiado bajo o problema de escaneo', 'Compara en otro puerto USB y revisa la configuración de debounce del firmware si está disponible.'],
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Método de Prueba que Reduce Falsos Positivos',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'Prueba una tecla sospechosa a la vez en lugar de escribir frases completas.',
+        'Presiona la tecla una vez, suéltala completamente y espera un momento antes de la siguiente pulsación.',
+        'Compara la tecla sospechosa con una tecla cercana que se sienta sana.',
+        'Ignora la primera fila de una tecla porque no tiene una pulsación previa con la que comparar.',
+        'Si la misma tecla muestra repetidamente filas rojas por debajo de 30 ms con pulsaciones únicas, trátalo como un fallo de hardware.',
+        'Si solo aparecen filas amarillas, repite la prueba más despacio y comprueba si tu ritmo de tecleo está causando el intervalo corto.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Chattering vs. Escritura Rápida Intencionada',
+      level: 3,
+    },
+    {
+      type: 'comparative',
+      columns: 3,
+      items: [
+        {
+          title: 'Chattering',
+          description: 'Agrupado en una tecla, a menudo por debajo de 30 ms, y aparece cuando pretendías una sola pulsación.',
+          points: ['Inspecciona el interruptor o socket.', 'Compara con una tecla sana cercana.'],
+        },
+        {
+          title: 'Escritura rápida',
+          description: 'Afecta a muchas teclas, sigue tu ritmo y tiende a situarse por encima de 50 ms entre pulsaciones repetidas de la misma tecla.',
+          points: ['Generalmente uso normal.', 'Vuelve a probar con pulsaciones únicas más lentas.'],
+        },
+        {
+          title: 'Repetición de tecla del SO',
+          description: 'Aparece al mantener una tecla presionada y generalmente se repite con un ritmo regular establecido por tu sistema operativo.',
+          points: ['Suelta completamente entre pulsaciones.', 'Verifica la configuración de repetición de teclado por separado.'],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Qué Hacer Cuando una Tecla Falla',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'Guarda un registro CSV antes de cambiar nada para poder comparar resultados antes y después.',
+        'Retira la tecla e inspecciona si hay suciedad, residuos de líquido o un vástago que no retorna suavemente.',
+        'Para teclados hot-swap, reasienta o reemplaza el interruptor y prueba la misma posición de nuevo.',
+        'Para teclados soldados, compara las opciones de debounce del firmware antes de asumir que la PCB necesita reparación.',
+        'Prueba otro cable y puerto USB si múltiples teclas no relacionadas muestran deltas imposibles.',
+        'Para soporte de garantía, incluye la tecla afectada, los valores delta repetidos, el modelo de teclado, la versión de firmware y si el fallo sigue al interruptor o al socket de la PCB.',
+      ],
+    },
+    {
+      type: 'summary',
+      title: 'Regla rápida',
+      items: [
+        'Una sola fila roja es una pista, no un veredicto.',
+        'Filas rojas repetidas por debajo de 30 ms en la misma tecla física son fuerte evidencia de chattering de teclado.',
+        'Usa pulsaciones únicas deliberadas y compara el interruptor sospechoso con una tecla sana cercana antes de reemplazar hardware.',
+      ],
+    },
+  ],
+  ui: {
+    statusIdle: 'Presiona cualquier tecla',
+    statusListening: 'Midiendo deltas de tecla',
+    statusChatter: 'Chattering detectado',
+    totalPresses: 'Pulsaciones totales',
+    chatterEvents: 'Eventos de chattering',
+    worstDelta: 'Peor delta',
+    watchWindow: 'Filas conservadas',
+    keyColumn: 'Tecla',
+    deltaColumn: 'Delta',
+    verdictColumn: 'Veredicto',
+    timeColumn: 'Tiempo',
+    normal: 'Normal',
+    suspect: 'Sospechoso',
+    chatter: 'Chattering',
+    waiting: 'Esperando',
+    clear: 'Limpiar registro',
+    exportLog: 'Exportar CSV',
+    hint: 'El registro conserva las 80 filas más recientes para que las sesiones largas sean rápidas. La repetición de tecla mantenida se ignora; las filas rojas provienen de pulsaciones separadas que ocurrieron demasiado juntas.',
+    captureNotice: 'Sin botón de inicio. Pulsa una tecla sospechosa una vez y observa el delta desde su pulsación anterior.',
+    keyboardAriaLabel: 'Actividad reciente de teclas',
+    logAriaLabel: 'Registro de eventos de chattering de teclado',
+    escapeKey: 'Esc',
+    backspaceKey: 'Retro',
+    tabKey: 'Tab',
+    enterKey: 'Enter',
+    capsLockKey: 'Mayús',
+    shiftKey: 'Shift',
+    controlKey: 'Ctrl',
+    metaKey: 'Meta',
+    altKey: 'Alt',
+    spaceKey: 'Espacio',
+    csvHeader: 'tecla,código,delta_ms,gravedad,hora',
+  },
+};

package/src/tool/keyboardChatterTest/i18n/fr.ts

@@ -0,0 +1,232 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { KeyboardChatterTestUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'test-rebond-clavier';
+const title = 'Test de Rebond de Clavier';
+const description = 'Détectez le rebond des claviers mécaniques, la double frappe et les rebonds de contact défectueux en vérifiant la rapidité avec laquelle la même touche apparaît deux fois.';
+
+const faqData = [
+  {
+    question: 'Qu\'est-ce que le rebond de clavier ?',
+    answer: 'Le rebond de clavier est un défaut matériel où une pression physique est enregistrée comme plusieurs pressions. Il est courant sur les interrupteurs mécaniques sales, usés, oxydés ou mal anti-rebondis.',
+  },
+  {
+    question: 'Comment fonctionne ce test de rebond de clavier ?',
+    answer: 'Appuyez lentement sur la même touche suspecte, une pression à la fois. Si le journal montre des pressions répétées à seulement quelques millisecondes d\'intervalle, l\'interrupteur rebondit peut-être et produit des doubles lettres.',
+  },
+  {
+    question: 'Quel delta signifie que mon clavier fait de la double frappe ?',
+    answer: 'Une pression répétée en dessous de 30 ms est fortement suspecte de rebond. Les répétitions de 30 à 50 ms méritent attention. Les répétitions intentionnelles normales sont généralement au-dessus de 50 ms pour la plupart des utilisateurs.',
+  },
+  {
+    question: 'Pourquoi la première pression n\'affiche-t-elle pas de delta ?',
+    answer: 'Un delta nécessite une pression précédente de la même touche. La première pression établit la ligne de base, et les pressions suivantes montrent l\'écart de temps en millisecondes.',
+  },
+  {
+    question: 'Les logiciels peuvent-ils corriger le rebond de clavier ?',
+    answer: 'Un logiciel anti-rebond peut masquer certains symptômes, mais il ne répare pas l\'interrupteur. Nettoyer, réinsérer les interrupteurs hot-swap, remplacer l\'interrupteur ou réparer le PCB du clavier peut être nécessaire.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Ouvrez l\'outil et appuyez normalement sur les touches',
+    text: 'Il n\'y a pas de bouton de démarrage. Cliquez dans l\'outil si nécessaire, puis appuyez sur la touche qui a tapé en double.',
+  },
+  {
+    name: 'Appuyez une seule fois sur la touche suspecte',
+    text: 'Appuyez sur la touche qui tape en double. Si une pression physique crée plusieurs lignes de journal avec de petits deltas, l\'interrupteur rebondit probablement.',
+  },
+  {
+    name: 'Lisez le code couleur',
+    text: 'Vert signifie normal au-dessus de 50 ms, jaune signifie suspect de 30 à 50 ms et rouge signifie rebond détecté en dessous de 30 ms.',
+  },
+  {
+    name: 'Exportez le journal si nécessaire',
+    text: 'Utilisez le bouton de téléchargement pour enregistrer un journal CSV qui peut aider à comparer les touches ou documenter un défaut intermittent.',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
+  inLanguage: 'fr',
+};
+
+export const content: ToolLocaleContent<KeyboardChatterTestUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  bibliography,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Test de Double Frappe de Clavier Mécanique',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Ce test de rebond de clavier aide à diagnostiquer un clavier mécanique qui tape deux lettres à partir d\'une pression, rate des relâchements nets ou produit des caractères répétés sans que vous tapiez intentionnellement deux fois. Utilisez-le avant de nettoyer des interrupteurs, de modifier les paramètres anti-rebond du firmware, d\'ouvrir une réclamation de garantie ou de remplacer un interrupteur hot-swap.',
+    },
+    {
+      type: 'diagnostic',
+      variant: 'info',
+      title: 'Comment lire le résultat',
+      badge: 'Seuils de delta',
+      html: '<p><strong>Normal</strong> signifie que la répétition était au-dessus de 50 ms et est généralement intentionnelle. <strong>Suspect</strong> signifie 30-50 ms et doit être retesté sur la même touche. <strong>Rebond détecté</strong> signifie en dessous de 30 ms, ce qui est très probablement une pression physique rebondissant en plusieurs contacts électriques.</p>',
+    },
+    {
+      type: 'title',
+      text: 'Pourquoi les Interrupteurs Mécaniques Rebondissent',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Un interrupteur mécanique ne se ferme pas comme un signal numérique parfaitement propre. Les contacts métalliques peuvent rebondir pendant quelques millisecondes avant de se stabiliser. Le firmware du clavier filtre normalement ce rebond avec une fenêtre anti-rebond. Le rebondissement se produit lorsque le contact est sale, usé, oxydé, desserré, fissuré ou mal réglé au point que le clavier signale des pressions supplémentaires après que le filtre anti-rebond aurait dû les gérer.',
+    },
+    {
+      type: 'table',
+      headers: ['Symptôme', 'Cause probable', 'Que tester en premier'],
+      rows: [
+        ['Une touche tape la même lettre deux fois', 'Contact d\'interrupteur sale ou usé', 'Retirez le capuchon, soufflez la poussière et testez à nouveau avant de remplacer l\'interrupteur.'],
+        ['Plusieurs touches hot-swap rebondissent après un montage', 'Broches d\'interrupteur mal insérées', 'Retirez et réinsérez l\'interrupteur, en vérifiant les broches tordues ou un socket desserré.'],
+        ['Se produit seulement après des déversements ou de l\'humidité', 'Oxydation ou résidus sur les contacts', 'Débranchez le clavier et nettoyez selon les instructions du fabricant.'],
+        ['De nombreuses touches montrent de petits deltas', 'Anti-rebond du firmware trop bas ou problème de scan', 'Comparez sur un autre port USB et examinez les paramètres anti-rebond du firmware si disponibles.'],
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Méthode de Test Qui Réduit les Faux Positifs',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'Testez une touche suspecte à la fois au lieu de taper des phrases complètes.',
+        'Appuyez une fois sur la touche, relâchez-la complètement et attendez un moment avant la pression suivante.',
+        'Comparez la touche suspecte avec une touche voisine qui semble saine.',
+        'Ignorez la première ligne pour une touche car il n\'y a pas de pression précédente à comparer.',
+        'Si la même touche montre à plusieurs reprises des lignes rouges sous 30 ms avec des pressions simples, traitez-la comme un défaut matériel.',
+        'Si seules des lignes jaunes apparaissent, répétez le test plus lentement et vérifiez si votre rythme de frappe cause l\'intervalle court.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Rebond vs. Frappe Rapide Intentionnelle',
+      level: 3,
+    },
+    {
+      type: 'comparative',
+      columns: 3,
+      items: [
+        {
+          title: 'Rebond',
+          description: 'Concentré sur une touche, souvent en dessous de 30 ms, et apparaît lorsque vous vouliez une seule pression.',
+          points: ['Inspectez l\'interrupteur ou le socket.', 'Comparez avec une touche saine voisine.'],
+        },
+        {
+          title: 'Frappe rapide',
+          description: 'Affecte de nombreuses touches, suit votre rythme et tend à se situer au-dessus de 50 ms entre les pressions répétées de la même touche.',
+          points: ['Généralement une utilisation normale.', 'Retestez avec des pressions simples plus lentes.'],
+        },
+        {
+          title: 'Répétition de touche du système',
+          description: 'Apparaît en maintenant une touche enfoncée et se répète généralement à un rythme régulier défini par votre système d\'exploitation.',
+          points: ['Relâchez complètement entre les pressions.', 'Vérifiez les paramètres de répétition du clavier séparément.'],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Que Faire Quand une Touche Échoue',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'Enregistrez un journal CSV avant de changer quoi que ce soit pour pouvoir comparer les résultats avant et après.',
+        'Retirez le capuchon de touche et inspectez la saleté, les résidus de liquide ou une tige qui ne revient pas en douceur.',
+        'Pour les claviers hot-swap, réinsérez ou remplacez l\'interrupteur et testez à nouveau la même position.',
+        'Pour les claviers soudés, comparez les options anti-rebond du firmware avant de supposer que le PCB a besoin de réparation.',
+        'Essayez un autre câble et port USB si plusieurs touches non liées montrent des deltas impossibles.',
+        'Pour le support de garantie, incluez la touche affectée, les valeurs delta répétées, le modèle de clavier, la version du firmware et si le défaut suit l\'interrupteur ou le socket PCB.',
+      ],
+    },
+    {
+      type: 'summary',
+      title: 'Règle rapide',
+      items: [
+        'Une seule ligne rouge est un indice, pas un verdict.',
+        'Des lignes rouges répétées en dessous de 30 ms sur la même touche physique sont une preuve forte de rebond de clavier.',
+        'Utilisez des pressions simples délibérées et comparez l\'interrupteur suspect avec une touche saine voisine avant de remplacer le matériel.',
+      ],
+    },
+  ],
+  ui: {
+    statusIdle: 'Appuyez sur une touche',
+    statusListening: 'Mesure des deltas de touche',
+    statusChatter: 'Rebond détecté',
+    totalPresses: 'Pressions totales',
+    chatterEvents: 'Événements de rebond',
+    worstDelta: 'Pire delta',
+    watchWindow: 'Lignes conservées',
+    keyColumn: 'Touche',
+    deltaColumn: 'Delta',
+    verdictColumn: 'Verdict',
+    timeColumn: 'Temps',
+    normal: 'Normal',
+    suspect: 'Suspect',
+    chatter: 'Rebond',
+    waiting: 'En attente',
+    clear: 'Effacer le journal',
+    exportLog: 'Exporter CSV',
+    hint: 'Le journal conserve les 80 lignes les plus récentes pour que les longues sessions restent rapides. La répétition de touche maintenue est ignorée ; les lignes rouges proviennent de pressions séparées trop rapprochées.',
+    captureNotice: 'Pas de bouton de démarrage. Appuyez une fois sur une touche suspecte et observez le delta par rapport à sa pression précédente.',
+    keyboardAriaLabel: 'Activité récente des touches',
+    logAriaLabel: 'Journal des événements de rebond de clavier',
+    escapeKey: 'Échap',
+    backspaceKey: 'Retour',
+    tabKey: 'Tab',
+    enterKey: 'Entrée',
+    capsLockKey: 'Verr Maj',
+    shiftKey: 'Maj',
+    controlKey: 'Ctrl',
+    metaKey: 'Meta',
+    altKey: 'Alt',
+    spaceKey: 'Espace',
+    csvHeader: 'touche,code,delta_ms,gravité,heure',
+  },
+};