@jjlmoya/utils-hardware 1.1.0

package/src/tool/keyboardTest/i18n/en.ts

@@ -0,0 +1,146 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { TestTecladoUI } from '../ui';
+
+const slug = 'keyboard-test';
+const title = 'Online Keyboard Test & Ghosting Detector';
+const description = 'Check if your keyboard suffers from Ghosting or Key Jamming. Real-time key visualizer and N-Key Rollover counter.';
+
+const faqData = [
+  {
+    question: 'What is Ghosting on a keyboard?',
+    answer: 'It\'s a defect that occurs when you press multiple keys at once and the computer doesn\'t register some of them. It\'s due to limitations in the keyboard\'s internal electrical matrix that cannot process certain combinations.',
+  },
+  {
+    question: 'What does N-Key Rollover (NKRO) mean?',
+    answer: 'NKRO means the keyboard can register as many keys as you can press simultaneously without failure. It\'s a premium feature, common in high-end mechanical and gaming keyboards.',
+  },
+  {
+    question: 'Why does my keyboard fail when I press 3 keys at once?',
+    answer: 'Most cheap office keyboards have a 2 or 3-key rollover. This is sufficient for typing but insufficient for intensive gaming or complex shortcuts.',
+  },
+  {
+    question: 'How can I fix a key that doesn\'t respond?',
+    answer: 'If the test doesn\'t detect the keypress, it could be dirt under the switch, electrical contact failure, or a damaged cable. Try cleaning the keyboard with compressed air before giving up.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Focus the visualizer',
+    text: 'Click anywhere on the page to ensure the browser has focus and can capture hardware keypresses.',
+  },
+  {
+    name: 'Run the response test',
+    text: 'Press each key on your keyboard one by one. The corresponding key on screen will light up green if it works correctly.',
+  },
+  {
+    name: 'Check for ghosting',
+    text: 'Press common gaming keys (W, A, S, D, Space, Shift) all at once to see if they lock or all light up.',
+  },
+  {
+    name: 'Verify maximum rollover',
+    text: 'Try pressing as many keys as you can with both hands and watch the maximum simultaneous keypress counter.',
+  },
+];
+
+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: 'en',
+};
+
+export const content: ToolLocaleContent<TestTecladoUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Frequently Asked Questions',
+  faq: faqData,
+  bibliographyTitle: 'Technical References',
+  bibliography: [
+    {
+      name: 'USB Keyboard/Keypad Page - HID Usage Tables',
+      url: 'https://www.usb.org/sites/default/files/documents/hut1_12v2.pdf',
+    },
+    {
+      name: 'Mechanical vs Membrane Keyboards - Technical Deep Dive',
+      url: 'https://deskthority.net/wiki/Rollover',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Online Keyboard Test: Detect Ghosting and N-Key Rollover',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'An interactive tool for keyboard diagnostics. Check if your peripheral suffers from ghosting, jamming, or rollover limitations. Visually clear with support for all keyboard types.',
+    },
+    {
+      type: 'title',
+      text: 'What is Ghosting?',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Ghosting occurs when you press a specific combination of keys and the keyboard registers a phantom keypress you didn\'t make. This is due to limitations in the internal circuit matrix.',
+    },
+    {
+      type: 'title',
+      text: 'N-Key Rollover and Maximum Rollover',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '<strong>NKRO (N-Key Rollover):</strong> Allows registering all pressed keys simultaneously. <strong>6KRO:</strong> Old USB standard limit. <strong>2-3KRO:</strong> Common on cheap keyboards, sufficient for typing.',
+    },
+    {
+      type: 'title',
+      text: 'Mechanical vs Membrane Keyboards',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Mechanical keyboards have individual switches with isolated diodes, eliminating ghosting. Membrane keyboards share conductor traces, causing failures in simultaneous combinations.',
+    },
+  ],
+  ui: {
+    badge: 'Input Test',
+    title: 'Keyboard Test and Ghosting Detector',
+    description: 'Verify N-Key Rollover and detect failed keys.',
+    simultaneousLabel: 'Simultaneous',
+    eventLogLabel: 'Event Log',
+    resetBtn: 'Reset',
+  },
+};

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

@@ -0,0 +1,146 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { TestTecladoUI } from '../ui';
+
+const slug = 'test-teclado';
+const title = 'Test de Teclado y Ghosting Online';
+const description = 'Comprueba si tu teclado sufre de Ghosting o Key Jamming. Visualizador de teclas en tiempo real y contador N-Key Rollover.';
+
+const faqData = [
+  {
+    question: '¿Qué es el Ghosting en un teclado?',
+    answer: 'Es un defecto que ocurre cuando pulsas varias teclas a la vez y el ordenador no registra alguna de ellas. Se debe a limitaciones en la matriz eléctrica interna del teclado que no puede procesar ciertas combinaciones.',
+  },
+  {
+    question: '¿Qué significa N-Key Rollover (NKRO)?',
+    answer: 'NKRO significa que el teclado puede registrar tantas teclas como puedas pulsar simultáneamente sin fallar. Es una característica premium, común en teclados mecánicos de alta gama y gaming.',
+  },
+  {
+    question: '¿Por qué mi teclado falla al pulsar 3 teclas a la vez?',
+    answer: 'La mayoría de teclados de oficina baratos tienen un rollover de 2 o 3 teclas (2-Key Rollover). Esto es suficiente para escribir, pero insuficiente para gaming intensivo o atajos complejos.',
+  },
+  {
+    question: '¿Cómo puedo arreglar una tecla que no responde?',
+    answer: 'Si el test no detecta la pulsación, puede ser por suciedad bajo el switch, un fallo en el contacto eléctrico o el cable dañado. Intenta limpiar el teclado con aire comprimido antes de darlo por perdido.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Enfocar el visualizador',
+    text: 'Haz clic en cualquier parte de la página para asegurar que el navegador tenga el foco y pueda capturar las pulsaciones de hardware.',
+  },
+  {
+    name: 'Realizar el test de respuesta',
+    text: 'Presiona cada tecla del teclado una por una. La tecla correspondiente en pantalla se iluminará en verde si funciona correctamente.',
+  },
+  {
+    name: 'Comprobar el ghosting',
+    text: 'Pulsa varias teclas comunes de gaming (W, A, S, D, Espacio, Shift) a la vez para ver si se bloquean o si todas se iluminan.',
+  },
+  {
+    name: 'Verificar el rollover máximo',
+    text: 'Intenta pulsar tantas teclas como puedas con ambas manos y observa el contador de máxima pulsación simultánea.',
+  },
+];
+
+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: 'EUR' },
+  inLanguage: 'es',
+};
+
+export const content: ToolLocaleContent<TestTecladoUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Preguntas Frecuentes',
+  faq: faqData,
+  bibliographyTitle: 'Referencias Técnicas',
+  bibliography: [
+    {
+      name: 'USB Keyboard/Keypad Page - HID Usage Tables',
+      url: 'https://www.usb.org/sites/default/files/documents/hut1_12v2.pdf',
+    },
+    {
+      name: 'Mechanical vs Membrane Keyboards - Technical Deep Dive',
+      url: 'https://deskthority.net/wiki/Rollover',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Test de Teclado Online: Detecta Ghosting y N-Key Rollover',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Una herramienta interactiva para diagnóstico de teclados. Verifica si tu periférico sufre de ghosting, jamming o limitaciones de rollover. Visualmente clara con soporte para todos los tipos de teclado.',
+    },
+    {
+      type: 'title',
+      text: '¿Qué es el Ghosting?',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'El ghosting ocurre cuando pulsas una combinación específica de teclas y el teclado registra una pulsación fantasma que no realizaste. Esto se debe a limitaciones en la matriz de circuitos internos.',
+    },
+    {
+      type: 'title',
+      text: 'N-Key Rollover y Rollover Máximo',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '<strong>NKRO (N-Key Rollover):</strong> Permite registrar todas las teclas pulsadas simultáneamente. <strong>6KRO:</strong> Límite del estándar USB antiguo. <strong>2-3KRO:</strong> Común en teclados baratos, suficiente para escribir.',
+    },
+    {
+      type: 'title',
+      text: 'Teclados Mecánicos vs Membrana',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Los teclados mecánicos tienen switches individuales con diodos aislados, eliminando ghosting. Los de membrana comparten pistas conductoras, causando fallos en combinaciones simultáneas.',
+    },
+  ],
+  ui: {
+    badge: 'Input Test',
+    title: 'Test de Teclado y Ghosting',
+    description: 'Verifica el N-Key Rollover y detecta teclas fallidas.',
+    simultaneousLabel: 'Simultáneas',
+    eventLogLabel: 'Log de Eventos',
+    resetBtn: 'Reiniciar',
+  },
+};

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

@@ -0,0 +1,146 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { TestTecladoUI } from '../ui';
+
+const slug = 'test-clavier';
+const title = 'Test de Clavier et Détecteur de Ghosting';
+const description = 'Vérifiez si votre clavier souffre de ghosting ou de blocage de touches. Visualiseur de touches en temps réel et compteur N-Key Rollover.';
+
+const faqData = [
+  {
+    question: 'Qu\'est-ce que le ghosting sur un clavier?',
+    answer: 'C\'est un défaut qui se produit lorsque vous appuyez sur plusieurs touches à la fois et que l\'ordinateur n\'en enregistre pas certaines. Cela est dû aux limitations de la matrice électrique interne du clavier qui ne peut pas traiter certaines combinaisons.',
+  },
+  {
+    question: 'Qu\'est-ce que N-Key Rollover (NKRO)?',
+    answer: 'NKRO signifie que le clavier peut enregistrer autant de touches que vous pouvez en appuyer simultanément sans défaillance. C\'est une fonction premium, courante sur les claviers mécaniques haut de gamme et gaming.',
+  },
+  {
+    question: 'Pourquoi mon clavier échoue-t-il quand j\'appuie sur 3 touches à la fois?',
+    answer: 'La plupart des claviers de bureau bon marché ont un rollover de 2 ou 3 touches. Cela est suffisant pour taper, mais insuffisant pour les jeux intensifs ou les raccourcis complexes.',
+  },
+  {
+    question: 'Comment puis-je réparer une touche qui ne répond pas?',
+    answer: 'Si le test ne détecte pas la frappe, cela pourrait être de la saleté sous le switch, une défaillance du contact électrique ou un câble endommagé. Essayez de nettoyer le clavier avec de l\'air comprimé avant de l\'abandonner.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Mettre le visualiseur au point',
+    text: 'Cliquez n\'importe où sur la page pour vous assurer que le navigateur a le focus et peut capturer les frappes matérielles.',
+  },
+  {
+    name: 'Effectuer le test de réponse',
+    text: 'Appuyez sur chaque touche du clavier une par une. La touche correspondante à l\'écran s\'illuminera en vert si elle fonctionne correctement.',
+  },
+  {
+    name: 'Vérifier le ghosting',
+    text: 'Appuyez sur plusieurs touches communes du gaming (Z, Q, S, D, Espace, Maj) à la fois pour voir si elles se bloquent ou si elles s\'illuminent toutes.',
+  },
+  {
+    name: 'Vérifier le rollover maximal',
+    text: 'Essayez d\'appuyer sur autant de touches que possible avec les deux mains et observez le compteur de frappe simultanée maximale.',
+  },
+];
+
+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: 'EUR' },
+  inLanguage: 'fr',
+};
+
+export const content: ToolLocaleContent<TestTecladoUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Questions Fréquemment Posées',
+  faq: faqData,
+  bibliographyTitle: 'Références Techniques',
+  bibliography: [
+    {
+      name: 'USB Keyboard/Keypad Page - HID Usage Tables',
+      url: 'https://www.usb.org/sites/default/files/documents/hut1_12v2.pdf',
+    },
+    {
+      name: 'Mechanical vs Membrane Keyboards - Technical Deep Dive',
+      url: 'https://deskthority.net/wiki/Rollover',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Test de Clavier en Ligne: Détectez le Ghosting et N-Key Rollover',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Un outil interactif pour le diagnostic du clavier. Vérifiez si votre périphérique souffre de ghosting, blocage ou limitations de rollover. Visuellement clair avec support pour tous les types de clavier.',
+    },
+    {
+      type: 'title',
+      text: 'Qu\'est-ce que le Ghosting?',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Le ghosting se produit lorsque vous appuyez sur une combinaison spécifique de touches et que le clavier enregistre une frappe fantôme que vous n\'avez pas faite. Ceci est dû aux limitations de la matrice de circuits interne.',
+    },
+    {
+      type: 'title',
+      text: 'N-Key Rollover et Rollover Maximal',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '<strong>NKRO (N-Key Rollover):</strong> Permet d\'enregistrer toutes les touches appuyées simultanément. <strong>6KRO:</strong> Limite de l\'ancienne norme USB. <strong>2-3KRO:</strong> Courant sur les claviers bon marché, suffisant pour taper.',
+    },
+    {
+      type: 'title',
+      text: 'Claviers Mécaniques vs Membrane',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Les claviers mécaniques ont des switches individuels avec des diodes isolées, éliminant le ghosting. Les claviers à membrane partagent des pistes conductrices, causant des défaillances dans les combinaisons simultanées.',
+    },
+  ],
+  ui: {
+    badge: 'Test d\'Entrée',
+    title: 'Test de Clavier et Détecteur de Ghosting',
+    description: 'Vérifiez le N-Key Rollover et détectez les touches défaillantes.',
+    simultaneousLabel: 'Simultanées',
+    eventLogLabel: 'Journal des Événements',
+    resetBtn: 'Réinitialiser',
+  },
+};

package/src/tool/keyboardTest/index.ts

@@ -0,0 +1,34 @@
+import type { HardwareToolEntry, ToolLocaleContent, ToolDefinition } from '../../types';
+
+import TestTecladoComponent from './component.astro';
+import TestTecladoSEO from './seo.astro';
+import TestTecladoBibliography from './bibliography.astro';
+
+import type { TestTecladoUI } from './ui';
+export type TestTecladoLocaleContent = ToolLocaleContent<TestTecladoUI>;
+
+import { content as es } from './i18n/es';
+import { content as en } from './i18n/en';
+import { content as fr } from './i18n/fr';
+
+export const testTeclado: HardwareToolEntry<TestTecladoUI> = {
+  id: 'test-teclado',
+  icons: {
+    bg: 'mdi:keyboard-variant',
+    fg: 'mdi:keyboard-settings',
+  },
+  i18n: {
+    es: async () => es,
+    en: async () => en,
+    fr: async () => fr,
+  },
+};
+
+export { TestTecladoComponent, TestTecladoSEO, TestTecladoBibliography };
+
+export const TEST_TECLADO_TOOL: ToolDefinition = {
+  entry: testTeclado,
+  Component: TestTecladoComponent,
+  SEOComponent: TestTecladoSEO,
+  BibliographyComponent: TestTecladoBibliography,
+};

package/src/tool/keyboardTest/seo.astro

@@ -0,0 +1,14 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import type { KnownLocale } from '../../types';
+import { testTeclado } from './index';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await testTeclado.i18n[locale]?.();
+---
+
+{content && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/keyboardTest/ui.ts

@@ -0,0 +1,8 @@
+export interface TestTecladoUI extends Record<string, string> {
+  badge: string;
+  title: string;
+  description: string;
+  simultaneousLabel: string;
+  eventLogLabel: string;
+  resetBtn: string;
+}

package/src/tool/mousePollingTest/bibliography.astro

@@ -0,0 +1,14 @@
+---
+import { Bibliography as SharedBibliography } from '@jjlmoya/utils-shared';
+import type { KnownLocale } from '../../types';
+import { testRaton } from './index';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await testRaton.i18n[locale]?.();
+---
+
+{content && content.bibliography.length > 0 && <SharedBibliography links={content.bibliography} />}